按 v3 spec §2.1 的目录映射,把 9810 行代码重组成「平台层 + 业务层」两段: **平台层 `src/platform/`**(12 个文件,与业务零知识) - state / config / db / session / envelope / cipher / ids / protocol - body / mw / fallback(原 `src/routes/`,是通用响应改写与兜底,不是业务) **业务层 `src/tdc/`**(对位上游 `ssw.tdc.*` 包族) - `entity/` —— `registry.rs` 拆成 **18 个实体各一文件** + `mod.rs`(`ALL_SPECS` / `validate` / 权限键) - `mapper.rs` —— 原 `crud.rs` 的 SQL 组装/投影/序列化半边(机械活、实体无关) - `service/crud.rs` —— 原 `crud.rs` 的写路径规则/分档判定半边 - `service/identity.rs` / `service/account.rs` —— 原 `domain/identity.rs` / `account.rs` - `controller/` —— 原 `routes/`(crud / health / auth / account / tds_biz) - `client/tds.rs` —— 原 `tds/mod.rs`(TDS 出向客户端) - `util/code.rs` —— 原 `codec.rs`(**业务**编码生成器,非平台件) - `support/public_paths.rs` —— 免鉴权端点清单(业务侧持有,C5 接线) - `policy/ engine/ schedule/ notify/ heartbeat/ sso/` —— 上游同名包占位 **行为零变化**:HTTP 契约、响应形状、SQL、口令算法、权限判定全部不动。 - `cargo test` 223 passed / 0 failed / 1 ignored(与 B1a 基线一致) - `scripts/smoke.sh` PASS=75 / FAIL=0(断言数 == 基线 N=75,不增不减) - `scripts/check-boundary.sh` exit 0(账本 7 条 B1b 待清 + 2 条永久豁免) - `scripts/check-entity.sh` PASS=15 / FAIL=0 **边界账本同步**:CP3 的 `routes/crud.rs` 条目改为 `controller/crud.rs`(账本按路径后缀匹配,搬家不失效)。 **为什么搬家必须一个 commit**:`check-boundary.sh` 的 NEW_LAYOUT/LEGACY 判定是**全有或全无** (`src/platform/` 目录存在即切新布局)⇒ 分批搬会让账本条目在中间态失效 ⇒ 尺子当场红。 ⇒ 搬家一个 commit,之后 C1–C12 各一个 commit。 Co-Authored-By: Claude Code <[email protected]>
19 lines
936 B
Rust
19 lines
936 B
Rust
//! TDC 连接器(数据接入连接器)—— 本地优先 Rust 重实现。
|
||
//!
|
||
//! 红线(详见 `CLAUDE.md` 与设计文档 §3.3):
|
||
//! - TDC↔TDS 只走 HTTP 契约,绝不编译期耦合。
|
||
//! - 前端不直接持有数据库;全部数据访问经 `/api/ssw/tdc/*`。
|
||
//! - 业务错误读 body 的 `code`,不只看 HTTP 状态。
|
||
//! - 所有 DB 访问持 `state.db_lock`(PGlite 单 in-process backend)。
|
||
//! - 任意 SELECT 走 `db::query_json()`(row_to_json 包裹)。
|
||
//!
|
||
//! **分层(v3 spec §2.1)**:
|
||
//! - `platform/` —— 与业务无关的基础设施(**零业务知识**);
|
||
//! - `tdc/` —— 业务层,对位上游 `ssw.tdc.*` 包族。
|
||
//!
|
||
//! 🔴 分层后的唯一入口是 `crate::platform::*` 与 `crate::tdc::*` ——
|
||
//! 根模块**不再**暴露任何业务件(避免「又漏回根模块」的第二条路径)。
|
||
|
||
pub mod platform;
|
||
pub mod tdc;
|