Commit Graph
94 Commits
Author SHA1 Message Date
admin 43dcd3f9eb chore(p4): 收拢库操作到唯一出口,为统一 sspf Db.lock 做准备
- 新增 platform::db::exec_params,收拢业务层 12 处裸 state.db.query
- 新增 check-db-access.sh 护栏:白名单 3 文件,7 处命中 0 越界
- 平台侧需求写入 ssw-platform/docs/SSPF-BUSINESS-DB-ACCESS.md(目标 v0.5.0)
- Cargo.toml 仍锁 v0.3.0,132 端点契约与响应形状未变
2026-11-04 22:20:55 +08:00
admin 6a66698607 feat(p3): 打通 tdc 与 sspf 面 B 会话,同一 token 通吃双契约
- 业务登录镜像一条平台会话,平台 Router 上翻译 Authorization
- 映射挂在 tdc 会话行,过期/吊销后面 B 同步失效
- 对外 token 仍是 32 位 hex,132 条端点契约不变
- 双契约尺子 10 扩到 17 断言,cargo test 294 passed
2026-11-04 21:25:03 +08:00
admin d10480abb6 feat(p2): 接入 sspf v0.3.0,单进程/单库/单端口双契约装配
- main.rs 改两阶段 assemble/finish,共用平台 PGlite;业务 Router 优先 + 平台兜底嵌套(绕开 6 条撞车路径)
- 新增 tdc/schema.rs 共库建表:跳过多条同源 base_* DDL,剥前导注释后按动词+对象名精确判定
- health 的 baseTables 按 migrate.sql 声明清单计数,共库后仍为 3
- on_ready 清理平台单-md5 admin 种子,由业务账号层按官方双 md5 重新引导
- 新增 check-dual-contract.sh 附加尺子(10 断言)与 CLAUDE.md 架构同步
- 验收:285 测试 / 五把尺子全绿 / 双契约 10-10
2026-11-04 20:29:15 +08:00
admin 044ddc5f28 docs(memory): 记录第二份平台侧需求(业务自带状态装配)与 axum 类型链实测 2026-11-04 17:30:11 +08:00
admin 8a351b7de9 feat(p1): 接入 sspf v0.2.0 平台包(git tag 锁版本)
- 锁 rustc 1.95.0 与平台一致;release 去掉 panic=abort,保留 catch-all 所需 unwind
- 新增 P1 接入探针:只靠门面起单端口/单库,验面 B 登录、注入 DDL 与业务端点、零示例包
- 同步 CLAUDE.md 的 profile 描述;记录装配切换的状态类型阻断
2026-11-04 17:16:57 +08:00
admin be82334972 chore: 收尾 sspf 改造前基线 —— dev 关闭增量编译 + 记录平台包调研结论 v0.1.0-pre-sspf 2026-11-04 17:07:23 +08:00
adminandClaude Code 1a0fdbf879 feat(upstream-parity): 移植上游测试用例 —— 29 条对位用例 + 第五把尺子
**影响**
- 生产档弱密钥守卫从「只比默认值」升级为上游 `ProdGuard` 的**六条判据**(纯函数),
  弱令牌用「默认值加后缀」绕过、弱标记词、长度下限三类都拦得住;`CIPHER_KEY`(协议共享值)**不受管**。
- 出向 TDS 超时**外置到 env**(`SSW_TDS_CONNECT_TIMEOUT_MS` / `SSW_TDS_READ_TIMEOUT_MS`),
  且**只有 cause 链里真有超时**才改写文案 ⇒ 连接被拒 / DNS 失败不再被误报成「超时」(排查方向不被带偏)。
- 上游 15 个测试类全部**登记在册**:3 个已移植(29 条对位用例)、12 个判定超范围(逐条记理由)。
- 新增第五把尺子 `scripts/check-upstream-tests.sh`:台账 ⇄ 代码 ⇄ 上游测试类集合三向对账,
  上游新增测试类而台账没登记 ⇒ **红**(不靠"记得看"防漂移)。
- 回归网:`cargo test` 246 → **278**(+32),其余四把尺子与引用自检**全绿**。

**改动**
- `src/platform/guard.rs`(新):上游 `ProdGuard.violations` 的纯函数移植(弱值清单 / 弱标记词整体词匹配 / `MIN_LEN=12` / 逐条点名)。
- `src/platform/config.rs`:`check_secret_guard` 改走守卫判据;新增 `guard_values`(只放本部署真有的键)
  与出向超时两项配置(非法值回落默认,不让连接器起不来)。
