Commit Graph
63 Commits
Author SHA1 Message Date
adminandClaude Code 77c2df577c test(api): 补一条 HTTP 层的 secretKey 去敏回归
**影响**
- 改动前:R10 的回归只在 **CRUD 引擎层**(`tests/crud_engine.rs`)覆盖,
  路由 + 业务信封层没有断言。
- 改动后:`/api/ssw/tdc/Identity` 的**详情 / 列表 / 新建**三处出参都断言
  「没有 `secretKey` 这个键」,且入参送 `secretKey` 不落库。

**改动**
- `tests/api_smoke.rs` 新增 `identity_secret_key_is_never_exposed_over_http`:
  直插一条**带密钥**的身份行(绕开 CRUD 写路径的「静默忽略」)⇒
  详情 / 列表(按 `identityCode` 过滤)都不得出现 `secretKey` 键;
  再 POST 一条带 `secretKey` 的身份 ⇒ 响应不含该键、库里那列仍为空。

**设计**
- 🔴 断言只看**键名**,不回显任何值 ⇒ 密钥不会进 transcript。
- **变异验证过是 load-bearing**:把 `row_to_json_spec` 里的 `obj.remove(*key)` 关掉
  ⇒ 本用例在 `tests/api_smoke.rs:559` 变红(已还原,`shasum` 与提交版逐字节一致)。
- 验收:`cargo test` ⇒ **223 passed / 0 failed / 1 ignored**;clippy 干净;`cargo fmt --check` 干净。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 15:27:07 +08:00
adminandClaude Code 1044af8a47 docs: 同步 R10(@JsonIgnore 去敏)到项目指引与工作日志
**影响**
- 改动前:项目指引里没有「CRUD 出参不许带密钥」这条机制,新加实体/字段时
  容易重蹈 `secretKey` 泄漏。
- 改动后:红线、关键实现细节(第 15 条)、踩坑表三处都指明
  `TableSpec::hidden_fields` 这条路,并写清「新增字段前先查上游 `@JsonIgnore`」。

**改动**
- `CLAUDE.md`:
  - 红线「私钥不得外泄」补一段 CRUD 出参的去敏机制与新增字段前的动作;
  - 「关键实现细节」新增第 15 条(`row_to_json_spec` / `body_to_columns` /
    `hidden_fields` 键名是 camelCase / frozen 自检要跳过 hidden 列);
  - 踩坑表新增一行(`Identity` 回显 `secretKey` 的症状 / 根因 / 修法)。
- `.workbuddy/memory/2026-10-25.md`:追加「R10 + R11 收尾」小节
  (机制、上游核对结论、刻意更严的一处、变异验证、验收数字、仍开着项)。

**设计**
- 文档只写「原则 + 一句话摘要 + 指路」,长 traceback 与逐条 diff 留在
  SDD 台账(gitignored)与提交信息里。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 15:11:50 +08:00
adminandClaude Code 19d0d93bff style: 全仓 cargo fmt(清掉 13 个文件的历史格式漂移)
**影响**
- 改动前:`cargo fmt --check` 报 13 个文件漂移 ⇒ 新代码容易跟着旧风格走,
  review diff 噪声大。
- 改动后:`cargo fmt --check` 干净;**零行为变更**(纯排版,
  `cargo test` 222 passed / 0 failed / 1 ignored,`cargo clippy -D warnings` 干净)。

**改动**
- `src/{account,auth,codec,crud,db,envelope,ids,protocol,registry,session}.rs`、
  `src/domain/identity.rs`、`src/routes/health.rs`、`tests/account_api.rs`:
  统一 rustfmt 排版(长行折行、match 分支、struct 字面量多行展开等)。

**设计**
- 单独一笔 style 提交,与语义改动(`fix(crud)`)分开 ⇒ review 时格式噪声可整笔跳过。
- 不引入 `rustfmt.toml`:沿用默认配置,避免与上游风格分叉。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 15:10:15 +08:00
adminandClaude Code cf361b6aca fix(crud): 上游 @JsonIgnore 字段不再从 CRUD 出参泄漏、也不再被写入
**影响**
- 改动前:`GET /api/ssw/tdc/Identity` 与 `GET /api/ssw/tdc/Identity/{id}` 会把
  `secretKey` 原样回显(`SELECT *` + camelCase 直出)⇒ 接入密钥泄漏到 API 响应。
- 改动后:这 3 个键在出参里**整条不出现**(不是 null),入参里带则**静默忽略**。

**改动**
- `src/registry.rs`:`TableSpec` 新增 `hidden_fields`(camelCase JSON 键),
  18 个实体逐个登记;`validate()` 校验每个键能反解成合法列名。
