- 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 个坑 / 数字(均已复验)
857 lines
65 KiB
Markdown
857 lines
65 KiB
Markdown
# HANDOFF —— 交给下一个 session 的现场交接
|
||
|
||
> 更新于 2026-11-01(面 B 批次 11 收尾)。**开工先读这一页**(尤其 §0-bis 缺口全景),再读 `CLAUDE.md`(硬约定),
|
||
> 最后看 `.workbuddy/memory/` 最近一天的日志(踩过的坑)。
|
||
> 无人值守时不要问用户,选最保守可行的方案继续,并把决策写回本文件。
|
||
|
||
---
|
||
|
||
## 0. ⚠️ 修正上一版口径(很重要)
|
||
|
||
上一版说「跑 pnpm 必须 `dangerouslyDisableSandbox`」。**这条不完整**:真正拦住 fs 的是
|
||
`NODE_OPTIONS` 里注入的 `node-language-shim.cjs`(brokered-fs),退沙箱它仍在,末尾报
|
||
`CODEBUDDY_BROKER_OUTCOME_UNKNOWN — Broker request timed out`。**正确做法见 §2,用
|
||
`env -u NODE_OPTIONS pnpm ...`** —— 实测 2169 包 46.5s 装完。
|
||
|
||
---
|
||
|
||
## 0-bis. 📊 缺口全景(2026-10-31 05:00 全量摸底,看这里决定下一步)
|
||
|
||
用 `/tmp/fe-scan/scan.py` 扫前端 `src/api/**`(741 条端点定义,先解 `enum Api` 再解析
|
||
模板串),跟后端 `routes.rs` 做差集。**只看本仓该有的 6 个前缀**:
|
||
|
||
| 前缀 | 已覆盖 | 缺口 | 缺口主要是什么 |
|
||
|---|---|---|---|
|
||
| `permission` | 54 | 62 | 个人设置 `Users/Current/*`(14)、`Standing`(6)、`PermissionGroup`(6)、`Action`(3)、导入导出 |
|
||
| `system` | 29 | 208 | **大半是本仓没这个模块**:printDev(15)/Dataset(16)/DataModel(11)/DataInterface(10)/InterfaceOauth(9)/DataSource(5)/PortalManage(4)/BusinessCategory(5)/Area(6)/BillRule(6)… |
|
||
| `oauth` | 3 | 11 | 扫码登录、锁屏、验证码证书 |
|
||
| `message` | 0 | 53 | 消息中心(本仓无表) |
|
||
| `file` | 0 | 32 | 文件/网盘(本仓无表) |
|
||
| `extend` | 0 | 53 | 示例模块 + 邮件 + 甘特图(本仓无表) |
|
||
| **合计** | **86** | **419** | |
|
||
|
||
🔴 **判断**:419 里约 **250 条属于「本仓没这个模块」**,真做也只是恒空 stub。
|
||
剩下的真价值集中在 `permission` 那 62 条。所以**下一轮按这个顺序做**:
|
||
1. `permission/Users/Current/*` 个人设置(14 条,个人中心要用)—— ✅ 批次 1(实际 23 条)
|
||
2. `permission/Standing` / `PermissionGroup` / `Action`(15 条)—— ✅ 批次 2(实际 21 条)
|
||
3. ~~`system/System` + `system/SysConfig`(17 条,系统配置页)~~ —— ✅ 批次 3(实际 25 条)
|
||
4. ~~`message`(53) / 低代码模块 ⇒ 批量恒空 stub~~
|
||
✅ **批次 4 做完(实际 19 条)**——新表 `base_business_category` / `base_message` /
|
||
`base_notice`;业务分类(官方 38 行种子)+ 站内消息(列表/已读/回执/删除)+
|
||
公告(增删改查 + **发布即逐收件人落消息**)。
|
||
⚠️ 只做了 `api/system/message.ts` 那 14 条(消息记录页 / 公告管理页用的),
|
||
`api/msgCenter/*`(发送配置/账号配置/供应商/模板/监控/敏感词 —— 共 36 条)
|
||
是「消息中心运维后台」,本仓没这个产品 ⇒ **仍待定**(见下条)。
|
||
|
||
**被最多页面共用的接口**(`python3 scripts/fe-page-deps.py` 的实测排序,按这个做收益最高):
|
||
`DataModel/{}/Tables`(12 页) / `visualdev/OnlineDev/{}/Config`(10) / `ai/AiSupplier/Selector`(10) /
|
||
`BusinessCategory/treeList`(9 ✅批次4) / `Log`(9) / `workflow/operator/List`(9) /
|
||
`Dataset/{}/Actions/InfoByIds`(9) / `BasicDataType`(9) / `extend/TableExample` 四个(9) / `Tag/selector`(8 ✅批次3)。
|
||
|
||
~~**下一个(批次 5)建议**:`system/Log`(5) + `system/CommonWords`(6) + `system/BillRule`(8)~~
|
||
✅ **批次 5 做完(实际 21 条)**——新表 `base_sys_log` / `base_common_words` / `base_bill_rule`;
|
||
登录即落日志(`Log` 页与个人中心「登录日志」同一份数据)、审批常用语 CRUD + 使用计数、
|
||
单据规则 CRUD + **单号生成器**(时间/随机/UUID 三分支 + 跨天归零 + 回写流水)。
|
||
顺手把 `DictionaryData/All` 从「恒空」改成真读字典 + 灌 `businessType` 13 行种子。
|
||
详见 §1「批次 5」小节。
|
||
|
||
~~**下一个(批次 7)建议**:数据建模的**写面**(`POST/PUT/DELETE /DataModel/{linkId}/Table…`
|
||
+ `addFields` + `Copy` + `Export`/`Import`,共 8 条)—— 这批要动**真 DDL**
|
||
(`CREATE TABLE` / `ALTER TABLE` / `DROP TABLE`),必须先立两条护栏:
|
||
① `base_*` 平台表**禁止** ALTER/DROP(只允许看);② 表名/列名一律过白名单再拼 SQL。~~
|
||
✅ **批次 7 做完(实际 8 条)**——两条护栏都立了,且**判据取 DDL 真源**:
|
||
|
||
- ① `db_ident` 白名单(`[A-Za-z_][A-Za-z0-9_]*` + 双引号包裹)—— 唯一能拼字符串进 DDL 的入口;
|
||
- ② `is_builtin_table` = `sspf_store::db::ddl_tables()` ⇒ **`schema.sql` 里定义过的 35 张全部只给看**
|
||
(不写死清单,加表自动受保护,不会「加了表忘了加护栏」)。
|
||
- 官方 `checkTab` 的两道闸照抄:内置表 `DB101/DB102`、**表里有数据** `DB201/DB202`。
|
||
- 🔴 `update` 是**重建表**(官方也是),所以「有数据就拒」这条闸**不能省** —— 省了就是「改个注释,数据全没」。
|
||
- 🔴 `addFields` **不要求主键**(主键早在表上):要求了会让「加一列」永远失败;
|
||
且只 `ADD COLUMN IF NOT EXISTS`,新列一律可空(给非空表加 `NOT NULL` 列必失败)。
|
||
- 🔴 `Copy` 用 `LIKE … INCLUDING ALL`(官方按字段清单重建会**丢自增**);
|
||
`type=1` 的数据搬运写成**显式列清单** —— `INSERT … SELECT *` 会被 `check-arch` MEM1 判成整表载入。
|
||
- `deleteAllTable` **有意收窄**:只删「不在 `schema.sql` 里」的表(官方全删,含系统表 ⇒ 在这仓等于自杀)。
|
||
- `Export`/`Import` 恒 `400` + 人话(没有文件服务 / 没启 multipart),**不返假下载地址**。
|
||
|
||
做完这三页(`/dataCenter/dataModel`、`/dataCenter/dataSource`、`/dataCenter/basicField`)
|
||
就真正可用了。再往后是 `systemData` 的 `Dataset`/`DataInterface` 其余族。
|
||
|
||
~~**批次 8 候选**:`systemData` 的 `Dataset`(16) / `DataInterface`(10) / `InterfaceOauth`(9)
|
||
+ `system/printDev`(15)。~~ ✅ **批次 8 做完 `Dataset`(实际 18 条)**——见 §1「批次 8」小节。
|
||
|
||
- 它是全仓**唯一执行用户手写 SQL** 的地方 ⇒ 三道护栏(只 `select/with`、不许分号、
|
||
按词边界扫危险动词)+ 变量全走 `$N` 绑定。
|
||
- `Dataset` 是 `AutoComplete` / `PopupSelect` / `InputTable` / `SelectModal` / 报表 / 打印 /
|
||
大屏的**共同底座**(`fe-page-deps` 里 `Actions/InfoByIds` 被 9 个页面共用)⇒ 收益比条数大。
|
||
- ⚠️ 只做 `sqlType=1`(手写 SQL);图形化配置式(`sqlType=2`)/ HTTP / 静态数据一律 `400` + 人话。
|
||
- **下一个(批次 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」小节。~~
|
||
- **批次 11 候选**:继续沿权限族往下挑,选了**数据权限三件套**:
|
||
`ModuleDataAuthorize`(6) + `ModuleDataAuthorizeScheme`(5) + `ModuleDataAuthorizeLink`(4)。
|
||
~~✅ **批次 11 做完(实际 15 条)**——见 §1「批次 11」小节。~~
|
||
|
||
**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) —— **基本都属于「本仓没这个模块」**。
|
||
(🔴 批次 9 收尾时此处写的 252/28.0% 是**批次 8 的旧数**,实测 291/32.3%,此处已更正。)
|
||
|
||
---
|
||
|
||
## 1. 一句话现状(2026-11-01 批次 11 收尾)
|
||
|
||
**📌 当前数字(以此为准,下面各批的「当时数字」仅存档)**:
|
||
|
||
- 契约端点 **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` 里的 52 张)与「有数据的表」一律禁改禁删。
|
||
- 🔴 **数据集(`/dataCenter/dataset`)真能跑 SQL 了**:这是全仓**唯一**执行用户手写 SQL 的地方,
|
||
三道护栏 + 变量全走 `$N` 绑定。它是 `AutoComplete` / `PopupSelect` / `InputTable` /
|
||
`SelectModal` / 报表 / 打印 / 大屏的**共同底座** —— 这一批之后那批通用组件不再是空壳。
|
||
- 🔴 **数据接口(`/dataCenter/dataService`)真能取数了**:复用数据集那套执行面(SQL 只读 +
|
||
`$N` 绑定),`Export` 明说不支持。接口认证(`/integrationCenter/openApi`)与
|
||
打印模板(`/onlineDev/printDev`)也落地了;打印模板**只存设计 JSON、不渲染**
|
||
(本仓无渲染引擎 ⇒ `Export`/`BatchData` 恒 `400` + 人话)。
|
||
- 🔴 **权限配置族落地了**(批次 10):电子签章、按钮权限、列表权限、表单权限、
|
||
高级查询方案共 31 条端点 —— 这是「权限」页配权限的后端地基,见 §1「批次 10」小节。
|
||
- 🔴 **数据权限三件套落地了**(批次 11):数据权限字段 / 数据权限方案 / 数据连接共 15 条端点
|
||
—— 见 §1「批次 11」小节。
|
||
|
||
**✅ 后端已拆成 workspace 多 crate,业务包可独立编译;十二道闸门全绿;空载内存 8 MB。**
|
||
|
||
- 新增 `crates/sspf-contract`(契约层,无 axum)、`crates/sspf-sdk`(业务包唯一依赖)、
|
||
`packs/asset`(样板业务包,只依赖 sdk,能 `cargo test -p sspf-pack-asset` 独立跑)。
|
||
- `rust-toolchain.toml` 全仓锁 **1.95.0**(L3 动态库 ABI 一致性强依赖;本机代理限速装不上 1.99)。
|
||
- 新增两道闸门:`scripts/check-arch.sh`(AR1–AR5 + MEM1–MEM2,带 `--self-test`)、
|
||
`scripts/mem-budget.sh`(空载内存实测,用 `vmmap`,**本机沙箱禁 ps/top**)。
|
||
- 内核 `platform/{envelope,entity,menu,ids}.rs` 已改为 re-export 契约层 ⇒ 引用路径零变化。
|
||
- `cargo test --workspace` = **240 条**(不是 221/230 了,拆 crate 后数字会变,别写死)。
|
||
- 长期架构与路线看 **`PLAN.md`**(尤其判断 ⑥ 内存约束、判断 ⑦ 执行器、§4.5 动态库 ABI)。
|
||
|
||
**前端侧(未变):✅ 浏览器里真跑起来了,用户管理页可渲染、列表/新增/编辑/删除全部可用。**
|
||
|
||
- 登录 `admin/123456` → 进 `/home` → `/permission/user` 正常渲染,左侧分组树 + 右侧表格有数据,
|
||
**整页零非 200 请求**(fetch/XHR 双钩子实测 `[]`)。
|
||
- 机构管理 `/permission/organize` 也正常渲染(空状态,零报错)。
|
||
**第二波(04:00–05:00)当时的数字(已过期,仅存档):**
|
||
|
||
- 契约端点 **207 条**(面 B **177** 条);`tables` → **26**(新增 `base_group`、
|
||
`base_position`、`base_dictionary_type`、`base_dictionary_data`、`base_user_extra`、
|
||
`base_sign_img`、`base_standing`、`base_permission_group`、`base_action`)。
|
||
- 六闸全绿:`check-module 114` / `check-boundary 11` / `check-contract 10` /
|
||
`check-citations 4` / `perm-smoke 43` / `perm-smoke-jnpf 23`,`cargo test` **230 全过**。
|
||
- 官方端点台账覆盖 **165/172**(implemented 160 / partial 5 / absent 7)。
|
||
- 浏览器实测 5 个页面**零非 200**:用户管理、机构管理、角色管理、菜单管理、岗位。
|
||
菜单管理页能正常显示树(系统管理 → 用户/角色/机构/菜单管理)。
|
||
|
||
### 批次 2(2026-10-31 08:00–09:00)做了什么
|
||
|
||
`permission/Standing`(8) + `permission/PermissionGroup`(8) + `permission/Action`(5) = **21 条面 B 端点**,
|
||
新增官方表 `base_standing`(15 列) / `base_permission_group`(16 列) / `base_action`(15 列)。
|
||
|
||
**官方 DDL 逐字对齐**(行号已核对 `JNPF-PostgreSQL.sql`):
|
||
`base_action`:1 / `base_permission_group`:3278 / `base_standing`:4071。
|
||
|
||
🔴 **官方陷阱已照抄**:`base_action.f_enabled_mark` 是 **VARCHAR(11)**(不是 INTEGER)⇒
|
||
投影用 `COALESCE(f_enabled_mark,'0')`,**不加 integer CAST**。
|
||
|
||
🔴 **官方语义已对齐**:
|
||
- `base_standing.f_is_system`:**1=系统身份 / 2=自定义** ⇒ 新建默认写 **2**,投影归一化成 `isSystem` 0/1。
|
||
- `base_action.f_type`:**1=自定义** ⇒ 新建强制写 1(前端 `record.type == 1 ? '自定义' : '系统'`)。
|
||
- `PermissionGroupController.list` 会用 `userService.getFullNameByIds` 把 `f_permission_member`
|
||
的 **id 串换成用户名串** ⇒ 本仓用子查询 `string_agg(...)` 做同样的替换。
|
||
|
||
### 🔴 本轮踩到并解决的 4 个真 bug(都有回归测试 + 反自证)
|
||
|
||
| # | 症状 | 根因 | 修法 |
|
||
|---|---|---|---|
|
||
| ① | `GET /PermissionGroup/PermissionMember/{id}` → 500 / `data:null` | `f_id = ANY($1::text[])` ⇒ pglite-rs 把 `$1::text[]` 当成 PG 数组类型 `_text` | 改 `ANY(string_to_array($1::text, ','))`(**函数在 SQL 里做** ⇒ 参数仍是 text) |
|
||
| ② | `DELETE /PermissionGroup/{id}` → 500 `42P18` | 软删 `base_authorize` 的 SQL 带了 `$1` 但 WHERE/赋值里**没用到** ⇒ PG 拒「无法确定 $1 类型」 | 把 `f_delete_user_id = $1::text` 写进 SET(既是审计列,也用掉参数) |
|
||
| ③ | `DELETE /Standing/{id}` 后**关联残留**(静默) | 软删关联的**占位符与参数顺序错位**(SQL `$1`=item_type、`$2`=item_id,参数传 `[account, id]`) | `rel = [item_type, id, account]` + SQL 改 `$1/$2/$3` 对齐 |
|
||
| ④ | 权限组列表 `permissionMember` 返**uuid 串** | 漏了官方的 `getFullNameByIds` 替换 | 子查询 `string_agg` 换成人名串 |
|
||
|
||
回归测试:`src/backend/tests/batch2_it.rs`(**4 条**,每个钉一个 bug)。
|
||
**反自证全部做过**:逐个把修复回退 ⇒ 测试精确复现原始报错(`cannot convert between String and _text` /
|
||
`42P18` / 关联残留 n=1 / uuid 串)⇒ 恢复后 4 条全过。
|
||
|
||
### 批次 3(2026-10-31 21:40–22:10)—— 应用中心 + 系统配置
|
||
|
||
**31 条面 B 端点**:`/api/system/System`(13:列表/详情/新建/改/删/复制/置顶/偏好/开发者授权×3/Selector/userAuthList)
|
||
+ `/api/system/SysConfig`(8:参数读写/第三方配置读写/管理员列表/设置/企业微信·钉钉连通性测试)
|
||
+ `/api/system/SynThirdInfo`(4:同步/统计/清空/失败清单)
|
||
+ `/api/system/Tag`(6:列表/详情/新建/改/删/selector —— 应用中心页一进来就拉 `selector?enCode=AppTags`)。
|
||
|
||
- 新表三张(官方 DDL 逐字):`base_system_top`(置顶按 `f_user_id + f_type` 记账)、
|
||
`base_sys_config`(`f_category + f_key → f_value` 的键值表)、`base_tag`(标签)。
|
||
- 🔴 **老库补表**:`Db::ensure_schema` 原先见到 `base_user` 就早退 ⇒ 后加的表在老库上
|
||
**永远不存在**。现在会按 `schema.sql` 逐表探 `to_regclass`,缺哪张补哪张
|
||
(DDL 仍以 `schema.sql` 为唯一真源,不另写迁移脚本);单独测试见
|
||
`tests/schema_upgrade_it.rs`。
|
||
- 🔴 **尺子自身的 bug 修了**:`check-contract-scan.py` 判面 B 守卫时只认模块名
|
||
`jnpf` 与函数 `require_login_jnpf` —— 文件早已改名 `face_b.rs` / `require_login_face_b`
|
||
⇒ 整片面 B 的 CC6 守卫检查**静默失效**(只打 warning)。两个名字都认之后恢复生效。
|
||
- 复制应用**只复制应用行**(菜单/表单资源不复制)⇒ `[OFFICIAL]` 记 `partial`;
|
||
应用授权的 `devUsers` 存 `f_user_id` 逗号串、不写 `base_authorize` ⇒ 也记 `partial`。
|
||
- 企业微信/钉钉连通性测试**恒业务失败**(未接 SDK)—— 刻意不假装成功。
|
||
|
||
### 批次 4(2026-10-31)—— 消息业务分类 + 站内消息 + 公告
|
||
|
||
**19 条面 B 端点**:`/api/system/BusinessCategory`(7:树/详/增/改/删/`treeList`/`selector`)
|
||
+ `/api/message`(5:列表/全部已读/读消息/删记录/回执)
|
||
+ `/api/message/Notice`(7:列表/增/详/改/删/发布/回执人列表)。
|
||
|
||
- 新表三张(官方 DDL 逐字):`base_business_category` / `base_message` / `base_notice`;
|
||
tables 26 → 29。
|
||
- 🔴 **业务分类是平台字典,不是用户数据**:官方初始库灌 89 行(一级 + 二级 + 三级)。
|
||
本仓在 `platform/seed.rs::BUSINESS_CATEGORIES` 灌 **38 行**(5 个一级 + 33 个二级),
|
||
**id 沿用官方雪花 id**(`f_category` 存的就是这些 id 串,改 id 官方历史消息就错位)。
|
||
三级是「消息事件」粒度(`flow_todo_remind` 之类),没有消息行时展示不到 ⇒ 暂不灌。
|
||
- 🔴 **`base_message` 一行 = 一个收件人**(`f_user_id` 是收件人,发件人在 `f_creator_user_id`)
|
||
⇒ 所有查询必须带 `f_user_id = 当前用户`,漏了就是串号。
|
||
- 🔴 **公告发布是全链路的唯一消息来源**:`PUT /Notice/{id}/Actions/Release` 置
|
||
`f_enabled_mark=1` 后**逐收件人插 `base_message`**(收件人为空 ⇒ 全体启用用户),
|
||
`f_category` 拼「公告一级 id,公告提醒二级 id」⇒ 消息记录页按二级页签过滤、
|
||
按一级 `enCode` 显示类型名,两者同时成立。不落这一步,消息记录页永远是空的。
|
||
- 🔴 **`ReadInfo` 会写库**(`f_is_read` 0⇒1),且 `f_is_read=2`(已回执)时不回退 ——
|
||
前端「点开就变已读」全靠它,别当纯查询。
|
||
- 🔴 **用户标签要按 `f_id` 与 `f_account` 双键查**:本仓写 `f_creator_user_id` 存的是**账号**
|
||
(`seed.rs` 的 `ADMIN_ACCOUNT`),官方历史数据里是 **id** ⇒ 只查一种另一种永远显示空。
|
||
- 已知 `partial`:`POST /message/Notice/List` 的**时间区间过滤未做**
|
||
(`releaseTime`/`creatorTime`/`expirationTime` 三个区间参数接受但忽略);
|
||
分类删除是**软删**(官方物理删,本仓偏保守)。
|
||
- 回归测试 `tests/batch4_it.rs`(**3 条**):分类树/裁剪/两段式 selector/判重、
|
||
发布扩散、读+回执+删除(含「已回执不回退」与「只删自己的」)。
|
||
|
||
### 批次 5(2026-11-01)—— 系统日志 + 审批常用语 + 单据规则
|
||
|
||
**21 条面 B 端点**:`/api/system/Log`(6:列表/详情/删一条/按类型清空/清登录日志/模块名)
|
||
+ `/api/system/CommonWords`(7:列表/selector/详/增/改/删/使用计数)
|
||
+ `/api/system/BillRule`(10:列表/selector/详/增/改/启停/删/导出/导入/生成单号)。
|
||
|
||
- 新表三张(官方 DDL 逐字):`base_sys_log`(30 列)/ `base_common_words` / `base_bill_rule`;tables 29 → **32**。
|
||
- 🔴 **登录日志此前根本不存在**:`self_system_log`(个人中心「登录日志」)是手写的恒空分页。
|
||
本轮在 `auth.rs::login_handler` 里落一行 `f_type=1`(成功 `f_login_mark=1`、失败 `=0` 且 `f_description` 存失败原因),
|
||
**失败只打 stderr 绝不冒泡**(日志写坏了不能把登录搞挂)⇒ `Log?category=1` 与 `Users/Current/SystemLog`
|
||
共用同一个 `log_page(.., 1, Some(uid))`,两处同时变真。
|
||
- 🔴 **`DELETE /Log/{type}` 的 `{type}` 是分类号不是 id**(官方 `deleteLoginLog` 就是删 `f_type=1` 全部)。
|
||
实现成「删某一条」的话,管理员点「一键清空」会静默什么都不做。路由上 `/Log/{id}` 的 GET(详情)与 DELETE(清空)
|
||
共用同一段名 `{id}`(matchit 不允许同位置两个参数名),handler 内部按分类号解析。
|
||
- 🔴 **`to_char` 的占位符不能照搬官方**:PG 的 `HH` 是 12 小时制、毫秒叫 `MS` 不叫 `SSS`
|
||
⇒ 单独写 `to_char_pattern()` 把小写官方格式映射成 PG 格式,否则会生成「下午 03 点」的错号。
|
||
- 🔴 **改单据规则时只有四个条件变了才清流水**(前缀/后缀**长度**、位数、日期格式)——
|
||
照抄官方这段判断,不然「改个描述」也会把 `f_this_number` 清掉,已发出的号就重号了。
|
||
- 🔴 **`f_this_number` / `f_output_number` 只由 `BillNumber` 回写**,不在 `*_WRITE_FIELDS` 里(14 列不含这两个);
|
||
规则被发过号(`f_output_number` 非空)就**禁删**(`400 单据已经被使用,不允许被删除`)。
|
||
- 🔴 **常用语判重按 `文本 + 类型` 同档**(公共/个人各一套),且 `CommonWordsController` 官方**一个
|
||
`@SaCheckPermission` 都没有** ⇒ 故意不挂 `guard()`,只做 `require_login_face_b`。
|
||
- 已知 `partial`:`DELETE /Log/{id}` 的 `dataInterfaceId` 收窄未做;`BillRule` 的 `Export`/`Import`
|
||
恒业务失败(本仓没有文件服务,**刻意不假装成功**)。
|
||
- 顺手修:`GET /api/system/DictionaryData/All` 原先**恒空**(`businessType` 之类下拉全空且不报错)
|
||
⇒ 改为真读两张字典表 + `seed.rs` 灌 `businessType` 13 行(`isTree=0`)。
|
||
- 回归测试 `tests/batch5_it.rs`(**6 条**):登录落日志双读者一致、三条删除路径语义不同、
|
||
常用语 CRUD + 计数、单号时间格式 + 跨天归零、规则守卫、随机/UUID 分支。
|
||
|
||
### 批次 6(2026-11-01)—— 数据连接 + 数据建模只读面
|
||
|
||
**16 条面 B 端点**:`/api/system/DataSource`(8:列表/分组/下拉树/详/增/改/删/测试连接)
|
||
+ `/api/system/BasicDataType`(1:基准类型列表)+ `/api/system/CommonFields`(1:常用字段列表)
|
||
+ `/api/system/DataModel/**`(6:表清单 / 表+视图 / 表信息 / 字段 / 字段下拉 / 数据预览)。
|
||
|
||
- 新表三张(官方 DDL 逐字):`base_db_link`(22 列)/ `base_data_type` / `base_common_fields`;tables 32 → **35**。
|
||
- 两张**平台字典**照官方初始库逐字灌(`seed.rs`):`DATA_TYPES` 7 行 + `COMMON_FIELDS` 10 行。
|
||
🔴 前者是数据建模表单的**类型下拉唯一数据源**,空了表单虽能开但**建不出表**(不报错)。
|
||
- 🔴 **`DataSource/Selector` 的第一组第一项必须是合成的「默认数据库」(`id="0"`)**:
|
||
`dataCenter/dataModel/index.vue:158-166` 取 `list[0].children[0]` 当默认连接,
|
||
少了它 `dbType` 是 `undefined` ⇒ 建表表单判不出库类型。本仓只有一个库 ⇒ **`linkId` 一律忽略**。
|
||
- 🔴 **`Preview` 绝对不能写 `SELECT *`**:`query_json_params` 会把 `f_*` 列名归一成 camelCase
|
||
(`f_en_code` ⇒ `enCode`),而 `Preview.vue:62` 取的是 `record[column.field.toLowerCase()]`
|
||
(**原样列名**)⇒ 整张表会**空白且不报错**。必须逐列 `"col" AS "col"`(双引号别名是权威名)。
|
||
- 🔴 **`hasTableData` 必须真探测**(`EXISTS(SELECT 1 …)`):前端据此把已有字段**锁成不可改**
|
||
(`Form.vue:113-115`),给 `false` 会让用户在**有数据**的表上删列 ⇒ 直接丢数据。
|
||
- 🔴 **详情不回明文密码**(`password` 恒空串);`update` 传空串 = **不改密码**(前端编辑时密码框本来就空)。
|
||
`Actions/Test` **恒业务失败**(本仓没有外部驱动层)—— 刻意不假装连上了。
|
||
- 表名/列名收窄成 `[A-Za-z_][A-Za-z0-9_]*`([`db_ident`],比 `valid_table` 宽一点:官方允许 `_` 开头),
|
||
只有 `Preview` 会把表名拼进 SQL ⇒ 这段白名单 + 双引号是唯二的注入防线。
|
||
- 已知 `partial`:`dbType` 保持编码原样(官方换字典中文名,本仓没灌「系统数据连接」字典);
|
||
`CommonFields` 只校验登录(官方要 `dataCenter.dataModel|dataCenter.basicField` 任一,
|
||
本仓后者还没登记成点权限);`tableName`/`fieldName` 取 PG 注释,**本仓 schema.sql 没写
|
||
`COMMENT ON` ⇒ 全是空串**(数据建模页「说明」列会空,想改就补 `COMMENT ON`)。
|
||
- 🔴 **尺子也改了一处**:`check-contract-scan.py` 原先只认 `guard(&state,&headers,CONST)`,
|
||
新增 `guard_any(&state,&headers,&[A,B])` 的推导(契约里写 `A|B`,**顺序即代码里的顺序**)
|
||
—— 官方 `@SaCheckPermission(..., mode=OR)` 那几处就靠它,否则整条只能打「推不出」警告。
|
||
- 回归测试 `tests/batch6_it.rs`(**5 条**):连接的增删改查 + 默认库契约 + 软删三处一致、
|
||
两张字典的 7/10 行与 `dataTypeName` 联查、表清单分页/关键词/字段归一/`hasTableData`、
|
||
预览分页与单字段模糊、未登录 602。
|
||
|
||
### 批次 7(2026-11-01)—— 数据建模**写面**(真 DDL)
|
||
|
||
**8 条面 B 端点**:`POST/PUT /DataModel/{linkId}/Table`(建表 / 改表)
|
||
+ `PUT …/addFields`(加字段)+ `DELETE …/Table/{tableName}`(删表)
|
||
+ `DELETE …/deleteAllTable` + `POST …/Table/{t}/Actions/Copy` + `GET …/Actions/Export` + `POST …/Actions/Import`。
|
||
|
||
- 🔴 **两条护栏,缺一不可**:
|
||
① [`db_ident`] 白名单(`[A-Za-z_][A-Za-z0-9_]*` + 双引号)—— 全仓唯一能把字符串拼进 DDL 的入口;
|
||
② [`is_builtin_table`] = `sspf_store::db::ddl_tables()` ⇒ **`schema.sql` 里定义过的 35 张全部只给看**。
|
||
🔴 判据**取 DDL 真源**而不是在 handler 里再抄一份清单 —— 抄一份的后果是「加了表忘了加护栏」,
|
||
新表能被用户在建模页一键删掉。
|
||
- 🔴 **`update` 是重建表**(官方 `creTable`→`dropTable`→`reTableName`)⇒「表里有数据就拒」(`DB202`)
|
||
这条闸**不能省**:省了就是「改个表注释,数据全没」。本仓实现成
|
||
`DROP TABLE old; CREATE TABLE new …` **同一批**交给 `Db::exec`(simple protocol ⇒ 隐式事务),
|
||
比官方那三步少一个「删了旧表但新表没建起来」的中间态。
|
||
- 🔴 **`addFields` 不要求主键**:主键早在表上,还要求「必须选一个主键」会让**「加一列」永远失败**。
|
||
这条是实测踩到的(第一版照抄 create 的校验 ⇒ 400「请选择一个字段作为主键」)。
|
||
且只 `ADD COLUMN IF NOT EXISTS`、新列一律可空(给非空表加 `NOT NULL` 列必失败)。
|
||
- 🔴 **`Copy` 用 `CREATE TABLE … (LIKE … INCLUDING ALL)`**:主键 / `NOT NULL` / `DEFAULT` /
|
||
`IDENTITY` 一起带过去。官方是「读字段清单再重建」⇒ **复制出来的表丢自增**。
|
||
`type=1` 的数据搬运写**显式列清单**(`INSERT INTO dst (c1,c2) SELECT c1,c2 FROM src`)——
|
||
写 `SELECT *` 会被 `check-arch` 的 MEM1 判成「整表载入内存」。
|
||
- 🔴 **`deleteAllTable` 有意收窄**:官方删 `getTableList` 的**全部**表(含系统表,
|
||
在这仓等于把平台自己拆了 —— `base_user` 一没就再也登不回来,种子只在空库上跑)
|
||
⇒ 本仓只删「不在 `schema.sql` 里」的表,也就是用户自己从建模页建的。
|
||
- 🔴 **`dataLength` 对 `decimal` 必须带小数位**(`18,4` 而不是 `18`):只给精度的话,
|
||
前端编辑一次表就把 `numeric(18,4)` 改成 `numeric(18,0)`,**静默丢精度**。
|
||
改的是 `db_field_rows` 的 `numeric_precision || ',' || numeric_scale`。
|
||
- `Export`/`Import` 恒 `400` + 人话(没有文件服务 / 没启 `axum/multipart`),
|
||
**不返假下载地址**(前端会拿它去 `location.href`,得到一个 404 页面)。
|
||
- 回归测试 `tests/batch7_it.rs`(**8 条**):建表往返 + 重名、五类非法 schema、
|
||
内置表禁改禁删、改表重建 + 改名、加字段只追加、有数据的表冻结、
|
||
复制守卫 + 清空只删非内置、导出导入诚实失败。
|
||
|
||
### 批次 8(2026-11-01)—— 数据集(真执行 SQL)
|
||
|
||
**18 条面 B 端点**:`/Dataset` 的 `GET`/`POST`/`PUT`/`DELETE` + `getList` + `previewSql`
|
||
+ `fields` + `GetParam/{id}` + `{id}/get` + `{id}/save` + `{id}/Actions/{Export,Copy,Preview,List,InfoByIds,getRes}`
|
||
+ `Actions/Import`。新表 `base_data_set`(26 列)/ `base_data_set_relation`(13 列),`tables` 35 → 37。
|
||
|
||
- 🔴 **这是全仓唯一执行用户手写 SQL 的地方**(数据连接那条只是存配置)。三道护栏见
|
||
[`dataset_sql_guard`]:① 去尾分号后必须 `select`/`with` 开头;② 全文不许再有 `;`
|
||
(pglite 的 `exec` 走 simple protocol,多语句会**一起跑**);③ 按**词边界**扫危险动词
|
||
(`insert/update/delete/drop/truncate/alter/create/grant/revoke/copy/vacuum/merge`)与
|
||
文件/延时函数(`pg_read_file` / `pg_ls_dir` / `lo_import` / `pg_sleep` / `dblink` …)。
|
||
- 🔴 **按词边界而不是子串**:`update_time` / `create_id` 这种别名必须放行 —— 子串匹配会把
|
||
一批正常的业务 SQL 全拒掉(测试里专门钉了这一条)。
|
||
- 🔴 **变量只走绑定**:`${xxx}` / `@xxx` 一律转成 `$N` + 参数数组,**绝不拼进文本**。
|
||
与官方两处**有意不同**:官方找不到值时原样保留变量名(结果是一条非法 SQL,用户看到
|
||
PG 的语法错);本仓直接 `400 缺少参数 xxx`。官方空集合替换成一个空格(`in ( )` 语法错);
|
||
本仓替换成 `NULL`。
|
||
- 🔴 **`getRes` 用的是 body 里的 `dataConfigJson`**,不是库里的 —— 设计器边改边试跑,
|
||
读库永远是上一次保存的 SQL。
|
||
- ⚠️ **列名靠「执行 1 行」反推**:`row_to_json` 没有行就没有键 ⇒ **空结果集拿不到列名**,
|
||
`fields` 返回空数组(官方走 JDBC 元数据,本仓做不到)。写进 `[OFFICIAL]` 的 `implemented` 备注里。
|
||
- 🔴 **列表与详情的形状不同**:列表 `DataSetListVO` 的 `type`/`returnType` 是**中文名**
|
||
(`SQL语句` / `列表数据`),详情 `DataSetForm` 里是**数字**。同一份投影,两个整形函数。
|
||
- 🔴 **`{id}/save` 的 `variateJson` 收下不落库**(本仓没有 `base_data_interface_variate` 表),
|
||
`{id}/get` 恒回 `"[]"` —— 形状对上,内容为空,**不假装存了**。
|
||
- 🔴 **`SELECT *` 会被 `check-arch` MEM1 判红**(终端内存预算 120MB)。而这里列名由用户 SQL
|
||
决定、拿不到清单 ⇒ 写成 `jnpfs.*`(带表别名,语义等价,且每句都自带 `LIMIT`)。
|
||
- **`InfoByIds` 的 `propsValue` 过 `db_ident` 白名单** —— 它要拼进 SQL 的列名位,
|
||
不过白名单就是一个注入口(测试里用 `code" ; drop table base_user --` 钉住了)。
|
||
- `previewSql` 只支持 `sqlType=1`(原样回 SQL);图形化配置式 / HTTP / 静态数据一律 `400` + 人话。
|
||
- 回归测试 `tests/batch8_it.rs`(**6 条**):形状与 CRUD(含「只改名称不误判重」)、
|
||
`getList` 剔 `isSystem` 参数、绑定执行(含引号注入串 ⇒ 0 行)、护栏五拦一放、
|
||
设计器往返 + `getRes` 用 body、`InfoByIds` 顺序对齐 + 导出导入诚实失败。
|
||
|
||
### 批次 9(2026-11-01)—— 数据接口 + 接口认证 + 打印模板
|
||
|
||
**39 条面 B 端点**:`DataInterface`(12) + `InterfaceOauth`(10) + `printDev`(17)。
|
||
新表 6 张:`base_data_interface` / `base_data_interface_oauth` / `base_data_interface_user` /
|
||
`base_data_interface_log` / `base_print_template` / `base_print_version`,`tables` 37 → 43。
|
||
|
||
🔴 **DDL 名 ≠ 实体名**(照抄官方时踩的坑):`PrintDevEntity` → **`base_print_template`**
|
||
(不是 `base_print_dev`);`PrintVersionEntity` → `base_print_version`;
|
||
`InterfaceOauthEntity` → `base_data_interface_oauth`。
|
||
|
||
- 🔴 **点权限编码三套并存**(判据都是 `base_module.f_en_code`):
|
||
`dataCenter.dataService`(数据接口)/ `integrationCenter.openApi`(接口认证)/
|
||
`onlineDev.printDev`(打印模板)。**官方没加 `@SaCheckPermission` 的那几条**
|
||
(`getList` / `GetParam` / `Preview` / `Selector` / `WorkSelector` / `getListOptions` /
|
||
`BatchData`)在本仓只要求**登录**(`require_login_face_b`)—— 与官方一致。
|
||
- 🔴 **数据接口的 `Preview` 复用数据集那套执行面**(SQL 只读 + `$N` 绑定 + 三道护栏),
|
||
官方另有 API / 静态数据两种类型 ⇒ 本仓 `400` + 人话(不假装支持)。
|
||
- 🔴 **`GetParam` 是裸数组**(官方 `ActionResult<List<DynamicForm>>`)—— 不是 `{list:[…]}`。
|
||
- 🔴 **接口认证的 `SaveUserList` 是本仓拆出来的独立端点**:官方是在 `create`/`update`
|
||
里**内联**保存用户清单(`InterfaceOauthController.java:125`),本仓为了让前端
|
||
`saveUserList` 能单独调用而拆开(等价语义,`[OFFICIAL]` 备注里写明了)。
|
||
- 🔴 **打印模板没有渲染引擎** ⇒ `Export` / `BatchData` 恒 `400` + 人话
|
||
(**不返假下载地址、不返空数据**);`Save` / `Version/*` **只存设计 JSON**。
|
||
- 🔴 **打印版本的发布语义**:`Save` 的 `type=1` 即发布 ⇒ 旧的已发布版本**归档(state=2)**、
|
||
新版本 `state=1`、模板 `state=1`;`type=0` 只存 JSON 不发布。
|
||
- 🔴 **版本删除的三道闸,顺序照抄官方**(`PrintDevController.java:332`):
|
||
① 只剩一个 ⇒ `至少保留一个版本`(官方 SYS043);
|
||
② `state=1` ⇒ `已发布版本不可删除`(SYS044);
|
||
③ `state=2` ⇒ `已归档版本不可删除`(SYS045)。
|
||
⇒ **顺序不能换**:只剩 1 个时先命中①,测不到②③(测试里专门复制出第二个版本再测)。
|
||
- 🔴 **`Selector` 是「分类节点 + 模板叶子」的树**(官方 `PrintDevTreeModel`),
|
||
且**只含 `state=1`(已发布)的模板** ⇒ 草稿模板不该出现在下拉里。
|
||
- 🔴 **版本列表 `fullName` = `打印版本V{n}`**(官方 `versionList` 逐字),
|
||
返回**裸数组**(官方 `ActionResult<List<PrintVersionListVO>>`)。
|
||
- 🔴 **复制模板要连版本一起复制**(官方 `copyPrintdev` 也复制版本);
|
||
副本名加「副本」+ 5 位 uuid 前缀,编码也换掉(撞名/撞码靠 uuid 天然避开)。
|
||
- 回归测试 `tests/batch9_it.rs`(**9 条**):数据接口双判重 + 只改名称不误判重 + 软删、
|
||
`GetParam` 裸数组 + 导出诚实失败、接口真取数 + 禁用后拒绝、接口认证判重 + `getAppId`
|
||
UUID + `interfaceSelector` 两棵树、打印建模板带首版本、`Save` 发布归档、版本删除三闸、
|
||
`Selector` 树只含已发布 + `Export`/`BatchData` 诚实失败、复制带版本。
|
||
|
||
### 🔴 本批踩到并解决的 2 个真 bug
|
||
|
||
1. **`interface_oauth_create` 的 INSERT 报 `42701 column "f_app_id" specified more than once`** ——
|
||
种子列里放了 `f_app_id`,而 `io_write_fields` 又把 body 的 `appId` 映射到同一列 ⇒
|
||
列出现两次。**修法**:`appId` 只走写字段路径(body 没给才补 uuid),不再单独塞列。
|
||
(这类「种子列 + 写字段表撞车」的坑,`data_interface_create` / `print_dev_create` 也有同款结构,
|
||
写新表时要一起检查。)
|
||
2. **`sspf-store` 的表数断言停在 37** ⇒ `cargo test --workspace` 直接红 2 条
|
||
(`schema_sql_has_expected_table_count` / `ddl_tables_parses_every_create_table`)。
|
||
🔴 **加表必须同时改三处**:`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 测试里的表数断言。
|
||
|
||
### 批次 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<String>`)⇒ `f_type = $2` 报
|
||
`cannot convert between ... Option<String> 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` 必须是**字符串** `"{}"` —— 给对象会让前端
|
||
`handleUpdatePreferences` 抛异常 ⇒ 登录后立刻跳 Logout(表现为「登录无效原地打转」)。
|
||
2. 菜单 `urlAddress` 走的是**面 B 路径** `permission/user`,不是面 A 的 `system/User` ⇒
|
||
之前直接访问 `/system/User` 必然 404。
|
||
3. `Users` 列表的 `keyword` 压根没进 SQL(搜索框形同虚设)⇒ 已补三列 ILIKE。
|
||
4. 空关键词时把 `like` 塞进参数数组 ⇒ PG 报「bind supplies 1 params, statement requires 0」
|
||
⇒ **必须** `if keyword.is_empty() { Vec::new() }`。
|
||
|
||
---
|
||
|
||
## 2. 运行中的现场(断了就按这里重启)
|
||
|
||
### 后端(端口 30000)
|
||
|
||
```bash
|
||
cd ~/Desktop/workspace/ssw-platform
|
||
RUSTC_WRAPPER=sccache cargo build --manifest-path src/backend/Cargo.toml # 改代码后
|
||
# 🔴 **尺子跑的是 release 产物** ⇒ 跑尺子前必须 `cargo build --release`
|
||
RUSTC_WRAPPER=sccache cargo build --release --manifest-path src/backend/Cargo.toml
|
||
nohup env PORT=30000 ./target/debug/ssw-platform > /tmp/ssw-backend.log 2>&1 & # 后台起
|
||
curl -s http://127.0.0.1:30000/api/health # 期望 {"ok":true,"tables":43,...}
|
||
```
|
||
|
||
拿 token(面 B):
|
||
|
||
```bash
|
||
ENC=$(./target/debug/ssw-platform --enc 123456)
|
||
curl -s -X POST http://127.0.0.1:30000/api/oauth/Login \
|
||
-H 'Content-Type: application/x-www-form-urlencoded' \
|
||
-H 'Vue-Version: 3' -H 'App-Code: mainSystem' \
|
||
--data-urlencode account=admin --data-urlencode "password=$ENC"
|
||
# → data.token(lite- 前缀)。Authorization 头是**裸 token,没有 bearer 前缀**
|
||
```
|
||
|
||
### 前端(`~/Desktop/workspace/jnpf/7.0/frontend/web/jnpf-web-monorepo-framework`)
|
||
|
||
🔴 **必须 `env -u NODE_OPTIONS`**:否则被 brokered-fs shim 逐次拦截(0.15 包/s,末尾
|
||
`ERR_PNPM_CODEBUDDY_BROKER_DENY` / `CODEBUDDY_BROKER_OUTCOME_UNKNOWN`)。依赖**已经装好**,
|
||
下面第 1 步只在坏了时重跑。
|
||
|
||
```bash
|
||
cd ~/Desktop/workspace/jnpf/7.0/frontend/web/jnpf-web-monorepo-framework
|
||
env -u NODE_OPTIONS pnpm install --prefer-offline --reporter=append-only # 断了才需要重跑,约 47s
|
||
pnpm -r run stub --if-present # 已由 postinstall 跑过
|
||
env -u NODE_OPTIONS nohup pnpm dev:main > /tmp/vite-main.log 2>&1 & # vite, 3000, /dev → 30000
|
||
```
|
||
|
||
- 成功标志:`node_modules/.modules.yaml` 存在(✅ 已存在)、vite 打印 `ready in ~7s`
|
||
- 打开 `http://localhost:3000/`(根路径 App-Code 为空 ⇒ 后端回退主系统,已支持)
|
||
- 登录:`admin` / `123456`(登录框自己加密,不要手填密文)
|
||
|
||
⚠️ **后台进程会随 turn 结束被回收**(`run_in_background` 起的东西在回复完就没了)。
|
||
🔴 **2026-10-31 实测修正**:`run_in_background` **不可靠**(上下文压缩那一轮 vite 就被回收了,
|
||
日志里明明 `ready in 5188ms`)。用 **`nohup ... &`** 起,实测能跨 turn 存活:
|
||
|
||
```bash
|
||
# 前端
|
||
cd ~/Desktop/workspace/jnpf/7.0/frontend/web/jnpf-web-monorepo-framework
|
||
env -u NODE_OPTIONS nohup pnpm dev:main > /tmp/vite-main.log 2>&1 &
|
||
# 后端
|
||
cd ~/Desktop/workspace/ssw-platform
|
||
nohup env PORT=30000 ./target/debug/ssw-platform > /tmp/ssw-backend.log 2>&1 &
|
||
```
|
||
|
||
两个都起好后,浏览器会话 `aix --session ssw` 可以直接复用(登录态在 localStorage)。
|
||
|
||
⚠️ **后端一重启,token 就失效**(session 是进程内内存表)⇒ 每轮开工必须重新登录拿 token。
|
||
|
||
### 代码仓库(本机 Gitea)
|
||
|
||
```bash
|
||
cd ~/Desktop/workspace/ssw-platform
|
||
git status -sb # main...origin/main,工作区应干净
|
||
# 推送(凭据只在 xop 注入的环境里存在,脚本不落盘)
|
||
xop run --secret GU=git_local_user --secret GP=git_local_pass -- bash -c '
|
||
export GIT_ASKPASS=/tmp/askpass-ssw.sh GIT_TERMINAL_PROMPT=0
|
||
git -c http.proxy= -c https.proxy= push origin main' < /dev/null
|
||
```
|
||
|
||
- 远端:`http://127.0.0.1:13300/ssw/ssw-platform.git`(Gitea 1.26.1,私有,默认分支 main)
|
||
- `ssw` 是**用户命名空间**不是组织(`/api/v1/orgs/ssw` 返 404),建仓用 `POST /api/v1/user/repos`
|
||
- `/tmp/askpass-ssw.sh` 若不存在,重建:`case "$1" in *[Uu]sername*) echo "$GU";; *) echo "$GP";; esac`
|
||
- 🔴 xop 会把输出里等于密钥值的串打码(`ssw` → `ss****【xop禁止将密钥泄漏】`),日志别扭但无害
|
||
- 每批做完建议 `git add -A && git commit`(一晚上至少留一个可回滚点)
|
||
|
||
---
|
||
|
||
## 3. 待办(按优先级,做完一条划一条)
|
||
|
||
### ~~P0 —— 用户管理页剩余接口~~ ✅ **2026-10-31 全部做完**
|
||
|
||
| 端点 | 状态 |
|
||
|---|---|
|
||
| `GET /api/permission/Group` | ✅ 左侧分组树(ListVO)。**表是官方 `base_group`**(不是 `base_user_group`,官方 DDL `JNPF-PostgreSQL.sql:1758` 只有 `base_group`) |
|
||
| `GET/POST/PUT/DELETE /api/permission/Group/{id}` | ✅ CRUD 全通,端到端实测(建→详情→改→加成员→移出→删) |
|
||
| `POST /api/permission/Group/{id}/Actions/AddUser` / `DeleteUser` | ✅ 走 `base_user_relation`(f_object_type='Group'),幂等插 |
|
||
| `POST /api/permission/Users/{id}/SetPosition` + `/SetPositionBatch` | ✅ 405 已修(单独注册 `/Users/SetPositionBatch`) |
|
||
| `GET /api/permission/Users/{id}/SelectorByUserPosId` | ✅ |
|
||
| `GET /api/system/System/getDevUser` | ✅ |
|
||
| `DELETE /api/permission/socials/{id}` | ✅ 本仓无 `base_socials_users` ⇒ 恒成功 |
|
||
| `POST /api/permission/Users/workHandover` | ✅ 置 `f_handover_mark=1` |
|
||
|
||
**另外顺手补了 5 条页面级 404**(都是「不补就弹红条」的):
|
||
`GET /api/system/DictionaryData/All`(恒 `{list:[]}`,**不能是裸数组**)、
|
||
`GET /api/system/HomeData`(恒 `[]`,前端读 `res.data.length`)、
|
||
`POST /api/system/MenuData/useModuleNum/{id}`(恒成功)、
|
||
`GET /api/oauth/getLoginConfig` + `getConfig/{account}`(**登录前调用 ⇒ 无守卫**,恒 `{}`)。
|
||
|
||
### ~~P1 —— 让页面真跑起来~~ ✅ **2026-10-31 达成**
|
||
|
||
可复现步骤(实测有效):
|
||
|
||
1. `nohup` 起后端 + vite(命令见 §2)
|
||
2. `aix open "http://localhost:3000/login" --session ssw` → `aix snapshot` 拿 `@eN`
|
||
→ fill 账号/密码 → click 登录 → 约 9s 后落到 `/home`
|
||
3. `aix open "http://localhost:3000/permission/user"` ⇒ 期望:左侧「全部用户」+ 分组节点,
|
||
右侧表格有 admin 行,零报错
|
||
4. 零非 200 的查法(比看控制台准):进页面前先注入 fetch/XHR 双钩子收集 `window.__net`,
|
||
再 filter `x[0]!==200`。**控制台看不到 404 的 details 时就用这招**
|
||
|
||
### ~~P2 —— 机构管理 `Organize` CRUD + `Selector`~~ ✅ **2026-10-31 做完**
|
||
|
||
`GET/POST /api/permission/Organize`、`GET/PUT/DELETE /api/permission/Organize/{id}`、
|
||
`GET /api/permission/Organize/Selector` 共 6 条。
|
||
端到端实测:建父 → 建子(`organizeIdTree` = 父树+自己,`orgNameTree` 同理)→ 详情 →
|
||
改(只发 `fullName`,`enCode` 不动)→ Selector 2 行 → 删 → 剩 0 行。
|
||
⚠️ 删机构**不级联**(只软删本行)⇒ 已记为已知限制 `(ak)`。
|
||
|
||
### ~~P3 —— 菜单管理 / 角色授权~~ ✅ **2026-10-31 05:00 做完**
|
||
|
||
| 批次 | 端点 | 备注 |
|
||
|---|---|---|
|
||
| 岗位 `Position` | 12 条 | 新表 `base_position`(官方 23 列逐字)。CRUD + Selector/SelectorTree/Condition/SelectedList/DutyPosition/DutyUser |
|
||
| 角色 `Role` | 6 条 | `base_role` 已有。CRUD + Selector + RoleCondition |
|
||
| 菜单 `Menu` | 13 条 | `base_module` 已有。CRUD + 四种 Selector + Export/权限组 |
|
||
| 字典 `DictionaryType`/`Data` | 14 条 | 新表 2 张。分类 CRUD + 数据 CRUD + 两种下拉 |
|
||
| 用户选人 / 授权 / 关系 | 16 条 | `Users/Selector`、`getUserList`、`getSelected*`、`getAllPermission`、`Authorize`、`Authority/{kind}/{id}`、`RoleRelation/*`、`UserRelation/*` |
|
||
|
||
### P4 —— 剩下的(按 §0-bis 的全景表,从上往下做)
|
||
|
||
1. ~~`permission/Users/Current/*` 个人设置 14 条(BaseInfo/改密码/主题/语言/头像/签名/saas)~~
|
||
✅ **批次 1 做完(实际 23 条)**——新表 `base_user_extra` / `base_sign_img`
|
||
2. ~~`permission/Standing`(6) / `PermissionGroup`(6) / `Action`(3)~~
|
||
✅ **批次 2 做完(实际 21 条)**——新表 `base_standing` / `base_permission_group` / `base_action`
|
||
3. ~~`system/System`(11) + `system/SysConfig`(6) 系统配置页~~ ← **下一个**
|
||
✅ **批次 3 做完(实际 31 条,含 Tag)**——新表 `base_system_top` / `base_sys_config`;
|
||
应用中心 CRUD + 置顶 + 应用授权 + 系统参数/第三方配置键值表 + 管理员设置 + 同步统计。
|
||
4. ~~`message`(53) 里的 `api/system/message.ts` 那 14 条~~
|
||
✅ **批次 4 做完(实际 19 条,含 BusinessCategory)**——新表 `base_business_category` /
|
||
`base_message` / `base_notice`。`api/msgCenter/*`(36 条运维后台)仍未定。
|
||
5. ~~`system/Log`(5) + `system/CommonWords`(6) + `system/BillRule`(8)~~
|
||
✅ **批次 5 做完(实际 21 条)**——新表 `base_sys_log` / `base_common_words` / `base_bill_rule`;
|
||
登录落日志 + 常用语 CRUD + 单据规则与单号生成器。
|
||
6. ~~`DataModel/{}/Tables`(12 页共用) + `DataSource` + `BasicDataType` + `CommonFields`~~
|
||
✅ **批次 6 做完(实际 16 条)**——新表 `base_db_link` / `base_data_type` / `base_common_fields`;
|
||
数据建模**只读面**(表清单/字段/预览)+ 数据连接 CRUD。**写面(真 DDL)留给批次 7**。
|
||
7. ~~`DataModel` 写面 8 条(`CREATE/ALTER/DROP TABLE` + `addFields` + `Copy` + `Export`/`Import`)~~
|
||
✅ **批次 7 做完(实际 8 条)**——真 DDL + 两道护栏(`db_ident` + `ddl_tables` 内置表清单)
|
||
+ 官方 `checkTab` 的「内置表 / 有数据」双闸。数据建模三页现在**真能用**。
|
||
8. ~~`systemData` 的 `Dataset`(16)~~ ✅ **批次 8 做完(实际 18 条)**——新表
|
||
`base_data_set` / `base_data_set_relation`;CRUD + 设计器 `get`/`save` + 六条取数
|
||
(`Preview`/`List`/`InfoByIds`/`getRes`/`previewSql`/`fields`)+ 下拉 + 恒失败的导出导入。
|
||
**真执行 SQL**,三道护栏 + `${xxx}`/`@xxx` 全绑定。
|
||
9. ~~`DataInterface`(12) + `InterfaceOauth`(11) + `system/printDev`(17)~~
|
||
✅ **批次 9 做完(实际 39 条)**——新表 6 张(`base_data_interface` /
|
||
`base_data_interface_oauth` / `base_data_interface_user` / `base_data_interface_log` /
|
||
`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. ~~数据权限三件套 `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_<bind>_jnpf_` 是**两套**);
|
||
**create 用 `fieldRule!=0`、update 用 `fieldRule==1`**;delete 比对用**带前缀**的码。
|
||
🔴 **方案列表只需登录**(官方没加 `@SaCheckPermission`)。
|
||
🔴 `FieldList` / 表字段端点依赖低代码表单与数据库内省 ⇒ **诚实返回空**(不假装)。
|
||
|
||
**下一个(批次 12)**:`fe-gap` 余下最大的 `system` 55 条 / `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`。
|
||
`docs/contract.md` 三处登记必须同步,否则 CC10 / CIT2 会红。
|
||
|
||
---
|
||
|
||
## 4. 每批实现的固定动作(缺一不可)
|
||
|
||
```bash
|
||
cd ~/Desktop/workspace/ssw-platform
|
||
# 1) 实现 → 编译
|
||
RUSTC_WRAPPER=sccache cargo build --manifest-path src/backend/Cargo.toml
|
||
# 2) 重启后端(老进程先 kill)
|
||
PORT=30000 ./target/debug/ssw-platform &
|
||
# 3) 运行时验证(比静态比对权威)
|
||
python3 scripts/probe-page.py docs/fe/page-user.tsv
|
||
# 4) 单测 + 六闸
|
||
RUSTC_WRAPPER=sccache cargo test --manifest-path src/backend/Cargo.toml
|
||
# 🔴 **尺子跑的是 release 产物** ⇒ 跑尺子前必须先 build --release
|
||
RUSTC_WRAPPER=sccache cargo build --release --manifest-path src/backend/Cargo.toml
|
||
for s in check-module check-boundary check-contract check-citations; do bash scripts/$s.sh; done
|
||
bash scripts/perm-smoke.sh
|
||
ENC_BIN="$PWD/target/debug/ssw-platform" bash scripts/perm-smoke-jnpf.sh
|
||
```
|
||
|
||
新增/变更端点必须同步三处,否则闸门必红:
|
||
|
||
1. `docs/contract.md` 的 `[ENDPOINT]`(面 B 行首列写 `B`)与 `[OFFICIAL]`(`absent → implemented`)
|
||
2. `docs/contract.md` 的 `[FACE]` 计数 + `[RULER]` 里 `perm-smoke-jnpf.sh` 的断言数
|
||
3. `src/backend/src/routes.rs` 测试里的 `JNPF_REGISTERED`(按**路径**列,同路径多方法算一条)
|
||
|
||
---
|
||
|
||
## 5. 必踩的坑(都已踩过一次,别再踩)
|
||
|
||
- 🔴 **一条 `.route()` 只挂一个方法**:`check-contract-scan.py` 只解析每个 `.route()` 的第一个方法,
|
||
`get(a).post(b)` 会被判成「契约写 POST、代码是 GET」。同路径多次 `.route()` 在 axum 里是合并,不冲突。
|
||
- 🔴 **驼峰 ≠ 下划线机械转换**:`ranks` ↔ `f_rank`、`certificatesType` ↔ `f_certificates_type`。
|
||
列名只来自白名单常量(如 `USER_WRITE_FIELDS`),别用 `snake_case()` 猜。
|
||
- 🔴 `f_creator_time` 写 SQL `now()` 时**不占参数位**:`marks.push("now()")` 而非 `placeholder()`,
|
||
否则 `$n` 序号和 `columns` 错位(报 `column is of type timestamp but expression is of type text`)。
|
||
- 🔴 写路径只 `SET` **body 里出现过的键**,未出现的列必须保持原值(有断言钉住)。
|
||
- 🔴 读回**不选** `f_password` / `f_secretkey`(有断言钉住「详情无 password 键」)。
|
||
- 🔴 `{id}` 会吞掉 `Users/` 下未注册的静态 GET 子路径;matchit 静态段优先,所以那些路由
|
||
**一旦注册就自动优先匹配**,不需要改详情。
|
||
- 🔴 测试共用 `platform/test_support.rs` 的**单例 pglite**(进程内只能开一个实例),
|
||
别在测试里 `open_temp`。
|
||
- 🔴 `python` 脚本里递归取同目录 `.vue` 时用 `if seen is None:`,**不能写 `seen = seen or set()`**
|
||
(空 set 是 falsy ⇒ 每层新建 ⇒ 环形 import OOM 被 SIGKILL)。
|
||
- 🔴 jq 里 `$d|has(a) or $d|has(b)` 会被 `|` 抢结合 ⇒ 用 `[keys[]|select(.=="a" or .=="b")]|length`。
|
||
- 🔴 端口:前端 dev 3000,代理 `/dev` → **30000**,后端绝不能起在 3000。
|
||
- 🔴 **npm/pnpm 类命令一律 `env -u NODE_OPTIONS`**(见 §0);cargo 不受影响,不用加。
|
||
- 🔴 **后台进程随 turn 结束被回收**:起服务与验证必须同一 turn 内完成。
|
||
- 🔴 git 推送别把密码塞 remote URL:用 `GIT_ASKPASS` + `xop run --secret`,并加 `-c http.proxy=`。
|
||
- 🔴 `.gitignore` 已挡 `target/`(1.7G) 与 `src/backend/data/`(38M);`git add -A` 前先
|
||
`git diff --cached --name-only | wc -l` 确认没暴涨。
|
||
|
||
### 批次 2 新增的坑
|
||
|
||
- 🔴 **PG 数组参数一律不能写 `$N::text[]`**:pglite-rs 0.2.7 会把它当成 PG 数组类型 `_text`,
|
||
而本仓参数**一律按 text 绑定**(`Option<String>`)⇒ 协议错
|
||
`cannot convert between the Rust type String and the Postgres type _text`。
|
||
⇒ 改成 `= ANY(string_to_array($N::text, ','))`(**函数在 SQL 里做**)。
|
||
- 🔴 **PG 会拒「SQL 里有 $N 但没用它」**:`42P18: could not determine data type of parameter $1`。
|
||
⇒ 凡是留了 `$N` 的软删 SQL,都要把对应列写进 SET(`f_delete_user_id = $N::text`)。
|
||
- 🔴 **占位符顺序必须与参数追加顺序逐字对齐**(不是「大致对上」)⇒ 写完对着读一遍。
|
||
- 🔴 **`base_action.f_enabled_mark` 是 VARCHAR(11)**(官方 DDL 陷阱)⇒ 别按整数 CAST。
|
||
- 🔴 **`base_standing.f_is_system` 是 1=系统 / 2=自定义** ⇒ 新建写 **2**,不是 1。
|
||
- 🔴 **官方 `list` 端点常有「id 串换人名串」的后处理**(`getFullNameByIds`)⇒ 抄控制器别只抄模型。
|
||
- 🔴 **Bash 里写多层嵌套引号的 curl + python 验证脚本很容易引号不闭合**(`bash -n` 报
|
||
`unexpected EOF` 但**定位不到行**)⇒ **直接用 Python 写验证器**(`urllib` + `ProxyHandler({})`
|
||
绕过本机代理),别跟 bash 引号较劲。
|
||
- 🔴 **尺子用的是 `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<String> 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. 收工前(每一轮都要做)
|
||
|
||
1. 追加 `.workbuddy/memory/YYYY-MM-DD.md`:结论 / 坑 / 数字(闸门通过数)
|
||
2. 更新本文件 §1 现状、§2 现场、§3 待办(划掉做完的)
|
||
3. 若还有未完成项,**确认下一次定时任务存在**(`automation_update` list 可查),没有就新建
|