From a949fe6f575acc5443f649a5a74a8d2d1709c571 Mon Sep 17 00:00:00 2001 From: Joseph Doherty Date: Sat, 1 Aug 2026 12:34:34 -0400 Subject: [PATCH] =?UTF-8?q?docs(plans):=20retire=20the=20env2=20+=20transp?= =?UTF-8?q?ort=20manual=20checklists=20=E2=80=94=20core=20scenario=20run?= =?UTF-8?q?=20live=202026-08-01=20(caught=20+=20fixed=20the=20create-missi?= =?UTF-8?q?ng=20FK=20bug),=20rest=20covered=20by=20automated=20suites=20+?= =?UTF-8?q?=20#31?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...2026-05-24-second-environment-verification.md | 16 ++++++++++++++++ .../2026-05-24-transport-manual-verification.md | 7 +++++++ 2 files changed, 23 insertions(+) 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