Commit Graph
20 Commits
Author SHA1 Message Date
admin fe9f84b7c1 refactor(skill): 改为依赖已发布的 sspf v0.4.0,删除自研平台、迁入示例业务包
- 平台改由 sspf 门面提供(workspace 锁 git tag v0.4.0),应用瘦成 ~500 行薄壳
- 删除 src/backend/src/platform(17 文件)、routes.rs、bootstrap.rs、db/schema.sql、7 个旧集成测试
- 迁入 4 个示例业务包 packs/{demo,shop,books,asset},依赖从 sspf-sdk 改门面 sspf
- 新增 check-scaffold.py(SC1-SC6 + 反自证 6/6)、重写 pack-sync.py、新增 new-pack 与 verify.sh
- 删除测「本仓平台实现」的四把静态闸门(platform 搬走后无测量对象,留着即假绿)
- 契约补入 asset:MENU_TREE 9 菜单、ENDPOINT +3、FACE A=28
- 前端 dist 入库(后端直接托管,免 npm build)
- 验收:check-scaffold 6/6 + 自证 6/6;perm-smoke 32/32;perm-smoke-jnpf 18/18;verify.sh 7/7
2026-11-04 22:36:13 +08:00
adminandClaude Code 96594df72f feat(repo): 平台层/业务层分离收尾 + 六道闸门(把「尺子」变成机器)
**影响**
后端从「平台层里塞业务知识」改成「装配根 + 业务层自带 spec/菜单/路由」;闸门 5 道 → 6 道,
契约尺子 2 条 → 3 条;两把尺子**默认自起隔离后端** ⇒ 不用先起后端就能冒烟(CI 可跑)。
单测 220 passed / 0 failed;静态闸门 93 + 11 + 10 + 4 全绿;面 A 32/32、面 B 18/18 全绿。

**改动**
- 后端:新增 `platform/guard.rs`(生产档弱口令守卫六条判据 + 配置级/库内级两道检查)、
  `platform/menu.rs`(菜单 spec 的类型)、`bootstrap.rs`(装配根:唯一同时认识平台层与业务层的地方);
  业务模块的菜单与路由下沉到 `modules/<app>.rs`,平台层只 `merge(modules::router())` 一次。
- 闸门:新增 `check-boundary.sh`(分层红线 CP1–CP6)、`check-contract.sh`(契约端点表 + 官方端点台账
  ↔ 代码真实路由,CC2–CC10)、`check-citations.sh`(文档引文 `路径:行号` 逐条核对);
  `check-module.sh` 改为从契约期望值派生(63 → 93 条);三把尺子各带反自证用例。
- 契约:`docs/contract.md` 附录 A 扩成机器可读区段(`[ENDPOINT]` / `[FACE]` / `[OFFICIAL]` / `[RULER]` …)
  ⇒ 六把尺子的期望值只有一处;`[OFFICIAL]` 官方端点台账 53 行四态 ⇒ 覆盖 **8/47**(算出来的)。
