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
S
Description
JNPF 兼容契约的 Rust 实现(单二进制、零外部服务,进程内原生 PostgreSQL)
834 KiB
0 Stars 1 Watchers 0 Forks
Languages
Shell 31.1%
Rust 25.7%
Python 18.5%
TypeScript 15.3%
Java 7.6%
Other 1.8%