36 lines
2.8 KiB
Markdown
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.
|