Migrations

Status: Placeholder — to be developed. Last reviewed: —

Scope

Conventions for Django migrations: when a data migration is required, naming, reversibility, how to coordinate migrations across environments (make migrate ENV=...), large-table guardrails.

Sources to mine when writing this

• Makefile — migrations, migrate targets and what they actually run.
• Recent migrations across apps that involved data migrations or schema renames.
• Any past incident notes on migrations that broke staging or prod (check roadmap/done/ for relevant entries).