16 Commits
Author SHA1 Message Date
admin 652d03367a feat(fetch): 无凭据时匿名拉包(平台仓已公开)+ 修 heredoc 反引号
- 平台仓 private=false 后,下载 release asset 可匿名;脚本改为「有凭据带凭据、
  没凭据走匿名」,不再因无凭据直接放弃
- 修 heredoc 里未转义的反引号(config 注释中的 `use sspf::` 被当命令执行,
  报 'use: command not found' 且注释缺字)
2026-11-05 14:44:38 +08:00
admin d8a8165dd7 fix(skill): 自检/文档同步到方案 C(SC3/SC4/SC5 + rustdocflags + description)
- check-scaffold.py: 三条判据从旧模型(sspf 必须声明为 Cargo 依赖)改为方案 C:
  SC3 应用不声明平台/框架件;SC4 业务包不声明外部依赖;
  SC5 Cargo.toml 不出现 sspf(平台由 .cargo/config.toml 的 --extern 提供)。
  _base_tree 与 VIOLATIONS 同步,反自证仍 6/6。
- fetch-platform.sh: 生成的 .cargo/config.toml 同时写 rustdocflags
  (cargo test 的 doctest 走 rustdoc,不吃 build.rustflags,之前 E0432)。
- SKILL.md frontmatter description 改为「预编译 rlib / Gitea Release 按 tag+平台取包 / 零重编」。
- Cargo.toml 头部、HOWTO_MODULE、docs/runbook、new-pack/pack-sync 注释同步。

验证:verify.sh 全量 7/7(静态 3 步 + cargo test + release 构建 + 面 A/面 B 各 18 断言)。
2026-11-05 13:54:52 +08:00
admin a9c6bd34a3 feat(fetch): 从 Gitea Release 按 tag+目标平台拉包(本地 dist 回退)
- fetch-platform.sh: TARGET=rustc host;优先 Gitea Release web 下载
  /<repo>/releases/download/<tag>/<asset>(API assets 端点会 302 到 attachments
  且跨 host 丢 auth,实测 404,已避开);gzip 魔数校验防错误页;
  本地 dist(target/旧名)与 SSPF_TAR 作离线回退
- 文档同步 SKILL/README/HANDOFF
2026-11-05 13:45:18 +08:00
admin f8d2cf4cf5 feat(dep): 技能改纯 rlib 消费 —— fetch 只解 lib/,不再解包平台源码
- fetch-platform.sh: 解包加 --exclude=crates/src/frontend/Cargo.toml/Cargo.lock,
  只留 lib/ + rust-toolchain.toml + bin/ + docs/README(vendor 少解 ~62M 源码)
- 校验改为认 vendor/.../lib/libsspf-*.rlib,不再读 crates/sspf/Cargo.toml
- 所有「dev 回退 path 到 vendor 源码」改为「极端回退用 git tag 依赖」
- 文档同步 SKILL/README/HANDOFF

验证: cargo clean 后 dev 5.14s / release 9.34s,只编本仓 5 crate;
vendor 无任何平台源码;二进制 --help 正常(基于 sspf v0.5.0)。
2026-11-05 12:50:46 +08:00
admin bef326ad2f feat(dep): 方案 C —— 消费平台预编译 rlib,零重编平台/axum
- Cargo.toml: [workspace.dependencies] 清空(sspf/axum/tokio/serde/serde_json
  全部改由平台包 lib/ 经 --extern 喂入);release profile lto=false
  (预编译 rlib bitcode-free,开 LTO 会 failed to get bitcode for LTO)
- src/backend/Cargo.toml: 去掉 axum/tokio;packs/*: 去掉 sspf workspace 依赖
- scripts/fetch-platform.sh: 解包前 mv 走旧包目录(避免旧 hash rlib 残留);
  为 sspf/axum/tokio/serde/serde_json/http/bytes 生成 --extern(保证与 sspf
  同一 crate 实例,否则跨 API 边界 E0308 mismatched types);修 channel 解析
- .gitignore: 忽略 .cargo/config.toml(含本机绝对路径,跨机无效)
- rust-toolchain.toml: 新增(锁 rustc 1.95.0)
- 文档同步 SKILL/README/CLAUDE/HANDOFF

实测: cargo build 5.7s / --release 11s,只编本仓 5 个 crate,平台 17 crate 与
axum/tokio 零重编。
2026-11-05 11:41:19 +08:00
admin dc54e8bd1d refactor(dep): 平台依赖改为 vendor 发布包,去掉 git 依赖
- Cargo.toml 的 sspf 由 git tag 改为 path 指向 vendor/sspf-v0.5.0/crates/sspf。
- 新增 scripts/fetch-platform.sh:解包平台发布包到 vendor/(含离线校验)。
- [workspace] exclude vendor/,避免包内 crate 被误并入职本仓 workspace。
- .gitignore 忽略 vendor/;SKILL/README/CLAUDE/HANDOFF/runbook 同步说明新模型。
2026-11-05 09:28:48 +08:00
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 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 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