- 尺子:`scripts/smoke_backend.sh` 让两把契约尺子默认自起隔离后端(显式给了 `B` ⇒ 不自起、不可达即退出码 2)。
- 文档:CLAUDE.md / SKILL.md / README.md / HANDOFF.md / HOWTO_MODULE.md / docs/* 同步到新结构与新闸门;
  裁决 96 → 98 条(P91 尺子自起设计、P92 官方端点覆盖账本)。

Co-Authored-By: Claude Code <[email protected]>
2026-10-27 11:33:25 +08:00
adminandClaude Code ab8833af28 refactor(backend): 平台层 / 业务层分离 —— 加业务模块只碰 modules/
后端从平铺(src/{config,db,cipher,…,entities}.rs)改两层,对齐 react 版的
common+auth+sys / demo+shop+books 与官方 JNPF 的 jnpf-common+jnpf-system / jnpf-admin。

- 平台层 src/platform/:契约实现(config·db·cipher·envelope·ids·session·state·
  auth·permission·seed·sys·jnpf·entity·crud)—— 加业务模块不动
- 业务层 src/modules/:mod.rs + demo/shop/books,各自带 spec + 3 条路由 + 自己的 router()
- routes.rs 变成「平台路由 + 一次 merge(modules::router())」,业务路由不再登记在平台层
- 业务路由清单也搬到业务层(modules::ALL_ROUTES),平台层钉子测试遍历它
  ⇒ 原来「每加一模块要改 routes.rs 路由表」的口子被堵死
- 清掉平台层最后一个业务知识泄漏:S22 的 f_creator_user_id 规则原在引擎里写死
  app_code == "demo",改为业务 spec 自己声明(EntitySpec.creator_fixed)
- check-module.sh 新增反向断言(平台层不得注册业务路由)+ 正向断言(业务层须登记)
  ⇒ 断言 57 → 69
- 文档同步(SKILL/CLAUDE/README/HANDOFF/PERMISSION/MIGRATION/HOWTO_MODULE/contract),
  新增红线「平台层不许出现业务表名 / app_code」;decisions.md 补 P81

验证:cargo build --release 0 error 0 warning · cargo test 197 passed / 0 failed ·
check-module.sh PASS=69 FAIL=0 · 面 A PASS=32 FAIL=0 · 面 B PASS=18 FAIL=0 SKIP=0

Co-Authored-By: Claude Code <[email protected]>
2026-10-26 17:26:21 +08:00
adminandClaude 7c4ae39664 refactor(skill): 仓根即技能本体 —— 技能资产进版本控制 + 三处软链指向同一仓
影响:此前技能资产(SKILL.md / HOWTO_MODULE.md / PERMISSION.md / MIGRATION.md /
JNPF_SOURCE_AUDIT.md / JNPF_COMPAT_SURFACE.md / references/ / template-boot-jnpf/)
实体住在 ~/.agents/skills/ssw-jnpf-lite-rust/(仓外、不在 git)⇒ 改仓不生效、实体与仓漂移。
现在仓根 = 技能根(对齐 ssw-jnpf-lite-react 的形态),~/.agents · ~/.claude · ~/.workbuddy
(+ ~/.qwenworkcn)四处软链全部解析到同一个仓 ⇒ 改一次仓 = 改一次技能。

改动:
- 新增根级技能文档 6 份:SKILL.md(并补 frontmatter:name/description/type,原文件没有 frontmatter
  只靠目录名兜底)/ HOWTO_MODULE.md / PERMISSION.md / MIGRATION.md / JNPF_SOURCE_AUDIT.md /
  JNPF_COMPAT_SURFACE.md;references/ 与 template-boot-jnpf/ 一并入仓
- 根 README.md 改为技能版(选型/运行/验收门/已知限制),旧项目版 README 移入 docs/README-project.md
- docs/ 下 3 份与根级同源的文档删除(技能版取代),全仓链接改指根级(已修全部相对链接,无坏链)
- docs/ 保留契约真源 contract.md / runbook.md / decisions.md / known-limitations.md / ddl/
- Cargo.toml 取「技能版注释 + 仓版补充」合并;run.sh 用仓版(多旧名兜底 pkill)
- SKILL.md 补 frontmatter + 「技能目录 = 仓根」说明;CLAUDE.md 目录速览同步;HANDOFF.md 技能资产
  描述同步;工作日志补第三段

验证:cargo build --release 0 error · cargo test 195 passed/0 failed · check-module.sh PASS=57
FAIL=0 · 面 A 尺子 PASS=32 FAIL=0 · 面 B 尺子 PASS=18 FAIL=0 SKIP=0(覆盖 18/18)

Co-Authored-By: Claude <[email protected]>
2026-10-26 16:56:58 +08:00
adminandClaude Code 8b24bb1aea refactor(name): 项目正式名称统一为 ssw-jnpf-lite-rust
**影响**:仓库/目录/二进制/契约里的项目标识全部换成 `ssw-jnpf-lite-rust`,
旧名 `tds-lite-rs`(曾误写 `tdc-lite-rs`)不再出现在任何代码、脚本或文档里。

**改动**
- Cargo:`package`/`[[bin]]` → `ssw-jnpf-lite-rust`,`[lib]` → `ssw_jnpf_lite_rust`;
  `Cargo.lock` 随之重生成
- 运行期:`jnpf.rs` 的 `SYSTEM_ID`/`SYSTEM_CODE` → `ssw-jnpf-lite-rust`
  (面 B 响应的 `currentSystemId`/`systemCode`/菜单 `systemId` 兜底值随之变化);
  `main.rs` 的 `--help`/`--enc`/启动与停止日志文案
- 脚本:`run.sh` 二进制路径与 `pkill` 模式(**保留旧名兜底 pkill**,收掉改名前起的老进程);
  `perm-smoke.sh`/`perm-smoke-jnpf.sh` 的 `ENC_BIN` 默认路径、`App-Code` 头、提示文案;
  `check-module.sh`;`.env.example`
- 文档:`CLAUDE.md`/`README.md`/`HANDOFF.md`/`docs/*.md` 全文;
  `HANDOFF.md` §1 第 5 条决策改为「正式名称,2026-10-26 改定」,原方案 `tds-lite-rs` 标为已推翻

**验收**:`cargo build --release` 0 error 0 warning · `cargo test` 195 passed / 0 failed ·
面 A 冒烟 PASS=32 FAIL=0 · 面 B 冒烟 PASS=18 FAIL=0 SKIP=0 · 静态自检 PASS=57 FAIL=0 ·
`--enc 123456` 输出与上游检验向量逐字一致

Co-Authored-By: Claude Code <[email protected]>
2026-10-26 12:36:06 +08:00
adminandClaude Code 806f9f8454 feat(jnpf): 面 B(官方 JNPF 契约面)S1–S6 全部落地 —— 双面后端成形
影响:同一进程现在同时提供面 A(ssw/react 契约,27 条,冻结)与面 B
(官方 JNPF 形状,5 条新增 + 2 条共用按判别头分流)。官方 JNPF 前端
可以直接打在本仓上;两把尺子由「面 B 覆盖 5/18」走到「18/18 全绿」,
面 A 尺子零回归(仍 PASS=32)。

改动:
- src/backend/src/jnpf.rs(新):判别头 `Vue-Version: 3` · `PcUserVO` 5 字段
  · `PageListVO` / `ListVO` 分页信封 · 点权限守卫 · 5 个官方 RESTful 端点。
- src/backend/src/permission.rs:新增 `has_en_code_permission()` —— 第二套
  判据(按 `base_module.f_en_code`),结构同面 A:管理员短路 → 查授权 →
  未映射放行 → 四源成员 → DB 出错拒绝。
- src/backend/src/auth.rs:`require_login_any()` —— 面 A 未登录 `600`、
  面 B 未登录 `602`(官方前端只对 `601`/`602` 清 token ⇒ 返 `600` 会卡死)。
- src/backend/src/envelope.rs:码表补齐 `401`/`500`/`601`/`602`。
- src/backend/src/routes.rs:注册面 B 5 条路由 + 两个路由表钉子测试
  (`route_table_is_pinned` 27 条 / `jnpf_route_table_is_pinned` 5 条)。
- src/backend/src/seed.rs:8 条内置菜单补 `f_en_code`(存量行只补 NULL,
  不覆盖已改值、不复活已删);src/backend/src/sys.rs:`query_param` 放开
  供面 B 复用官方分页参数。
- 文档同步:CLAUDE.md(红线 10/11 + 端点全表拆两面)、README.md、
  HANDOFF.md、docs/{contract,runbook,MIGRATION,JNPF_SOURCE_AUDIT,
  JNPF_COMPAT_SURFACE,known-limitations}.md。

设计:两套权限判据**并存**(面 A 按菜单路径、面 B 按点权限)⇒ 同一用户
可能面 A 通、面 B 拒,这不是 bug。`permissionList` 粒度 = 每菜单一条
(`modelId` = 菜单 id),依据官方前端 dynamicModel/list/index.vue:739
做 `permissionList.find(o => o.modelId === menuId)` 且容忍缺项。

已知偏差 B1–B10 记在 known-limitations.md §H(授权读 list 空数组 ·
sysConfigInfo={} · 无按钮级权限 · 无数据级权限 · 无导入导出 ·
缺 secretkey 一步 · 业务菜单 f_en_code 是自拟占位 · AsyncList 未分页)。

验证:cargo test 195 passed / 0 failed(8 个测试目标);
perm-smoke.sh(面 A)PASS=32 FAIL=0;
perm-smoke-jnpf.sh(面 B)PASS=18 FAIL=0 SKIP=0;
check-module.sh PASS=57 FAIL=0。

Co-Authored-By: Claude Code <[email protected]>
2026-10-26 11:28:47 +08:00
adminandClaude Code c055e1b634 fix(auth): 契约措辞对齐 + DB 报错文案 + 补三条测试钉子 + cipher 去 expect
Co-Authored-By: Claude Code <[email protected]>
2026-10-25 23:32:07 +08:00
adminandClaude Code 15469ea635 docs(contract): §5.1 划清「两版后端可开同一个库」的适用范围(Ruling P47)
「两版后端可开同一个库」这句话原文只挂在 3 张业务表上;base_* 7 张是官方 DDL 逐字,
而 react 的 base_* entity 只是子集 ⇒ react 后端打不开本仓的库(synchronize 会 ALTER)。
补一段显式注解:写以官方 DDL 为准,读以 react entity 列集为准(§5.3)。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 21:38:45 +08:00
adminandClaude Code a77d8c1769 docs(spec): §7.2/§7.3/§7.4 回写「只 SET body 里出现的键」全局规则(Ruling P42)
§7.1 早已写明「只覆盖 body 里出现的键,undefined ⇒ 不动原值」,但 §7.2/§7.3/§7.4
只是没重复这句 ⇒ 逐字实现会把 f_url_address / f_icon / f_en_code / f_description
在 body 缺该键时写成 NULL/空。

🔴 承重之处:菜单的 f_url_address 是 §8.2 权限守卫的比对键 ⇒ 被清成 NULL ⇒
该菜单变成「未映射」⇒ 守卫走「未映射放行」⇒ 任何登录用户都能访问该模块(静默越权)。

本次回写:
- §7 开头加全局规则(react / TypeORM save 的 undefined 语义),并写明例外:
  凡显式给出 `?? 原值` / `|| '0'` / `? 1 : 0` 兜底表达式的列,一律按表达式求值。
- §7.2 Role / §7.3 Organize / §7.4 Module 的更新条目统一标注「body 有才覆盖」。
- 标注 f_url_address 的越权风险。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 21:26:23 +08:00
adminandClaude Code aa45da8e29 docs(spec): §11 验收门① 的 release profile 去掉 panic="abort"(Ruling P19)
§6.5 要求 panic ⇒ HTTP 200 + code=400,而 panic="abort" 下 catch_unwind
抓不到 panic(进程直接 abort ⇒ 客户端连接重置)。Ruling P19 已决定保留默认
unwind,但 §11 的表格里仍写着 panic="abort",与 Cargo.toml 现状矛盾 ——
按契约写的实现者会把 panic="abort" 加回去。此处消除矛盾。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 21:11:11 +08:00
adminandClaude Code 0fef2fbfb7 docs(spec): 投影别名改双引号(PG 折叠未加引号的标识符)
Task 3 实现者实测发现:PostgreSQL 把未加引号的别名折叠成小写 ——
`SELECT row_to_json(q)::text FROM (SELECT 1 AS realName) q` ⇒ {"realname":1},
写 AS "realName" 才是 {"realName":1}。规格原先给的示例(§R1.4 / §5.2 / §5.3)
照抄会**静默**产出小写 JSON 键 ⇒ 前端读不到字段。

- §R1.4 / §4 / §5.2 / §5.3:规范写法改为 `f_xxx AS "<JSON键>"`(带双引号)。
- §5.4:登记 db.rs 的键归一为**安全网**(能兜住漏引号的写法),但规范写法不依赖它。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 18:07:45 +08:00
adminandClaude Code 349aeef06f docs(spec): 规格 §9 对齐 pglite::Error 与 state.rs;release 去掉 panic=abort
- §9 crud.rs 三个签名统一成 `pglite::Error`(原写的 `DbError` 未定义)
- §9 lib.rs 清单补 `pub mod state;`(Ruling P14:AppState 归 state.rs,Task 4 是 lib.rs 唯一写入者)
- 根 Cargo.toml 去掉 `[profile.release] panic = "abort"`:
  规格 §6.5 要求 panic ⇒ HTTP 200 + code=400,而 abort 下 catch_unwind 抓不到
  panic(进程直接死 ⇒ 客户端连接重置)。catch-all 中间件依赖默认 unwind。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 17:50:06 +08:00
adminandClaude Code 28de290be5 docs: 业务表 DDL 逐字对齐 react entity(列宽 + f_stock 默认值)
读 react 三个 business entity 源码后发现原 DDL 描述有 3 处偏差:
- demo_item.f_status 实际 varchar(32)(原写 50)
- book_shop_book.f_isbn 实际 varchar(32)(原写 50)
- book_shop_book.f_stock 实际带 default: 0(原写「只有 f_delete_mark 有默认值」)

第三处是真契约分歧:§7.6 路径 2(带 id 但行不存在)在 react 里 f_stock 得 0,
按原描述实现会得 NULL。已同步修正 §5.1 与 §7.6。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 17:42:45 +08:00
adminandClaude Code f44b3000a0 docs: 定死 lib.rs 归属、schema 幂等口径、cipher 失败文案
- §9:AppState 落独立 state.rs,lib.rs 的唯一 owner 是 Task 4(只加一行 pub mod state;)
- §5.5:schema.sql 只在 base_user 不存在时整体执行一次;索引带 IF NOT EXISTS
- §3 / §6.1:decrypt_to_md5 返回 None ⇒ 登录回 400 '账号或密码错误'(与 react 同形,不另造文案)
- §3:明确不加「解密结果长度 == 32」的额外校验(react 没有)

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 17:34:35 +08:00
adminandClaude Code 0de161ddef docs: 补 panic 兜底信封与 405 传输层状态码
- R1.2 / §6.5 / §10:未捕获异常(panic / DB 报错)⇒ HTTP 200 + code=400
  + msg='系统异常,请联系管理员'(对齐 react 全局 ActionResultFilter 兜底)
- §6.5:405 定死为 HTTP 405 + {code:405,...},保留 Allow 头;
  未知路由仍是唯一的 404 传输层例外
- §10 第 6 步:链尾加 catch-all 中间件(不能漏出 axum 默认 500 空 body)

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 17:31:49 +08:00
adminandClaude Code 1db2f0a1db docs: 修正投影别名铁律(AS 必须用 camelCase JSON 键)
row_to_json 用列的输出名当 JSON 键。原 §5.2 示例写的是 `AS creator_time`,
照抄会得到 `"creator_time"` 而 react 是 `"creatorTime"` ⇒ 前端字段全读不到。
§5.2/§5.3/R1.4 补上「每列显式 AS <JSON键>」并给出正确示例。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 17:21:08 +08:00
adminandClaude Code c927632dd9 docs: 规格 §7 按 react 源码逐字重写(9 处修正 + 1 处刻意偏离)
- §7.1–§7.6 逐条核对 react 源码后重写:User 更新也查重 / 总是覆盖
  isAdministrator·organizeId;Role 更新不查重不碰 sortCode;Role 删除不带
  itemType 过滤;Module 删除不带 objectType 过滤;Organize·Module 不写
  creatorUserId;业务模块保存有三条路径;roleNames 查不到就跳过。
- §7.7 记录唯一刻意偏离:User Save 响应剥掉 password(react 泄露 md5 摘要,
  可被重新加密成合法登录密文)——R1.6 优先于逐字一致。
- §6.3 授权端点:objectType 被忽略(一律落 f_object_type='role'),与 react 一致。
- §5.1 业务表只有 f_delete_mark 带 DEFAULT 0(§7.6 路径 2 依赖它)。
- §13 冒烟脚本:cipher 用后端 --enc、JSON 用 jq/python3、菜单树写字面量、
  后端地址默认 127.0.0.1:30010。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 17:17:22 +08:00
adminandClaude 4a7805ad65 docs: cipher 向量独立验算通过,修正长度断言(96 hex 字符,非 64)
Co-Authored-By: Claude <[email protected]>
2026-10-25 17:09:34 +08:00
adminandClaude 6b8c30ebb3 docs: 规格补齐 LoginForm 定义与登录端点原始 body 解析注记
Co-Authored-By: Claude <[email protected]>
2026-10-25 17:05:49 +08:00
adminandClaude 0aed12a102 docs: 契约规格 + 实施计划 + 官方 base_* DDL 原文
- docs/contract.md: 唯一规格来源(信封/cipher/端点/权限/种子/验收门)
- docs/ddl/base_ddl_raw.sql: 从官方 JNPF dump 逐字提取的 7 张 base_* DDL
- CLAUDE.md / HANDOFF.md: 项目级 agent 指引与交接文档

Co-Authored-By: Claude <[email protected]>
2026-10-25 17:05:00 +08:00