- `src/tdc/client/tds.rs`:新增 `cause_chain_has_timeout` / `timeout_text_or_null`(cause 链遍历**有界** `depth<16`),
  `TdsClient::with_timeouts` 接受超时。
- `tests/upstream_guard_parity.rs`(新 · 19 条)+ `tests/upstream_tds_timeout_parity.rs`(新 · 10 条)。
- `scripts/upstream-test-ledger.tsv`(台账真源)+ `scripts/upstream-test-census.py`(上游测试类普查/对账)
  + `scripts/check-upstream-tests.sh`(第五把尺子)。
- 文档:`docs/UPSTREAM-TEST-PARITY.md`(新)+ `docs/known-limitations.md` L8 + `docs/decisions.md` D22/D23
  + `CLAUDE.md` 同步(尺子表 / 目录树 / 命令速查 / 实现细节 22–23 / 坑位表)。

**设计**
- 上游 hop 1 的「反射读 socket 工厂」**抄不了**(`reqwest::Client` 不暴露超时 getter)⇒ 改用**行为级**判别
  (同一延迟 TCP 服务器:短超时⇒超时错、长超时⇒成功)⇒ 结论等价且更强(真跑 socket 层)。
- 上游 `*SelfTest.java` **surefire 不跑**(无统一入口)⇒ 判据落成 `cargo test` 常规用例(纯函数 ⇒ 可离线断言)。
- 超范围判定原则:**本仓没有对应功能 ⇒ 不搬**(硬搬只会是假绿);「机制」已覆盖的(P2P 那条)按机制记账。

Co-Authored-By: Claude Code <[email protected]>
2026-10-27 09:04:08 +08:00
adminandClaude Code ec7126fe6b docs(b5): 修正验收口径 —— 测试数 236→246、实体尺 PASS 15→13 的成因
两处数字此前记错,本批实测后更正并写明成因,避免下一轮把「更正」当成回退。

- `cargo test`:**236 → 246**。此前记的「172 lib + 62 集成」是误数
  (`src/` 与 `tests/` 自 B4 起未变 ⇒ 逐二进制实测就是 246;
  B4 提交信息里的 236 同误)。B4 提交信息不动(历史),从本批起统一用 246。
- `check-entity.sh`:**PASS 15 → 13**(B1a 基线 15)。不是回退 ——
  E6「权限键不重复」的 2 条断言随 B4 的 D6(删 18 条实体级权限键)自动跳过
  (`scripts/check-entity.sh:269-279` 的 `else` 分支)⇒ 少的是 2 条**已不适用**的断言。

Co-Authored-By: Claude Code <[email protected]>
2026-10-27 00:57:00 +08:00
adminandClaude Code 2e7f9b1975 feat(b5): 工程化外壳(文档层)—— 契约四件套 + 两本手册 + 第四把尺子
把 v3 spec §11.2 要求的整套文档层补齐,并把 spec §11.1 欠下的
「浏览器验收重跑」在真实上游 SPA 上补做完(内核浏览器 aix 驱动)。

新增文档:

- `docs/contract.md`(重写):**132 端点全表** + 4 种响应形状 + 数据模型 + 时间口径,
  唯一真源。端点表由 `scripts/check-contract.sh` 与源码注册路由**逐条对账**。
- `docs/decisions.md`(重写):逐条裁决 D1–D21。
- `docs/known-limitations.md`(重写):L1–L7,含 §5.4 权限敞开的显式条目(L4)。
- `docs/runbook.md`(新):怎么起 / 怎么冒烟 / 常见故障。
- `MIGRATION.md`(新):Java TDC ⇄ Rust 逐件翻译表 + 口令换算 + 数据 ETL。
- `HOWTO_ENTITY.md`(新):加一个实体(含子表挂载面)。
- `docs/ACCOUNT-LAYER.md`(新):`base_user` 账号层(官方双 md5 公式)。
- `docs/CONSOLE-ACCEPTANCE.md`(重写):**B5 重跑版**浏览器验收。

新增尺子(第四把 + 两把专项):

- `scripts/check-contract.sh`:端点表 vs 实际注册路由对账(132 == 132)。
- `scripts/check-citations.py`:文档里 `文件:行号` 引用逐条校验(139 条 0 失效)。
- `scripts/upstream-action-census.py`:上游动作端点普查(只读上游克隆,可复算)。
- `scripts/contract_probe.py`:动作端点形状探针(109 条逐条打过,零偏差)。

影响:

- **L5 数字纠正**:原先记的「111 条上游动作端点未实现」口径错了
  (`grep -rhoE` 只抓带参数的映射、且跨了全部 31 个控制器)
  ⇒ 真实数字 **109**(122 声明 − 11 CRUD 基线 − 2 聚合详情 = 26 形态 A + 83 形态 B)。
