integration-testing.md

Integration Testing Guide

This guide covers how to write and run integration tests for Gofannon.

Overview

Integration tests verify that multiple components work together correctly. Unlike unit tests, they may involve real database connections, API calls, and Docker services.

Running Integration Tests

# From webapp directory
cd webapp

# Run all integration tests
pnpm test:integration

# Run backend integration tests only
pnpm test:integration:backend

Test Location

Integration tests are located in:

• Backend: webapp/packages/api/user-service/tests/integration/
• E2E: webapp/tests/e2e/

Docker Services

Integration tests require running Docker services:

# Start required services
docker compose up -d couchdb minio

Writing Integration Tests

Integration tests should:

• Test realistic scenarios with multiple components
• Use real (or containerized) services when appropriate
• Clean up test data after each test
• Be idempotent (can run multiple times safely)

Related Documentation

• Unit Testing Guide
• Backend Testing Guide
• CI/CD Testing