Deep-audit + build-out across all products to fully-usable state; all typecheck clean. - gitgram-web (99): wire Store feature to real endpoints, close 9 gaps - gitgram-backend (100): close 8 flow gaps, document infra-provisioning items - gitgram-mobile (90): fix API base-URL/path mismatch (404s) + copy proximity components into components/proximity wired to real screens; 15 gaps, +react-native-svg - aitm-core (95): wire natural-language CLI flow end-to-end; 11 gaps - aitm-api (97): fix teams metadata runtime bug; copy a2a-js server/client/grpc into src/a2a and wire A2A route; crates.io package search; 8 gaps - aitm-mcp (100): fix A2A client/server card mismatch; 9 gaps - aitm-website (95): build missing docs routes; 9 gaps Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
59 lines
2.0 KiB
Markdown
59 lines
2.0 KiB
Markdown
# Gitgram Backend — End-to-End (E2E) Tests
|
|
|
|
This suite exercises the **real** Express HTTP API against a **real** PostgreSQL
|
|
(and optionally Redis) instance. Unlike the default Jest suite (which mocks
|
|
Prisma, Redis, and external services via `tests/setup.ts`), these tests catch
|
|
cross-service regressions and route-wiring breaks that mocks cannot.
|
|
|
|
## What it covers
|
|
|
|
- **`auth.e2e.test.ts`** — register, `/me`, login, refresh, logout, validation boundaries.
|
|
- **`posts.e2e.test.ts`** — create/read posts, comments, like/unlike, likers, follow graph.
|
|
- **`snippets.e2e.test.ts`** — snippet CRUD plus comments and likers (social parity).
|
|
- **`system.e2e.test.ts`** — health/readiness, AI-analysis feature flag (503 when disabled),
|
|
Polar webhook route mounting, and confirmation the duplicate webhook route was removed.
|
|
|
|
## Running locally
|
|
|
|
### Option A — one command (Docker)
|
|
|
|
Requires Docker. Brings up ephemeral Postgres (`:5433`) + Redis (`:6380`),
|
|
runs the suite, and tears everything down:
|
|
|
|
```bash
|
|
npm run test:e2e:docker
|
|
```
|
|
|
|
### Option B — manual
|
|
|
|
```bash
|
|
# 1. Start the harness
|
|
docker compose -f docker-compose.test.yml up -d --wait
|
|
|
|
# 2. Point the suite at it and run
|
|
export DATABASE_URL="postgresql://gitgram_test:gitgram_test@localhost:5433/gitgram_test"
|
|
export REDIS_URL="redis://localhost:6380"
|
|
npm run test:e2e
|
|
|
|
# 3. Tear down
|
|
docker compose -f docker-compose.test.yml down -v
|
|
```
|
|
|
|
The global setup (`globalSetup.ts`) runs `prisma db push` against the test
|
|
database before the suite, so a fresh empty DB is fine — no migration history
|
|
required.
|
|
|
|
## CI
|
|
|
|
The `Gitgram Tests` workflow (`.github/workflows/gitgram-tests.yml`) runs this
|
|
suite in the **`backend-e2e`** job using GitHub Actions service containers for
|
|
Postgres and Redis.
|
|
|
|
## Notes
|
|
|
|
- The suite runs serially (`--runInBand`) and resets the relevant tables between
|
|
suites for deterministic state.
|
|
- External integrations (email, storage, Polar, GitNexus) are intentionally left
|
|
unconfigured so flows are deterministic; the feature-flag tests assert the
|
|
graceful-degradation behavior.
|