- **L7(新增)**:**26 条**上游动作端点**不会 404** ⇒ 被通用详情路由 `/{Entity}/{id}`
  吞掉(`src/tdc/controller/crud.rs:65-93`)⇒ GET 返回 **200 + `code:400`**、
  POST 返回 **405** ⇒ 上游前端下拉框静默变空。**只判 HTTP 状态码会误判成成功**。
- **CONSOLE-ACCEPTANCE §4 纠正**:服务目录 / 我的账单**已实现**(P4),
  失败点在**连接器身份闸门**(`f_tds_space_id` / `f_tds_connector_id` 为空 ⇒ 出向前 fail-closed),
  **不是** TDS NOOP 降级、也不是代理 404。
- `CLAUDE.md` 同步:目录树、红线、坑位表(「上游动作端点不 404」新增一行)。

实测:cargo test **246** 项全绿 0 failed(1 ignored)· smoke.sh PASS=80 FAIL=0 ·
check-boundary.sh exit 0 · check-entity.sh PASS=13 FAIL=0 ·
check-contract.sh 132 条端点一致 · check-citations.py 139 条引用 0 失效 ⇒ **六把尺子全绿**。

⚠️ 口径更正:此前(B4 提交信息与记忆文件)记的「172 lib + 62 集成 = 236」是**误数**
—— `src/` 与 `tests/` 自 B4 起未变,逐二进制实测就是 246 ⇒ 从本批起统一用 246。

Co-Authored-By: Claude Code <[email protected]>
2026-10-27 00:56:09 +08:00
adminandClaude Code 54475322e0 feat(b4): 账号层切 base_user —— 官方双 md5 公式 + 删 18 权限键链路
账号层从本机 JSON 文件迁到 `base_user` 表,口令改用官方双 md5 公式,
并把从来没在管的「实体 → 权限键」那一层整条拆掉(D6 / D11)。

改动:

- `src/tdc/service/account.rs`(重写):账号读写 `base_user` / `base_role` /
  `base_role_relation`;口令 `f_password = md5(lower(md5(明文)) + lower(f_secretkey))`
  (上游 `PasswordTokenGranter.java:186`),`f_secretkey` 每账号随机 UUID v4,
  改密不换 secretkey;引导幂等;管理员位 = `f_is_administrator=1`,查询异常 ⇒ false。
- `src/tdc/controller/account.rs`(重写):登录改走官方公式比对;`require_admin` 改异步、
  按 `f_is_administrator` fail-closed;出参形状不变、不回显口令与 secretkey。
- `src/tdc/entity/mod.rs`:删 `PERMISSION_KEYS` / `permission_key()`(18 条实体级权限键)。
- `src/tdc/service/identity.rs`:删 `capabilities()`;`/Auth/Me` 加 `roles` 键
  (上游 `AuthController#me:207` 同款),角色码 SQL 逐字照抄上游。
- `src/tdc/service/crud.rs`:删 `require_write_permission()`,写路径改用
  `require_menu_permission()`(与上游 `TdcCrudController.requireMenuPermission()` 同构)。
- `src/main.rs` / `src/tdc/state.rs` / `src/tdc/config.rs`:账号层改由
  `bootstrap_account_layer()` 引导;`data/accounts.json` 保留但不再读取。
- `tests/permission_gate.rs` → `tests/permission_model.rs`(断言模型换成登录态闸门)。

影响:

- 登录 / 用户管理 6 端点的数据源从 JSON 文件变成 `base_user` 表;出参形状不变。
- 实体级写权限**敞开**(任何登录用户可写全部 18 个实体)—— 与上游同构,
  显式记账在 `docs/known-limitations.md` L4;部署退出门槛 = 账号只发给受信人。
- 存量 `data/accounts.json` 的账号**不导入**(D8)。

实测:cargo test 236 项全绿 0 failed · smoke.sh PASS=80 FAIL=0(基线 75 ⇒ +5)·
check-boundary.sh exit 0 · check-entity.sh PASS=13 FAIL=0。

Co-Authored-By: Claude Code <[email protected]>
2026-10-26 23:53:07 +08:00
adminandClaude Code ec47f47d46 feat(b3): 子表聚合补齐 —— 挂载面逐父子照抄上游(不新增端点)
影响:6 张「上游无独立控制器」的子表挂进父实体的响应;
245 条测试全绿(+6),冒烟断言数仍 76,边界/实体自检全绿。
Resource/Dataset 的普通详情**不带**子表(上游只在 /Detail 聚合体上挂)。

