chore: 接入 Prisma 迁移部署基线

2026-06-12 01:38:58 +08:00
parent 78f97fedf8
commit a21ec249b7
8 changed files with 537 additions and 68 deletions
@@ -31,6 +31,14 @@ pnpm prisma:migrate:dev --name init
 pnpm prisma:seed
 ```

+## 数据库迁移与 Jenkins 部署
+
+- 迁移历史从 `prisma/migrations/20260611000000_baseline_current_schema` 开始，空库可以直接执行 `pnpm prisma migrate deploy` 初始化当前 schema。
+- 生产库在启用 Prisma 迁移历史前已经存在表结构；`deploy/deploy-devops-platform-api-from-jenkins.sh` 会检测完整表结构并自动将基线迁移标记为已应用，再执行 `pnpm prisma migrate deploy`。
+- Jenkins 服务器使用 `/usr/local/bin/deploy-devops-platform-api-from-jenkins`，该脚本应与仓库 `deploy/deploy-devops-platform-api-from-jenkins.sh` 保持一致。
+- 如需紧急跳过迁移，可在服务器环境中设置 `PRISMA_MIGRATE_DEPLOY_ENABLED=false`，但不能在存在 schema 变更的版本长期使用该开关。
+- 新增表或字段时必须提交新的 `prisma/migrations/<timestamp>_<name>/migration.sql`，不要再用手工 SQL 直接改生产库。
+
 ## 内置账号

 - 超级管理员账号：`zhanxi`