# 已知限制(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 ```