改动:
- src/tdc/entity/mod.rs:新增 ChildMount(Aggregate/Detail/List 三面)与
  ChildTable(key/table/fk_column/parent_column/order_column/alive/mounts),
  TableSpec.child_tables 由 (key, table) 二元组升级成 ChildTable 切片;
  validate() 增加子表标识符白名单自检 + 「聚合体开关 ⇔ 有 Aggregate 面子表」一致性自检
- src/tdc/entity/{resource,dataset}.rs:字段说明 + 脱敏规则挂 Aggregate 面
- src/tdc/entity/data_interface.rs:参数 + 字段映射挂 Detail 面(上游覆写基类详情)
- src/tdc/entity/delivery_task.rs:参与方挂 Detail+List 面(按 f_tds_task_id),
  待发队列挂 Detail 面(按 local_task_id)
- src/tdc/service/crud.rs:子表挂载引擎(父行取值 / 单父取子行 / 批量取子行 /
  单行回填 / 列表回填),引擎仍零 match api_name(只认列名)
- tests/child_aggregate.rs(新):4 条集成用例(接口详情带子表 / 资源子表只在聚合体 /
  交付任务详情与列表带参与方 / 无平台任务号 ⇒ 参与方空集合)
- docs/contract.md(新增 §子表聚合)/ docs/decisions.md(D19)/
  docs/known-limitations.md(L3)/ CLAUDE.md / .workbuddy/memory/2026-10-26.md 同步

设计:挂载面逐父子不同(上游口径不是「子表都挂详情」)—— Resource/Dataset 只在
/Detail、DataInterface 只在普通详情、DeliveryTask 详情+列表;父行取值列不一定是
f_id(参与方按平台任务号挂 ⇒ 无平台任务号即空集合);存活谓词逐表不同(四张
资源/接口子表没有 f_delete_mark ⇒ 物理删除语义,不加谓词)。
outbox 挂详情是本仓扩展(上游不挂);tdc_demo_car_insurance 无父外键 ⇒ 挂不了,
记为已知限制 L3,不硬挂。

Co-Authored-By: Claude Code <[email protected]>
2026-10-26 23:15:42 +08:00
adminandClaude Opus 4.8 70b540f668 feat(b2): 账号层三表入 schema —— base_user / base_role / base_role_relation
影响:/api/health 的 baseTables 从 0 变 3(tables 仍 30);data/ 清空重建。
冒烟断言数 75 → 76(多的那条是 baseTables 对账),其余契约零变化。

改动:
- schema/migrate.sql:末段追加账号层三表(真源 = 上游 j7
  boot/db/j7/V1.0.0__jnpf_base_schema.sql,base_user 在 :17384):
  列类型/列序/96 条 COMMENT ON/3 个索引逐字搬运;
  主键 PRIMARY KEY (f_id, f_tenant_id) 内联(上游在 dump 后置 ALTER 里加,
  pglite 只吃 migrate.sql ⇒ 必须自带)
- tests/schema_init.rs:public 表数 30 → 33,并逐名断言 base_* 三表在位
- src/platform/db.rs:迁移产物单测改成 30 tdc_* + 3 base_* 逐名断言
- scripts/reset-data.sh:提示语改成「30 张 tdc_* + 3 张 base_*」
- docs/known-limitations.md:新增 L2(上游 base_user 的 f_maxkey_user_id
  没建 —— 本仓不实现 MaxKey SSO)
- CLAUDE.md / .workbuddy/memory/2026-10-26.md 同步

设计:tdc_* 侧零 DDL 改动(B0 已逐列对账一致);base_* 只建上游真正用到、
且本仓要用的三张,其余 120 张 base_* 与 base_module/base_authorize 一律不建。

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
2026-10-26 22:58:53 +08:00
adminandClaude Opus 4.8 d4a22e18b0 refactor(b1b-c12): 手写日历算法换 chrono —— 时间口径写进 contract.md
影响:仓里不再有第二套日期换算实现;对外行为零变化
(239 条测试全绿、冒烟断言数仍 75、边界与实体自检全绿)。

改动:
- src/tdc/service/account.rs:删手写 civil_from_days(天元纪日换算)与手拼
  now_iso(),一律 chrono(Utc::now().format("%Y-%m-%d %H:%M:%S"))
  ⇒ 输出值与原来逐字相同;单测换成 now_iso_is_utc_and_parsable
    (形状可解析 + 与 Utc::now() 差 ≤ 5 秒 ⇒ 有人改成 Local::now() 会红)
- src/tdc/util/code.rs / src/tdc/service/crud.rs:补口径注释(业务编码与
  DB 审计列 = 服务器本地时区,与上游 LocalDateTime.now()/now() 同口径)
