Commit Graph
14 Commits
Author SHA1 Message Date
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 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 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 afa4a89ed0 docs(spec): 消除控制台口径残留矛盾(非目标 / 阶段顺序)
Co-Authored-By: Claude Code <[email protected]>
2026-10-24 14:05:03 +08:00
adminandClaude Code 42935a5f0b docs(plan/spec): 控制台改托管上游完整前端,新增本地账号层任务
- 决策 R1:控制台不重写,改为构建并托管上游 frontend/web 的 vite 产物
- 决策 R2:撤掉 /api/ssw/tdc/meta/entities(上游前端无消费者)
- 决策 R3:新增 Task 12,本地账号层 + /api/oauth/Login 兼容上游登录
- 规格同步:§5.1 取舍、§5.4 登录通道、新增 §5.4-A 本地账号层、§13 控制台重写
- P6 阶段并入 P0+P1;验收口径改为「能登录 + 能列出 18 实体」

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 14:03:50 +08:00
adminandClaude Code 4519a51b44 docs(plan): P0/P1 实施计划(schema + 契约骨架)
- 11 个任务:库骨架/信封/协议闸门/会话/鉴权/身份域/注册表/CRUD 引擎/路由装配/旧 API 下线与控制台/权限键
- 每个任务给出文件清单、接口签名、可直接粘贴的代码、跑测命令与提交信息
- 附 12 条完成标准与后续 P2–P6 的拆分说明

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 12:50:01 +08:00
adminandClaude Code 1e1bacf094 docs(spec): 修正 id 生成、模块划分、CRUD 两处上游缺陷与 DDL 实测计数
- §6:新增 id = 雪花号十进制串(上游 RandomUtil.uuId() = Yitter nextId),非 UUID
- §3.1:新增 protocol.rs(协议版本闸门独立成模块),auth.rs 相应收窄
- §6:标注上游基类两处缺陷并给出 Rust 修正口径
  (ApiConsumeLog 默认 keywordColumns 指向不存在的 f_name;filterColumns 对 smallint 列绑定失败)
- §6/§12:DeliveryTask 的 no_create/no_delete 文案与 40 个 frozen_columns 口径
- §12.1/§12.2:DDL 实测计数 97 KB / 308 条可执行语句(原写 1233,实为朴素切分块数)

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 12:21:28 +08:00
adminandClaude Code b418621314 docs(spec): 补联调环境实测——平台必填占位符清单与四类闸门行为
- §16.3:补平台 yml 无默认值的必填占位符(CONFIG_API/FRONTDOMAIN、
  SSW_BOXDEPLOYER_*)与联调取值;DB/Redis 账号密码走 yml 默认值,不落命令行
- §16.3:补 2026-10-24 实测的平台闸门四象限(无头→code600 / 协议不兼容→HTTP401 /
  白名单内部端点→仅需 X-Internal-Token / 非白名单→仍需登录态)
- §16.3:明确连接器出向须区分「白名单内部端点」与「普通端点」

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 12:13:07 +08:00
adminandClaude Code d03eedd959 docs(spec): 对齐 spec 自审修订(词表以代码为准、库级 COMMENT 过时口径标注)
- §2.1/§5.1:登录主体 = 连接器身份,删除「另立本地用户/角色表」残留表述;
  补身份词表 f_status/f_register_status 实测取值
- §10.3/§10.6:标注 tdc_order.f_status、tdc_policy.f_priority 库级 COMMENT 为过时口径,
  明确以控制器常量 / ExecutionPolicyGate 源码为准
- §11.3:数据源类型词表对齐上游 SUPPORTED_TYPES(13 种,POSTGRESQL 非 POSTGRES,
  KAFKA/ES/OSS 不在其中);补 JDBC/API/FILE/SFTP/未实现分流与同步前置校验
- §5.1:f_register_status 引导值 APPROVED → REGISTERED

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 12:04:03 +08:00
adminandClaude Code 217c891d11 docs(spec): TDC 连接器对齐新版 ssw-tdc/ssw-tds 契约的设计文档
按新版连接器仓与平台仓(均为重构而非版本升级)重做 tdc-rs 的设计:
数据模型 30 表、API 18 个 CRUD 实体 + ~130 自定义动词、跨端 12 个协议面类。

要点:
- 交付状态权威从"TDC 与平台共治"改为"平台唯一权威",本地表退化为投影
- 跨端契约作废 App-Code: tdc + Bridge/**,改为 X-Internal-Token + X-Protocol-Version
- 通用 CRUD 引擎 + 声明式表注册表替代逐控制器手写
- 12 个协议面类给出 Rust 字节级复刻规格(含 JSON 键序即协议等坑位)
- 引擎/数据源探活显式降级,不伪装成功;本地单机模式单独标记
- 记录 TDS 客户端 4 处已确认缺陷(D1-D4)与平台侧 1 处鉴权缺口
- 阶段划分 P0-P6 + P4.5,联调环境(tds2 库 / 30041 端口)已就绪

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 11:44:13 +08:00