Commit Graph
66 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
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 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 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 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 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 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 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