Commit Graph
6 Commits
Author SHA1 Message Date
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 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