- docs/contract.md(新):时间口径对照表(含 file:line 引用)
- docs/decisions.md(新):决策日志 D1–D16 摘要 + 补记 D17 + 新增 D18
- CLAUDE.md / .workbuddy/memory/2026-10-26.md 同步

设计:spec 的「口径统一为 UTC」没有全仓执行(记 D18)—— 全仓 UTC 会让业务
编码的日期段在上游的 8 小时错位窗口里差一天 ⇒ 造出新的对上游偏差,且违反
B1b「行为零变化」;落地口径 = 账号库自有审计字段用 UTC(无上游对照物),
业务编码与 DB 审计列用服务器本地时区(有上游对照物)。

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
2026-10-26 22:38:24 +08:00
admin fbee7ae860 refactor(b1b-c11): 常量时间比较上收到平台层 —— 两份实现合一
影响:全仓只剩一份 constant_time_eq 实现;对外行为零变化
(239 条测试全绿、冒烟断言数仍 75)。

改动:
- src/platform/compare.rs(新):常量时间比较的唯一实现 + 2 条单测
  (含多字节 UTF-8 用例)
- src/tdc/service/identity.rs / src/tdc/service/account.rs:
  各自的本地实现换成 pub use 复用平台那一份 ⇒ 调用方路径不变、实现只有一份
- src/platform/mod.rs:挂上新模块
- CLAUDE.md / .workbuddy/memory/2026-10-26.md 同步

设计:比较(compare)与加解密(cipher)分成两个平台件,不混在一起。
2026-10-26 22:31:31 +08:00
admin 3076bdae7a refactor(b1b-c10): tdc_identity 领域 SQL 收口到 identity 服务,只 SELECT 明确列
影响:控制器层不再自己拼 tdc_identity 的 SQL(原先散在 TDS 账单控制器里的
那一条已移入领域服务);对外行为零变化(237 条测试全绿、冒烟断言数仍 75)。

改动:
- src/tdc/service/identity.rs:新增 TdsBinding + local_tds_binding()
  (取本端默认身份的 f_tds_space_id / f_tds_connector_id,SQL 只列明确列)
- src/tdc/controller/tds_biz.rs:local_identity() 改为转调领域服务;
  两处 resolve_connector_id_* 的入参类型换成 identity::TdsBinding
- docs/known-limitations.md(新):记 L1「tdc_identity 双读写路径」
  (上游无通用引擎概念,硬收会失真 ⇒ 显式承认 + 收口 + 记账 = 决策 D15)
- CLAUDE.md / .workbuddy/memory/2026-10-26.md 同步

设计:领域路径只 SELECT 明确列 ⇒ 密钥列 f_secret_key 不会被整行拖进内存。
2026-10-26 22:29:04 +08:00
admin 49e5fcefe4 refactor(b1b-c9): 状态分家 —— 平台 AppState 只留运行态,业务态进 TdcState
影响:平台层不再认识业务类型(引导身份 / 本地账号库 / TDS 客户端 / 业务配置
全部移出 AppState);对外行为零变化(237 条测试全绿、冒烟断言数仍 75)。

改动:
- src/platform/state.rs:AppState 收敛为 {config, db, db_lock, sessions}
- src/tdc/state.rs(新):TdcState = platform + 业务配置 + 引导身份 + 账号库 + TDS 客户端
  · Deref<Target = AppState> => 业务层字段访问(state.db 等)写法不变
  · impl FromRef<TdcState> for AppState => axum 里 State<AppState> 仍可用
- src/main.rs:装配顺序改为 platform -> bootstrap_identity -> TdcState
- 控制器/服务/测试:入参一律换成 &TdcState(bootstrap_identity 仍是 &AppState,
  它跑在装配期,那时 TdcState 还没造出来)
- scripts/check-boundary.sh:新增第 5 个接触点 CP5(平台层不得 use crate::tdc::),
  专门盯这条反向依赖;CP1 只查表名/端点前缀,查不出模块引用
- CLAUDE.md / .workbuddy/memory/2026-10-26.md 同步

设计:FromRef 在 axum::extract(不是 axum::core::extract)=> 手写 impl。
2026-10-26 22:24:54 +08:00
adminandClaude Code 6e14fbeb47 chore(scripts): 加 SysV 信号量泄漏回收工具(macOS + PGlite 专用)
macOS(XNU) 的 SysV 信号量集在创建进程退出后不回收,且系统不带 ipcrm/ipcs。
本仓每轮 cargo test 会新建若干 PGlite 实例(initdb 阶段 semget 一个
nsems=20 的 set)=> 跑够几百轮后 kern.sysv.semmns(87381) 被撑满,
任何新的 PostgreSQL 实例都起不来(semget: No space left on device)。

