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
|
f10fb85832
|
docs(log): 补记 2026-10-27 —— 尺子化四条落地与验证
P0-1(契约端点表机器可读)· P0-4(引文闸门)· P0-3(尺子自起隔离后端)·
P1-8(官方端点覆盖账本);含三条端到端漂移证明与顺手改掉的真问题清单。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-27 11:33:36 +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
|
a9e5e9f937
|
docs(log): 补记远端仓名对齐 ssw-jnpf-lite-rust
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 17:45:44 +08:00 |
|
 adminandClaude Code
|
c75c26cd93
|
docs(log): 补记 react 姊妹技能三处软链补齐
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 17:35:45 +08:00 |
|
 adminandClaude Code
|
60003fed16
|
merge: 后端平台层/业务层分离(refactor/backend-layering)
平台层 src/platform/ + 业务层 src/modules/,加业务模块只碰业务层。
契约零改动(面 A 32 / 面 B 18 条尺子全绿,单测 197 通过)。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 17:26:33 +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
|
5350fc6400
|
feat(spec): 官方 JNPF 对齐三件套 + 第二把尺子(面 B 规格落地前的地基)
- docs/JNPF_SOURCE_AUDIT.md:官方 Java/Vue 源码逐行核对(标 文件:行号),
差异清单 D1–D8(端点风格 / 列表响应 / CurrentUser 形状 / 码表 / 菜单接口 /
鉴权模型 / 请求头 / 口令存储)。
- docs/JNPF_COMPAT_SURFACE.md:面 B 规格 —— 官方形状的端点 / 响应 / 码表 /
分流规则 / 落地顺序 S1–S6。
- docs/MIGRATION.md:本仓 ↔ 官方逐项映射 + 数据 ETL + 口令 secretkey 换算
(一次性换算即可,不需要明文)。
- scripts/perm-smoke-jnpf.sh:第二把尺子,18 条官方形状断言;未落地记 SKIP
且不计入 PASS(当前 PASS=5 FAIL=0 SKIP=13 ⇒ 覆盖 5/18)。
fix(spec): 面 A/面 B 判别头纠错 —— 改用 `Vue-Version: 3`
规格初稿断言「本仓前端一个官方头都不带」并用 `Jnpf-Origin: pc` 判面,
但本仓前端 request.ts:35-36 **也发** App-Code 与 Jnpf-Origin(与官方同款)
⇒ 按字面实现会把每个面 A 请求都误判成面 B。三个官方头里只有 Vue-Version
是本仓前端唯一不发的 ⇒ 判别只能用它。已在规格(§2.2 / D7 / A13 / §3.7)
统一改正,并在 check-module.sh 的「全局红线」段静态钉住两侧:
本仓前端禁发该头 + 面 B 尺子必带该头。
docs: 导航文档补链 + 已知限制新增 §H
CLAUDE.md 红线加第 9 条(判别头)、README.md 目录与「第二把尺子」、
HANDOFF.md §0/§6/§9(已知限制 + 下一步 S1–S6)、known-limitations.md §H
(面 B 只有规格没有实现 / 缺 secretkey 一步 / 判据是菜单路径不是点权限 /
码表缺 602)。
验证:cargo test 179 passed / 0 failed;check-module.sh PASS=57 FAIL=0;
perm-smoke.sh(面 A)PASS=32 FAIL=0;perm-smoke-jnpf.sh PASS=5 SKIP=13。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 10:37:20 +08:00 |
|
 adminandClaude Code
|
ed106a272e
|
docs: 记录 Dashboard 顶层菜单无按钮这一继承限制
影响:登录后的 Dashboard「功能菜单」只渲染二级节点 ⇒ `Demo 示例` /
`产品管理` / `图书超市` 三个顶层业务菜单只有标题、没有可点按钮,
只能按 URL 直达。读者按业务手册找入口会扑空。
改动:known-limitations.md 的「D. 前端层」新增 (ac) 行,写清
成因(react 版逐字复制,前端只允许改 vite 代理端口)、契约未覆盖
的理由,以及代价(UI 无侧栏入口,门④ 浏览器自验按 URL 直达)。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 08:41:57 +08:00 |
|
 adminandClaude Code
