- 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
57 KiB
HANDOFF —— 交给下一个 session 的现场交接
更新于 2026-11-01(面 B 批次 10 收尾)。开工先读这一页(尤其 §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 条。所以下一轮按这个顺序做:
permission/Users/Current/*个人设置(14 条,个人中心要用)—— ✅ 批次 1(实际 23 条)permission/Standing/PermissionGroup/Action(15 条)—— ✅ 批次 2(实际 21 条)—— ✅ 批次 3(实际 25 条)system/System+system/SysConfig(17 条,系统配置页)✅ 批次 4 做完(实际 19 条)——新表message(53) / 低代码模块 ⇒ 批量恒空 stubbase_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)建议:
✅ 批次 5 做完(实际 21 条)——新表 system/Log(5) + system/CommonWords(6) + system/BillRule(8)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-archMEM1 判成整表载入。 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」小节。
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) —— 基本都属于「本仓没这个模块」。
(🔴 批次 9 收尾时此处写的 252/28.0% 是批次 8 的旧数,实测 291/32.3%,此处已更正。)
1. 一句话现状(2026-11-01 批次 10 收尾)
📌 当前数字(以此为准,下面各批的「当时数字」仅存档):
- 契约端点 361 条(面 A 28 + 面 B 331 + 两面共用 2);
tables→ 49。 cargo test --offline --workspace= 545 passed / 0 failed。- 十二道闸门全绿;
check-contractPASS=10 FAIL=0,官方端点覆盖 350/357 (implemented 323 / partial 27 / absent 7;oos 6 单列)。 python3 scripts/fe-gap.py:合计 322 / 900(35.8%),permission111/137(81.0%)、system132/196(67.3%)、systemData74/106(69.8%)。 (批次 9 收尾时此处写的 252/28.0% 是批次 8 的旧数,批次 9 实测 291/32.3%,此处已更正。)- 🔴 数据建模三页(
/dataCenter/dataModel/dataSource/basicField)现在真能用了: 建表 / 改表 / 加字段 / 删表 / 复制 / 预览 / 导出(明说不支持)全通, 平台表(schema.sql里的 49 张)与「有数据的表」一律禁改禁删。 - 🔴 数据集(
/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」小节。
✅ 后端已拆成 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 test230 全过。 -
官方端点台账覆盖 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,投影归一化成isSystem0/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_read0⇒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灌businessType13 行(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_TYPES7 行 +COMMON_FIELDS10 行。 🔴 前者是数据建模表单的类型下拉唯一数据源,空了表单虽能开但建不出表(不报错)。 - 🔴
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 列),tables35 → 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-archMEM1 判红(终端内存预算 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裸数组 + 导出诚实失败、接口真取数 + 禁用后拒绝、接口认证判重 +getAppIdUUID +interfaceSelector两棵树、打印建模板带首版本、Save发布归档、版本删除三闸、Selector树只含已发布 +Export/BatchData诚实失败、复制带版本。
🔴 本批踩到并解决的 2 个真 bug
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也有同款结构, 写新表时要一起检查。)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_+enCodefieldRule == 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、高级查询必填校验。
🔴 本批踩到并解决的坑
- 🔴 契约扫描器只认
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⇒ 写成LIMIT ${}::text::integer OFFSET ${}::text::integer。 - 🔴
base_module_form.f_sort_code是BIGINT—— 抄 DDL 时手误写成BIGIG会被 PG 直接拒。 - 🔴 加表仍然是三处(批次 9 已经踩过一次,这里再确认):
schema.sql+main.rs的BASE_TABLES+crates/sspf-store/src/db.rs的两处断言。 本批 43 → 49,另加src/backend/tests/batch6_it.rs与routes.rshealth 测试里的表数断言。
🔴 上一批(第一批)踩到并解决的 4 个真 bug
CurrentUser的preferenceJson必须是字符串"{}"—— 给对象会让前端handleUpdatePreferences抛异常 ⇒ 登录后立刻跳 Logout(表现为「登录无效原地打转」)。- 菜单
urlAddress走的是面 B 路径permission/user,不是面 A 的system/User⇒ 之前直接访问/system/User必然 404。 Users列表的keyword压根没进 SQL(搜索框形同虚设)⇒ 已补三列 ILIKE。- 空关键词时把
like塞进参数数组 ⇒ PG 报「bind supplies 1 params, statement requires 0」 ⇒ 必须if keyword.is_empty() { Vec::new() }。
2. 运行中的现场(断了就按这里重启)
后端(端口 30000)
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):
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 步只在坏了时重跑。
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 存活:
# 前端
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)
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 达成
可复现步骤(实测有效):
nohup起后端 + vite(命令见 §2)aix open "http://localhost:3000/login" --session ssw→aix snapshot拿@eN→ fill 账号/密码 → click 登录 → 约 9s 后落到/homeaix open "http://localhost:3000/permission/user"⇒ 期望:左侧「全部用户」+ 分组节点, 右侧表格有 admin 行,零报错- 零非 200 的查法(比看控制台准):进页面前先注入 fetch/XHR 双钩子收集
window.__net, 再 filterx[0]!==200。控制台看不到 404 的 details 时就用这招
P2 —— 机构管理 Organize CRUD + Selector ✅ 2026-10-31 做完
Organize CRUD + SelectorGET/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 做完(实际 23 条)——新表permission/Users/Current/*个人设置 14 条(BaseInfo/改密码/主题/语言/头像/签名/saas)base_user_extra/base_sign_img✅ 批次 2 做完(实际 21 条)——新表permission/Standing(6) /PermissionGroup(6) /Action(3)base_standing/base_permission_group/base_action← 下一个 ✅ 批次 3 做完(实际 31 条,含 Tag)——新表system/System(11) +system/SysConfig(6) 系统配置页base_system_top/base_sys_config; 应用中心 CRUD + 置顶 + 应用授权 + 系统参数/第三方配置键值表 + 管理员设置 + 同步统计。✅ 批次 4 做完(实际 19 条,含 BusinessCategory)——新表message(53) 里的api/system/message.ts那 14 条base_business_category/base_message/base_notice。api/msgCenter/*(36 条运维后台)仍未定。✅ 批次 5 做完(实际 21 条)——新表system/Log(5) +system/CommonWords(6) +system/BillRule(8)base_sys_log/base_common_words/base_bill_rule; 登录落日志 + 常用语 CRUD + 单据规则与单号生成器。✅ 批次 6 做完(实际 16 条)——新表DataModel/{}/Tables(12 页共用) +DataSource+BasicDataType+CommonFieldsbase_db_link/base_data_type/base_common_fields; 数据建模只读面(表清单/字段/预览)+ 数据连接 CRUD。写面(真 DDL)留给批次 7。✅ 批次 7 做完(实际 8 条)——真 DDL + 两道护栏(DataModel写面 8 条(CREATE/ALTER/DROP TABLE+addFields+Copy+Export/Import)db_ident+ddl_tables内置表清单)- 官方
checkTab的「内置表 / 有数据」双闸。数据建模三页现在真能用。
- 官方
✅ 批次 8 做完(实际 18 条)——新表systemData的Dataset(16)base_data_set/base_data_set_relation;CRUD + 设计器get/save+ 六条取数 (Preview/List/InfoByIds/getRes/previewSql/fields)+ 下拉 + 恒失败的导出导入。 真执行 SQL,三道护栏 +${xxx}/@xxx全绑定。✅ 批次 9 做完(实际 39 条)——新表 6 张(DataInterface(12) +InterfaceOauth(11) +system/printDev(17)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 做完(实际 31 条)——新表 6 张(Signature(7) +ModuleButton(7) +ModuleColumn(6) +ModuleForm(6) +AdvancedQuery(5)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。
docs/contract.md 三处登记必须同步,否则 CC10 / CIT2 会红。
4. 每批实现的固定动作(缺一不可)
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
新增/变更端点必须同步三处,否则闸门必红:
docs/contract.md的[ENDPOINT](面 B 行首列写B)与[OFFICIAL](absent → implemented)docs/contract.md的[FACE]计数 +[RULER]里perm-smoke-jnpf.sh的断言数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写 SQLnow()时不占参数位:marks.push("now()")而非placeholder(), 否则$n序号和columns错位(报column is of type timestamp but expression is of type text)。 - 🔴 写路径只
SETbody 里出现过的键,未出现的列必须保持原值(有断言钉住)。 - 🔴 读回不选
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」)。
6. 收工前(每一轮都要做)
- 追加
.workbuddy/memory/YYYY-MM-DD.md:结论 / 坑 / 数字(闸门通过数) - 更新本文件 §1 现状、§2 现场、§3 待办(划掉做完的)
- 若还有未完成项,确认下一次定时任务存在(
automation_updatelist 可查),没有就新建