diff --git a/docs/plans/2026-05-24-second-environment-verification.md b/docs/plans/2026-05-24-second-environment-verification.md index 834b9722..5a53e2c3 100644 --- a/docs/plans/2026-05-24-second-environment-verification.md +++ b/docs/plans/2026-05-24-second-environment-verification.md @@ -1,5 +1,21 @@ # Env2 + Transport Manual Verification Checklist +> **RETIRED 2026-08-01 — never run as written; superseded by automated suites + a live cross-environment run.** +> The step list below predates the M8 import-wizard Map step and was never annotated. Instead of +> refreshing ~48 stale steps, the core scenario this checklist exists for was run live on 2026-08-01 +> (rig session, task #12): CLI `bundle export` from the primary cluster (encrypted, `--include-dependencies`, +> template closure + shared scripts + external system + site-a + instances) → `bundle preview` against the +> empty env2 (correct Map requirements surfaced) → `bundle import --create-missing-sites +> --create-missing-connections` into env2 → 20 entities added, secrets (`AuthConfiguration`) intact, +> instances landed `NotDeployed`, connection FK wired to the created site. **The run caught a real bug** +> (create-missing site id never materialised before the connection insert → FK 547 on real SQL Server, +> masked by the in-memory test provider) — fixed the same day with an SQLite regression test +> (`CreateMissingSiteRelationalTests`, commit `0c9dffed`). Env2 boot/PSK/LocalDb were separately proven +> PASS 3/3 by Gitea #31 (2026-07-23). Remaining coverage lives in +> `tests/ZB.MOM.WW.ScadaBridge.Transport.IntegrationTests` (RoundTrip/RoundTripEquivalence/ +> ConflictResolution/ValidationFailure/SiteInstanceImport/CreateMissingSiteRelational). This checklist +> is retired — do not run or refresh it. + **Date created:** 2026-05-24 **Companion to:** [`2026-05-24-second-environment-design.md`](2026-05-24-second-environment-design.md), [`Component-Transport.md`](../requirements/Component-Transport.md) **Goal:** Exercise the Transport (#24) bundle export/import flow against two real running environments (primary + env2). diff --git a/docs/plans/2026-05-24-transport-manual-verification.md b/docs/plans/2026-05-24-transport-manual-verification.md index a36b3d33..25078b21 100644 --- a/docs/plans/2026-05-24-transport-manual-verification.md +++ b/docs/plans/2026-05-24-transport-manual-verification.md @@ -1,5 +1,12 @@ # Transport Manual Verification +> **RETIRED 2026-08-01 — never run as written; ~80% overlap with +> `2026-05-24-second-environment-verification.md`, which carries the full retirement rationale.** +> The steps predate the M8 import-wizard Map step (numbering stale). The export→preview→import flow +> was proven live cross-environment on 2026-08-01 via the CLI (see the retirement banner in the env2 +> checklist), and the UI wizard surface is covered by the Transport Playwright/bUnit suites. Retired — +> do not run or refresh. + This document is a one-time manual verification to be run against the docker cluster after the Transport feature is fully built and `bash docker/deploy.sh` has rebuilt the image. Each step is sequential and assumes the previous step succeeded. The entire flow takes approximately 15 minutes. ## Prerequisites