docs(release): finalize demo-productization acceptance evidence

Records the clean-checkout drill result (127 backend tests, 56
Playwright tests, all green on an isolated fresh clone), final live
Unraid verification, and the complete required evidence summary for
the demo-productization work on this branch.
This commit is contained in:
NuklearRabbit
2026-08-03 15:31:13 +02:00
parent a5024f7190
commit 294a8176d1
2 changed files with 225 additions and 0 deletions
+34
View File
@@ -784,3 +784,37 @@ scenarios, demo manifest, About page). Gap audit: `docs/demo-release/current-dem
demo-scenarios/demo-data/demo-guide/demo-runbook, README, .env.example), final Unraid
deploy + live evidence with screenshots, `artifacts/demo-release/final-summary.md` —
task #36 (final).
### Batch 7 (final) — clean-checkout drill, docs, final Unraid evidence (complete)
- **Clean-checkout drill**: fresh `git clone` into an isolated scratch directory,
isolated Compose project (`mobilityops-cleandrill`) + remapped ports via
`compose.override.yaml`, `up --build -d` from empty volumes. Migrations ran
automatically to `e7b08389f47f (head)`; seeded; full backend gate **127 passed**,
ruff/mypy clean; `npm ci` clean (same pre-existing advisories as before, unchanged);
`tsc -b`/`vite build` clean; full Playwright suite **56 passed** against the isolated
stack; reseeded and confirmed all 5 scenarios `ready: true` via the manifest; torn down
(`down -v` on the isolated project only — the working dev stack was untouched
throughout).
- Added the full demo-release documentation set: `docs/demo-release/demo-concept.md`,
`demo-scenarios.md`, `demo-data.md`, `demo-guide.md`, `demo-runbook.md`; updated
`README.md` (current test counts, links to the new docs, a "Demo" section) and
`docs/17-runbook.md` (cross-reference to the demo-specific runbook).
- Added `frontend/e2e/_capture-demo-screenshots.spec.ts` (tooling, excluded from the
regular suite) and captured 17 evidence screenshots live against
`http://192.168.10.150:1236` into `artifacts/demo-release/screenshots/`.
- Final live acceptance: full Playwright suite re-run against the live server —
**56 passed**; `docker compose ps` on the server shows `api`/`db`/`web` all healthy;
`docker logs` for `api`/`web` show no errors; reseeded to leave the server
demo-ready after evidence capture.
- Wrote `artifacts/demo-release/final-summary.md` with the full required evidence
(branches/commits, org/roles/guide/scenarios, seed/date-anchor/reset strategy, real vs.
synthetic vs. not-connected, all test results, clean-checkout result, deployment/
health/console/log results, responsive/accessibility results including the two real
layout bugs found and fixed this work (mobile topbar overflow in Batch 3, desktop
guide-panel overlap in Batch 6), known limitations, 5-/10-minute demo flows, redeploy/
rollback commands, and the screenshot list).
- Demo-productization work on this branch is complete. Every task (#29#36) is done;
every batch was tested locally, deployed to Unraid, and re-verified live before moving
to the next. See `artifacts/demo-release/final-summary.md` for the definitive
acceptance evidence.