|
5721e6e29e
|
docs: 修正单测计数漂移(177 → 179)
影响:README 与 HANDOFF 的「验收四门」表里,单测数字写的是 177,
实际 `cargo test --release` 是 179(lib.rs 63→65,R=3 修复轮补的用例)。
读者按文档核对会以为少了 2 个用例。
改动:README.md、HANDOFF.md(3 处)里的计数改为 179,
并同步「8 个测试目标:63+…」的分解为 65+6+19+24+3+18+7+37(合计 179)。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 05:53:50 +08:00 |
|
 adminandClaude Code
|
1143238479
|
docs: 决策记录与已知限制从 SDD 过程草稿提升为受版本控制的正本
影响
- 交付物里多了两份「代码之外的为什么」:docs/decisions.md(实施期 88 条裁决:
什么 — 为什么 — 判错了的代价)与 docs/known-limitations.md(被接受/挂起的限制)。
这两份原本只存在于 .superpowers/sdd/<plan>/ 下的 git-ignored 过程草稿里,
草稿清理后就会消失;现在随仓库走。
- README / CLAUDE.md / HANDOFF.md 各自补上指向它们的入口。
改动
- docs/decisions.md(新增):从 ledger 抽出 88 条裁决正文(P1–P80 的实现期裁决 +
F1–F12 的最终整体评审裁决),去掉逐条验证输出与任务流水;按编号排序。
- docs/known-limitations.md(新增):分支级已知限制清单正本(A–G 分节,顺序已修正)。
- HANDOFF.md:§1 补「实施期 88 条裁决另见 docs/decisions.md」;已知限制摘要指向正本。
- README.md / CLAUDE.md:文档树与入口补齐。
设计
- 保留裁决正文而不是整份 ledger:ledger 混着大量一次性验证输出与任务流水,
对下一个读者是噪声;裁决本身才是「为什么这样写代码」的长期资产。
- 编号 P34/P35 在 ledger 里只有引用、没有独立条目,故正本中不出现。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 05:50:16 +08:00 |
|
 adminandClaude Code
