Historical (April 2026). This describes the consolidation from the FastAPI backend to Next.js. Phase 16 (2026-08-28) deleted the FastAPI backend, the backend-proxy layer and the legacy UI this plan refers to; nothing here describes TestForge today. Kept for history only — see
README.md.
Goal: establish a complete inventory of current functionality before migration so no behavior is lost.
| Endpoint | Implemented In | Purpose | Status For Consolidation |
|---|---|---|---|
| GET / | app.py (legacy template UI) | Serves legacy HTML app | Legacy-only; plan deprecate after parity |
| POST /api/generate | app.py | Generate Python Playwright code | Legacy-only API contract |
| POST /api/run | app.py | Execute generated Python test | Legacy-only API contract |
| POST /api/generate | src/app/api/generate/route.ts | Generate TypeScript Playwright suite with best-practice + content-aware options | Primary target |
| POST /api/run | src/app/api/run/route.ts | Async run lifecycle, structured report, artifacts, reruns | Primary target |
| GET /api/run?runId=… | src/app/api/run/route.ts | Poll run status/progress | Primary target |
| DELETE /api/run | src/app/api/run/route.ts | Cancel active run | Primary target |
| POST /api/crawl | src/app/api/crawl/route.ts | Crawl site pages async | Primary target |
| GET /api/crawl?crawlId=… | src/app/api/crawl/route.ts | Poll crawl status/progress | Primary target |
| DELETE /api/crawl | src/app/api/crawl/route.ts | Cancel crawl | Primary target |
| POST /api/introspect | src/app/api/introspect/route.ts | Inspect pages for headings/text/links/actionables | Primary target |
| POST /api/save-suite | src/app/api/save-suite/route.ts | Save generated suites to .playwright-runs | Primary target |
| Capability | Next.js UI (src/app/page.tsx) | FastAPI UI (templates/index.html) | Parity Risk |
|---|---|---|---|
| Generate suite | Yes | Yes | Low |
| Edit/copy generated code | Yes | Yes | Low |
| Run suite | Yes | Yes | Low |
| Async run progress + cancel | Yes | No | High |
| Structured report tabs (summary/execution/defects/coverage/performance/usability/seo) | Yes | No | High |
| Crawl pages + selection/filter | Yes | No | High |
| Introspect + content-aware rules | Yes | No | High |
| Save suite to explorer | Yes | No | Medium |
| Rerun failed selection | Yes | No | Medium |
| Artifact download linkage | Yes | No | High |