- scripts/ipc-reap.c:只读扫描 id 空间 + 精准 IPC_RMID 回收
  口径:nsems==20(PGlite 指纹)且创建者 uid==当前用户
        且最近一次 semop 距今超过阈值(活实例不会被误删)
- scripts/reap-ipc-leaks.sh:编译 + 调用的壳脚本,支持 --dry-run

实测(2026-10-26):回收 4350 个残留 set / 87000 个信号量,
可建 set 上限从 9 个信号量恢复到 4096 个。

Co-Authored-By: Claude Code <[email protected]>
2026-10-26 22:19:23 +08:00
adminandClaude 1797aa0d64 refactor(b1b-c8): 配置分家 —— 平台 Config 零业务字段
**影响**
- `platform::config::Config` 不再持有 `identity_code` / `identity_name` /
  `identity_secret` / `bootstrap_admin_account` / `bootstrap_admin_password`;
  平台层**不认识**「本连接器是谁」。
- 新增业务层 `tdc::config::TdcConfig`(同五项)与 `tdc::constant`(默认值 + 业务 env 名清单)。
- 对外契约**零变化**(env 名、默认值、取值口径逐字不变)。

**改动**
- 新增 `src/tdc/config.rs`:`TdcConfig::from_env` / `from_raw`(纯函数,可单测)/
  `Default`;`src/tdc/constant.rs`:默认值 + 5 个业务 env 名(+ 撞名自检)。
- `src/platform/config.rs`:删 3 个业务常量与 5 个字段;`env_or_default` 转 `pub`
  (平台提供**机制**,业务提供**清单**)。
- `identity::bootstrap_identity(state, &tdc_config)`:业务配置改为**显式入参**
  (平台层不再持有它 ⇒ 装配层递进去)。
- `main.rs` 造 `TdcConfig::from_env()` 并递给引导与账号库;
  8 个测试文件同步改用 `TdcConfig`。
- `CLAUDE.md` + `.workbuddy/memory/2026-10-26.md` 同步。

**设计**
- `TdcConfig::from_raw(..)` 做成纯函数(不读进程全局 env)⇒ 与平台层同口径,
  测试不引入串行/并行竞态。

Co-Authored-By: Claude <[email protected]>
2026-10-26 20:57:38 +08:00
admin f8764b248c feat(b1b-c7): /api/health 补 baseTables —— W5 契约的账号层表数
- health 控制器(已在业务层 tdc/controller/health.rs)改成**一次查询数两类表**:
  `tables` = public schema 下 tdc_* 条数(P0 口径 30),
  `baseTables` = public schema 下 base_* 条数(B2 建表后为 3,当前 0)
- 两个计数都真查库,与 schema/migrate.sql 逐名对账由 scripts/smoke.sh 守住
  (smoke 里 baseTables 的断言是条件式的 ⇒ 本批断言数仍为 75)
2026-10-26 20:44:44 +08:00
admin 8618465a9b docs(b1b-c6): 记下「假权限层」的拆除清单 —— 零代码改动
C6 的原话是「平台引擎 → 业务域的反向依赖」⇒ 该反向依赖已随 B1b 搬家消失
(引擎住业务层 ⇒ service/crud → service/identity 是业务→业务)。
但权限键逻辑本身还在,故在两处**记下 B4/D6 的拆除清单**,以免实施时漏删:
- service/crud.rs::require_write_permission 的文档注释
- entity/mod.rs::PERMISSION_KEYS 的文档注释(18 条权限键 + permission_key()
  + identity::capabilities() + require_write_permission() + create/update/delete 三处调用点)
🔴 B4 只删假权限层,不把权限收紧成 fail-closed。
2026-10-26 20:38:33 +08:00
admin df7ce37ba9 refactor(b1b-c5): 白名单清单归业务层 —— 平台层零端点字面量
- 删掉 platform::auth 的 WHITE_URL / EXTRA_WHITE_URL 两个 const
- AuthState 增字段 public_paths: Arc<Vec<&'static str>>(清单由业务层注入)
- 清单真源移到 tdc::support::public_paths:4 条活路径(3 业务 + /api/health),
  并剪掉上游 gateway.white-url 里本仓**无对应路由**的 9 条死路径
  (Gateway×2 / P2P×5 / Portal / Topology)⇒ 记 D17(spec 写「7 条」与实际「9 条」有出入)
