From e0c1904a0eeb86f7d69c3cf451acf0fee111a4fd Mon Sep 17 00:00:00 2001 From: admin Date: Sun, 1 Nov 2026 19:18:17 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=90=8C=E6=AD=A5=E9=9D=A2=20B=20?= =?UTF-8?q?=E6=89=B9=E6=AC=A1=2011=20=E6=94=B6=E5=B0=BE=EF=BC=88HANDOFF/PL?= =?UTF-8?q?AN/CLAUDE=20+=20memory=20=E6=97=A5=E5=BF=97=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - HANDOFF §1 现状:端点 376(面 B 346)/ tables 52 / 测试 550 / 官方覆盖 365-372 - HANDOFF 新增 §1「批次 11」小节:表名≠控制器名、enCode 前缀化(create 用 !=0、 update 用 ==1,delete 比对用带前缀的码)、conditionJson 三层结构、方案列表 只需登录、SYS020/SYS021、3 处诚实降级 - HANDOFF 新增「本批踩到并解决的 5 个真 bug」+ §5「批次 11 新增的坑」6 条 - HANDOFF §3 待办:划掉批次 11,补批次 12 指引(缺口 system 55 / permission 26 / systemData 32) - HANDOFF 修正「八道闸门」为「十二道闸门」(旧措辞与 CLAUDE.md 不一致) - PLAN 差距表:面 B 331 → 346,base_* 49 → 52 - CLAUDE.md:cargo test 545 → 550(两处写死值) - memory 日志追加批次 11 段落:结论 / 9 个坑 / 数字(均已复验) --- .workbuddy/memory/2026-11-01.md | 84 ++++++++++++++++++++ CLAUDE.md | 4 +- HANDOFF.md | 134 ++++++++++++++++++++++++++++---- PLAN.md | 4 +- 4 files changed, 208 insertions(+), 18 deletions(-) diff --git a/.workbuddy/memory/2026-11-01.md b/.workbuddy/memory/2026-11-01.md index 7c963f5..9b9b7ca 100644 --- a/.workbuddy/memory/2026-11-01.md +++ b/.workbuddy/memory/2026-11-01.md @@ -311,3 +311,87 @@ HANDOFF §0-bis 与 §1 已更正,并补了批次 9/10 的逐批增量。 `fe-gap` 余下:`system` 64 / `permission` 26 / `systemData` 32 —— 从**有官方 `base_*` 表支撑** 的族里挑;`workFlow`(104) / `onlineDev`(101) / `aiCenter`(75) / `extend`(64) / `msgCenter`(50) 基本是「本仓没这个模块」⇒ **先确认产品边界再动手**。 + +--- + +## 面 B 批次 11(2026-11-01 夜)—— 数据权限三件套 + +**15 条端点**:`ModuleDataAuthorize`(6) + `ModuleDataAuthorizeScheme`(5) + +`ModuleDataAuthorizeLink`(4)。提交 `4b14ecd`,新增 3 张表,`tables` 49 → 52。 +回归测试 `tests/batch11_it.rs`(**5 条**)。 + +### 踩到 / 想清楚的 6 个点 + +- 🔴 **表名 ≠ 控制器名 ≠ 实体名**(抄官方最容易错的一处):控制器叫 + `ModuleDataAuthorize*`,实体 `@TableName` 却是 `base_module_authorize` / + `base_module_scheme` / `base_module_link` —— **不是** `base_module_data_authorize_*`。 +- 🔴 **`enCode` 前缀化是「写时加、读时剥」**,且与批次 10 的 `ModuleColumn` 是 + **两套完全不同的前缀**(批次 10 = `jnpf__jnpf_`,本批 = `bindTable + "."`): + | 动作 | 判据 | 落库值 | + |---|---|---| + | create | `module.type==3` && `fieldRule != 0` && `bindTable` 非空 | `bindTable + "." + enCode` | + | update | `module.type==3` && `fieldRule == 1` && `bindTable` 非空 | `bindTable + "." + enCode` | + 🔴 **create 用 `!=0`、update 用 `==1`** —— 官方两处判据**不一样**,别统一。 + 🔴 **delete 的方案引用比对用「原始带前缀」的 enCode**(官方 + `ModuleDataAuthorizeController.java:297` 比的是 `entity.getEnCode()`,库里那个值带前缀) + ⇒ 拿剥过的码去比会**失配** ⇒ 永远拦不住。 +- 🔴 **`conditionJson` 是三层结构**:JSON 数组 → `groups` 数组 → item 的 `field` 字段: + `[ { "groups": [ { "field": "demo_item.f_name" } ] } ]`。 +- 🔴 **`b10_insert` 把 `None` 当 `now()` 绑定**(不是「不写这列」)⇒ 整型列直接类型错 + (`column "f_all_data" is of type integer but expression is of type timestamp`)。 + 本批改 `f_all_data` / `f_type` 时**顺手炸出批次 10 的 `f_field_rule` ×2 同款雷** + (列表权限批量 / 表单权限批量)⇒ 一并改成「缺省按官方默认 0」。 + **以后写 `b10_insert` 整型列一律不许传 `None`。** +- 🔴 **查 `int4` 列必须 `$N::text::integer`**(本仓参数一律按 text 绑定): + `f_type = $2` ⇒ `cannot convert between ... Option and the Postgres type int4`。 + 批次 10 已在 `LIMIT/OFFSET`(int8)踩过同一个坑的变体。 +- 🔴 **写路径要「只 SET body 里出现的键」**(官方 `updateById` = Mybatis NOT_NULL 策略): + 本批补齐 `ModuleDataAuthorize` 的 `enCode` 与 `ModuleDataAuthorizeLink` 的 + `linkId` / `linkTables` / `dataType` —— 之前一律 SET ⇒ 会把没传的字段清空。 + +### 另外 3 个通用坑(跨批次) + +- 🔴 **共用 pglite 的测试不要写死绝对条数**:同一测试文件里 `any_menu_id()` 对每个测试 + 返回**同一个**菜单 ⇒ 别的测试先建过行 ⇒ 批次 10 的 + `module_column_batch_rejects_duplicate_in_batch` 断言 `count == 0` 必红。 + 已改成**基线相对**(`before` → `before + 2`)。 +- 🔴 **`async fn` 忘了 `.await` 会静默不执行**(编译器只给 `unused_must_use` 警告)⇒ + 测试里「插了行却查不到」先查这个。 +- 🔴 **官方 `ActionResult.success(String msg)` 是「msg 带提示、data 为 null」**, + 与本仓 `ok(json!({...}))`(`msg="成功"`、data 透传)**不是同一个形状**。 + 本仓沿用既有约定(create 回 `{id}`,全仓 11 处一致)—— 改时要**连前端消费点一起看**。 + +### 诚实降级(3 处,不假装成功) + +- `GET /ModuleDataAuthorize/{moduleId}/FieldList` ⇒ 官方靠 `visualdevServiceImpl` 解析低代码表单 + ⇒ 本仓**返回空数组**(不是 404、不是假数据)。 +- `GET /ModuleDataAuthorizeLink/{linkId}/Tables/{tableName}/Fields/{menuType}/{dataType}` ⇒ + 官方靠 `dbTableService.getFieldList` 做**数据库内省** ⇒ 本仓**返回空 PageListVO**。 +- `getVisualTables` 对低代码菜单(type **3/9/11**)官方走表单解析 ⇒ 本仓返回 + `{linkId:"", linkTables:[]}`;其余 type 按 `menuId + type` 查 `base_module_link`。 + +### 官方消息码(`MsgCode.java`,本批直接采用) + +`EXIST001="名称不能重复"` / `EXIST002="编码不能重复"` / `FA002="更新失败,数据不存在"` / +`FA003="删除失败,数据不存在"` / `SU001="新建成功"` / `SU002="保存成功"` / +`SU003="删除成功"` / `SU004="更新成功"` / +`SYS020="该字段在方案{0}中已被使用"` / `SYS021="修改失败,该方案不允许编辑"` + +### 契约登记(`docs/contract.md` 三处,缺一必红) + +`[ENDPOINT]` +15 行(guard:OR 两码 `permission.resource|appConfig.appResource`, +方案列表取「登录」)|`[FACE]` B 331 → **346**|`[OFFICIAL]` +15 条 +(src 写真实 Java 方法行号)。 + +### 数字(批次 11 收尾,均已复验) + +`cargo test --workspace` **550**(+5)| 契约端点 **376 条(面 B 346)** | `tables` **52** +| 官方覆盖 **365/372(implemented 338 / partial 27 / absent 7)** | 十二道闸门 PASS=12 FAIL=0 +| fe-gap **331/900(36.8%)**(system 141/196、permission 111/137、systemData 74/106) +| 空载内存 8 MB + +### 下一个(批次 12) + +`fe-gap` 余下:`system` 55 / `permission` 26 / `systemData` 32 —— 从**有官方 `base_*` 表支撑** +的族里挑;`workFlow`(104) / `onlineDev`(101) / `aiCenter`(75) / `extend`(64) / `msgCenter`(50) +基本是「本仓没这个模块」⇒ **先确认产品边界再动手**,做也只是恒空 stub。 diff --git a/CLAUDE.md b/CLAUDE.md index 7d55980..ffae9ea 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -222,7 +222,7 @@ ssw-platform/ 每把尺子结尾比对「实际断言数 vs 契约登记数」,对不上即失败 —— 尺子不会被悄悄改弱。 **加任何业务模块 / 改任何契约 / 加任何 crate 依赖 / 改任何内部标识 / 加任何表,十二道闸门必须全绿才算完成。** -🔴 **`cargo test --workspace` 当前 545 条**(内核 + contract 13 + store 17 + sdk 2 + pack-asset 5 + mcp 52 + adapter-baseline 19 + lowcode 112 + 集成测试)—— +🔴 **`cargo test --workspace` 当前 550 条**(内核 + 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 # 单测(当前 545 条) +cargo test --workspace # 单测(当前 550 条) bash run.sh dev # 起后端(30010) + 前端(5173) bash scripts/perm-smoke.sh # 面 A 43 条 bash scripts/perm-smoke-jnpf.sh # 面 B 23 条 diff --git a/HANDOFF.md b/HANDOFF.md index 4ada007..f5151ea 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -1,6 +1,6 @@ # HANDOFF —— 交给下一个 session 的现场交接 -> 更新于 2026-11-01(面 B 批次 10 收尾)。**开工先读这一页**(尤其 §0-bis 缺口全景),再读 `CLAUDE.md`(硬约定), +> 更新于 2026-11-01(面 B 批次 11 收尾)。**开工先读这一页**(尤其 §0-bis 缺口全景),再读 `CLAUDE.md`(硬约定), > 最后看 `.workbuddy/memory/` 最近一天的日志(踩过的坑)。 > 无人值守时不要问用户,选最保守可行的方案继续,并把决策写回本文件。 @@ -90,10 +90,13 @@ - **批次 10 候选**:从「本仓确有官方 `base_*` 表支撑」的候选族里挑,选了**权限配置族**: `Signature`(7) + `ModuleButton`(7) + `ModuleColumn`(6) + `ModuleForm`(6) + `AdvancedQuery`(5)。 ~~✅ **批次 10 做完(实际 31 条)**——见 §1「批次 10」小节。~~ +- **批次 11 候选**:继续沿权限族往下挑,选了**数据权限三件套**: + `ModuleDataAuthorize`(6) + `ModuleDataAuthorizeScheme`(5) + `ModuleDataAuthorizeLink`(4)。 + ~~✅ **批次 11 做完(实际 15 条)**——见 §1「批次 11」小节。~~ -**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)**、 +**2026-11-01 实测**(`python3 scripts/fe-gap.py`):合计 **331 / 900**(36.8%); +`permission` 111/137(81.0%)、`system` **141/196(71.9%,批次 4 47→66、批次 5 66→84、 +批次 9 84→101、批次 10 101→132、批次 11 132→141)**、 **`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) —— **基本都属于「本仓没这个模块」**。 @@ -101,20 +104,20 @@ --- -## 1. 一句话现状(2026-11-01 批次 10 收尾) +## 1. 一句话现状(2026-11-01 批次 11 收尾) **📌 当前数字(以此为准,下面各批的「当时数字」仅存档)**: -- 契约端点 **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%)**。 +- 契约端点 **376 条**(面 A 28 + 面 B **346** + 两面共用 2);`tables` → **52**。 +- `cargo test --offline --workspace` = **550 passed / 0 failed**。 +- 十二道闸门全绿;`check-contract` `PASS=10 FAIL=0`,官方端点覆盖 **365/372** + (implemented 338 / partial 27 / absent 7;oos 6 单列)。 +- `python3 scripts/fe-gap.py`:合计 **331 / 900(36.8%)**,`permission` 111/137(81.0%)、 + `system` 141/196(71.9%)、**`systemData` 74/106(69.8%)**。 (批次 9 收尾时此处写的 252/28.0% 是**批次 8 的旧数**,批次 9 实测 291/32.3%,此处已更正。) - 🔴 **数据建模三页(`/dataCenter/dataModel` / `dataSource` / `basicField`)现在真能用了**: 建表 / 改表 / 加字段 / 删表 / 复制 / 预览 / 导出(明说不支持)全通, - 平台表(`schema.sql` 里的 49 张)与「有数据的表」一律禁改禁删。 + 平台表(`schema.sql` 里的 52 张)与「有数据的表」一律禁改禁删。 - 🔴 **数据集(`/dataCenter/dataset`)真能跑 SQL 了**:这是全仓**唯一**执行用户手写 SQL 的地方, 三道护栏 + 变量全走 `$N` 绑定。它是 `AutoComplete` / `PopupSelect` / `InputTable` / `SelectModal` / 报表 / 打印 / 大屏的**共同底座** —— 这一批之后那批通用组件不再是空壳。 @@ -124,8 +127,10 @@ (本仓无渲染引擎 ⇒ `Export`/`BatchData` 恒 `400` + 人话)。 - 🔴 **权限配置族落地了**(批次 10):电子签章、按钮权限、列表权限、表单权限、 高级查询方案共 31 条端点 —— 这是「权限」页配权限的后端地基,见 §1「批次 10」小节。 +- 🔴 **数据权限三件套落地了**(批次 11):数据权限字段 / 数据权限方案 / 数据连接共 15 条端点 + —— 见 §1「批次 11」小节。 -**✅ 后端已拆成 workspace 多 crate,业务包可独立编译;八道闸门全绿;空载内存 8 MB。** +**✅ 后端已拆成 workspace 多 crate,业务包可独立编译;十二道闸门全绿;空载内存 8 MB。** - 新增 `crates/sspf-contract`(契约层,无 axum)、`crates/sspf-sdk`(业务包唯一依赖)、 `packs/asset`(样板业务包,只依赖 sdk,能 `cargo test -p sspf-pack-asset` 独立跑)。 @@ -481,6 +486,79 @@ `schema.sql` + `main.rs` 的 `BASE_TABLES` + `crates/sspf-store/src/db.rs` 的两处断言。 本批 43 → **49**,另加 `src/backend/tests/batch6_it.rs` 与 `routes.rs` health 测试里的表数断言。 +### 批次 11(2026-11-01)—— 数据权限三件套(字段 / 方案 / 数据连接) + +**15 条面 B 端点**:`ModuleDataAuthorize`(6) + `ModuleDataAuthorizeScheme`(5) + +`ModuleDataAuthorizeLink`(4)。 +新表 3 张:`base_module_authorize` / `base_module_scheme` / `base_module_link`, +`tables` 49 → 52。 + +🔴 **表名 ≠ 控制器名 ≠ 实体名**(抄官方时最容易错的一处): +控制器叫 `ModuleDataAuthorize*`,但实体 `@TableName` 是 `base_module_authorize` / +`base_module_scheme` / `base_module_link` —— **不是** `base_module_data_authorize_*`。 + +🔴 **点权限**:除「方案列表」外全部 OR 两码 `{"permission.resource","appConfig.appResource"}` +(`guard_any`);**方案列表只需登录**(官方 `ModuleDataAuthorizeSchemeController.java:62` +那个 `list` **没加** `@SaCheckPermission`)。 + +🔴 **`enCode` 前缀化是「写时加、读时剥」**(与批次 10 的 `ModuleColumn` 是**两套不同前缀**): + +| 动作 | 判据 | 落库值 | 读回 | +|---|---|---|---| +| create | `module.type==3` && `fieldRule != 0` && `bindTable` 非空 | `bindTable + "." + enCode` | 剥掉 `bindTable.` 前缀 | +| update | `module.type==3` && `fieldRule == 1` && `bindTable` 非空 | `bindTable + "." + enCode` | 同上 | + +- 🔴 **create 是 `!=0`、update 是 `==1`** —— 官方两处判据**不一样**,别统一成 `!=0`。 +- 🔴 **delete 的方案引用比对用「原始带前缀」的 enCode**(官方 + `ModuleDataAuthorizeController.java:297` 比的是 `entity.getEnCode()`,库里那个值带前缀) + ⇒ 拿剥过的码去比会**失配** ⇒ 永远拦不住。 + +🔴 **`conditionJson` 结构是「数组 → groups 数组 → item.field」**(三层): + +``` +[ { "groups": [ { "field": "demo_item.f_name" } ] } ] +``` + +🔴 **官方消息码**(`MsgCode.java`):`EXIST001="名称不能重复"` / `EXIST002="编码不能重复"` / +`FA002="更新失败,数据不存在"` / `FA003="删除失败,数据不存在"` / +`SYS020="该字段在方案{0}中已被使用"` / `SYS021="修改失败,该方案不允许编辑"`。 + +🔴 **两处「诚实降级」(本仓无对应能力,不假装成功)**: + +- `GET /ModuleDataAuthorize/{moduleId}/FieldList` ⇒ 官方靠 `visualdevServiceImpl` 解析 + 低代码表单字段 ⇒ 本仓**返回空数组**(不是 404、不是假数据)。 +- `GET /ModuleDataAuthorizeLink/{linkId}/Tables/{tableName}/Fields/{menuType}/{dataType}` ⇒ + 官方靠 `dbTableService.getFieldList` 做**数据库内省** ⇒ 本仓**返回空 PageListVO**。 +- 另:`getVisualTables` 对低代码菜单(type **3/9/11**)官方走表单解析 ⇒ 本仓返回 + `{linkId:"", linkTables:[]}`;其余 type 按 `menuId + type` 查 `base_module_link`。 + +- 回归测试 `tests/batch11_it.rs`(**5 条**):字段 enCode 前缀化 + 剥除 + FieldList 空数组 + + condition 解码、update 前缀化 + 「更新失败,数据不存在」、delete 的 SYS020 拦截 + 软删 + + 「删除失败,数据不存在」、方案双判重 + PageListVO + SYS021 + 软删、连接新建/更新 + + getVisualTables 低代码空/非低代码查表 + getInfo 命中/未命中 + 表字段空 PageListVO。 + +### 🔴 本批踩到并解决的 5 个真 bug(跨批次,顺手修掉的) + +1. 🔴 **`b10_insert` 把 `None` 当 `now()` 绑定** ⇒ 整型列直接类型错 + (`column "f_all_data" is of type integer but expression is of type timestamp`)。 + 触发点:可选整型字段缺省时传了 `None`。本批改了 `f_all_data` / `f_type`, + **顺手发现批次 10 的 `f_field_rule` 有两处同样的雷**(列表权限批量 / 表单权限批量) + ⇒ 一并改成「缺省按官方默认 0」。**以后写 `b10_insert` 整型列一律不许传 `None`。** +2. 🔴 **查 `int4` 列必须写 `$N::text::integer`** —— 本仓参数**一律按 text 绑定** + (`params_of` 统一 `Option`)⇒ `f_type = $2` 报 + `cannot convert between ... Option and the Postgres type int4`。 + 同批的 `LIMIT/OFFSET` 已在批次 10 踩过同一个坑(那时是 int8)。 +3. 🔴 **写路径要「只 SET body 里出现的键」** —— 官方是 `updateById(entity)`, + Mybatis **只 SET 实体里非 null 的字段** ⇒ body 没带的键**保持原值**。 + 本批补齐了 `ModuleDataAuthorize` 的 `enCode` 与 `ModuleDataAuthorizeLink` 的 + `linkId`/`linkTables`/`dataType`(之前一律 SET ⇒ 会把没传的字段清空)。 +4. 🔴 **批次 10 有个「跨用例污染」的假绿/假红**:`module_column_batch_rejects_duplicate_in_batch` + 断言列表权限「一条都不许落库 ⇒ count == 0」,但**同一文件共用一个 pglite 临时库**、 + `any_menu_id()` 对每个测试都返回**同一个**菜单 ⇒ 别的测试已建过 2 行 ⇒ 必然红。 + 已改成**基线相对**(`before` → `before + 2`)。**教训:共用库的测试不要写死绝对条数。** +5. 🔴 **裸 `exec_params` 绑整型会炸** —— pglite-rs 按 `&str` 推断参数类型, + 绑 `int4` 列要写成 `$N::text::integer`;测试里插行**优先走端点**(顺带覆盖了端点)。 + ### 🔴 上一批(第一批)踩到并解决的 4 个真 bug 1. `CurrentUser` 的 `preferenceJson` 必须是**字符串** `"{}"` —— 给对象会让前端 @@ -660,8 +738,18 @@ xop run --secret GU=git_local_user --secret GP=git_local_pass -- bash -c ' 🔴 **OR 两码点权限**(`permission.resource` | `appConfig.appResource`); `Signature`/`AdvancedQuery` 官方无点权限 ⇒ 只需登录。 🔴 `enCode` **写时前缀化 / 读时剥除**(单条按「菜单存在」,批量无条件)。 +11. ~~数据权限三件套 `ModuleDataAuthorize`(6) + `ModuleDataAuthorizeScheme`(5) + + `ModuleDataAuthorizeLink`(4)~~ + ✅ **批次 11 做完(实际 15 条)**——新表 3 张(`base_module_authorize` / + `base_module_scheme` / `base_module_link`);数据权限字段 + 方案(双判重 / SYS021 / + 引用校验 SYS020)+ 数据连接。 + 🔴 表名 ≠ 控制器名(`ModuleDataAuthorize*` ⇒ `base_module_authorize` 等)。 + 🔴 `enCode` 前缀化用 **`bindTable + "."`**(与批次 10 的 `jnpf__jnpf_` 是**两套**); + **create 用 `fieldRule!=0`、update 用 `fieldRule==1`**;delete 比对用**带前缀**的码。 + 🔴 **方案列表只需登录**(官方没加 `@SaCheckPermission`)。 + 🔴 `FieldList` / 表字段端点依赖低代码表单与数据库内省 ⇒ **诚实返回空**(不假装)。 -**下一个(批次 11)**:`fe-gap` 余下最大的 `system` 64 条 / `permission` 26 条 / +**下一个(批次 12)**:`fe-gap` 余下最大的 `system` 55 条 / `permission` 26 条 / `systemData` 32 条里挑**有官方 `base_*` 表支撑**的;`workFlow`(104) / `onlineDev`(101) / `aiCenter`(75) / `extend`(64) / `msgCenter`(50) 基本都是「本仓没这个模块」⇒ **先确认产品边界再动手**,做也只是恒空 stub。 @@ -741,6 +829,24 @@ ENC_BIN="$PWD/target/debug/ssw-platform" bash scripts/perm-smoke-jnpf.sh - 🔴 **尺子用的是 `target/release/ssw-platform`**,不是 debug 产物 ⇒ 改完代码跑尺子前 **必须 `cargo build --release`**,否则尺子跑的是旧二进制(表现为「刚修好的端点还是 405」)。 +### 批次 11 新增的坑 + +- 🔴 **`b10_insert` 的 `None` 不是「不写这列」,是「写 `now()`」** ⇒ 整型列直接类型错 + (`column "f_all_data" is of type integer but expression is of type timestamp`)。 + ⇒ **写整型列一律给具体值**(缺省按官方默认补 `0`),**不要传 `None`**。 + (这条已把批次 10 的 `f_field_rule` ×2 也炸出来了 —— 同一个雷,隔一批才被踩到。) +- 🔴 **查 `int4` 列必须 `$N::text::integer`**(本仓参数一律按 text 绑定)。 + `f_type = $2` ⇒ `cannot convert between ... Option and the Postgres type int4`。 +- 🔴 **`updateById` 语义 = 只 SET body 里出现的键**:官方 Mybatis 只 SET 实体里**非 null** 的字段 ⇒ + body 没带的键**保持原值**。⇒ 自己拼 SET 列表时**别把没传的键也 SET 上去**(会清空数据)。 +- 🔴 **共用 pglite 的测试不要写死绝对条数**:同一测试文件里 `any_menu_id()` 对每个测试返回 + **同一个**菜单 ⇒ 别的测试先建过行 ⇒ 「count == 0」必红。⇒ 一律**基线相对**(`before`/`before + n`)。 +- 🔴 **`async fn` 忘了 `.await` 会静默不执行**(编译器只给 `unused_must_use` 警告)⇒ + 测试里「插了行却查不到」先查这个。 +- 🔴 **官方 `ActionResult.success(String msg)` 是「msg 带提示、data 为 null」**, + 与本仓 `ok(json!({...}))`(`msg="成功"`、data 透传)**不是同一个形状**。 + 本仓沿用既有约定(create 回 `{id}`)—— 改的时候要**连前端消费点一起看**。 + --- ## 6. 收工前(每一轮都要做) diff --git a/PLAN.md b/PLAN.md index abe9ea4..93d1020 100644 --- a/PLAN.md +++ b/PLAN.md @@ -251,8 +251,8 @@ ssw-platform/ | 能力 | 现状 | 目标 | 差距 | |---|---|---|---| -| 面 B 契约端点 | ✅ **331 条**(2026-11-01 批次 10 收尾) | 全量(含 lowcode/flow/file/message) | 官方端点覆盖 350/357;余下多为「本仓没这个模块」 | -| `base_*` DDL | ✅ **49 张**逐字对齐 | 全量 331 张中的必需集 | 按域补 | +| 面 B 契约端点 | ✅ **346 条**(2026-11-01 批次 11 收尾) | 全量(含 lowcode/flow/file/message) | 官方端点覆盖 365/372;余下多为「本仓没这个模块」 | +| `base_*` DDL | ✅ **52 张**逐字对齐 | 全量 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** |