docs: 同步面 B 批次 10 收尾(HANDOFF/PLAN/CLAUDE + memory 日志)

- HANDOFF §1 现状:端点 361(面 B 331)/ tables 49 / 测试 545 / 官方覆盖 350-357
- HANDOFF 新增 §1「批次 10」小节:OR 两码点权限、enCode 前缀化与剥除、
  批量落库全成全败、Signature/AdvancedQuery 的形状与归属差异、4 个新坑
- HANDOFF §0-bis 修正过期 fe-gap 数字(252/28.0% 是批次 8 的旧数 ⇒ 291/32.3% ⇒ 322/35.8%)
- HANDOFF §3 待办:划掉批次 10,补批次 11 指引
- PLAN 差距表:面 B 261 → 331,base_* 21 → 49
- CLAUDE.md:cargo test 536 → 545(另修 527 这处更旧的写死值),空载内存 7 → 8 MB
This commit is contained in:
admin committed 2026-11-01 17:14:30 +08:00
1 parent 4e8ef78b20
commit 2c12091d55
4 files changed
+182 -19

No files matched your search

+73
View File
@@ -238,3 +238,76 @@
`systemData` 余下 54 条里挑真有价值的;`workFlow`(104) / `onlineDev`(101) / `aiCenter`(75) /
`extend`(64) / `msgCenter`(50) 基本都是「本仓没这个模块」⇒ 做也只是恒空 stub,
**建议先确认产品边界再动手**。
## 面 B 批次 10(2026-11-01 傍晚)—— 权限配置族
**31 条端点**:`Signature`(7) + `ModuleButton`(7) + `ModuleColumn`(6) + `ModuleForm`(6)
+ `AdvancedQuery`(5)。提交 `4e8ef78`,新增 6 张表,`tables` 43 → 49。
### 踩到 / 想清楚的 7 个点
- 🔴 **契约扫描器只认 `face_b` 这一个 mod 名**(`scripts/check-contract-scan.py:252`:
`if mod in ("jnpf", "face_b")`)⇒ 守卫的**静态推导只对内联在 `face_b.rs` 里的 handler 生效**。
本批一度想拆独立文件 `face_b_batch10.rs`,那会让 CC6 守卫**静默失效**(不是红,是根本没跑)
⇒ **拆文件前先读扫描器**,别让「守卫没跑」变成绿灯。
解法:临时文件 → Python 脚本插入 `face_b.rs` 的 PRINT DEV 段之后 → 删临时文件。
- 🔴 **`LIMIT/OFFSET` 也必须 `::text::integer`**(本仓参数一律按 text 绑定):
`LIMIT $N OFFSET $M` ⇒ `protocol error: cannot convert between ... Option<String>
and the Postgres type int8`。凡是分页 SQL 都要写 `LIMIT ${}::text::integer OFFSET ${}::text::integer`。
- 🔴 **点权限有两种形态,判据都是 `base_module.f_en_code`**(管理员在 SQL 前短路):
① **OR 两码**(`guard_any`):`ModuleButton`/`ModuleColumn`/`ModuleForm` 官方是
`@SaCheckPermission(value={"permission.resource","appConfig.appResource"}, mode=OR)`;
② **只需登录**(`require_login_face_b`):`Signature` 与 `AdvancedQuery` 官方控制器
**根本没加** `@SaCheckPermission` ⇒ 与官方一致,别自作主张加权限。
- 🔴 **`enCode` 写时前缀化 / 读时剥除**(官方 `ModuleColumnController.java:184-195`):
`fieldRule==1` ⇒ `jnpf_` + `bindTable` + `_jnpf_` + `enCode`;
`fieldRule==2` ⇒ `childTableKey` + `-` + `enCode`。
🔴 **单条路径只在「菜单存在」时套前缀**(官方判据 `moduleService.getInfo(moduleId) != null`),
**批量路径无条件套**(官方批量不看菜单是否存在)—— 两条路径行为不一样,别统一。
常量出处:`JnpfConst.SIDE_MARK_PRE = "jnpf_"` / `SIDE_MARK = "_jnpf_"`
(`jnpf-common/.../constant/JnpfConst.java:170,175`)。
- 🔴 **「批量落库要么全成要么全败」是两族共有的语义**:`ModuleButton/selectActions` 逐条判重,
**任一撞 ⇒ 整体失败且一条都不落库**(落库时 `parentId="-1"` 表示根、`enabledMark=1`、新 id);
`ModuleColumn`/`ModuleForm` 批量创建**批内撞码也失败**(HashSet 去重)。
- 🔴 **同一字段两种形状**:`Signature` 列表的 `userIds` 是**字符串**(多人用 `;` 连接,
官方 `StringJoiner`),**详情**的 `userIds` 是**数组**。
`AdvancedQuery` 的列表是 **`ListVO`(`{list:[…]}`)不是 `PageListVO`**。
- 🔴 **`AdvancedQuery` 的归属隔离**:`getList`/`getInfo`/`delete` 都按
`f_creator_user_id = 当前用户` 过滤 ⇒ 别人的方案看到「数据不存在」/「删除失败,数据不存在」;
但官方 `update` 是 `updateById`(**不校验归属**)⇒ 本仓同样「存在即可改」,别自作主张加隔离。
`Signature` 的名称/编码是**两次独立判重** ⇒ 分别报「名称不能重复」「编码不能重复」;
`userIds` 变化 ⇒ **先全删后全插**(官方 `signatureUserMapper.delete(id)` 后重建)。
### 官方消息码(`MsgCode.java`,本批直接采用)
`EXIST001="名称不能重复"` / `EXIST002="编码不能重复"` / `FA001="数据不存在"` /
`FA002="更新失败,数据不存在"` / `FA003="删除失败,数据不存在"` /
`SU001="新建成功"` / `SU002="保存成功"` / `SU003="删除成功"` / `SU004="更新成功"` /
`SU005="操作成功"` / `SU007="复制成功"` /
`SYS050="只能输入字母、数字、点、横线和下划线,且以字母开头"`
### 契约登记(`docs/contract.md` 三处,缺一必红)
`[ENDPOINT]` +31 行(guard 取值两套:`permission.resource|appConfig.appResource`
与「登录」)|`[FACE]` B 300 → **331**|`[OFFICIAL]` +31 条
(src 写真实 Java 方法行号,如 `SignatureController.java:55`、
`ModuleButtonController.java:204`、`ModuleColumnController.java:294`、
`ModuleFormController.java:290`、`AdvancedQueryController.java:106`)。
### 数字(批次 10 收尾)
`cargo test --workspace` **545**(+9)| 契约端点 **361 条(面 B 331)** | `tables` **49**
| 官方覆盖 **350/357(implemented 323 / partial 27 / absent 7)** | 十二道闸门全绿
| 空载内存 8 MB
🔴 **修正一批过期数字**:`fe-gap` 在批次 9 收尾时写的是 252/900(28.0%),
那是**批次 8 的旧数** —— 实测批次 9 = **291**(32.3%)、批次 10 = **322**(35.8%)。
HANDOFF §0-bis 与 §1 已更正,并补了批次 9/10 的逐批增量。
(`fe-gap` 与 `check-contract` 的官方覆盖不是一回事:前者对**前端清单**,
后者对**官方后端控制器**,口径不同别混。)
### 下一个(批次 11)
`fe-gap` 余下:`system` 64 / `permission` 26 / `systemData` 32 —— 从**有官方 `base_*` 表支撑**
的族里挑;`workFlow`(104) / `onlineDev`(101) / `aiCenter`(75) / `extend`(64) / `msgCenter`(50)
基本是「本仓没这个模块」⇒ **先确认产品边界再动手**。
+3 -3
View File
@@ -216,13 +216,13 @@ ssw-platform/
| **契约尺子·MCP** | **`scripts/mcp-smoke.sh`** | **48 条:4 元工具上限 / 分层加载 / 自提示 / 业务失败不误报协议错 / 结构注入防护 / 写工具校验 / 授权闭环 / prompts 模板 / stdout 纯 NDJSON + 阶段 B 低代码动态 CRUD(seed → 默认 dryRun 不落库 → 真写 → 查证 → 子表差集 → 删除 → 建表幂等 / 口令列不外泄)** | **48/48 已绿** |
| **契约尺子·低代码** | **`scripts/lowcode-smoke.sh`** | **15 条:真实样例解析 / 同构保序 / inline 校验 / 缺参拦截 / 建表 DDL 规则(类型映射·复合主键·逻辑删除列·系统列视图类型)+ 四条反自证** | **15/15 已绿** |
| **契约尺子·双后端** | **`scripts/baseline-smoke.sh`** | **10 条:基线适配器自动登录 / health 裸对象 / 形状归一化(list→menus、organize→organizeId、裁剪多余键)/ 不支持的 op 发请求前拦下** | **10/10 已绿** |
| **运行时·内存** | **`scripts/mem-budget.sh`** | **空载物理内存(vmmap `Physical footprint`)是否 ≤ 预算** | **7 MB / 40 MB 预算 已绿** |
| **运行时·内存** | **`scripts/mem-budget.sh`** | **空载物理内存(vmmap `Physical footprint`)是否 ≤ 预算** | **8 MB / 40 MB 预算 已绿** |
🔴 期望值只有一处:`docs/contract.md` 附录 A(机器可读 `[ENDPOINT]` / `[OFFICIAL]` 等),由 `scripts/contract_expect.py` 解析。
每把尺子结尾比对「实际断言数 vs 契约登记数」,对不上即失败 —— 尺子不会被悄悄改弱。
**加任何业务模块 / 改任何契约 / 加任何 crate 依赖 / 改任何内部标识 / 加任何表,十二道闸门必须全绿才算完成。**
🔴 **`cargo test --workspace` 当前 536 条**(内核 + contract 13 + store 17 + sdk 2 + pack-asset 5 + mcp 52 + adapter-baseline 19 + lowcode 112 + 集成测试)——
🔴 **`cargo test --workspace` 当前 545 条**(内核 + contract 13 + store 17 + sdk 2 + pack-asset 5 + mcp 52 + adapter-baseline 19 + lowcode 112 + 集成测试)——
拆 crate 后总数会变,**不许把断言数写死**,跑一遍看实际值。
cipher 自证(免 node):`./target/release/ssw-platform --enc 123456`。
@@ -276,7 +276,7 @@ cp .env.example .env && ./run.sh install && ./run.sh dev
```bash
cargo build --release # 编译(workspace 根,含 crates/* 与 packs/*)
cargo test --workspace # 单测(当前 527 条)
cargo test --workspace # 单测(当前 545 条)
bash run.sh dev # 起后端(30010) + 前端(5173)
bash scripts/perm-smoke.sh # 面 A 43 条
bash scripts/perm-smoke-jnpf.sh # 面 B 23 条
+104 -14
View File
@@ -1,6 +1,6 @@
# HANDOFF —— 交给下一个 session 的现场交接
> 更新于 2026-11-01(面 B 批次 9 收尾)。**开工先读这一页**(尤其 §0-bis 缺口全景),再读 `CLAUDE.md`(硬约定),
> 更新于 2026-11-01(面 B 批次 10 收尾)。**开工先读这一页**(尤其 §0-bis 缺口全景),再读 `CLAUDE.md`(硬约定),
> 最后看 `.workbuddy/memory/` 最近一天的日志(踩过的坑)。
> 无人值守时不要问用户,选最保守可行的方案继续,并把决策写回本文件。
@@ -87,28 +87,34 @@
- **下一个(批次 9)**:`DataInterface`(12) + `InterfaceOauth`(11) + `system/printDev`(17)。
`printDev` 是本仓没有打印设计器 ⇒ 多半只能恒空 stub(先看 `onlineDev/printDev/Form.vue` 再定)。
~~✅ **批次 9 做完(实际 39 条)**——见 §1「批次 9」小节。~~
- **批次 10 候选**:从「本仓确有官方 `base_*` 表支撑」的候选族里挑,选了**权限配置族**:
`Signature`(7) + `ModuleButton`(7) + `ModuleColumn`(6) + `ModuleForm`(6) + `AdvancedQuery`(5)。
~~✅ **批次 10 做完(实际 31 条)**——见 §1「批次 10」小节。~~
**2026-11-01 实测**(`python3 scripts/fe-gap.py`):合计 **252 / 900**(28.0%);
`permission` 111/137(81.0%)、`system` **84/196(42.9%,批次 4 47→66、批次 5 66→84)**、
**`systemData` 52/106(49.1%,批次 6 从 0 起、批次 7 29→35、批次 8 35→52)**;
**2026-11-01 实测**(`python3 scripts/fe-gap.py`):合计 **322 / 900**(35.8%);
`permission` 111/137(81.0%)、`system` **132/196(67.3%,批次 4 47→66、批次 5 66→84、
批次 9 84→101、批次 10 101→132)**、
**`systemData` 74/106(69.8%,批次 6 从 0 起、批次 7 29→35、批次 8 35→52、批次 9 52→74)**;
剩下体量最大的仍是 `workFlow`(104) / `onlineDev`(101) / `aiCenter`(75) /
`extend`(64) / `msgCenter`(50) / `systemData` 余下 54 —— **基本都属于「本仓没这个模块」**。
`extend`(64) / `msgCenter`(50) —— **基本都属于「本仓没这个模块」**。
(🔴 批次 9 收尾时此处写的 252/28.0% 是**批次 8 的旧数**,实测 291/32.3%,此处已更正。)
---
## 1. 一句话现状(2026-11-01 批次 9 收尾)
## 1. 一句话现状(2026-11-01 批次 10 收尾)
**📌 当前数字(以此为准,下面各批的「当时数字」仅存档)**:
- 契约端点 **330 条**(面 A 28 + 面 B **300** + 两面共用 2);`tables` → **43**。
- `cargo test --offline --workspace` = **536 passed / 0 failed**。
- 十二道闸门全绿;`check-contract` `PASS=10 FAIL=0`,官方端点覆盖 **319/326**
(implemented 292 / partial 27 / absent 7;oos 6 单列)。
- `python3 scripts/fe-gap.py`:合计 **252 / 900(28.0%)**,`permission` 111/137(81.0%)、
`system` 84/196(42.9%)、**`systemData` 52/106(49.1%)**。
- 契约端点 **361 条**(面 A 28 + 面 B **331** + 两面共用 2);`tables` → **49**。
- `cargo test --offline --workspace` = **545 passed / 0 failed**。
- 十二道闸门全绿;`check-contract` `PASS=10 FAIL=0`,官方端点覆盖 **350/357**
(implemented 323 / partial 27 / absent 7;oos 6 单列)。
- `python3 scripts/fe-gap.py`:合计 **322 / 900(35.8%)**,`permission` 111/137(81.0%)、
`system` 132/196(67.3%)、**`systemData` 74/106(69.8%)**。
(批次 9 收尾时此处写的 252/28.0% 是**批次 8 的旧数**,批次 9 实测 291/32.3%,此处已更正。)
- 🔴 **数据建模三页(`/dataCenter/dataModel` / `dataSource` / `basicField`)现在真能用了**:
建表 / 改表 / 加字段 / 删表 / 复制 / 预览 / 导出(明说不支持)全通,
平台表(`schema.sql` 里的 43 张)与「有数据的表」一律禁改禁删。
平台表(`schema.sql` 里的 49 张)与「有数据的表」一律禁改禁删。
- 🔴 **数据集(`/dataCenter/dataset`)真能跑 SQL 了**:这是全仓**唯一**执行用户手写 SQL 的地方,
三道护栏 + 变量全走 `$N` 绑定。它是 `AutoComplete` / `PopupSelect` / `InputTable` /
`SelectModal` / 报表 / 打印 / 大屏的**共同底座** —— 这一批之后那批通用组件不再是空壳。
@@ -116,8 +122,10 @@
`$N` 绑定),`Export` 明说不支持。接口认证(`/integrationCenter/openApi`)与
打印模板(`/onlineDev/printDev`)也落地了;打印模板**只存设计 JSON、不渲染**
(本仓无渲染引擎 ⇒ `Export`/`BatchData` 恒 `400` + 人话)。
- 🔴 **权限配置族落地了**(批次 10):电子签章、按钮权限、列表权限、表单权限、
高级查询方案共 31 条端点 —— 这是「权限」页配权限的后端地基,见 §1「批次 10」小节。
**✅ 后端已拆成 workspace 多 crate,业务包可独立编译;八道闸门全绿;空载内存 7 MB。**
**✅ 后端已拆成 workspace 多 crate,业务包可独立编译;八道闸门全绿;空载内存 8 MB。**
- 新增 `crates/sspf-contract`(契约层,无 axum)、`crates/sspf-sdk`(业务包唯一依赖)、
`packs/asset`(样板业务包,只依赖 sdk,能 `cargo test -p sspf-pack-asset` 独立跑)。
@@ -404,6 +412,75 @@
🔴 **加表必须同时改三处**:`schema.sql`、`main.rs` 的 `BASE_TABLES`、
**`crates/sspf-store/src/db.rs` 的两处断言**(后者容易漏 —— 它在另一个 crate 里)。
### 批次 10(2026-11-01)—— 权限配置族(电子签章 / 按钮 / 列表 / 表单 / 高级查询)
**31 条面 B 端点**:`Signature`(7) + `ModuleButton`(7) + `ModuleColumn`(6) +
`ModuleForm`(6) + `AdvancedQuery`(5)。
新表 6 张:`base_signature` / `base_signature_user` / `base_module_button` /
`base_module_column` / `base_module_form` / `base_advanced_query_scheme`,
`tables` 43 → 49。
🔴 **点权限有两种形态,判据都是 `base_module.f_en_code`(管理员在 SQL 前短路)**:
- **OR 两码**(`guard_any`):`ModuleButton` / `ModuleColumn` / `ModuleForm` 三族官方是
`@SaCheckPermission(value={"permission.resource","appConfig.appResource"}, mode=OR)`
⇒ **满足其一**即可。
- **无点权限、只需登录**(`require_login_face_b`):`Signature` 与 `AdvancedQuery`
官方控制器**根本没加** `@SaCheckPermission` ⇒ 与官方一致,不要自作主张加权限。
🔴 **`enCode` 有「写时前缀化 / 读时剥除」的对称语义**(官方 `ModuleColumnController.java:184-195`):
- `fieldRule == 1` ⇒ 落库值 = `jnpf_` + `bindTable` + `_jnpf_` + `enCode`
- `fieldRule == 2` ⇒ 落库值 = `childTableKey` + `-` + `enCode`
- **单条路径只在「菜单存在」时套前缀**(官方判据 `moduleService.getInfo(moduleId) != null`);
**批量路径无条件套前缀**(官方批量不看菜单是否存在)—— 两条路径行为不一样,别统一。
- 读回时剥掉前缀还原成原始 `enCode`(`-` 取其后;再去 `jnpf_<bindTable>_jnpf_`)。
🔴 **官方常量**(`JnpfConst.java:170,175`):`SIDE_MARK_PRE = "jnpf_"`、
`SIDE_MARK = "_jnpf_"` —— 就是上面那个前缀的来源。
🔴 **「批量落库要么全成要么全败」是两族共有的语义**:
- `ModuleButton/selectActions`:逐条判重,**任一撞 ⇒ 整体失败且一条都不落库**;
落库时 `parentId = "-1"`(官方 `selectActions` 把 parentId 置 `"-1"` 表示根)、
`enabledMark = 1`、新 id。
- `ModuleColumn/ModuleForm` 批量创建:**批内撞码也失败**(HashSet 去重),同样一条都不落库。
🔴 **形状差异容易踩**:
- `Signature` 列表的 `userIds` 是**字符串**(多个授权人用 `;` 连接,官方 `StringJoiner`),
**详情**的 `userIds` 是**数组** —— 同一字段两种形状,别写混。
- `Signature` 的**名称与编码是两次独立判重** ⇒ 分别报「名称不能重复」「编码不能重复」。
- `Signature` 的 `userIds` 变化 ⇒ **先全删后全插**(官方 `signatureUserMapper.delete(id)` 后重建)。
- `AdvancedQuery` 的列表是 **`ListVO`(`{list:[…]}`)不是 `PageListVO`**;
且 `getList`/`getInfo`/`delete` **都按 `f_creator_user_id = 当前用户` 过滤**
⇒ 别人的方案看到的是「数据不存在」/「删除失败,数据不存在」。
但官方 `update` 是 `updateById`(**不校验归属**)⇒ 本仓同样「存在即可改」。
🔴 **官方消息码**(`MsgCode.java`)本批直接采用:
`EXIST001="名称不能重复"` / `EXIST002="编码不能重复"` / `FA001="数据不存在"` /
`FA002="更新失败,数据不存在"` / `FA003="删除失败,数据不存在"` /
`SYS050="只能输入字母、数字、点、横线和下划线,且以字母开头"`。
- 回归测试 `tests/batch10_it.rs`(**9 条**):签章判重 + `userIds` 形状、改签章重建授权人、
Selector/ListByIds/软删、按钮判重 + `selectActions` 原子性、`enCode` 前缀与剥除、
批量撞码整体失败、表单前缀与默认值、高级查询归属隔离 + ListVO、高级查询必填校验。
### 🔴 本批踩到并解决的坑
1. 🔴 **契约扫描器只认 `face_b` 这一个 mod 名**(`scripts/check-contract-scan.py:252`:
`if mod in ("jnpf", "face_b")`)⇒ 守卫的静态推导**只对内联在 `face_b.rs` 里的 handler 生效**。
本批一度想拆独立文件 `face_b_batch10.rs`,会直接让 CC6 守卫静默失效 ——
**拆文件前先读扫描器,别让「守卫没跑」变成绿灯**。
⇒ 解法:临时文件 → Python 脚本插入 `face_b.rs` 的 PRINT DEV 段之后 → 删临时文件。
2. 🔴 **`LIMIT/OFFSET` 也必须 `::text::integer`**(本仓参数一律按 text 绑定):
`LIMIT $N OFFSET $M` 会报 `protocol error: cannot convert between ... Option<String>
and the Postgres type int8` ⇒ 写成 `LIMIT ${}::text::integer OFFSET ${}::text::integer`。
3. 🔴 **`base_module_form.f_sort_code` 是 `BIGINT`** —— 抄 DDL 时手误写成 `BIGIG` 会被 PG 直接拒。
4. 🔴 **加表仍然是三处**(批次 9 已经踩过一次,这里再确认):
`schema.sql` + `main.rs` 的 `BASE_TABLES` + `crates/sspf-store/src/db.rs` 的两处断言。
本批 43 → **49**,另加 `src/backend/tests/batch6_it.rs` 与 `routes.rs` health 测试里的表数断言。
### 🔴 上一批(第一批)踩到并解决的 4 个真 bug
1. `CurrentUser` 的 `preferenceJson` 必须是**字符串** `"{}"` —— 给对象会让前端
@@ -575,6 +652,19 @@ xop run --secret GU=git_local_user --secret GP=git_local_pass -- bash -c '
`base_print_template` / `base_print_version`);数据接口**复用数据集执行面真取数**、
接口认证 CRUD + 用户清单、打印模板模板/版本两套 CRUD + 发布归档语义。
🔴 打印**无渲染引擎** ⇒ `Export`/`BatchData` 恒 `400` + 人话。
10. ~~权限配置族 `Signature`(7) + `ModuleButton`(7) + `ModuleColumn`(6) +
`ModuleForm`(6) + `AdvancedQuery`(5)~~
✅ **批次 10 做完(实际 31 条)**——新表 6 张(`base_signature` / `base_signature_user` /
`base_module_button` / `base_module_column` / `base_module_form` /
`base_advanced_query_scheme`);电子签章 + 按钮/列表/表单权限 + 高级查询方案。
🔴 **OR 两码点权限**(`permission.resource` | `appConfig.appResource`);
`Signature`/`AdvancedQuery` 官方无点权限 ⇒ 只需登录。
🔴 `enCode` **写时前缀化 / 读时剥除**(单条按「菜单存在」,批量无条件)。
**下一个(批次 11)**:`fe-gap` 余下最大的 `system` 64 条 / `permission` 26 条 /
`systemData` 32 条里挑**有官方 `base_*` 表支撑**的;`workFlow`(104) / `onlineDev`(101) /
`aiCenter`(75) / `extend`(64) / `msgCenter`(50) 基本都是「本仓没这个模块」⇒
**先确认产品边界再动手**,做也只是恒空 stub。
**实现模板(照抄就行)**:`ORGANIZE_WRITE_FIELDS` / `POSITION_WRITE_FIELDS` 那一套
—— 列白名单 + `now()` 不占参数位 + 只 SET body 里出现的键 + 读回不选 `f_password`。
+2 -2
View File
@@ -251,8 +251,8 @@ ssw-platform/
| 能力 | 现状 | 目标 | 差距 |
|---|---|---|---|
| 面 B 契约端点 | ✅ 261 条 | 全量(含 lowcode/flow/file/message) | 补 ~250 条(多在 lowcode 域) |
| `base_*` DDL | ✅ 21 张逐字对齐 | 全量 331 张中的必需集 | 按域补 |
| 面 B 契约端点 | ✅ **331 条**(2026-11-01 批次 10 收尾) | 全量(含 lowcode/flow/file/message) | 官方端点覆盖 350/357;余下多为「本仓没这个模块」 |
| `base_*` DDL | ✅ **49 张**逐字对齐 | 全量 331 张中的必需集 | 按域补 |
| 平台/业务分层 | ✅ `check-boundary.sh` 钉住 | 升级为 crate 级隔离 | **P0 已拆 contract / store / sdk;asset 包可独立编译;`jnpf.rs`→`face_b.rs`** |
| 低代码元数据引擎 | ✅ **P2-b 完成**:解析 + 校验 + 建表 + 动态 CRUD(6 个工具) | visualdev 同构 + 动态 CRUD + 发布 | 读 release / 单据号 / 乐观锁 → P2-c |
| 业务包格式 | 🟡 `pack.toml` 已定稿、`packs/asset` 已有样板 | 导入导出工具 | **P3** |