影响:控制器层不再自己拼 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 不会被整行拖进内存。
2.2 KiB
2.2 KiB
已知限制(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