ci: dev-* 分支纳入 docker-build 触发范围 (构建/部署/数据库自动升级)

- docker-build.yml: push branches 增加 'dev-*', 与 main/master 同环境部署
- Apply DB migrations 步骤加 migrate status 输出并强调在 Remove old container 之前执行
- readme: 新增「分支与 CI/CD」章节, 说明分支触发矩阵与数据库升级约定

.gitea/workflows/docker-build.yml

@@ -1,13 +1,17 @@
 name: Docker Build and Push
 
-# 仅 main 分支 push 触发, 其他分支不触发
+# main / master / dev-* 分支 push 触发, 其他分支不触发
-# 每次主分支提交: 构建前端 + 生成 OTA 升级包 (签名) → 打进 Docker 镜像 → 部署
+# 每次提交: 构建前端 + 生成 OTA 升级包 (签名) → 打进 Docker 镜像 → 自动升级数据库 → 部署
 # OTA 随镜像发布: 容器内 OTA_PACKAGE_DIR=/app/ota-package 指向打包的 ota-package/
+#
+# dev-* (如 dev-0.1 / dev-0.2) 与 main/master 部署到同一套环境 (容器 iboard, 宿主 3001),
+# 即开发分支推送 = 直接发布: 数据库共用同一个库, migrate deploy 在启新容器前执行 (幂等).
 on:
   push:
     branches:
       - main
       - master
+      - 'dev-*'
 
 jobs:
   build-image:
@@ -57,10 +61,16 @@ jobs:
         run: docker images
 
       - name: Apply DB migrations
-        # 仓库内的 prisma 迁移自动应用 (migrate deploy 幂等, 无新迁移时为 no-op)
+        # 数据库自动升级: 按 prisma/migrations/ 下的迁移顺序应用 (dev-* 与 main/master 共库)
+        # migrate deploy 幂等, 无新迁移时为 no-op
+        # 位置关键: 在 "Remove old container" 之前 —— 建表/改表成功后才切换流量,
+        # 迁移失败则整个 workflow 中断, 不会用新镜像顶掉仍在运行的旧容器
         env:
           DATABASE_URL: ${{ secrets.DATABASE_URL }}
-        run: npx prisma migrate deploy
+        run: |
+          set -euo pipefail
+          npx prisma migrate status || true
+          npx prisma migrate deploy
 
       - name: Remove old container
         run: docker rm -vf iboard || true

readme

@@ -17,6 +17,24 @@
 - `BUILD_ID` 每次编译自动生成（见 `vite.config.js` 的 `__BUILD_ID__`），无需手动维护。
 - `ota-package/latest.json` 为运行时产物，不纳入版本管理。
 
+## 分支与 CI/CD (Gitea Actions)
+
+分支按版本命名：`dev-0.1`、`dev-0.2`…… 对应 `docs/V<版本>/` 下的需求/设计文档。
+
+| 分支 | 触发的 workflow | 行为 |
+| --- | --- | --- |
+| `main` / `master` | `docker-build.yml` | 生产发布：构建前端 → 生成签名 OTA 包 → 打 Docker 镜像 → 数据库自动升级 → 重启容器 `iboard` (宿主 3001) |
+| `dev-*` | `docker-build.yml` | **与生产同环境**：推送即构建、迁移数据库、部署（开发分支直接顶掉生产，含 OTA 热更） |
+| `android-*` | `android-build.yml` | 打签名 release APK 并上传到 Gitea Generic Package Registry |
+| 手动 | `ota-build.yml` / `sync-registry.yml` | 单独出 OTA 包 / 同步 secrets 到注册中心 |
+
+数据库升级约定：
+- 唯一入口是 `prisma/migrations/` 下的迁移文件，由 `npx prisma migrate deploy` 在**启新容器之前**执行
+  （幂等，无新迁移时为 no-op）；迁移失败会中断 workflow，不会用新镜像顶掉仍在运行的旧容器。
+- `dev-*` 与 `main/master` 共用同一个 MariaDB 库（同一个 `DATABASE_URL` secret），
+  因此开发分支上的迁移会直接作用到该库结构，合入前请确认迁移可回滚。
+- 本地改了 `prisma/schema.prisma` 后：写迁移 SQL → `npx prisma migrate deploy` 验证 → 提交迁移目录。
+
 - 首页主要是放经济文章
 - 数据主要是放各种经济数据和图表。
 - 策略是放按照经济理论组织的相关数据和图表的对比。