|
4611d75c39
|
fix(final): 复核后 4 处收尾 + 已知限制正本化到 docs/
影响
- 停机路径的输出从「一律说已优雅关闭」改为「按实际是否校验过来说」:临时库模式
(PGLITE_DIR=memory://)下数据目录不可知 ⇒ 如实报「未校验」,不再给没校验过的断言。
- IPv6 绑定时启动横幅是合法 URL(http://[::1]:30010),此前是非法的 http://::1:30010。
- run.sh stop 给后端 3 秒宽限(与后端自己给嵌入式 PostgreSQL 的 3 秒预算对齐),
此前 1 秒就 SIGKILL,正好把「PG 被 SIGKILL 打断 ⇒ 下次 crash recovery」又打回来;
进程提前退出就立刻收工(0.2s 一跳轮询),stop 总耗时从 4.4s 回到 0.8s。
- 模块文档与实际改写层对齐(该层现在同管 405 与 413)。
- 已知限制清单从 git-ignored 的 SDD 过程草稿提升为受版本控制的 docs/known-limitations.md,
HANDOFF 的指向同步改到它 ⇒ 草稿清理后引用不悬空。
改动
- run.sh:stop_pid 增加宽限参数(后端 3s / 前端 1s),宽限改为轮询存活、提前退出即收工。
- src/backend/src/main.rs:横幅按 IPv4/IPv6 分别拼 URL;停机结论区分「已校验且已关库」
/「已校验但没关掉」/「临时库模式未校验」三种;模块文档补 413。
- docs/known-limitations.md(新增):分支级已知限制清单正本,含本轮新记的 (aa)(ab)。
- HANDOFF.md:已知限制摘要的编号与全局清单对齐,指向 docs/known-limitations.md。
设计
- 「第二次停机信号不再强杀」与「用 process::exit(0) 收尾」两条不修:前者收尾有界(≤3 秒),
动刚写好的信号路径收益仅是省几秒;后者是刻意设计(pglite 收尾线程可能卡死,
不能让它吊住进程),且与改动前行为一致。两条已记入 known-limitations (aa)(ab)。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 05:47:44 +08:00 |
|
 adminandClaude Code
|
1539892d86
|
fix(final): 前端就绪校验 + 绑 127.0.0.1 + 413 信封化 + 优雅停机 + 文档事实修正
- run.sh: dev 增加前端就绪轮询(60s),失败收前端(PID 文件 + 按端口兜底)、打印 frontend.log 尾部、退出码 1,并写明后端仍在运行
- 后端默认只监听 127.0.0.1(BIND_ADDR 可覆盖,非法值回落 127.0.0.1),横幅打印实际绑定地址
- 响应改写层新增 413 ⇒ 信封(保留 HTTP 413 状态码),并补一条 >2MB body 的单测
- SIGTERM/SIGINT 优雅停机:先收完在途请求,再关嵌入式 PG(数据目录不再留 postmaster.pid)
- 文档事实修正:畸形百分号编码的假断言、memory:// 的口径、模块表 API、门④命令、端口口径、token 实际寿命
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 05:22:57 +08:00 |
|
 adminandClaude Code
|
621e636e76
|
fix(task12): run.sh 的 PORT 守卫只对 dev/backend 生效 + dev 就绪失败一并收掉前端
- 端口守卫从「case 之前」收进 guard_port() 函数,只在 dev / backend 两个分支里调用
(这两个才真的会起后端并让后端继承 PORT);--help / 无参 / logs / install / build /
stop / frontend 完全不受 PORT 影响。守卫仍在 kill_ports 之前 ⇒ 用法错不破坏现场。
报错三行文案与退出码 2 保持不变;export PORT="${PORT:-30010}" 留在原处。
- dev 的就绪失败分支:用 stop_pid 按 PID 文件把本次刚起的前端一并收掉(不用 pkill),
输出一行「前端进程已一并收掉」,再照旧打印 backend.log 尾部 20 行并 exit 1
⇒ 不再在 5173 上留残进程。
- docs/runbook.md 的端口说明同步收窄,并补「dev 失败时前端一并收掉」。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 04:20:11 +08:00 |
|
 adminandClaude Code
|
c249f4167f
|
fix(task12): run.sh 收窄 pkill + dev 就绪校验 + PORT 硬约定;HANDOFF §4/§5 对齐事实;check-module api 期望表
- run.sh stop:pkill 模式收窄到 target/release/tds-lite-rs,删掉 pkill -f "vite"
(vite 交给 kill_ports 5173 按端口收);dev/backend 的二进制存在性检查提到
kill_ports 之前;dev 起完轮询 /api/health(最长 30s),不通则打印 backend.log
尾部并 exit 1;PORT ≠ 30010 明确报错 exit 2;mkdir 从文件顶部挪进 dev/stop/logs。
- scripts/check-module.sh:期望值表新增「前端 api 文件该有没有」(demo=无,
shop/books=有)⇒ 期望有而文件缺失直接 ❌,不再打误导性绿灯;补 set -u 取舍注释
与「新增模块须同步期望表」注释。
- HANDOFF.md §4:去掉把 abort 型 panic 写成 release 配置的错误表述,②③ 门改成
实测值(177 passed / 0 failed、32 条断言);§5 step 11/12 对齐事实;§9 补记
exec 退出码透传与 stop 的实际停止路径。
- .gitignore 追加 src/backend/data.bak-*/;docs/runbook.md 同步本轮口径与记档项。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 04:09:13 +08:00 |
|
 adminandClaude Code
|
8edcd3507d
|
feat: 前端逐字复制(仅代理端口改 30010)+ run.sh + check-module.sh + 文档
前端:从 ssw-jnpf-lite-react/src/frontend 逐字复制(package-lock.json 一并复制),
唯一改动 = vite.config.ts 的代理目标 30000 → 30010(含紧邻注释行的端口);
src/api/request.ts 的注释与 axios timeout: 30000 逐字节保留。
脚本:run.sh(install/build/dev/backend/frontend/stop/logs,退出码 0/1/2,
kill_ports 只清 30010 与 5173);scripts/check-module.sh(9 接触点静态自检,
纯静态零 node 依赖)。
文档:README.md、docs/runbook.md、.env.example;CLAUDE.md 逐条核对并与代码同步,
HANDOFF.md §0 状态表与 §9 交接话术改为交付态。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 03:26:22 +08:00 |
|
 adminandClaude Code
|
8366a3745f
|
fix(smoke): 断言类型保真(numeric 必须 JSON 字符串)+ token 空值 + curl 超时 + JQ_BIN 可覆盖
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 02:47:24 +08:00 |
|
 adminandClaude Code
|
c97ee833a8
|
feat: 权限闭环冒烟脚本(32 条断言,逐条对齐 react 版)
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 02:26:21 +08:00 |
|
 adminandClaude Code
|
433bf5d09a
|
docs(main): 装配链的唯一权威指向 routes::build_app
修复轮 R=1 的 scoped re-review 指出:main.rs 模块级文档第 6 步仍写成
「build_router(state) + 404 兜底 + 405 改写中间件 + catch-all 中间件 + with_state」,
把读者指向 main.rs,而那条链本轮已迁到 routes::build_app(唯一真源)。
改写该条,指向 routes::build_app(state) 并保留 S25 的顺序说明。
⚠️ 续行一律不以 `+` 开头 —— rustdoc 会把它当**嵌套列表项**,
随后的续行就成了该嵌套项的 lazy continuation ⇒ 触发 clippy 的
`doc_lazy_continuation`(doc list item without indentation)⇒ 告警数会从 6 变 7。
改用 `→` 作分隔符后告警数回到 6(全为既有)。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 02:18:48 +08:00 |
|
 adminandClaude Code
|
c906b7d8e8
|
refactor(routes): 装配链单一真源 + 405 无条件改写 + 子命令退出码可测 + 路由表钉子测试
必改 1:新增 routes::build_app(state) -> Router 作为**唯一权威的装配链**
(build_router → .fallback(404 兜底) → .layer(405 改写) → .layer(catch-all)
→ .with_state 链尾)。main.rs 第 6 步与 routes.rs 的测试辅助都只调它,
那条链在仓库里只剩一份 ⇒ 改顺序时生产与测试一起变。
build_router 的签名一个字未改(仍收 state、仍返回 Router<AppState>)。
必改 2:405 改写中间件**无条件**改写任何 405(不再看 body 是否为空),
杜绝「有 body 的 405 漏出非信封 body」这个唯一破口;非 405 原样放行。
必改 3:build_router 的文档注释改为如实说明——内部那次 with_state 是类型
层面的 no-op,真正喂状态给 handler 的是链尾那次;两次拿到的是同一个
AppState 的两个 clone,而三个字段全是 Arc ⇒ 共享同一份底层状态。
必改 4:子命令解析抽成纯函数 parse_args(&[String]) -> Cmd + exit_code(&Cmd)
(不读环境变量、不退出进程),补 6 条单测覆盖每种 args 的退出码:
--enc 0 / --enc 缺参 2 / --help 0 / -h 0 / 未知参数 2 / 无参 = Serve。
必改 5:补两条测试——路由表钉子测试(27 条路径逐条用「错方法 ⇒ 405」探测,
外加一条未注册路径 ⇒ 404)与「非 405 响应原样穿过改写中间件」。
未动:sys.rs / crud.rs / entities.rs / auth.rs / db.rs / config.rs /
envelope.rs / seed.rs / state.rs / lib.rs / Cargo.toml / docs/contract.md /
scripts/ / src/frontend/ / db/schema.sql / src/backend/tests/;未加任何依赖。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 02:05:48 +08:00 |
|
 adminandClaude Code
|
b21b9448da
|
feat(routes): 27 条路由装配 + 404/405/catch-all 三层兜底 + main 启动装配
routes.rs:逐条注册 27 条路由(axum 0.8.9/matchit 0.8.4 不支持 {a,b}
多参数写法 ⇒ 每条具体路径单独注册);`auth::current_user` 收 &AppState
⇒ 用闭包包一层;探活端点 /api/health 返 {ok,tables,version}。
三层兜底(控制器裁决 S25 的顺序):build_router → .fallback(404 兜底)
→ .layer(405 改写) → .layer(catch-all) → .with_state(链尾)。
404 显式配 StatusCode::NOT_FOUND(fail() 恒 200);405 只改写「405 且
body 为空」的响应并保留 Allow 头;catch-all 只接 panic(DB 报错已在
handler 内被 db_error 接住),用 catch_unwind 手写,不引 tower/futures。
main.rs:按契约 §10 的 7 步装配 —— resolve_project_dir(从可执行文件
向上找 schema.sql + Cargo.toml 锚点,与 cwd 解耦)→ Config::from_env
→ 标识符白名单自检(开库之前,不过则打印人话并 exit 1)→ 开库建表
→ 两段式种子(失败 exit 1)→ 路由装配 → 绑定端口(失败 exit 1)。
子命令:--enc <明文> 打印 hex(退出码 0)、--help 打印用法、未知参数退出码 2。
不实现静态托管(Ruling P79);DDL 绝不可从 HTTP 下载由「不托管任何
文件」天然满足,另加 /db/schema.sql 与 /src/backend/db/schema.sql ⇒ 404 的守卫测试。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 01:41:56 +08:00 |
|
 adminandClaude Code
|
f49dc36b44
|
test(crud): 补路径3写 numeric/int 列回归测试 + 强化 status 断言 + 测试数据自清理
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 01:25:57 +08:00 |
|
 adminandClaude Code
|
9a2b3fb770
|
fix(crud): 消掉新增 clippy 告警 + 补路径3写 creatorTime 与 numeric cast 一致性两条测试
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 01:10:47 +08:00 |
|
 adminandClaude Code
|
c2f6548718
|
feat: spec 驱动 CRUD 引擎 + demo/shop/books 三业务模块
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 00:48:06 +08:00 |
|
 adminandClaude Code
|
dc3884c4ec
|
test(sys): 补 roleIds 空数组与全非法数组两条分支钉子
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 00:38:00 +08:00 |
|
 adminandClaude Code
|
596886b07e
|
fix(sys): 角色关联写入不再吞错 + 非字符串 id 走更新分支 + 非法 roleIds 不清空授权 + 补 7 条测试
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 00:14:56 +08:00 |
|
 adminandClaude Code
|
8095f76da5
|
feat: 5 组 base_* CRUD + 授权写入(一维 module、objectType 被忽略)
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 23:56:36 +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
|
2133beeac6
|
feat: Login / CurrentUser 与登录、菜单守卫
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 22:30:46 +08:00 |
|
 adminandClaude Code
|
b39168205c
|
test(permission): 钉住关系表不过滤 delete_mark / f_item_type='module' / 管理员 SQL 前短路
评审 R=1(Approved,Critical 0 / Important 0 / Minor 5)⇒ 实现逻辑零改动,
只补 3 条测试钉子:
- soft_deleted_role_relation_still_counts /
soft_deleted_user_relation_still_counts:钉住「只有 base_authorize 过滤
f_delete_mark=0,两张关系表不过滤」(契约 §8.1 / brief S14)
- non_module_item_type_does_not_grant:钉住 base_authorize.f_item_type='module'
- db_error_denies_instead_of_allowing(扩展):base_module 被 DROP 的那段时间里
管理员仍放行 ⇒ 钉住「管理员在任何 SQL 之前短路」
permission.rs 仅给 MAX_TREE_DEPTH 补注释(防御性上限,react 无此概念)。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 22:10:06 +08:00 |
|
 adminandClaude Code
|
6a0cadb143
|
feat: 四源权限合并 + 管理员短路 + 未映射放行 + 菜单树
实现契约 §8.1/§8.2/§8.3:
- resolve_user_module_ids:直授 + 角色 + 组织 + 岗位四源合并
(base_role_relation 用 f_object_id,base_user_relation 用 f_user_id;
只有 base_authorize 过滤 f_delete_mark=0)
- has_module:管理员在任何 SQL 之前短路放行;菜单未映射 ⇒ 放行;
DB 查询失败 ⇒ 拒(false),与「查不到 ⇒ 放行」是两条分开写的分支
- build_menu_list:按 f_sort_code 升序取菜单,非管理员过滤成四源子集,
父不在可见集合内的节点自己成为根(对齐 react 的 toTree)
集成测试 15 个(tests/permission_it.rs):四源各源单独可注入、管理员短路、
未映射放行、已映射未授权拒绝、DB 报错拒绝、菜单树逐字串、JSON 形状、排序。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 21:56:27 +08:00 |
|
 adminandClaude Code
|
6251890a80
|
docs(seed): 存在性判定的注释同步为「en_code/url 或固定 id」
评审 R1 唯一遗留项(Minor,注释漂移):函数级 doc 与两处字段注释仍只写了
一半判定依据,下一轮照着改会把 Important #1 的缺陷重新引进来。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 21:50:44 +08:00 |
|
 adminandClaude Code
|
1fc85a596b
|
fix(seed): 存在性判定对齐固定 id + 补齐 §8.4/§8.5 断言
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 21:42:25 +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
|
cbc8897028
|
feat: 两段式种子(ensure_base 幂等 + first_seed 首启)
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 21:25:01 +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 Sonnet 5.5
|
93f14f53c5
|
feat: 36 位 UUID 与内存 token 会话表
- ids::new_uuid():uuid v4(36 位带连字符)
- session::SessionStore:Arc<std::sync::RwLock<HashMap>> 内存 token 表
- token = "lite-" + md5(account+毫秒+随机),总长 37
- resolve:bearer 前缀大小写不敏感;不命中则整串当裸 token 查
- state::AppState:config/db/sessions 三个 Arc
- lib.rs:加一行 pub mod state;
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
|
2026-10-25 21:10:36 +08:00 |
|
 adminandClaude Sonnet 5.5
|
18b2e8a6a1
|
fix(db): 键归一按投影作用域隔离 + scalar_text 按列类型分派
- 键归一只扫外层 SELECT 的投影列表(相对括号深度 0):CTE / 子查询 /
CAST(x AS TYPE) 里的 AS 一律不登记,不再跨作用域污染别的列的键;
双引号别名进 quoted 集并优先于任何还原;同名不同写法放弃还原
- scalar_text 按列类型 OID 分派:text 类直出、int2/4/8/bool 转十进制文本,
其它类型(numeric/timestamp/json)报错并提示 ::text
(原先 row.get::<String> 不校验类型,count(*) 会返回 8 个 NUL)
- split_sql_statements:注释处补一个空格,避免 SELECT 1/*x*/FROM t 粘连成 1FROM t
- exec / exec_params:补文档说明能力不对等(simple vs extended protocol)
- 补 6 条回归测试(4 单元 + 2 集成)+ 真实库 CTE 污染回归
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
|
2026-10-25 20:36:55 +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
|
08c266537a
|
test(cipher): 强化大写 hex 断言(不再以「两个 Option 相等」充数)
原先 assert_eq!(decrypt_to_md5(upper), decrypt_to_md5(lower)) 两侧同为 None
也会通过;改为断言具体值 Some(md5_hex("123456")),并加 assert_ne 确认
输入确实变成了大写。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 18:06:19 +08:00 |
|
 adminandClaude Sonnet 5.5
|
ed449eb773
|
feat: config + pglite db 封装 + 10 张表 schema 初始化
- config.rs: Config{port,pg_dir,project_dir,static_dir} + from_env(PORT 默认 30010、
PGLITE_DIR 默认 <project>/src/backend/data/lite.pg、memory:// ⇒ 临时库、static_dir 缺失 ⇒ None)
- db.rs: Db{pglite + 进程级 tokio::Mutex};exec_params 在 query 之上实现;
query_json 自包 row_to_json;ensure_schema 用 to_regclass 探测(只在 base_user 缺失时建库);
split_sql_statements 字面量感知(单引号/E''/双引号/dollar-quote/行注释/可嵌套块注释)
- db.rs: JSON 键归一 —— PG 会把未加引号的别名折叠成小写(AS realName ⇒ realname),
故按内层 SQL 的 AS 别名还原大小写,并支持 f_* 列名直投影(两种写法都出 camelCase)
- schema.sql: 只追加 3 张业务表 DDL(demo_item/shop_product/book_shop_book),
列宽与默认值逐字对齐 react TypeORM entity;7 张 base_* 一字未动
- tests/db_it.rs: 共享一个临时库(pglite 进程级单实例),覆盖 10 表存在/幂等/
numeric⇒字符串/int⇒数字/id 36 字符/DB 默认值/camelCase 键
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
|
2026-10-25 18:04:15 +08:00 |
|
 adminandClaude Code
|
d73b1617b2
|
test(cipher): 钉住 PKCS7 严格解填充 + 上游向量反向断言
- 补 invalid_pkcs7_padding_yields_none:改密文末字节(长度字节 0x10→0x11)
与填充块中间字节(0x10→0x0f)两条路径,均须解密失败 ⇒ None。
第二条是「严格性」的证据:宽松解填充会照单全收。
- 补 decrypt_matches_upstream_vector:上游密文 ⇒ Some(md5("123456"))。
- 补 uppercase_hex_input_is_accepted:十六进制大小写都接受。
- encrypt_password 加 debug_assert_eq!(src.len(), 32)。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 18:01:58 +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
|
f40b0b7f97
|
fix(envelope): E2E 测试的 HTTP 收发套 5s 超时
评审次要项:无超时的 read_to_end 在服务端不响应时会永久挂住而不是失败。
只影响可诊断性,不影响断言真实性。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 17:45:02 +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
|
b32269dd37
|
feat: ActionResult 统一信封(业务失败恒 HTTP 200)
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 17:40:28 +08:00 |
|