Files
tdc-rs/docs/known-limitations.md
T
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

2.2 KiB
Raw Blame History

已知限制(Known Limitations)

本文件记录本仓与上游的已知差距,以及刻意保留的取舍。 每条都带 file:line 引用,便于随时核对是否已过时。 决策背景见 decisions.md,对外契约见 contract.md。


L1 · tdc_identity 有两条读写路径(显式承认 + 已收口)

现象:tdc_identity 这一张表同时被两条路径读写 ——

路径 位置 用途
领域路径 src/tdc/service/identity.rs:99、:105、:148、:217、:241、:333、:403、:460、:511 引导身份、登录校验、当前身份、可用空间、能力集、TDS 绑定
引擎路径 src/tdc/service/crud.rs:248、:287、:317、:341、:721、:739 通用 CRUD 引擎对任意实体表(含 tdc_identity)的列表/详情/写入

为什么保留两条:上游没有「通用 CRUD 引擎」这个概念(每个实体一个 Controller + JNPF 底座), 硬把领域 SQL 收进引擎会失真(引擎是实体无关的,列清单/隐藏字段/冻结列都要靠 spec 驱动)。 ⇒ 决策:显式承认 + 收口 + 记账(v3 spec §2.3.1 C10 / 决策 D15)。

已经收口的部分:

  • 领域 SQL 全部集中在 src/tdc/service/identity.rs 一个文件 —— 控制器层不再自己拼 tdc_identity 的 SQL (原先 src/tdc/controller/tds_biz.rs 里的 tdc_identity 查询已移入 src/tdc/service/identity.rs:511 的 local_tds_binding)。
  • 领域查询只 SELECT 明确列,永不 SELECT * ⇒ 密钥列(f_secret_key)不会被整行拖进内存。

仍存在的风险:两条路径的隐藏字段 / 冻结列 / 权限语义可能漂移 —— 例如引擎路径的出参走 spec.hidden_fields 删键(src/tdc/mapper.rs), 而领域路径靠手写 SELECT 列表控制可见列。 新增 tdc_identity 字段时,两条路径都要看一眼。

复现/核对方式:

# 领域路径的 SQL 全在这一个文件里
grep -n "SELECT\|INSERT INTO" src/tdc/service/identity.rs
# 引擎路径的 SELECT *(实体无关,按表结构展开)
grep -n "SELECT \*" src/tdc/service/crud.rs