# 数据库迁移

## 说明

- **`sync_schema_to_models.sql`**：与当前 `api/database/models.py` 保持一致的幂等迁移脚本，**部署工作流会在每次部署后自动执行**。可重复执行，已存在的表/列会跳过。
- 其余 `add_*.sql` 为历史增量迁移，可按需单独执行；若已运行过 `sync_schema_to_models.sql`，通常不必再跑。

## 手动执行

```bash
# 从项目根目录
psql -U <user> -d <database> -f api/migrations/sync_schema_to_models.sql
```

若使用与 docker-compose 默认不同的数据库用户/库名，可在 GitHub 仓库中配置 Secrets：`MIGRATION_DB_USER`、`MIGRATION_DB_NAME`，工作流将用其执行迁移。