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