- platform::auth 的 is_white_url 改成「清单由调用方给」,机制不变(Ant 匹配)
- 单测:平台层 white_url_matching_is_manifest_driven(机制)+
  业务层 the_manifest_holds_exactly_the_live_endpoints / dead_upstream_paths_are_not_in_the_manifest
- 边界账本清空 B1b 责任条目(CP1/CP4 全部归零)⇒ 账本只剩 2 条永久豁免
2026-10-26 20:36:17 +08:00
admin 42cb97cabc refactor(b1b-c4): schema 探针通用化 —— 平台层零业务表名
- ensure_schema 的探针从 `SELECT 1 FROM tdc_identity LIMIT 1` 改成
  `SELECT count(*)::text FROM pg_catalog.pg_tables WHERE schemaname = 'public'`
  ⇒ public 下有表就跳过 migrate.sql(单 schema 布局,base_* 与 tdc_* 同处 public)
- 新增 tests/schema_init.rs(独立测试二进制,自带一个临时 PGlite):
  首启建出 30 张业务表 + 二跑幂等不增删表
- 边界账本删掉已失效条目(CP1 db.rs tdc_identity)
2026-10-26 20:30:46 +08:00
admin 8b4721601f refactor(b1b-c3): 聚合体路由由 spec 声明 —— 控制器零硬编码实体名
- TableSpec 增字段 aggregate_detail: bool
- Resource / Dataset 置 true,其余 16 个置 false
- controller/crud.rs 删掉 find("Resource")/find("Dataset") + expect,改为遍历 ALL_SPECS 按 flag 注册
- 补单测 aggregate_detail_is_pinned_to_the_resource_side(聚合体 ⊆ 有子表)
- 边界账本删掉已失效的两条 CP3(controller/crud.rs find(...))
2026-10-26 20:26:19 +08:00
admin c4840a3aa2 refactor(b1b-c2): 查无文案归业务 spec —— 引擎零 match api_name
- TableSpec 增字段 not_found_msg: &'static str(默认「记录不存在或已删除」)
- Dataset 一条保留上游特例「数据集不存在或资源已删除」,其余 17 个取默认
- service/crud.rs 删掉按 api_name 分叉的 detail_not_found_msg(),改读 spec.not_found_msg
- 补单测 only_dataset_overrides_the_not_found_message(17 条默认 + 1 条特例)
- 边界账本删掉已失效条目(CP3 crud.rs match api_name)
2026-10-26 20:23:32 +08:00
admin a3f6de5b36 refactor(b1b-c1): 子表声明归业务 spec —— 引擎零 match api_name
- TableSpec 增字段 child_tables: &'static [(&'static str, &'static str)]
- 18 个实体 spec 各自声明子表(Resource / Dataset 两条,其余 16 条空)
- service/crud.rs 删掉按 api_name 分叉的 child_tables(),改读 spec.child_tables
- 边界账本删掉已失效条目(CP3 crud.rs match spec.api_name)
2026-10-26 20:20:18 +08:00
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 2180660523 feat(b1a): 三把尺子 —— HTTP 契约冒烟 + 边界静态自检 + 实体静态自检
cargo test 是进程内 oneshot,从不经过 HTTP 层 ⇒ HTTP 状态码 / 响应头 /
body 原始 JSON 文本 / 404·405 真实形状 / 隐藏字段是否真不在出参 —— 全都没被测到。
本批只加尺子,不改任何行为。

