Files
ZitPlane/docs/P02-EVIDENCE.md
T

36 lines
2.8 KiB
Markdown

# 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.