mirror of
https://github.com/Cccc-owo/CheckInApp.git
synced 2026-06-17 05:56:29 +00:00
3ab845798d
Add a lightweight migration runner with schema_migrations tracking, run pending migrations during backend startup before the scheduler, and keep a manual backend-migrate entrypoint. The change also moves the existing lockout and task-thread-ID schema steps into shared migration modules, updates docs, and archives the OpenSpec change.
1.2 KiB
1.2 KiB
1. Migration Runner Foundation
- 1.1 Add a backend migration metadata table and helper utilities for reading and writing applied migration records.
- 1.2 Implement a deterministic migration registry with stable identifiers and ordered execution.
- 1.3 Extract the existing account-lockout and task-thread-id migration logic into shared callable migration units.
- 1.4 Add a manual migration entrypoint that invokes the shared registry.
2. Startup Integration
- 2.1 Wire the migration runner into backend FastAPI startup after base table creation and before scheduler startup.
- 2.2 Make startup fail fast when a migration fails and ensure the scheduler does not start afterward.
- 2.3 Add clear logs for applied, skipped, and failed migrations.
3. Verification and Documentation
- 3.1 Add backend tests for first-run execution, repeat-run skipping, and failure-not-marked behavior.
- 3.2 Add startup-order coverage to prove migrations run before the scheduler.
- 3.3 Update developer/deployment documentation with automatic startup migration behavior and the manual migration command.
- 3.4 Run the repository checks for backend code and OpenSpec validation before archiving or implementation handoff.