mirror of
https://github.com/whekin/household-bot.git
synced 2026-03-31 23:54:02 +00:00
61 lines
1.3 KiB
Markdown
61 lines
1.3 KiB
Markdown
# Migration Runbook
|
|
|
|
## Model
|
|
|
|
- Source of truth: Drizzle schema in `packages/db/src/schema.ts`
|
|
- Generated SQL migrations: `packages/db/drizzle/*.sql`
|
|
- Do not edit generated SQL manually unless required and reviewed.
|
|
|
|
## Local workflow (algorithm)
|
|
|
|
1. Change schema in `packages/db/src/schema.ts`.
|
|
2. Generate migration:
|
|
|
|
```bash
|
|
bun run db:generate
|
|
```
|
|
|
|
3. Review generated SQL in `packages/db/drizzle/`.
|
|
4. Validate migration metadata:
|
|
|
|
```bash
|
|
bun run db:check
|
|
```
|
|
|
|
5. Apply migration to target DB:
|
|
|
|
```bash
|
|
bun run db:migrate
|
|
```
|
|
|
|
6. Run quality gates:
|
|
|
|
```bash
|
|
bun run format:check
|
|
bun run lint
|
|
bun run typecheck
|
|
bun run test
|
|
bun run build
|
|
```
|
|
|
|
7. Commit schema + migration files together in one PR.
|
|
|
|
## CI behavior
|
|
|
|
- CI runs `bun run db:check` in parallel with other quality jobs.
|
|
- CI does not apply migrations to shared environments.
|
|
|
|
## CD behavior
|
|
|
|
- CD deploy can run migrations before deploy **if** `DATABASE_URL` secret is present.
|
|
- If `DATABASE_URL` is not set, deploy continues without auto-migration.
|
|
|
|
## Safety rules
|
|
|
|
- Prefer additive migrations first (new columns/tables) over destructive changes.
|
|
- For destructive changes, use two-step rollout:
|
|
1. Backward-compatible deploy
|
|
2. Data backfill/cutover
|
|
3. Cleanup migration
|
|
- Never run `db:push` in production pipelines.
|