Files
ZitPlane/docs/P02-EVIDENCE.md
T

2.8 KiB

P02 — Local backend integration evidence

Date: 2026-11-22 Baseline: 8f54ccb30426f2955472c0cd40fb94d0b18e86ac Scope: docs/PHASES.md P02.

What was introduced

  • Official ZITADEL v4.20.4 Go image; matching official prebuilt Login V2 v4.20.4 runtime dependency.
  • PostgreSQL 17.10 Alpine, Traefik 3.7.7; Docker Compose loopback-only development stack.
  • Generated random, local-only ignored .env with non-overwriting setup; no secrets committed.
  • Backend health check via /app/zitadel ready, HTTP probe via /debug/ready.
  • Persistent Postgres and login client token volumes; no port exposure besides local 127.0.0.1:8080.
  • Local helper commands and focused unittest contracts.

Verification status

  • Baseline hash and existing unrelated untracked file: inspected before changes.
  • PC Python: 3.12.0; Docker CLI/Desktop: not detected; PyYAML: not installed.
  • Python stdlib focused tests: 3/3 PASS, 0 failures (secret generation/idempotence; version-pinned local-only Compose contract; secrets ignored).
  • Dev .env: generated locally with random secrets, values not printed; git check-ignore .env = PASS.
  • Exact staged patch: 9 approved files; git diff --cached --check = PASS; unrelated AI_INSTRUCTIONS.md left untracked and unchanged.
  • Docker Compose validation via docker compose config: BLOCKED (Docker missing).
  • Actual backend image pull/start: BLOCKED (Docker missing).
  • Admin Console login: NOT TESTED.
  • Database persistence across restart: NOT TESTED.
  • Safe shutdown/no volume removal: only script behavior reviewed; runtime NOT TESTED.

P02-RUNTIME-ACCEPTANCE-01 — source handoff (2026-11-22)

The user superseded the request for local runtime verification: do not run any local tests, Docker, dev servers, or health checks. Finish the existing P02 source/doc handoff and push to the authorized Gitea repository. Accordingly, this follow-up executed no local tests. The 3/3 static test result above was from the previous P02 implementation, not from this follow-up. No Gitea Actions workflow or CI run was created/executed in this scope; CI verification remains for a separately approved phase.

Exit criteria / unresolved item

Source configuration can be committed and pushed as a runtime-unverified checkpoint; it is not live backend acceptance. Future Gitea Actions must validate Compose parsing, image pull, startup/ready, Admin Console auth, restart persistence and shutdown on a Docker-capable isolated runner. Any run must use disposable test data and masked secrets. Do not deploy this developer Compose to production.

Safety notes

  • The new dev Compose stack uses local HTTP and password pre-verification for a synthetic local administrator; do not deploy as production.
  • P02 does not include UI source, Coolify deployment, domain changes or external Git actions.