- `src/crud.rs`:新增 `row_to_json_spec()`(出参删键)+ `body_to_columns()` 增加
  第三个参数 `hidden_fields`(入参跳键);`update` 的 frozen 列自检跳过 hidden 列
  (上游 `devUrl` / `devToken` 既是 `@JsonIgnore` 又是 frozen ⇒ Jackson 绑不上 ⇒
  `changed()` 恒 false ⇒ 上游既不拒也不写)。
- `tests/crud_engine.rs`:新增 1 条集成测试(建 Identity 送 `secretKey` ⇒ 库里
  仍为空、detail/list 无 `secretKey` 键、update 送 `secretKey` 不落库)。

**设计**
- 清单**逐字照抄上游**:全仓只有 3 个属性标了 `@JsonIgnore`
  (`IdentityEntity.f_secret_key` / `DeliveryTaskEntity.f_dev_url` / `f_dev_token`)。
- 🟡 **有意比上游更严的一处**:`CredentialEntity.f_secret_key` 上游**漏标**
  `@JsonIgnore`(该列是「预留 SK 密文(本期空)」,上游自注)⇒ 本仓补上去敏;
  该列本仓从不写入(恒 NULL)⇒ 对外行为零差异,纯属兜底。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 15:08:25 +08:00
adminandClaude Code 52074a136d docs(tds): 补齐 P4 出向通道的契约文档与项目指引
影响:
- `docs/TDC-TDS-CONTRACT.md` 由「P4 的输入清单」改写为「已落地契约」:
  只走 internal 通道、6 个固定出向头、10 个对外端点 → 出向 TDS 端点映射、
  降级三档、7 条刻意分歧、真 TDS 实测记录。
- `README.md` / `CLAUDE.md` 补上 10 个出向端点、两个环境变量、TDS 通道小节与踩坑行。

改动:
- 契约文档重写:新增「返回风格两套」「身份解析两套口径」「降级三档」三节,
  补录本仓 10 个端点与 TDS 侧 11 条原始返回的实测表。
- README:后端 API 表增 7 行、环境变量表增 `SSW_TDS_BASE_URL` /
  `SSW_TDS_INTERNAL_TOKEN`(令牌值只指向 `src/config.rs`,不入文档)。
- CLAUDE.md:目录树、红线、API 表、关键实现细节 13–14、TDS 出向通道小节、
  踩坑表 6 行、范围外声明同步。
- 计划文件:修正「12 条用例」为实际的 4 条用例(219 = 207 + 8 + 4),
  并记录实施后与上游的三处差异(空体可选、connectorId 取值宽松、query 传参)。
- 工作日志追加 P4 小节:4 个 commit、5 个变异自证表、真 TDS 实跑结果、3 个遗留项。

设计:
- 不改 `static/`:上游 SPA 的 serviceCatalog / billing 两个 api 对象要的正是
  这 10 个路径,后端补齐即可 ⇒ 前端一个字不动。
- 遗留 R10(`GET /api/ssw/tdc/Identity` 泄漏 `secretKey`,上游是 `@JsonIgnore`)
  与 R11(13 个文件的 rustfmt 漂移)本轮不修,超出 P4 范围,已登记。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 14:24:54 +08:00
adminandClaude Code b82c71a1e9 test(tds): 补一条「解包型端点的 TDS 业务失败」断言
目录查询走的是**解包型**信封(internalCatalog → unwrap_data),
原先只覆盖了整包型(Billing/List → unwrap_envelope)的业务失败分支。
补上后,变异「解包型不判 body.code」也能被用例抓住(Task 6 变异③a 已实测红)。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 13:44:25 +08:00
adminandClaude Code d3d609f110 test(tds): TDS 出向客户端集成测试(假 TDS + 4 条用例)
假 TDS 跑在 127.0.0.1(出向必须 no_proxy,否则被系统代理劫持),
逐条断言**出向**请求的方法 / 路径 / 查询串 / 头 / 体:

- 服务目录:Catalog/Internal/Catalog 与 TradeOrder/Internal/Apply 的路径映射、
  上游 6 个固定头一字不差、绝不夹带 Authorization / Cookie、
  Buy 自动带出 buyerConnectorId、BuyBatch 空体报「请求体不能为空」且不出向
- 账单:List 的整包信封解包、TDS 业务失败(HTTP 200 + code 600)映射成本仓业务失败、
  LocalCompare 只读本地 tdc_api_consume_log(零出向)、缺 contractId 报「contractId 必填」
- 账单动作:越权自检拒「非本方账单,无权发起异议」且不发动作请求、
  Confirm 的严格身份口径拒「与传入 connectorId 不一致」、
  Confirm/Settle 带 ?connectorId=、Receipt 只挑 receiptNo + remark、Voucher 走 GET
- 降级:NOOP 报「未配置 TDS 地址(本地单机模式)」、
  TDS 不可达报「TDS 账单查询不可达」(不得 500)、无凭证回 401 裸三字段(无 data 键)

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 13:36:35 +08:00
adminandClaude Code a2c0213908 feat(routes): 照抄上游 ServiceCatalog/Billing 两控制器(10 个端点)
严格对齐上游 ssw-tdc 的 ServiceCatalogController 与 BillingController:

