shop/doc/systems/migrations/features.md

• migrations
  • orchestrator (migrations.py): discover per-app migration folders (apps//migrations/), configure alembic version_locations dynamically, coordinate multi-head merging
  • startup check: fail fast if schema is not up to date
  • migrations/ directory: alembic version store (today still holds all migrations centrally; per-app folders are the target state)
  • use alembic