test: enforce chinese schema comments

2026-09-20 20:43:21 +08:00
parent 9875bb847c
commit e966061025
3 changed files with 60 additions and 1 deletions
--- a/docs/07-data-model.md
+++ b/docs/07-data-model.md
@@ -11,7 +11,7 @@
 - `internal/storage/mysql/`：连接、事务与显式迁移，不向 SDK 暴露。
 - `sdk/go/`：独立 Go module；对外 DTO 与服务端模型分别维护。

-模型使用普通 Go struct 与 `db` 标签，模型与持久化字段提供中文注释，SQL 表和字段同步维护中文 COMMENT。SQL 是可审查的版本化迁移。目前未引入 ORM，也没有自动同步表结构。
+模型使用普通 Go struct 与 `db` 标签，模型与持久化字段提供中文注释，SQL 表和字段同步维护中文 COMMENT。`TestFreshInstallBaselineHasChineseModelComments` 会在测试门禁中逐表、逐字段检查当前基线，防止新增持久化字段漏写说明。SQL 是可审查的版本化迁移。目前未引入 ORM，也没有自动同步表结构。

 ## 2. 存储约定