20260803225403

code/fms/fms-api/config/migrations/README.md

@@ -0,0 +1,15 @@
+# Database migrations
+
+Module architecture cutover is manual and is not run during application startup.
+
+Run against a backed-up `FMS` database in this order:
+
+1. `033_create_module_structure.sql`
+2. `034_module_runtime_views.sql`
+3. `verify_module_architecture.sql`
+
+`033` is a one-time transaction: it migrates valid metadata and removes the old metadata tables only after conversion checks pass. It intentionally does not create compatibility views or dual writes.
+
+`034` uses SQL Server `GO` batch separators because each `CREATE OR ALTER VIEW/TRIGGER` must start its batch. Use SSMS, Azure Data Studio, `sqlcmd`, or another runner that understands `GO`.
+
+`verify_module_architecture.sql` is a target-schema verification script. It does not modify application tables.