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

44 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 已知限制(Known Limitations)
> 本文件记录**本仓与上游的已知差距**,以及**刻意保留的取舍**。
> 每条都带 `file:line` 引用,便于随时核对是否已过时。
> 决策背景见 [`decisions.md`](decisions.md),对外契约见 [`contract.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` 字段时,**两条路径都要看一眼**。
**复现/核对方式**:
```bash
# 领域路径的 SQL 全在这一个文件里
grep -n "SELECT\|INSERT INTO" src/tdc/service/identity.rs
# 引擎路径的 SELECT *(实体无关,按表结构展开)
grep -n "SELECT \*" src/tdc/service/crud.rs
```