Files
ZitPlane/docs/PHASES.md
T

2.4 KiB

Phase register and scope locks

Only Phase 01 is approved for implementation in this session. Each later phase requires its own explicit approval and exact scope lock.

P01 — Foundation

  • Allowed writes: README.md, AGENTS.md, .gitignore, .editorconfig, docs/**, and README placeholders under core/backend/zitadel/, auth/ui/v2/, users/ui/, packages/, deployment/, scripts/, tests/.
  • Action: Create compact repository structure; configure repository-local Git identity (Vib Tools / hello@vibtools.io); create initial local main-branch commit.
  • Excluded: Backend source/image download, dependencies, UI code, Compose deployment, secrets, external Git pushes, builds.
  • Acceptance: Repository tree and Git identity confirmed; no unexpected files; clean worktree after commit.

P02 — ZITADEL local backend (proposed; NOT approved)

  • Write scope to approve: core/backend/zitadel/**, deployment/docker/compose.backend.dev.yaml, .env.example, backend-focused tests/**, and narrowly docs/** / README.md.
  • Pin official image version/digest, local PostgreSQL and persistence, safe bootstrap + local test admin, startup/health checks. No Go backend vendoring.
  • No public domain, Coolify deploy, real users, Login V2 import, new UI or production master keys.
  • Focused acceptance: local startup + admin console reachability, persistence after restart, and clean shutdown; document exact lock and versions.

P03 — Login V2 import (proposed)

Import one compatible official upstream commit including required workspace/dependencies under approved paths; unmodified functional baseline; verify one build and baseline auth route. No visual redesign.

P04 — Account portal foundation (proposed)

Implement OIDC-protected basic user self-service skeleton under users/ui/; no fake production authentication.

P05 — Integration (proposed)

Local development workflows, shared design tokens as needed, production-safe Compose topology, routing drafts, tests and docs. No live deployment.

P06 — UI redesign (proposed)

Compact login and account UI, accessibility, responsive design and scoped visual regression. No change to protected authentication semantics.

P07 — Production deployment (proposed)

Coolify, secured external domains, HTTPS, secrets, backups, persistent volumes and focused end-to-end readiness checks; only on explicit approval.