admin
|
acf076df5a
|
refactor: 内核瘦身 —— 示例搬成业务包 + 装配/测试各归其位
- 内核只有 lib:启动装配 → crates/sspf-admin(bin sspf-admin);37 个集成测试 → crates/tests(package sspf-tests)。
- demo/shop/books 的 spec/菜单/DDL/面 B 路由搬进 packs/{demo,shop,books};内核 modules/*.rs 只剩「面 A 适配器 + pub use」⇒ 内核零业务知识,示例可整目录搬走。面 A 与前端零改动。
- 示例表 DDL 按平台规则补 f_tenant_id + 复合主键(spec 不加 ⇒ JSON 键与响应逐字不变)。
- 修 is_builtin_table 只认 schema.sql 的漏洞:包表(含 asset_data_resource)此前可被建模页删除/改;现为「平台 DDL ∪ 包表」。
- sspf-compat-online_dev → onlinedev(包名/模块/文件/路由别名同步);6 个 5 行转发壳合并为 forward.rs。
- 新增 AR16 闸门 + lib.rs「30 秒地图」+ src/backend/README.md;pack-sync 补两处判据(module_key=None 的 urlAddress、apiFile 查存在性)。
- 回归:704 tests / 6 道静态闸门全绿;health 181 表;四个包面 A/面 B 运行时全部 200。
|
2026-11-04 14:46:12 +08:00 |
|
admin
|
867552af37
|
refactor(arch): M7 删 platform/ 转发壳 —— 壳层收口,平台能力只剩真源
- 删 src/backend/src/platform/ 下 38 个转发壳 ⇒ 平台层只有真源(在 crates/)
- 新增 src/backend/src/compat.rs 别名表(16 个域)⇒ routes.rs 的 1010 处
compat::<域>:: 调用点零改动,风险面从 1010 处降到 1 个文件
- test_support.rs 从 platform/ 迁到壳侧根(依赖装配根 ensure_schema_all ⇒ 认识业务层)
- 全仓改写 import:crate::platform::X → sspf_core::X(44 处/9 文件);
ssw_platform::platform::X → sspf_core::X(229 处/38 文件)
- 修 check-contract-scan.py 的 plat_key 推导:按 crate 名判定(原按路径段数猜,
M7 拆 crate 后必然失效 ⇒ CC6 静默失效);新增 derive_plat_key + 20 条断言自证
- 新增 AR15 防旧平台路径复活(三层判据,含目录级「含 .rs 才算复活」)
- 闸门去壳路径:check-arch / check-boundary / check-module / check-contract-scan
- 文档同步:CRATES-MIGRATION / contract / HANDOFF / HOWTO_MODULE / CLAUDE.md
验证:cargo build 零警告;cargo test 695 passed / 0 failed(与 M1 基线一致);
check-arch 20/20;--self-test 10/10;check-boundary 12/12;check-contract 10/10
(反自证 12 例 + 20 条推导断言);check-module 123/123;check-citations 4/4;
check-naming 3/0/1;verify.sh --smoke 14 步全绿。
至此 M1–M7 全部完成:crates/ 17 个包,src/backend/src/ 只剩装配 + 业务层。
|
2026-11-03 22:17:34 +08:00 |
|
admin
|
210a885f79
|
refactor(arch): M6 MCP 适配层下沉 —— 2 模块 / 3,283 行迁入 sspf-mcp-adapter
迁入 src/backend/src/mcp_{adapter,compat}.rs(3,283 行)到 crates/sspf-mcp-adapter/,
原路径变转发壳(pub use sspf_mcp_adapter::<mod>::*)⇒ --mcp 启动路径与集成测试零感知。
依赖(比计划瘦):sspf-mcp + sspf-core + 仅四个 compat 域包
(system/permission/workflow/online_dev)+ sspf-lowcode + sspf-lowcode-exec
+ axum + pglite-rs。原计划写「所有 compat 包」,实际 msg/ext/compat-core 不必依赖。
闸门:
- 新增 AR14(依赖白名单 + 源码不许 use sspf_pack_*),反自证 9/9
- CP1/CP2 纳入适配层真源 + 新增 CP1'' 扫描面反自证
- CP1 抓出 5 处既有业务标识符泄漏(hint 提示语与单测断言里)⇒ 已改通用形态
- 契约 [RULER] check-boundary.sh 由 11 改 12
验证:cargo build 零警告;cargo test 695/0;check-arch 19/19;
check-boundary 12/12;check-contract 10/10;check-module 123/123;
check-citations 4/4;verify.sh --smoke 14 步全绿(397.3s)
|
2026-11-03 21:13:22 +08:00 |
|
admin
|
98b93967da
|
refactor(arch): M5 低代码执行层下沉 —— 4 模块 / 2,674 行迁入 sspf-lowcode-exec
把 src/backend/src/lowcode_{crud,ddl,check,seed}.rs 下沉到 crates/sspf-lowcode-exec/,
原路径全部变成 5 行转发壳 ⇒ CLI(--seed-lowcode-demo)与 MCP 适配器的调用路径零感知。
与 sspf-lowcode 的分工不变:前者纯计算(AR7 白名单不动),本 crate 是执行层
(连库 / 跑 SQL / 比对真实库列 / 事务 / 回写模型)。
依赖:sspf-lowcode + sspf-core + sspf-store + sspf-mcp + pglite-rs + chrono + serde_json
(比原计划多三个:pglite::ToSql/Error 是直接用的、now_iso() 用 chrono::Local::now()、JSON payload)
闸门改造:
- check-arch.sh 新增 AR13(两层:依赖白名单 + 源码不许 use sspf_pack_*)
- check-arch.sh 反自证 7→8(两处都注入:越界依赖 axum + 业务包引用,按路径分别验)
- check-boundary.sh 新增 LOWCODE_EXEC ⇒ CP1/CP2 纳入执行层真源
(反向验证:插 LEAK_PROBE ⇒ CP1 报红;还原后 11/11)
- check-contract-scan.py 不用改 —— 契约里零 lowcode 端点(低代码是 MCP 工具不是 HTTP 路由)
🔴 踩坑:改写时把 use crate::lowcode_ddl; 一并改成 use crate::ddl; ⇒ 编译不过。
教训:搬 crate 只改跨 crate 的前缀(crate::platform:: → sspf_core::),
模块名一律不动;文档内链([`crate::lowcode_crud`])也不能跟着改(改了就变死链)。
数字:cargo build 零警告;cargo test 695/0(与 M1 基线完全一致);
check-arch 17/17;--self-test 8/8;check-boundary 11/11;check-contract 10/10;
check-module 123/123;check-citations 4/4;check-naming 3/0/1;
verify.sh --smoke 14 步全绿(377.6s)
|
2026-11-03 20:12:50 +08:00 |
|
admin
|
e821770f58
|
refactor(arch): M4 契约面下沉 —— 14 模块 / ~49,000 行迁入 6 个 crate
把 src/backend/src/platform/compat/ 下的 14 个契约面模块拆进 6 个 crate,
原路径全部变成 5 行转发壳 ⇒ 上层 import 零感知,695 个测试一个没改。
新 crate(按官方模块名切,实测依赖图定分组):
- sspf-compat-system system + scheduletask + core
- sspf-compat-permission permission(单向依赖 system,4 符号)
- sspf-compat-msg message + msg_center
- sspf-compat-workflow workflow + report + visualdata
- sspf-compat-ext extend + teamwork + ai + mobile(单向依赖 system + msg)
- sspf-compat-online_dev online_dev(🔴 Rust 包名不能带连字符)
闸门改造:
- check-arch.sh 新增 PLAT_SRC_DIRS(动态 glob)⇒ AR9/AR10 扫真源
- check-arch.sh 新增 AR12(契约面各包彼此独立,Cargo.toml 级判据 + 3 条单向白名单)
- check-contract-scan.py 动态收编所有 crates/sspf-compat-*/src(不写死列表)
- check-boundary.sh 新增动态 COMPAT_DIRS ⇒ CP1/CP2 纳入契约面包
- 修 8 条引文路径(行号 1:1 未变 ⇒ 迁移是纯搬运)
🔴 三个「尺子是假的」的坑(都是反自证抓出来的):
1. CC6 守卫推导静默失效 —— compat_dirs 只收了 sspf-compat-core,六包真源没收
⇒ 改动态 glob;反向验证:改坏真源 EN_ROLE ⇒ CC6 精确报出
2. CP1 业务标识符未扫契约面包 ⇒ 加 COMPAT_DIRS;反向验证:插 LEAK_PROBE ⇒ 精确报出
3. macOS 的 BSD grep 不支持 \s(POSIX ERE)⇒ AR11/AR12 的 Cargo.toml 级判据
永远匹配不到 ⇒ 永远「通过」(AR11 从 M3 起就没真正生效过)
⇒ 改 [[:space:]];全仓扫过 scripts/*.sh 确认只有这一处
数字:cargo build 零警告;cargo test 695/0(与 M1 基线完全一致);
check-arch 15/15;--self-test 7/7;check-boundary 11/11;check-contract 10/10
(反自证 12 例全过);check-module 123/123;check-citations 4/4;
check-naming 3/0/1;verify.sh --smoke 14 步全绿(300.9s)
|
2026-11-03 18:57:00 +08:00 |
|
admin
|
eea3d0329f
|
refactor(arch): M3 契约面公共底座下沉 —— helper/res 进 crates/sspf-compat-core
平台能力全迁 crates/ 迁移计划第 3 批(docs/CRATES-MIGRATION.md)。
本批次 = M3:被 14 个契约面模块共用的底座先下沉,M4 的 6 个包才能都依赖它。
搬迁:
- compat/helper.rs(994) + compat/res.rs(460) git mv 进 crates/sspf-compat-core/src/
- src/backend/src/platform/compat/{helper,res}.rs 改成 pub use sspf_compat_core::<mod>::*
⇒ 14 个契约面模块的 use super::helper::{…} 零感知
- 路径改写 crate::platform::X → sspf_core::X(独立 crate 不能用 crate::X)
- pub(super) → pub(54 处):转发壳的 pub use …::* 只转发 pub 项(含 struct 字段)
- helper 的 8 个单测自足 ⇒ 随迁,总测试数不变 695
闸门改造(同 M2 纪律 = 两处都扫:真源 + 转发壳):
- check-arch.sh AR11 扫 crates/sspf-compat-core/src/helper.rs + 壳,
并新增 Cargo.toml 级判据(sspf-compat-core 不许依赖 sspf-compat-* ⇒ M4 的 6 个包)
- check-arch.sh 反自证 6/6 两处注入探针、按路径分别验
- check-contract-scan.py 的 plat_files 对 compat__<mod> 收真源 + 壳同键拼接
(守卫常量 EN_ROLE 等在 helper 真源里,漏收 ⇒ CC6 假漂移)
- 修 1 条引文:compat/helper.rs:89-92 → crates/sspf-compat-core/src/helper.rs:87-91
反向验证:只往真源 helper 塞 use crate::res::Res; ⇒ AR11 报红;清理后恢复绿。
顺带落档四个决策(§11):壳最后删 / compat 拆 6 包 / mcp_compat 放 crates / tests 跟着拆。
影响:功能零变化(响应形状、路由、语义均未动),纯结构下沉。
验证: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(CC6 零漂移);
check-module 123/123;check-citations 4/4;verify --smoke 14 步全绿(561.3s)。
|
2026-11-03 17:48:41 +08:00 |
|
admin
|
94d05f4649
|
refactor(arch): M2 平台核心下沉 —— 19 模块迁入 crates/sspf-core + 闸门扫真源
平台能力全迁 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)。
|
2026-11-03 15:49:00 +08:00 |
|
admin
|
215b5e8fcf
|
refactor(arch): M1 解耦 —— 拆掉三处跨 crate 循环依赖 + 加 AR10/AR11 闸门
平台能力全迁 crates/ 的迁移计划见 docs/CRATES-MIGRATION.md(基线 tag v0.1.0)。
本批次 = M1:先把三处跨 crate 循环依赖解开,否则后续拆 crate 时编译器直接报错。
断环(实测定位,非推断):
- 环 A(平台层 → 契约面):auth.rs 的面 B 判据改走契约层唯一真源
sspf_contract::headers::is_face_b;面 B 分流点上移到装配根 routes.rs,
平台层与契约面互不知道对方;resolve_user 由 pub(crate) 提为 pub。
- 环 B(契约面底座 helper ↔ system):menu_node / official_view_path 搬进 helper。
- 环 C(契约面底座 helper ↔ permission):USER_DETAIL_COLUMNS / organize_name_of 搬进 helper。
闸门:
- 新增 AR10「平台层不许反向依赖契约面」(拆 crate 的前置条件)。
- 新增 AR11「契约面底座 helper 不许依赖其它契约面模块」(14 个模块依赖它 ⇒ 反向依赖即成环)。
- 反自证由 4 条扩到 6 条(新增 AR10/AR11 两条真实违规注入),确认尺子能抓到。
影响:功能零变化(面 A / 面 B 的响应形状、路由、语义均未动),仅为依赖方向解耦。
验证: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;
check-module 123/123;check-citations 4/4;verify --smoke 14 步全绿。
|
2026-11-03 13:25:06 +08:00 |
|
admin
|
639ade7923
|
docs(migration): 打 v0.1.0 基线 tag + 制定「平台能力全迁 crates/」迁移计划
## 影响
- 新增 docs/CRATES-MIGRATION.md:7 批次迁移计划(依赖图 / 三处循环依赖解法 / 闸门改造 / 风险 / 回滚)
- CLAUDE.md / HANDOFF.md 挂上计划入口,HANDOFF 新增 §0-0-pre 交接段
- 纯文档,**零代码改动** ⇒ 695 测试 / 12 道闸门基线不变
## 改动
- 打 tag v0.1.0(commit b957a11,已推 origin)= 迁移前可回滚锚点
- 计划含实测数据:壳 5,664 行(6%)vs 平台能力 61,500 行;crates 7 个 → 目标 15 个
- 定位三处跨 crate 循环依赖(auth↔compat/helper、helper↔system、helper↔permission)及各自解法
- 标注最大风险:check-contract-scan.py / check-boundary-scan.py 路径写死 ⇒ 搬迁后闸门静默失效
- 4 个待确认决策(转发壳删不删 / compat 包数 / mcp_compat 归属 / tests 是否拆)
## 设计(仅记录明确拒绝的方案)
- ❌ 不按 ssw-mvp 的 biz/entity/controller 三件套切 —— 本仓 compat 是「契约面 handler」不是「业务实体」
- ❌ 不把 compat 做成不认 axum 的纯 crate —— 会与 AR6/AR7 纪律冲突;ssw-mvp 的 *-controller 本身就带 axum
|
2026-11-03 12:16:08 +08:00 |
|