平台能力全迁 crates/ 迁移计划第 2 批(docs/CRATES-MIGRATION.md,基线 tag v0.1.0)。
本批次 = M2:平台核心从 src/backend/src/platform/ 下沉到 crates/sspf-core/。
搬迁:
- 19 个模块 git mv 进 crates/sspf-core/src/(保留历史):
auth/authorization/cipher/config/crud/db/entity/envelope/guard/ids/menu/
monitor/registry/route/seed/session/state/sys/variate_catalog
- src/backend/src/platform/*.rs 全改成 pub use sspf_core::<mod>::* 转发壳(5 行/个)
⇒ 上层零感知:routes / modules / 695 个测试的 import 一个没改
- crate 内路径改写 crate::platform::X → crate::X(compat 除外,那是 M3/M4)
- pub(crate) → pub(10 处,跨 crate 后失效)
闸门改造(🔴 本批最大风险不是代码是闸门 —— 搬迁后闸门扫空壳 = 虚假安全感):
- 纪律 = 「两处都扫」:真源 crates/sspf-core/src/(管实现)+ 转发壳(防塞私货)
- check-arch.sh AR9/AR10 扫两处;反自证 2/6、5/6 两处注入探针且按路径分别验
- check-boundary.sh 新增 PLATFORM_CORE;CP1/CP2 两处扫;CP6 的 seed.rs 改读真源
- check-contract-scan.py 的 plat_files 两处都收、重名键拼接(覆盖会丢函数 ⇒ 推不出守卫)
- check-module.sh 的 CRUD 改读 crates/sspf-core/src/crud.rs(软删契约要看 SQL)
- gen-function-catalog.py 的 OUT 改写真源(否则覆盖转发壳 ⇒ 上层 import 全断)
- 反向验证:只往 crates/sspf-core/ 塞违规 ⇒ AR9/AR10 都报红(证明真在扫真源)
测试归属调整:crud.rs 3 个测试原依赖 crate::modules::all_specs()(业务层)
⇒ 改用契约层合成 spec 参数化测试;registry.rs 测试改自建库 + seed::ensure_base(db, &[])。
顺带记录技术债:write_cast 的 numeric 映射是列名枚举而非 spec 声明。
影响:功能零变化(路由、响应形状、语义均未动),纯结构下沉。
验证:cargo build 零警告;cargo test --workspace 695 passed / 0 failed(与基线一致);
check-arch 14/14;--self-test 6/6;check-boundary 11/11;check-contract 10/10(反自证 12 例全过);
check-module 123/123;check-citations 4/4;verify --smoke 14 步全绿(512.3s)。
43 lines
1.8 KiB
TOML
43 lines
1.8 KiB
TOML
[package]
|
||
name = "sspf-core"
|
||
version.workspace = true
|
||
edition.workspace = true
|
||
rust-version.workspace = true
|
||
|
||
# 🔴 **平台核心层**(M2 起从 `src/backend/src/platform/` 下沉到这里)。
|
||
#
|
||
# 装什么:契约实现(信封 / cipher / 登录 / 会话 / 权限 / `base_*` 管理 /
|
||
# CRUD 引擎 / 应用状态)—— 即「平台自带、与业务无关」的那一层。
|
||
#
|
||
# 🔴 **依赖纪律**:
|
||
# - 允许:契约层(类型与码表)+ 存储层(db / config)+ axum(HTTP 包装)
|
||
# + 序列化 + 时间 + 加密原语。
|
||
# - 禁止:**业务包**(`sspf_pack_*`)—— 平台层不许认识任何业务(AR9)。
|
||
# - 禁止:**契约面**(面 B 的 compat)—— 平台层不许反向依赖契约面(AR10)。
|
||
# 装配根(`src/backend/src/routes.rs`)负责按判别头分流。
|
||
#
|
||
# 🔴 **为什么允许依赖 axum**:本层是「HTTP 包装层」—— 信封 `Json<ActionResult>`、
|
||
# `Router`、extractor 都住在这一层。它**不认识业务**,因此不会把业务包拖进框架。
|
||
[dependencies]
|
||
# 契约层(类型 / 码表 / 判别头)
|
||
sspf-contract = { path = "../sspf-contract" }
|
||
# 存储层(db / config)—— 不认识 HTTP
|
||
sspf-store = { path = "../sspf-store" }
|
||
|
||
axum = { workspace = true }
|
||
tokio = { workspace = true }
|
||
serde = { workspace = true }
|
||
serde_json = { workspace = true }
|
||
serde_urlencoded = { workspace = true }
|
||
# cipher 原语(md5 + AES-256-ECB)
|
||
aes = { workspace = true }
|
||
ecb = { workspace = true }
|
||
md-5 = { workspace = true }
|
||
hex = { workspace = true }
|
||
# 会话 token 生成
|
||
rand = { workspace = true }
|
||
# 时间戳(会话过期 / 种子时间 / 监控采样)
|
||
chrono = { workspace = true }
|
||
# `monitor.rs` 的 macOS 负载均值读法(`getloadavg`)
|
||
libc = { workspace = true }
|