refactor(b1b-c9): 状态分家 —— 平台 AppState 只留运行态,业务态进 TdcState
影响:平台层不再认识业务类型(引导身份 / 本地账号库 / TDS 客户端 / 业务配置
全部移出 AppState);对外行为零变化(237 条测试全绿、冒烟断言数仍 75)。
改动:
- src/platform/state.rs:AppState 收敛为 {config, db, db_lock, sessions}
- src/tdc/state.rs(新):TdcState = platform + 业务配置 + 引导身份 + 账号库 + TDS 客户端
· Deref<Target = AppState> => 业务层字段访问(state.db 等)写法不变
· impl FromRef<TdcState> for AppState => axum 里 State<AppState> 仍可用
- src/main.rs:装配顺序改为 platform -> bootstrap_identity -> TdcState
- 控制器/服务/测试:入参一律换成 &TdcState(bootstrap_identity 仍是 &AppState,
它跑在装配期,那时 TdcState 还没造出来)
- scripts/check-boundary.sh:新增第 5 个接触点 CP5(平台层不得 use crate::tdc::),
专门盯这条反向依赖;CP1 只查表名/端点前缀,查不出模块引用
- CLAUDE.md / .workbuddy/memory/2026-10-26.md 同步
设计:FromRef 在 axum::extract(不是 axum::core::extract)=> 手写 impl。
This commit is contained in:
1 parent
6e14fbeb47
commit
49e5fcefe4
23 files changed
+395
-210
No files matched your search
@@ -13,13 +13,18 @@
|
||||
# 没记账的越界 ⇒ 红(当场抓新增泄漏);记账已失效的条目 ⇒ 红(账本只许变短)。
|
||||
# ⇒ B1b 的 C1–C12 做完,账本必须清空。
|
||||
#
|
||||
# 扫描口径(**四条接触点的判定规则,写死在这里,避免"尺子随实现漂移"**):
|
||||
# 扫描口径(**接触点的判定规则,写死在这里,避免"尺子随实现漂移"**):
|
||||
# ① 只扫**非测试代码**:每个文件里第一处 `#[cfg(test)]` 之后的内容不计入
|
||||
# (单元测试必须引用具体实体/端点才有意义;生产代码不许)。
|
||||
# ② 注释不计入(`//` 行注释、`/* */` 块注释都先剥掉)。
|
||||
# ③ 平台层 = `src/platform/**`(新布局)或旧布局的平台件清单(见 `PLATFORM_LEGACY`)。
|
||||
# ④ 通用 CRUD 引擎 = `src/tdc/{mapper,service/crud,controller/crud}.rs`(新布局)
|
||||
# 或 `src/crud.rs` + `src/routes/crud.rs`(旧布局)。
|
||||
#
|
||||
# 🔴 **CP5 是 C9 之后补的第 5 条**(v3 spec §2.3.2 的 4 条接触点之外):
|
||||
# 「平台层不得 import 业务层」—— 拆 `AppState` 之前 `src/platform/state.rs`
|
||||
# 直接 `use crate::tdc::service::account::AccountStore` ⇒ 依赖方向反了,
|
||||
# 而 CP1(只查表名/端点前缀)查不出来 ⇒ 补这条钉住。
|
||||
|
||||
set -u
|
||||
|
||||
@@ -232,6 +237,20 @@ for path in PLATFORM_FILES:
|
||||
if pat in s:
|
||||
add("CP1", path, lineno, s, pat)
|
||||
|
||||
# CP5:平台层**不得 import 业务层**(平台 → 业务的反向依赖)
|
||||
#
|
||||
# 🔴 这条是 C9 之后补上的:拆 `AppState` 之前,`src/platform/state.rs` 直接
|
||||
# `use crate::tdc::service::account::AccountStore` / `use crate::tdc::client::tds::TdsClient`
|
||||
# ⇒ 平台层被迫认识业务类型 ⇒ 依赖方向反了。
|
||||
# CP1 只查「表名前缀 / 端点前缀」,查不出 `crate::tdc::` 这种**模块引用** ⇒ 补这条。
|
||||
for path in PLATFORM_FILES:
|
||||
lines = code_lines(path)
|
||||
if lines is None:
|
||||
continue
|
||||
for lineno, s in lines:
|
||||
for m in re.finditer(r"\buse\s+(?:crate|super)::tdc\b", s):
|
||||
add("CP5", path, lineno, s, m.group(0))
|
||||
|
||||
# CP2:平台层不得出现具体实体名
|
||||
for path in PLATFORM_FILES:
|
||||
lines = code_lines(path)
|
||||
@@ -307,8 +326,9 @@ RULE_DESC = {
|
||||
"CP2": "平台层不得出现具体业务实体名",
|
||||
"CP3": "通用 CRUD 引擎不得按实体名分支(只能读 TableSpec 字段)",
|
||||
"CP4": "平台 auth 不得出现字面量端点路径(只能引用业务层清单)",
|
||||
"CP5": "平台层不得 import 业务层(平台 → 业务的反向依赖)",
|
||||
}
|
||||
for rule in ("CP1", "CP2", "CP3", "CP4"):
|
||||
for rule in ("CP1", "CP2", "CP3", "CP4", "CP5"):
|
||||
rs = [f for f in findings if f[0] == rule]
|
||||
print("%s:%d 处发现 —— %s" % (rule, len(rs), RULE_DESC[rule]))
|
||||
for f in rs:
|
||||
|
||||
Reference in new issue
Block a user