mr-onion

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.

Phase 10 - Cutover Runbook and Rollback

Goal

Provide a safe operator runbook for switching to single-UI mode while keeping rollback immediate and low risk.

Scope

Required environment variables

Set these in .env for single-UI cutover:

Cutover procedure

  1. Ensure the backend (FastAPI) is running and reachable.
  2. Ensure the Next.js app is running at http://localhost:3000.
  3. Apply the required environment variables.
  4. Restart application processes.
  5. Validate core workflows from Next.js UI:
    • Generate
    • Introspect
    • Crawl
    • Save suite
    • Run and fetch artifacts
  6. Validate legacy UI deprecation behavior:
    • Request http://localhost:8000/
    • Confirm HTTP 307 redirect target is Next.js URL

Rollback procedure

  1. Set TESTFORGE_DISABLE_LEGACY_UI=false.
  2. Restart FastAPI process.
  3. Verify http://localhost:8000/ serves the legacy UI.
  4. If needed, unset TESTFORGE_BACKEND_BASE_URL to return Next.js API routes to local fallback behavior.

Acceptance criteria