docs: changelog + README updates for batch A (migrations, CI, B14/B15/B17)
This commit is contained in:
+16
-1
@@ -68,7 +68,22 @@ docker volume rm book-comic-library_pgdata book-comic-library_cache
|
||||
|
||||
## 改 schema 前必读
|
||||
|
||||
`db.Migrate` 只执行 `schema.sql` 的 `CREATE TABLE IF NOT EXISTS`——对已存在的库**加列/改列不会生效**。任何列变更之前,必须先引入 `schema_migrations` 版本表 + 有序迁移脚本,否则老部署会静默跑在旧结构上。
|
||||
Schema 变更通过 `backend/internal/db/migrations/` 中的有序迁移系统执行:
|
||||
|
||||
1. 新建文件:`NNNN_description.sql`(四位序号,小写下划线命名)。
|
||||
2. 已应用的迁移文件不可修改——它们是不可变的。
|
||||
3. 不支持 down 迁移:回滚靠数据库备份,fix-forward。
|
||||
4. 已有数据库在首次启动时自动基线化(0001 标记为已应用,不重跑 DDL)。
|
||||
5. 迁移使用 `pg_advisory_lock` 确保 `--scale api=N` 副本串行执行。
|
||||
|
||||
每批合入前的本地门禁:`go vet ./... && gofmt -l . && go test -p 1 -count=1 ./...`(需启动 dev PG+Redis)。
|
||||
|
||||
## CI
|
||||
|
||||
- 工作流:`.github/workflows/ci.yml`(标准 GitHub Actions 语法,兼容 Gitea Actions)。
|
||||
- **Gitea**:注册 `act_runner` 实例,在仓库设置中启用 Actions,开箱即用。
|
||||
- **GitHub**:开箱即用。
|
||||
- Runner 注册前,合入前手动执行本地门禁。
|
||||
|
||||
## PWA
|
||||
|
||||
|
||||
Reference in New Issue
Block a user