docs(contract): §5.1 划清「两版后端可开同一个库」的适用范围(Ruling P47)

「两版后端可开同一个库」这句话原文只挂在 3 张业务表上;base_* 7 张是官方 DDL 逐字,
而 react 的 base_* entity 只是子集 ⇒ react 后端打不开本仓的库(synchronize 会 ALTER)。
补一段显式注解:写以官方 DDL 为准,读以 react entity 列集为准(§5.3)。

Co-Authored-By: Claude Code <[email protected]>
This commit is contained in:
adminandClaude Code committed 2026-10-25 21:38:45 +08:00
1 parent a77d8c1769
commit 15469ea635
1 file changed
+9
+9
View File
@@ -225,6 +225,15 @@ pub fn valid_column(name: &str) -> Option<String>;
> 除 `f_id` 外**没有**其它 NOT NULL 列 ⇒ 插入只需给业务列 + `f_tenant_id`。
> 唯一性(`f_account` / `f_en_code`)**无 DB 约束**,应用层保证。
> 🔴 **「两版后端可开同一个库」这句话的适用范围 = 下面那 3 张业务表**(本节的措辞如此)。
> `base_*` 7 张是**官方 DDL 逐字**(本仓的「契约」),而 react 的 `base_*` entity 只是它的**子集**
> (react 的 `base_module` 没有 `f_creator_user_id`;`base_authorize` 没有 `f_creator_time` /
> `f_creator_user_id`;`base_role_relation` 这两列都没有)⇒ **react 后端本来就打不开本仓的库**
> (它的 TypeORM `synchronize: true` 会 `ALTER` 掉官方 DDL 的多余列)。
> ⇒ 本仓真正复用的是 react 的**前端产物**,**不是** react 的**后端**。
> 两个方向的依据分开:**写**以**官方 DDL** 为准(本仓的种子会写 `f_creator_user_id` /
> `f_creator_time`);**读**以 **react 的 entity 列集**为准(见 §5.3 的投影规则)。
业务表 3 张 —— 表名与 react 版同名(两版后端可开同一个库):
| 表 | 列 |