Rewrite project documentation

2026-07-23 21:05:43 +02:00
parent 30d6f1a2e1
commit 6b6d2c2a42
17 changed files with 535 additions and 221 deletions
@@ -1,5 +1,10 @@
 # Circuit List Editor Migration

+## Status
+
+Upgrade-only. New installations already use the Circuit-First schema and do not
+run this workflow.
+
 ## Goal

 Migrate legacy row-first consumers into the circuit-first model without deleting legacy data.
@@ -80,4 +85,6 @@ Do not delete legacy consumers yet.

 - legacy read/write endpoints have been removed from the application server
 - migration trace tables reference old/new mapping
- keeping legacy rows allows comparison and rollback validation during transition
+- retained rows allow upgrade verification and audit of the completed mapping
+- a future automatic cleanup migration must migrate and verify old databases
+  before dropping these source and trace tables