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
|
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 |
|
 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
|
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
|
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 |
|
 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
|
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
|
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
|
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 |
|