- 服务目录:GET /ServiceCatalog、POST /ServiceCatalog/Buy、POST /ServiceCatalog/BuyBatch
- 连接器账单:GET /Billing/List、GET /Billing/LocalCompare,
  PUT /Billing/{id}/{Dispute,Confirm,Settle,Receipt}、GET /Billing/{id}/Voucher

关键实现点:

- 身份解析照抄上游两套口径:宽松(显式 connectorId 优先,List/Dispute/Receipt/Voucher)
  与严格(本端固定身份唯一,Confirm/Settle)
- 越权自检照抄上游 ownsLedger:先 listBillingForConnector 再比对 id,异常一律 fail-closed
- 信封拆解照抄上游 unwrap / unwrapStr:成功时 data 是账本 id 字符串而非对象
- OptionalJsonBody 还原上游 @RequestBody(required=false):空体 => null 而非失败
- Buy/BuyBatch 自动带出 buyerConnectorId(上游读的是 buyerConnectorId 不是 connectorId)
- LocalCompare 只读本地 tdc_api_consume_log,不发任何出向请求
- 业务失败一律 HTTP 200 + code 400;出向不可达用上游原话,NOOP 另给「未配置 TDS 地址」

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 13:33:04 +08:00
adminandClaude Code 03e9f05736 feat(tds): TDS 出向客户端(照抄上游 TdsReportClient 的 internal 通道)
- 9 个方法:internal_catalog/apply/apply_batch + list/dispute/confirm/settle/receipt/voucher
- 出向固定 6 个头(App-Code: sswflow / Jnpf-Origin: pc / Vue-Version: 3 / X-Internal-Token / X-Protocol-Version: 1.0)
- 超时 3s 连 / 5s 读;no_proxy 避免系统代理劫持 loopback 的 TDS
- 路径段白名单(字母数字下划线短横线,≤64)

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 13:21:27 +08:00
adminandClaude Code cda8729a3e feat(config): 新增出向内部令牌 SSW_TDS_INTERNAL_TOKEN(默认 ssw-internal-token-e2e)
- 与入向 SSW_INTERNAL_TOKEN 同值但不同源(方向相反,不混用)
- 纯空白回落默认值;首尾空白 trim
- 顺带收敛 config.rs 的 rustfmt 漂移(本轮触碰的文件保持 fmt 干净)

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 13:18:15 +08:00
adminandClaude Code a38c8418dd style: 修 main.rs 新增测试的 rustfmt 违规
Co-Authored-By: Claude Code <[email protected]>
2026-10-25 13:16:41 +08:00
adminandClaude Code 2ba0b74e89 style: 修 3 处历史 rustfmt 违规 + 边界③ 端口冲突改「打印 + exit 1」
- tests/{auth_flow,bootstrap_fail,crud_engine}.rs:仅格式化(语义零改动)
- main.rs:TcpListener::bind 的 unwrap 换成明确的错误文案 + exit 1,不再抛 panic 回溯

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 13:16:25 +08:00
adminandClaude Code 7f76cce56e docs(plan): P4 TDS 出向客户端实施计划(8 个 Task,含 R8 + 边界③)
Co-Authored-By: Claude Code <[email protected]>
2026-10-25 13:12:32 +08:00
adminandClaude Code ceac09a88b docs(spec): P4 TDS 出向客户端设计 —— 照抄新版上游 TDC 的 ServiceCatalog/Billing 两控制器
- 范围按上游逐控制器交叉后收敛:上游 7 个用 TDS 的控制器里,只有
  ServiceCatalogController / BillingController 对应本仓已有的 SPA 页面
  (服务目录 / 我的账单,当前 404);Contract/Order/DeliveryTask/P2P 对应的
  TDC 端点本身未实现(P2–P5)⇒ 无调用方
