Commit Graph
6 Commits
Author SHA1 Message Date
adminandClaude Code bafdc98228 refactor(b1b): 搬家 —— 平台层/业务层分离(行为零变化)
按 v3 spec §2.1 的目录映射,把 9810 行代码重组成「平台层 + 业务层」两段:

**平台层 `src/platform/`**(12 个文件,与业务零知识)
- state / config / db / session / envelope / cipher / ids / protocol
- body / mw / fallback(原 `src/routes/`,是通用响应改写与兜底,不是业务)

**业务层 `src/tdc/`**(对位上游 `ssw.tdc.*` 包族)
- `entity/` —— `registry.rs` 拆成 **18 个实体各一文件** + `mod.rs`(`ALL_SPECS` / `validate` / 权限键)
- `mapper.rs` —— 原 `crud.rs` 的 SQL 组装/投影/序列化半边(机械活、实体无关)
- `service/crud.rs` —— 原 `crud.rs` 的写路径规则/分档判定半边
- `service/identity.rs` / `service/account.rs` —— 原 `domain/identity.rs` / `account.rs`
- `controller/` —— 原 `routes/`(crud / health / auth / account / tds_biz)
- `client/tds.rs` —— 原 `tds/mod.rs`(TDS 出向客户端)
- `util/code.rs` —— 原 `codec.rs`(**业务**编码生成器,非平台件)
- `support/public_paths.rs` —— 免鉴权端点清单(业务侧持有,C5 接线)
- `policy/ engine/ schedule/ notify/ heartbeat/ sso/` —— 上游同名包占位

**行为零变化**:HTTP 契约、响应形状、SQL、口令算法、权限判定全部不动。
- `cargo test` 223 passed / 0 failed / 1 ignored(与 B1a 基线一致)
- `scripts/smoke.sh` PASS=75 / FAIL=0(断言数 == 基线 N=75,不增不减)
- `scripts/check-boundary.sh` exit 0(账本 7 条 B1b 待清 + 2 条永久豁免)
- `scripts/check-entity.sh` PASS=15 / FAIL=0

**边界账本同步**:CP3 的 `routes/crud.rs` 条目改为 `controller/crud.rs`(账本按路径后缀匹配,搬家不失效)。

**为什么搬家必须一个 commit**:`check-boundary.sh` 的 NEW_LAYOUT/LEGACY 判定是**全有或全无**
(`src/platform/` 目录存在即切新布局)⇒ 分批搬会让账本条目在中间态失效 ⇒ 尺子当场红。
⇒ 搬家一个 commit,之后 C1–C12 各一个 commit。

Co-Authored-By: Claude Code <[email protected]>
2026-10-26 20:15:09 +08:00
adminandClaude Code 0828bcfbc1 fix(fallback): 内容级兜底连 Range 分段一起拦,别让 DDL 被分块拼回来
影响:改名(或任意换名)的 DDL 副本之前只能用「整份响应」判据拦住;
`Range: bytes=0-1000` 这类分块请求的响应体只有 1001 字节 ⇒ 逃过整份比对 ⇒
逐段请求能把整份 DDL **拼回来**(实测 206 吐出 DDL 开头 1001 字节)⇒ 等于完整泄露。

改动:
- `src/routes/fallback.rs`:内容级兜底改为「拿响应体的哪一段去比」——
  无 `Content-Range` 时比整份(`Content-Length` 正好等于 DDL 长度才比),
  有 `Content-Range` 时比**同偏移**的 DDL 片段(`DDL[start..=end]`)⇒ 分块下载同样被拦。
- 新增 `parse_content_range`(只认 `bytes` 单位 + 闭区间,忽略 `total`)。
- `tests/spa_fallback.rs`:补 ④ 片段 Range ④⑤ 中段 Range ⇒ 404 JSON 且不含 DDL,
  ⑥ 片段 Range 打在等长不同内容的文件上 ⇒ 仍 206(证明比的是内容不是长度)。
- `src/main.rs` / `README.md`:兜底描述同步为「整份或 Range 分段」。

设计:`total` 段被忽略 ⇒ 「DDL + 一段尾巴」这类副本的前 N 字节同样被拦。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 10:45:35 +08:00
adminandClaude Code 5b0111e7a7 fix(fallback): DDL 守卫改两层——扩展名类规则 + 内容逐字节兜底
影响:DDL 不再能被任何路径拼法下载。旧守卫只比 ASCII 大小写,
`migrate.ſql`(APFS 上与 `migrate.sql` 是同一个文件)会漏网并吐出 99 KB DDL。
改后路径级判据是「任意一段的扩展名经 Unicode 大写折叠等于 SQL」
(覆盖 `migrate.sql` 的全部 1536 种 casefold 等价拼法),另加一层
「响应体与内嵌 DDL 逐字节相同 ⇒ 404」兜住改了名、但内容没变的副本。

