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