- 上游无通用代理(那是旧 Rust 版口径)⇒ 本轮不做 /api/ssw/tdc/tds/* 通配
- 通道只取 internal(X-Internal-Token);上游 standalone 分支本就用它,
  ensureToken / Bridge / ensureToken 依赖的 TDS 登录态本轮不做
- 出向头逐条照抄 internalHeaders()(含 App-Code: sswflow、X-Protocol-Version: 1.0),
  超时 3s/5s;业务信封一律判 body.code == 200
- 身份解析逐端点照抄上游两套口径(Confirm/Settle 严格,其余宽松),
  越权自检 ownsLedger 一并照抄
- 登记 4 处有意差异 + 3 条照抄的必然缺口(SPA 直连 /api/ssw/tds/* 仍缺 TDS 登录态)

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 13:02:48 +08:00
adminandClaude Code c7ef4571d0 docs: 项目指引更名 AGENTS.md → CLAUDE.md,并同步上游最新基线
- 更名并整体重写项目指引:上游真源改指最新版
  http://192.168.1.2:8080/ssw/trusted-space/ssw-tdc,原 ssw-mvp 标注为已过时
- 目录树与表清单对齐现状:18 实体 / 30 表 / 模块化 src/ / static/ 托管上游前端产物
- 补齐鉴权三道门、权限键、账号层、缓存布局等章节与踩坑清单
- 踩坑清单新增「后台标签冻结 CSS transition」一行,索引 docs/CONSOLE-ACCEPTANCE.md
- 修正密文契约回归防线的表述:除单测向量外,另有
  tests/account_api.rs::login_accepts_the_upstream_literal_ciphertext 端到端锚点

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 12:33:41 +08:00
adminandClaude Code 3bb545513d docs: 补上游控制台浏览器级验收(R3 收口)—— 逐页实测 + 两个 TDS 代理页定性
- docs/CONSOLE-ACCEPTANCE.md: 新增。上游完整前端(SPA)在真实浏览器里
  逐页走查的记录:17 个路由全部渲染、15 个页面调用全 200;复现命令;
  契约核对(上游 cipher.ts 的登录密文链、令牌落 localStorage 且不带
  bearer 前缀、401 裸三字段无 data 键);写路径/账号分层的正负向实测。
- 两个 404 定性:服务目录(ServiceCatalog)与我的账单(Billing/List)
  是 TDS 代理页(上游 controller 直接转发 TDS,本地无表)⇒ 属 P4,
  不是缺陷。
- 顺带确认只读分档与上游 UI 天然对齐:/tdc/datasets 上游本来就没有
  「新建」按钮 ⇒ Dataset 禁增分档在控制台里不会变成报错。
- 踩坑记录:内核浏览器在后台标签时 visibilityState=hidden ⇒ rAF 与
  CSS transition 全冻结 ⇒ antd 抽屉卡在 enter-start(停在屏幕外),
  表现为「点不到保存按钮」。这是测试环境假象,注入
  *{transition:none !important} + 摘掉卡住的 motion 类可绕过。
- README: 控制台(前端)小节补实测结论与文档指针;「明确不在 MVP 内」
  补两个 TDS 代理页;目录树补 docs/CONSOLE-ACCEPTANCE.md。
- .workbuddy/memory/2026-10-25.md: 工作日志。
- 验收数据已清理:探针账号 r3probe 已删;测试数据源已逻辑删除。
- 本轮未改源码 ⇒ cargo test 仍 207 passed / 0 failed / 1 ignored。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 12:23:26 +08:00
adminandClaude Code 3586333a7a fix(review): 整分支终审修 3 处 —— 密文契约外部锚点 / 相对数据目录分家 / 首启默认口令可覆盖
终审(就地执行)发现的 3 个问题:

1. 密文契约只在单元层被钉住(R1 未闭环):集成测试用本仓自己的
   encrypt_login_password 造密文 ⇒ 自证自洽 ⇒ CIPHER_KEY 改错时全绿。
   新增 login_accepts_the_upstream_literal_ciphertext:用上游仓库注释里的
   字面密文登录成功,篡一个字节必须失败。
   变异自证:换掉 CIPHER_KEY ⇒ 旧 7 例仍全绿、只有新用例红。

2. 相对 TDC_DATA_DIR 会让数据目录分家:pglite-rs 打开数据目录后会 chdir
   进去 ⇒ 之后 accounts.json 落到 data/tdc.pg/<相对路径>/ 下。
   Config::from_env 在 chdir 之前把数据目录钉成绝对路径(新增纯函数
   data_dir_from + 单测)。

3. 首启管理员口令是公开默认值 admin 且无覆盖机制(R2 未闭环):
   新增 TDC_BOOTSTRAP_ADMIN_ACCOUNT / TDC_BOOTSTRAP_ADMIN_PASSWORD;
   TDC_STRICT_SECRETS=1 时还有管理员在用默认口令 ⇒ 启动即失败。

验收:207 passed / 0 failed / 1 ignored;clippy --all-targets 干净。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 11:44:37 +08:00
adminandClaude Code 4a5b7ecb2b docs: 补齐鉴权/权限键说明 + 目录树同步 + DDL 守卫踩坑记录
- README: 新增「鉴权三道门」表与「写操作的权限键」说明块;「已实现范围」
  补 JNPF 兼容登录 + 本地账号管理一条;目录树同步到当前模块拆分
  (src/lib.rs、src/{account,auth,cipher,…}、src/domain、src/routes 全量、
  tests/、data/accounts.json)。
- docs/DDL-GUARD.md: 新增。记录 DDL 不可下载这条红线的四轮踩坑(路径级
  Unicode 大写折叠 1536/1536、内容级 Range 同偏移比对、fail-closed)、
  已知边界与回归测试入口。
- docs/TDC-TDS-CONTRACT.md: 加现状横幅 —— 旧代理网关已随 Task 10 下线
  (请求 /api/ssw/tdc/tds/* 现为 404),SSW_TDS_BASE_URL 仅用于健康检查
  回显与单机模式判定;本文改为 P4 出向客户端的输入契约。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 11:28:34 +08:00
adminandClaude Code e475137366 feat(auth): 本地账号层 + JNPF 兼容登录,上游完整控制台可登录
- cipher.rs:MD5 + AES-256-ECB,与上游前端 cipher.ts 逐字对齐(含上游自检向量)
- account.rs:本地账号库存 data/accounts.json(不建 tdc_* 表,30 表口径不变),首启引导 admin
- 新增 POST /api/oauth/Login(grant_type=password)与 /api/permission/Users*(仅管理员)
- AppState 增 accounts 字段与 with_accounts 构造器
- 账号登录走 SessionKind::Account,Auth/Me 返 accessAllowed + account
- README:订正「/api/oauth/Login 尚未实现」并补新端点表

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 11:23:12 +08:00
adminandClaude Code e75dcf9370 feat(auth): 声明式权限键 + 写操作二次校验
影响:写操作(新建 / 修改 / 逻辑删除)现在多一道**权限键**判定;
能力集来自 `tdc_identity.f_capability`,解析不出时 **fail-open 放行**
(对齐上游「菜单未映射即放行」口径)⇒ 存量连接器不受影响。

改动:
- `src/registry.rs`:新增 `PERMISSION_KEYS`(18 个实体 → 权限键)与 `permission_key()`,
  另加一条单测守住「每个实体都有权限键」。
- `src/domain/identity.rs`:新增 `capabilities()` —— 解析 `f_capability` 自由文本
  (`,` `;` 空白分隔)成 token 集合;解析不出返回 `None`。
- `src/crud.rs`:新增 `require_write_permission()`;`create` / `update` / `delete`
  改走它(读接口 `list` / `all` / `detail` / `detail_aggregate` **不动**,
  读不做权限键判定)。
- `tests/permission_gate.rs`:5 个用例(能力集解析 / fail-open / 命中与未命中 /
  通配符 / 内部令牌与无凭证),含一条**接线自证**——三个写路径未命中权限键时必须是 403。

设计:能力集解析不出 ⇒ 放行(fail-open);本地账号(无 `tdc_identity` 来源)同 footing。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 10:54:19 +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
adminandClaude Code 079dcff986 feat(console): 下线旧 API,托管上游完整前端构建产物
- 移除 /api/db/*、/api/ssw/tdc/node/identity*、/api/ssw/tdc/tds/* 及其旧 handler
- 静态托管改根挂载 + SPA fallback(深链回 index.html,vite base=/)
- /api/** 未命中回 404 + JSON(不吞成 SPA 的 HTML),/migrate.sql 同样 404
- 空体 405 改由响应改写中间件统一改写成业务信封,并保留 Allow 头
- 启动流程接入 registry::validate() fail-fast
- 交付 scripts/build-frontend.sh 作为可重放的前端构建入口

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 04:09:10 +08:00
adminandClaude Code 2cdbfcbcdc fix(routes): 空 body 的写请求回业务失败,不再建出全 null 的垃圾行
- JsonBody 去掉 Option:空 body 与畸形 JSON 走同一拒因(上游必填 @RequestBody
  ⇒ HttpMessageNotReadableException ⇒ 「请求体格式有误,请检查 JSON 结构与字段类型」)
- POST/PUT 的 body 取值改为 b.0(不再是 Option)
- 补 HTTP 级用例:空 body ⇒ HTTP 200 + code 400 + 上游原文,且不建出行
- detail_aggregate 查无分支改回 rustfmt 单行形态(仅此一处,其余历史违规不动)

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 02:02:34 +08:00
adminandClaude Code 5d74354944 fix(routes): 请求体解析失败与方法不允许都回到业务信封
- 新增宽松 JSON 抽取器:畸形 body 不再返回 axum 默认的 text/plain 400,
  改为 HTTP 200 + code 400 + 上游原文「请求体格式有误,请检查 JSON 结构与字段类型」
- 方法不允许返回 JSON(405 + code/msg),不再是空体
- /Detail 的查无文案逐实体对齐上游:Dataset 与 Resource 文案不同
- /Detail 路径改从注册表取,不再硬编码
- 补 HTTP 级用例覆盖 GET {id} / POST / PUT / DELETE 与聚合体子表

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 01:41:27 +08:00
adminandClaude Code 0f84fbdb83 feat(routes): 18 实体 CRUD 路由装配 + 全链路冒烟
- 每个实体 6 条路由(列表/All/详情/新增/修改/删除),路径参数用 axum 0.8 的 {id}
- 冒烟覆盖:无凭证 401 裸三字段、内部令牌业务信封、/All 裸数组、协议版本不兼容 401
- 补资源侧只读聚合路由 /Resource/{id}/Detail 与 /Dataset/{id}/Detail(上游前端在用)

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 00:06:23 +08:00
adminandClaude Code 0a3811585c fix(crud): 对齐评审发现的上游默认值、序号口径与错误脱敏
- 新建 Product/Resource 默认停用、Datasource 默认未测试(上游逐字,create_defaults 钩子)
- 补序号基线 used+1+i 的护栏测试;显式 null 不再抑制服务端默认值
- creator/last-modify 用户列改写操作人 id(对齐上游 safeUserId)
- delete 的「不存在」判定前置于禁删守卫;500 错误不再回显数据库原文
- DataInterface 的当日同前缀基线补 ALIVE 谓词(上游逐实体不同)

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 23:41:56 +08:00
adminandClaude Code 8b73397d66 fix(crud): 编码重试次数与失败文案逐实体对齐上游
- Product/Resource 重试 5 次,DataInterface/Datasource 重试 3 次(上游逐实体不同)
- 失败文案取上游原文,不再统一用「接口编码生成失败」
- 补注 Datasource 查重口径的有意分歧(本仓更严,唯一索引为部分索引,不会插入冲突)

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 23:09:03 +08:00
adminandClaude Code b4edff79c4 fix(crud): 写路径对齐上游(编码服务端生成 + 审计 actor + 约束失败转业务失败)
- 4 个编码列改为服务端生成,格式逐字对齐上游两套生成器(TdcCodeUtil / BizCodeUtil)
- 审计 actor 由登录主体推导,不再恒为「系统(自动)」
- DB 约束失败按 SQLSTATE 映射为业务失败(400),不再一律 500
- Contract 恒拒删;validate() 覆盖范围补齐

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 23:01:14 +08:00
adminandClaude Code 88464aaff9 feat(crud): 表无关的通用 CRUD 引擎
- list/all/detail/create/update/delete 六件套,行为逐条对齐上游 TdcCrudController
- 出参 camelCase、入参反查 f_ 列;null 值跳过;未知键静默忽略
- 过滤统一 CAST(col AS TEXT)=,规避上游 varchar 绑 smallint 的缺陷
- 冻结列只拒「值真的变化」,避免误伤整行回传的编辑弹窗
- 增补资源侧只读聚合体 detail_aggregate(fieldRules + maskRules),供上游前端 /{id}/Detail

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 22:50:07 +08:00
adminandClaude Code 70fe0c5cc2 feat(crud): 18 实体表注册表
- TableSpec 承载关键字列/过滤列/租户列/排序列/写入口禁令和冻结列
- DeliveryTask 的 41 个服务端权威列逐字抄自上游 changedAuthorityColumn
- Dataset 用派生谓词只读;ApiConsumeLog 关键字列修正上游 f_name 缺陷

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 20:50:12 +08:00
adminandClaude Code a86611d4cf chore(lint): 清掉 4 条既有 clippy 告警,启用 -D warnings 闸门
**影响**
`cargo clippy --lib --all-targets -- -D warnings` 从「必然失败(4 条既有告警)」变为 **0 告警通过**,
后续任务可以直接把它当闸门用(此前 Task 3 round 5 的实现者因这 4 条告警无法验证自己的改动)。

**改动**
- `src/db.rs:329` / `:374`:`needless_range_loop` ⇒ 改用 `for row in &rows` 直接迭代行。
- `src/db.rs:352`:`needless_question_mark` ⇒ `Ok(rows[0].get::<Option<String>>(0)?)` ⇒ `rows[0].get::<Option<String>>(0)`。
- `src/main.rs:77` / `:81`:`ptr_arg` ⇒ `&PathBuf` ⇒ `&Path`(`identity_path` / `read_identity`),
  导入改为 `use std::path::{Path, PathBuf};`。

**设计**
纯机械等价改写:不改查询语义、不改返回类型、不改调用点(`&PathBuf` → `&Path` 由 deref 强转自动成立)。
`cargo test` 全绿:109 + 7 + 1 + 2 doctests,0 失败。

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 20:07:48 +08:00
adminandClaude Code 8db55d1220 fix(protocol): 输出层统一去控制字符 + 补全守卫白名单 + 拆开期望值来源
- emit_warn 构造输出行前统一剥掉日志不安全字符(只剥不截)⇒ 兄弟模块
  即使传未净化值,ESC / 换行也进不了日志;固定路径整行不被截断
- 源级守卫白名单补齐 eprintln!("{line}") 形态 ⇒ 合法重构不再假红
- 固定路径的期望整行拆成两份互相独立的期望值 ⇒ 同步改写不再全绿
- emitted_count 的「原始行数」语义被用例钉住 ⇒ 行数防线不再依赖未钉语义

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 19:47:55 +08:00
adminandClaude Code 17cfc505e9 fix(auth): 引导失败不得回传密钥 + 键集合测试对着生产函数断言 + 锁改为进程级
- bootstrap INSERT 失败时不再回传/打印密钥(否则会打印一个永远登不上的死凭证),
  且 main.rs 因「没有身份」直接退出进程
- me_payload_key_set_is_stable 改为走生产函数 me_payload 比对精确键集合(原先是字面量自证)
- db_lock 改为进程级单例(pglite-rs 每进程只允许一个 PGlite ⇒ 一个进程只需要一把锁),
  main.rs 只造一个 AppState
- 启动时每次回显生效的身份 id/identityCode;配置码与库中已有身份码不一致时明确告警
- 随机密钥挪到「确定要建身份」之后生成(签发即落库变成结构上的不变量)

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 19:42:35 +08:00
adminandClaude Code c95b9d6e10 fix(auth): 闸门解耦 + 拒绝体自洽 + 白名单尾斜杠对齐 Spring
- require_internal_or_user 改成独立 match 臂,不再是 require_menu_permission 的别名
  (上游两者语义不同;别名会让 Task 12 收紧菜单检查时连坐收紧数据面闸门)
- reject() 改成显式传 HTTP 状态,body 的 code 由状态推出 ⇒ 结构上不可能错配
- ant_match 只去前导斜杠,尾斜杠保持显著(对齐 Spring AntPathMatcher)
- 补路由级中间件测试:白名单/内部令牌/协议闸门只作用内部通道/会话通道/SPA 深链/401 形状
- 补三个断言型测试:闸门独立性、拒绝体 code==状态、尾斜杠语义

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 19:24:37 +08:00
adminandClaude Code aea73ab040 fix(identity): Auth/Me 补 endpoint / tdsEndpoint(上游前端真的在读)
- 上游 IdentityManage 的 connIdentity 就是 me,表单预填从 me.endpoint / me.tdsEndpoint 取
- 两值取自 tdc_identity.f_endpoint / f_tds_endpoint,可为 null
- 与上游的一处有意差异:上游在 endpoint 为空时回退 tdc-report.base-url,
  本仓无该配置且无「平台回连」场景,不做回退(错的预填比空字段危险)
- me 的键集合 13 → 15(精确集合断言同步)

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 19:00:52 +08:00
adminandClaude Code c29e12184b feat(auth): 应用状态 + 身份域(登录/Me/SsoConfig/Spaces)+ 首次启动身份引导
- state: AppState 持有 Arc<PGlite> + db_lock + 会话存储 + 配置
- identity: 登录逐字对齐上游 AuthController(5 条失败文案 + 常量时间比较密钥)
- bootstrap: 首次启动建本地身份并把随机密钥打印一次;已有身份则幂等跳过
- routes: build_router 装配 health/auth/crud 三段路由

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 18:55:28 +08:00
adminandClaude Code d4ba87c235 fix(protocol): 闸门回归保护补强 —— 副作用级断言 + 封住跨模块出口
- emit_warn 构造完整输出行一次,真实输出与测试记录器共享同一字符串(不再分叉)
- 记录器改为线程局部并统计“实际发出的行数”⇒ 同 key 只发一次 / 洪水量 256 封顶在输出层被钉住
- 新增子进程用例:真 stderr 必须逐字出现两条 WARN 行(含前缀)
- 新增源级守卫:emit_warn 里恰好一处真实标准错误输出,打印共享的那一行
- warn_once_variable 降为模块私有 ⇒ 兄弟模块无法用未净化值触发告警
- 补消息内容/标签顺序/前缀/净化上限 64 字节的精确断言;ends_with 换 assert_eq
- 补正向 doctest,钉住 crate 路径可解析(compile_fail 不再因路径写错而假通过)

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 18:09:37 +08:00
adminandClaude Code fd40402a99 feat(security): 连接器入向鉴权三道门 + Ant 白名单匹配
- 执行顺序照搬 TdcAuthFilter:OPTIONS → 白名单 → 内部令牌(+协议版本闸门) → 会话令牌 → 401
- 401/403 用裸三字段形状 {success:false,code,msg}(无 data),与业务信封分开
- 控制器层三道门 require_menu_permission / require_internal_or_user / require_internal_only

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 17:42:12 +08:00
adminandClaude Code 6ce5d093ba test(session): 补两条断言 —— TTL 端到端锚定 + revoke 否定分支
复审指出的两个测试覆盖盲区(实现本身无误,仅补测试):

- session_expire_at_is_anchored_to_session_ttl:从内部 map 直接读出会话的
  expire_at,断言其落在 now + SESSION_TTL ±1 秒窗口内。此前把
  expire_at 改成 now + 3600s 六个测试全绿,会话时长可静默漂移。
- revoke_returns_false_for_unknown_token:断言吊销从未签发的 token
  返回 false,且同一 token 二次吊销也返回 false。此前 revoke 恒返回
  true 也全绿。

未改动实现、未改动既有六个测试。

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 17:35:29 +08:00
adminandClaude Code 8bedae5aaf feat(auth): 连接器会话存储(内存 / 30 分钟 TTL / 32 位十六进制 token)
Co-Authored-By: Claude Code <[email protected]>
2026-10-24 16:33:44 +08:00
adminandClaude Code 5069c552de fix(security): 协议闸门 fix round 3 —— 封住调用点缺口
I1 公开 check_protocol 的「一次性告警」副作用补断言(不只测布尔返回值)
I2 打进日志的 key 与消息体改收 SafePeer newtype(字段私有 + 子模块封装
   ⇒ 调用点在类型上无法把未净化的对端值送进日志;净化恰好一次)
I3 warn_once 加 compile_fail doctest,把 &'static str 的类型级保证钉住
M1 净化样本扩到 C1/零宽/双向隔离/BOM,逐字符断言
M2 连续两次 check_protocol(None) 都必须放行(钉住返回元组顺序)
M3 洪水量上界写成字面量 256,并钉住 WARN_ONCE_MAX_KEYS == 256
M4 emit_warn 注释锁死「打印在集合锁释放之后」的不变式
M5 端到端断言钉住变量告警 key 的前缀与净化后的对端值

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 16:27:38 +08:00
adminandClaude Code ec18a3f2ee fix(security): 协议闸门 fix round 2 —— 堵日志放大器 + 补公开 API 覆盖
I1 变量 key 集合满了改为抑制(不淘汰):淘汰会让每个新版本串补一条 WARN,
   退化成按对端节奏的无界日志放大器,且被淘汰的 key 会再次告警
I2 补公开 check_protocol 的直接断言(.0/.1 反转此前 14 个用例全绿)
M1 warn_once_variable / sanitize_for_log 降为 pub(crate),收回公开面
M2 warn_once 的 key 改 &'static str:对端派生的动态 key 编译不过
M3 全局集合的精确条数断言改为包含性断言
M4 补用例钉住「固定集合无上限」
M5 is_log_unsafe 补 U+2028/U+2029(行/段分隔符)
M6 incompatible_warn_key 收已净化值,同一字符串只净化一次

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 15:31:16 +08:00
adminandClaude Code 88dd271012 fix(security): 协议闸门补 M1-M4 —— 告警可观测性 / 日志净化 / 锁粒度
M1 check_protocol 补直接单测:缺失声明放行、兼容放行、不兼容拒绝,
     且同一声明值只告警一次(用私有 check_protocol_with_warn 暴露告警结果)
M2 固定 key 与变量 key 分开计数:固定 key(protocol:missing)永不受上限影响;
     变量 key 集合有界(256)且满时淘汰旧 key,对端灌不爆告警通道
M3 对端可控的声明值进日志前净化(去 C0/C1 控制字符、ANSI ESC 序列、
     双向控制字符,截断 64 字节);判定一律用原值,净化只用于日志
M4 告警打印与集合登记分离:判定在锁内、打印在锁外,不再持锁做 IO

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 15:13:44 +08:00
adminandClaude Code 4e1645a6b7 feat(security): 跨端协议版本闸门(InternalTokenSupport 的 Rust 等价物)
- parse_version 逐字复刻上游:两段都必须可解析,"1.x"/"1.2.3" 判为不可解析
- 只比 major;未声明 ⇒ 放行 + 一次性 WARN;声明但不兼容 ⇒ 由调用方返 HTTP 401
- warn_once 有界集合(上限 256 key)

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 14:58:25 +08:00
adminandClaude Code 4c2bdcda52 refactor(ids): IdGen 降为 pub(crate),收回公开面
- ids: IdGen 及其 new/next_at/next 降为 pub(crate),只留 next_id() 为公开面
  (next_at 可注入任意墙钟,不应成为公开后门)
- ids: 顺手清掉测试里的 3 处 clippy warning(同类型 cast / 无效 | 0)

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 14:54:48 +08:00
adminandClaude Code b477865d8c fix(contract): 内部令牌 trim 堵住安全闸门 fail-open;id 序列耗尽改逻辑毫秒推进
- config: internal_token 落库前 trim(并抽 internal_token_from 纯函数),
  check_secret_guard 比对已 trim 的值 ⇒ 带空白的默认值变体不再能绕过闸门
- ids: 序列耗尽改为逻辑毫秒 +1(不回绕、不等墙钟),
  消除时钟回拨时 yield_now 忙等烧满一个核的路径
- ids: 补纪元之前时间饱和到 0 的边界注释

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 14:45:00 +08:00