Commit Graph
13 Commits
Author SHA1 Message Date
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 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 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 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
xstudio 885b108fe0 init: TDC 连接器 Rust MVP(pglite-rs 内嵌 + 静态 HTML 控制台)
从 ssw-mvp/boot/ssw-tdc(Spring Boot/JNPF,37 Controller)剥离重底座的本地优先实现:
- axum 单进程承担控制面/数据面/静态托管/TDC→TDS HTTP 契约网关
- pglite-rs 0.2 内嵌原生 PostgreSQL(进程内,非浏览器 WASM),19 张 tdc_* 表
- 静态 HTML + 原生 JS 控制台:schema 自省驱动 CRUD + 按表生命周期动作
- 红线:TDC↔TDS 只走 HTTP 契约,未配 SSW_TDS_BASE_URL 时 Noop 降级
- AGENTS.md 记录架构红线、命令速查与踩坑清单;docs/ 记录跨方契约细节
2026-10-24 10:31:06 +08:00