scripts/smoke.sh(真进程真 HTTP,零 node 依赖,墙钟 ≈12s)
  ① 业务信封 200 + code ② 鉴权 401/403 裸三键(无 data)
  ③ /api/** 未命中 = 404 JSON(不是 SPA HTML)④ 405 = {code,msg,data:null} 且保留 Allow 头
  ⑤ hidden_fields(secretKey/devUrl/devToken)不在出参 ⑥ numeric 列 = JSON 数字
  ⑦ 列表分页信封 {pagination,list} ⑧ /api/health 真查库
  ⇒ 基线断言数 N = 75(后续每批只许增不许减;B1b 搬家前后必须 == 75)

scripts/check-boundary.sh(纯静态)+ scripts/boundary-ledger.txt(账本制)
  CP1 平台层无 tdc_/实体端点前缀 · CP2 平台层无业务实体名
  CP3 引擎不按实体名分支(零 match api_name) · CP4 平台 auth 无字面量端点路径
  越界不是一律红而是必须被记账;已失效的账本条目也红(账本只许变短)
  ⇒ 现状 7 条待 B1b 清 + 2 条永久豁免(SessionKind::Identity 是会话口径,非业务实体)

scripts/check-entity.sh(纯静态)+ scripts/upstream-json-ignore.tsv
  E1 表在 migrate.sql · E2 path == /api/ssw/tdc/<api_name> · E3 六条路由齐全
  E4 hidden_fields 覆盖上游 @JsonIgnore(可更严不可更松)· E5 编码前缀不重复
  E6 权限键不重复(B4 删表后自动跳过)· E7 f_↔camelCase 双向闭合
  ⇒ PASS=15 FAIL=0

src/main.rs:加 --enc 自证开关(cipher 用后端自己加密,脚本拿密文打登录)

规格更正(改提示词不改 spec 的决定):numeric 列是 JSON 数字,不是 JSON 字符串。
取证:上游 ProductEntity.java:88 的 BigDecimal 只带 @TableField、无 @JsonSerialize;
application.yml 无 spring.jackson 设置;上游全树无 SimpleModule/ToStringSerializer;
无任何 jnpf jar 含 BigDecimal 类 ⇒ Jackson 默认 ⇒ 上游发数字 ⇒ 本仓一致。
记入 v3 spec §12 D16,并改 v3 spec §2.4 ⑥ 与执行提示词 ⑥。

实测:cargo test 223 passed / 0 failed / 1 ignored;smoke.sh PASS=75 FAIL=0;
check-boundary.sh exit 0;check-entity.sh PASS=15 FAIL=0

Co-Authored-By: Claude Code <[email protected]>
2026-10-26 19:50:58 +08:00
adminandClaude Code 42dac738e3 docs(b0): 上游只读核查 —— 建过/活/删表集 + 逐名逐列对账
重放上游迁移脚本,算出三张表集(建过 43 / 活 30 / 删 13),
与本仓 schema/migrate.sql 的 30 张 tdc_* 逐名逐列对账:

- 表名差集:空;列差集:空(785 = 785)⇒ B2 无 tdc_* 追平工作量
- 实体覆盖差 10(spec 预估 9);上游控制器 32(spec 预估 33)
- 未覆盖控制器 25(spec 预估 ≈11)⇒ B6+ 的活比预想重
- 端点覆盖 124/259 = 52.1%(本仓 132 个方法级端点)
- tdc_delivery_outbox 的 9 列不带 f_ 前缀(上游原样)⇒ 不由通用引擎托管

产出:docs/superpowers/2026-10-26-tdc-rs-upstream-diff.md

Co-Authored-By: Claude Code <[email protected]>
2026-10-26 19:50:33 +08:00
admin 17a16ec930 docs(spec): v3 追加对标技能修订 + 落执行提示词
- v3 spec:补 D10–D15 / §0.5 借什么不借什么 / §2.3 边界规约 + C1–C12 /
  §2.4 三把尺子 / §5.4 权限现状盘点(五条放行路径)
- 新增 docs/superpowers/2026-10-26-tdc-rs-v3-execution-prompt.md(执行提示词)

回退点:06f5a79(B1b 搬家的 revert 基准)
2026-10-26 18:56:04 +08:00
admin 06f5a798fb docs(spec): v3 对齐设计 —— 业务包 MVC + 账号层同源 + 单库
- 四个拍板决定:上游 Vue 前端 / 业务追平上游 / 业务包 MVC 对位 / 单库
- 目标架构:src/tdc/{entity,mapper,service,controller,support,policy,engine,client}
  对位上游 ssw.tdc.*,保留通用 CRUD 引擎(hidden/frozen/分档不动)
- 数据层:单库单 schema,base_* 只建 3 张;schema 追平上游最新(43 建/30 活/13 删)
- 账号层:一步切 base_user,官方双 md5 口令公式,管理员位 fail-closed
- 权限:按上游(角色码 + 管理员位),删 18 个实体级权限键
- 分批:B0 只读核查 → B1 包结构重组 → B2 schema → B3 子表聚合 → B4 账号层
2026-10-26 15:25:39 +08:00
adminandClaude Code aa60886ce1 docs(log): 补记 HTTP 层回归与验收数字(223 passed)
**影响**
- 改动前:工作日志里 R10/R11 的验收数字停在 222 passed,且没记「活实例 curl 复验」
  被拦这件事 ⇒ 下次接手会以为还欠一次实测。
- 改动后:验收数字与最终状态一致,并写明实测被两条红线拦下、改用**永久 HTTP 层回归**替代。

**改动**
- `.workbuddy/memory/2026-10-25.md`:R10 小节补 HTTP 层回归(提交 `77c2df5`)、
  变异验证结论、以及「curl 复验为何没做」;验收数字 222 ⇒ **223 passed**。

**设计**
- 记「为什么没做 + 用什么替代」,不留悬空待办。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 15:28:01 +08:00
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