admin
|
fd8c83892d
|
docs(memory): 记录 G16 集成测试补字段与平台闭包切换的坑
- G16 加 ExecRuntime.tds 字段时漏同步集成测试,cargo test 编译不过
(cargo check 只编译 lib 故当时无感),已补齐并跑到 307 passed / 0 failed
- vendor/sspf-v0.5.0 软链指向 armv7 闭包导致 cargo check 40 errors,
切软链后必须重跑 scripts/fetch-platform.sh 重生成 .cargo/config.toml
|
2026-11-16 09:04:38 +08:00 |
|
admin
|
78248e74a5
|
fix(g16): 集成测试补 ExecRuntime 新增的 tds 字段
G16 给 ExecRuntime 加了出向 TDS 通道字段 tds: TdsClient,但集成测试
tests/exec_endpoints.rs 的构造点没同步 ⇒ cargo test 编译不过
(missing field `tds`)。按 src 内单测同口径补 TdsClient::new(None, String::new())
(契约测试不真连平台)。
验证:cargo check 通过;cargo test 全绿 307 passed / 0 failed。
|
2026-11-16 08:59:45 +08:00 |
|
admin
|
69cb6b84c3
|
feat(g16): 执行完成后自报 ExecFact + 脱敏 ExecLog(开关默认关闭)
|
2026-11-15 13:06:22 +08:00 |
|
admin
|
1dab81ddf6
|
chore(deps): Cargo.lock 跟随版本 bump 到 0.2.0
v0.2.0
|
2026-11-14 11:59:12 +08:00 |
|
admin
|
50911ea7d6
|
feat(version): 构建身份四件套,为按版本发标准包打底
- 新增 build.rs 注入 version/gitSha/target/buildTime;`--version` 打印一行。
gitSha 带 `-dirty` 后缀,避免「sha 对得上但代码其实改过」的误判。
- 版本行同时拼成静态字符串(TDC_VERSION_LINE):armv7 产物在 x86 打包机上
跑不起来,打包脚本要靠 strings 捞同一行。
- /api/health 增 gitSha/target/buildTime(纯新增,既有字段一个不动)。
- 版本 0.1.0 → 0.2.0。
动机:设备上跑的到底是哪个构建,此前只能靠 md5 比对几十兆的 `.bak`;
排查 carol 上一个 1.27M 的 mpc 时就卡在无法自证来源。
|
2026-11-14 11:57:08 +08:00 |
|
admin
|
22e6921fd3
|
feat(engine): MPC 算子白名单 + LR 参数透传,新增作废基准接口
- ensure_mpc 原只拼 PSI 参数,调 LR 会静默点火成 psi;现按
[psi, lr, lr-vertical] 白名单分派,未知算子硬拒、绝不回落。
- 参数四段优先级 payload → env → 产物 manifest.json → env 算子名;
colBlocks/labelOwner/物料缺失一律 fail-closed,不再猜。
- LR 补 --seed:缺它各端随机初始化,"三方权重一致"只是巧合而非正确。
- 新增 POST DeliveryTask/Internal/VoidAlgorithm;执行记录按 task_id
前缀匹配(实存为本端 id `<平台id>-LA`),有成功事实则拒绝作废。
|
2026-11-14 11:46:54 +08:00 |
|
admin
|
3271732e8b
|
feat(engine): 接入执行层与三入向端点,打通 Exec/Start 链路
- 新增 engine 模块(状态机/配置/SHA256摘要/进程拉起/状态):ACCEPTED→控制面→ET→Ray→MPC→终态
- 新增 controller/exec.rs:SelfCheckStatus/Dev/Artifact/Exec/Start + Exec/Status,handler 内复核内部令牌与协议版本
- 新增 client/mpc_control_plane.rs:GET /nodes /sessions /report 与 POST /desired,Bearer 鉴权
- 平台 nax 语义落地(rayHead 当 GCS、mpc 为算子执行体),密钥不落状态/回执/日志
- 海光控制面地址 192.168.1.102 → .23(运行态配置)
- tests/exec_endpoints.rs 6 条契约用例;MIGRATION.md §1.7.1 记录范围
|
2026-11-13 19:38:48 +08:00 |
|
admin
|
4b32b40bd6
|
feat(tds): 同步 ssw-tdc 最新 internal 契约并完成真 TDS 联调验证
- 协议版本收敛为单一常量 3.2,移除联调期自创的 env 覆盖
- 按真源同步 5 项契约:Dispute 下线、Billing/List 增 side、internalCatalog 6 过滤字段、新增 ServiceCatalog/Detail、出向方法收敛
- 修正 /api/** 未命中非 GET 请求被静态兜底判成 405 的偏差,恢复 404 契约
- 新增上游用例跨进程验证脚本与 4 份联调文档;部署级凭据只从环境变量读取
- 全量测试 308 passed;132 端点契约一致;真 TDS 21 条用例 19 PASS / 1 FAIL / 1 INFO
|
2026-11-05 17:53:15 +08:00 |
|
admin
|
400d883e1a
|
feat(p6): 平台改为预编译 rlib 接入,依赖全部来自包内闭包
- 新增 scripts/fetch-platform.sh:读 .sspf-version 解包 vendor/ + 生成 .cargo/config.toml(rustflags + rustdocflags),只校工具链 channel
- Cargo.toml 的 [dependencies]/[dev-dependencies] 清空:17 个 crate 全部 --extern 自平台闭包
- release profile lto 由 thin 改 false(平台 rlib bitcode-free,开 LTO 找不到 __bitcode)
- tower-http 不在闭包 ⇒ 自研 platform::static_files(ServeDir 等价,含 Range 206)与 platform::cors(permissive 等价)
- reqwest 与 extern tokio 双 runtime 必 panic(no reactor running)⇒ 自研 platform::http(HTTP/1.1 明文)
- tests/auth_flow 的 reqwest 调用改用 lib 客户端;tds_biz 的头白名单补 connection
- 新增尺子 check-platform-package.sh:依赖单一来源 + 真编一次证明平台闭包零重编
- 验收:cargo test 306 passed / 七把尺子 + 新尺子全绿;dev 构建 2.5s 只编本仓
|
2026-11-05 13:01:27 +08:00 |
|
admin
|
d875ed9964
|
docs: 决策固化——18 实体维持现状,不迁 sspf EntitySpec
- CLAUDE.md 新增「实体层边界」禁忌条:EntitySpec 仅 7 字段、crud 引擎只生成 6 条路由\n 承载不了 TableSpec 的业务语义;sspf 平台包零业务约束禁止吸收 tdc CRUD 逻辑\n- 工作日志记录评估结论 + 防回归提示
|
2026-11-04 23:28:00 +08:00 |
|
admin
|
e13768edd5
|
feat(p5): 业务库操作改走 sspf Db,与平台共用同一把锁
- Cargo.toml 升到 sspf v0.5.0;platform/db.rs 注入进程级 Arc<Db>
- query_json_params→query_json_raw(不归一)/ exec_params / query_scalar_text+column_types→query_rows
- 函数签名仍 db: &PGlite,service/* 与 controller/* 零改动;ensure_schema 启动期豁免
- main.rs 在任何业务 DB 操作前注入,失败即退出(不接受静默双锁)
- 新增 tests/sspf_db_lock.rs:真库验不归一 + 平台持锁时业务写排队
- 双契约尺子 17→18 断言(启动日志自证锁已接入)
- sspf_platform_package 的版本断言改为从 Cargo.toml 读 tag 对账,升级不再手改
- cargo test 296 passed / 0 failed / 1 ignored;七把尺子全绿
|
2026-11-04 23:08:08 +08:00 |
|
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 |
|