diff --git a/docs/contract.md b/docs/contract.md index 19ba698..008327b 100644 --- a/docs/contract.md +++ b/docs/contract.md @@ -225,6 +225,15 @@ pub fn valid_column(name: &str) -> Option; > 除 `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 版同名(两版后端可开同一个库): | 表 | 列 |