改动:
- src/routes/fallback.rs:is_ddl_path 改为扩展名类规则(Unicode 大写折叠);
  新增 ddl_content_guard(只在 `Content-Length` 等于 DDL 长度时逐字节比对:
  长度缺失 / 片段响应不比,长度与实际不符 ⇒ fail-closed;
  整份 Range(`bytes=0-`)的长度等于整份 ⇒ 同样被拦);
  语义表改为「充分条件」表述,覆盖范围与边界按本机实测写入模块文档。
- src/main.rs:注释同步(守卫已不是「只认一个文件名」的单条规则)。
- tests/spa_fallback.rs:变体清单 36 → 44 条;新增两个用例——Unicode casefold
  一族、以及「改名但内容逐字节相同」的副本(含等长不同内容的反向护栏
  与整份 Range 的绕过口)。
- README.md:单段式动作端点按方法分述(GET 200 业务信封 / POST 405);
  DDL 的两道兜底写进说明。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 10:39:25 +08:00
adminandClaude Code 3f66cf2834 fix(fallback): DDL 守卫改「任一段命中」口径,注释只写可证明的规则
影响:
- `is_ddl_path` 从「只看末段」改为「路径中任意一段(去尾部空白、忽略大小写)
  等于 migrate.sql 即命中」。旧口径下 `/migrate.sql/.` 等 24 条变体绕过守卫,
  ServeDir 归一化时丢弃 `Component::CurDir` 后直接把 DDL 文件端出来。
- 变体清单从 4 条扩到 36 条,逐条断言 404 + application/json + 响应体无标记串;
  任何一条漏网即红。另加一条 `ddl_is_blocked_by_any_path_segment` 单独钉住
  「任一段」口径;`static_assets_are_still_served` 补 content-type 断言
  (原来对「ServeDir 根目录坏掉」零区分度)。
- README:系统列改 10 个 / 24 张带齐 / 6 张精简 / 21 个唯一索引含 14 个 partial;
  实体写入能力改「通用读取 + 按实体分档」;动作端点区分两段式 404 与单段式 200。

改动:
- src/routes/fallback.rs:is_ddl_path 改任一段口径;模块语义表、DDL 守卫说明、
  ddl_guard / is_ddl_path 注释按新口径重写,并写清守卫边界(只认这一个文件名,
  根因修复是「DDL 文件不在 web root」);补「只 decode 一层是刻意选择」。
- src/main.rs:装配处两处守卫注释同步为同一口径。
- tests/spa_fallback.rs:36 条变体循环 + 新增任一段用例 + 静态资源 content-type
  断言;临时目录名加进程内自增序号,消除同进程并发用例的目录名撞车。
- README.md:四处按代码实测对齐。

设计:
- 判据取「任一段命中」而不是复刻 ServeDir 的归一化,避免两边口径再对不齐。
- 注释只写能被证明的规则,删掉「任何路径变体都拦」这类全称量词。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 08:45:57 +08:00
adminandClaude Code 1af08c1db7 fix(fallback): DDL 前置守卫跑在 ServeDir 之前,README 与代码对齐
- src/routes/fallback.rs: spa_fallback 返回 Router 并挂 from_fn(ddl_guard)
  前置守卫(axum 0.8.9 的 Router::layer 同时包住 fallback_router 与
  catch_all_fallback ⇒ 守卫必然先于 ServeDir);决策层的 DDL 判定移除(死代码),
  is_api_path/is_ddl_path 统一改用 percent-decode 之后的路径
- src/main.rs: 注释改成事实——真正的守卫是 ddl_guard,不是那条字面路由
- tests/spa_fallback.rs: 新增 ddl_in_web_root_is_still_not_downloadable
  (临时 web root 里放 migrate.sql ⇒ 仍须 404 + JSON 且不含 CREATE TABLE),
  并在既有用例里追加 /api%2Ffoo ⇒ 404 JSON、/apifoo ⇒ 不被误吞
- README.md: 删虚构的「契约网关」与「6 条脱敏规则 + 默认环境空间」,
  换成真实的 30 张表,并把已删除的旧控制台生命周期能力改成现状说明
  (动作端点属后续分期、尚未实现 ⇒ 前端点这些按钮会 404)

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 07:40:47 +08:00
adminandClaude Sonnet 5.5 e72345a958 fix(console): schema DDL 移出 web root,兜底行为抽进 lib 并锁进 CI
- static/migrate.sql ⇒ schema/migrate.sql(编译期内嵌不变,运行期不在 web root)
  ⇒ 大小写 / %2E / 尾斜杠 / 双斜杠等路径变体全部拿不到 DDL
- 404 与 SPA 兜底从二进制 crate 抽进 lib(src/routes/fallback.rs)
  ⇒ /api 与 /api/ 统一回 404 JSON,SPA 深链回 index.html
- 新增 tests/spa_fallback.rs:6 条断言锁住兜底行为
- README 整段重写为现行 18 实体 CRUD + 鉴权面 + 上游 SPA 托管
- build-frontend.sh 可执行;产物目录缺失时回落 npm 构建路径
- registry::validate() 挪到 PGlite::open 之前,注册表写坏即秒退
- mw.rs 注释点明两套 4xx 形状并存是刻意分歧

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
2026-10-25 05:58:20 +08:00