Files
ZitPlane/docs/PHASES.md
T

5.3 KiB

Phase register and scope locks

Implement one explicitly approved phase at a time. Keep out-of-scope files, existing authentication machinery and production systems unchanged.

P01 - Foundation (COMPLETE)

  • Baseline commit 8f54ccb30426f2955472c0cd40fb94d0b18e86ac.
  • Initial monorepo folder structure, docs, project Git identity and clean commit completed.

P02 - ZITADEL local backend (APPROVED 2026-11-22)

  • Allowed source writes: core/backend/zitadel/**, deployment/docker/compose.backend.dev.yaml, .env.example, backend-focused tests/**, and narrow docs/** / README.md.
  • Official versioned ZITADEL v4 backend image, local PostgreSQL persistence, secure random dev secret generation, first-admin bootstrap and health checks.
  • Official prebuilt Login V2 image as a runtime dependency only (v4 Admin Console login requires it); no Login V2 source import.
  • No backend Go source vendoring, UI redesign, public domain, Coolify deploy, production keys, remote push or changes to unrelated files.
  • Verify: static focused test/patch audit; with Docker available, live startup/ready/Admin Console, persistent DB after restart and shutdown.
  • Execution evidence: Docker CLI/Desktop absent on connected Windows PC; live Compose startup, admin login and persistence remain NOT VERIFIED. Prior P02 static checks are recorded in docs/P02-EVIDENCE.md.
  • P02-RUNTIME-ACCEPTANCE-01 instruction update (2026-11-22): user explicitly deferred all local test/dev execution to a future Gitea Actions phase; this is a source handoff, not runtime acceptance. Existing source is committed; authorized push to vibtools/ZitPlane is in scope. CI workflow creation and UI import remain outside P02.
  • Existing unrelated untracked AI_INSTRUCTIONS.md must remain untouched.

P03 - Official Login V2 source import (APPROVED 2026-11-22; SOURCE IMPLEMENTED)

  • Baseline: eadd0e558b459061e48583192badfc0579e95140.
  • Write Scope: auth/ui/v2/** (Login V2 and required upstream workspace files), narrow README.md and docs/** (P03 source/phase notes). No other files.
  • Upstream tag: v4.20.4 at 384bb9ec96b501ad39dc232ee2061a40fe180bbd, matching P02 Go backend image.
  • Import apps/login, packages/zitadel-client, packages/zitadel-proto, proto, root pnpm/Nx/build files and licensing nested under auth/ui/v2/. Preserve auth/UI behavior. Exclude upstream environment files; never commit secrets.
  • User explicitly requested no local builds, tests, dev servers or deployments. Only source/provenance/patch audit, documentation, Git commit and approved Gitea push. CI deferred.
  • P02 prebuilt Login UI remains configured in the development Compose; do not replace it or call runtime acceptance complete.
  • Evidence and known gaps: docs/P03-SOURCE-IMPORT.md. CI workflow not part of this scope.

P04 - User Account Portal foundation (APPROVED 2026-11-22; SOURCE IMPLEMENTED)

  • Baseline: 4404849fc4bd30c7b4b7cabe7caed54cbd7cd37d.
  • Exact Write Scope: users/ui/**, narrow project README.md and relevant docs/** (phase/evidence/architecture/developer guide). P02/P03 source read-only.
  • Separate compact Next.js portal, ZITADEL OIDC/PKCE authentication, server-protected user routes, read-only profile and security settings structure.
  • Real OIDC only; no fake production auth, browser admin credentials, billing or user-management mutation endpoints. Existing ZITADEL core/Login V2 untouched.
  • Explicitly no local builds, tests, dev server, Docker or deployment. Source-level audit only, Git commit and approved Gitea main push. Gitea Actions testing deferred; no CI workflow in this scope.
  • Evidence and pending runtime acceptance: docs/P04-ACCOUNT-PORTAL.md.

P05-CI-01 - Gitea Actions Verification Foundation (APPROVED 2026-11-22)

  • Baseline 7ecf53169776cc7f08af3dde6fe4b4492acf3ea1.
  • Approved paths .gitea/**, tests/ci/**, narrow users/ui/package.json and lockfile, auth/ui/v2/pnpm-workspace.yaml and lockfile, notes/**, project/**, relevant docs/** and README.md; root MINIFEST.md is a documentation-maintenance exception. Backend/Account auth/UI source READ-ONLY.
  • Manual Gitea workflow: account reproducible build, Login frozen build, dependency audit, disposable Docker backend readiness/discovery. No local tests/build/dev server.
  • Full OIDC login/session/MFA/Admin Console interactive acceptance is not covered without disposable app/user provisioning; status remains BLOCKED/PENDING, not fabricated PASS.
  • Gitea Run #81: 2 PASS (Login V2 frozen build + 1219/1219 unit tests; high/critical audit) and 2 FAIL (Account Auth.js TypeScript TS2345; Docker Alpine checkout missing Git). 18 moderate advisories unresolved. Pre-checkout Git source fix applied after the run, not rerun. See notes/P05-CI-01.md and docs/P05-CI-01.md. No production deployment/release.

P05 - Full Integration (proposed, NOT approved)

Shared design system, production-safe Compose topology and verified Login/Account OIDC wiring. No live deployment; separate approval.

P06 - UI redesign (proposed, NOT approved)

Compact login and account UI, accessibility, responsive design and scoped regressions. Protected authentication semantics unchanged.

P07 - Production deployment (proposed, NOT approved)

Coolify, HTTPS, secrets, backups, durable storage and focused production readiness; explicit approval required.