From 15469ea635e6e2d1e7e8256776d322e6a3f086c2 Mon Sep 17 00:00:00 2001 From: admin Date: Sun, 25 Oct 2026 21:38:45 +0800 Subject: [PATCH] =?UTF-8?q?docs(contract):=20=C2=A75.1=20=E5=88=92?= =?UTF-8?q?=E6=B8=85=E3=80=8C=E4=B8=A4=E7=89=88=E5=90=8E=E7=AB=AF=E5=8F=AF?= =?UTF-8?q?=E5=BC=80=E5=90=8C=E4=B8=80=E4=B8=AA=E5=BA=93=E3=80=8D=E7=9A=84?= =?UTF-8?q?=E9=80=82=E7=94=A8=E8=8C=83=E5=9B=B4=EF=BC=88Ruling=20P47?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 「两版后端可开同一个库」这句话原文只挂在 3 张业务表上;base_* 7 张是官方 DDL 逐字, 而 react 的 base_* entity 只是子集 ⇒ react 后端打不开本仓的库(synchronize 会 ALTER)。 补一段显式注解:写以官方 DDL 为准,读以 react entity 列集为准(§5.3)。 Co-Authored-By: Claude Code --- docs/contract.md | 9 +++++++++ 1 file changed, 9 insertions(+) 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 版同名(两版后端可开同一个库): | 表 | 列 |