diff --git a/.workbuddy/memory/2026-11-03.md b/.workbuddy/memory/2026-11-03.md index 1beb892..4582e2c 100644 --- a/.workbuddy/memory/2026-11-03.md +++ b/.workbuddy/memory/2026-11-03.md @@ -48,3 +48,20 @@ - **诚实失败(8 类)**:外部数据库连接 / 动态 SQL / 任意 URL 转发(proxy、GetApiData)/ 文件服务(put-file、图片列表)/ 导入导出 / 地图数据源 ⇒ 一律 400 + 人话,不返假连接成功、假 geojson、假链接。 - **数字**:契约 **1040** 条(面 B 1010,+52);官方台账覆盖 **1026/1031**(implemented 815 / partial 211 / absent 5);test **695 passed / 0 failed**(基线 684+11);verify --smoke 14 步全绿(793.9s);check-contract PASS=10;check-citations PASS=4(1264 条引文)。 - **文档**:`docs/known-limitations.md` §K(9 条降级/口径);`HANDOFF.md` §0-0-quinque。 + +### 12:00–12:20 打 tag v0.1.0 + 制定「平台能力全迁 crates/」计划 + +- **触发**:用户问「`crates/` 与 `src/backend/` 是不是重叠了?应该参考 ssw-mvp 做一个薄壳,平台能力打成包」⇒ 复核后确认:**不重叠**(分工清晰),但**壳不薄**(壳只占 6%)⇒ 用户拍板「打 tag + 制定计划,只留壳装配,其余迁 crates/」。 +- 🔴 **关键结论(复核后修正了初判)**:初判「crates 与 src/backend 重叠」是**错的** —— `platform/{db,entity,route}.rs` 是**纯 re-export 转发**,真值源在 crates;`lowcode` 是**纯计算 ↔ 执行**分层(AR7);`mcp_adapter` 是内核**实现** `sspf_mcp::PlatformAdapter` trait(AR5 规定 mcp 不许依赖内核,否则远程基线那条路就死了)。**三层无重叠。** +- **基线 tag**:`v0.1.0`(commit `b957a11`,已推 origin)= 迁移前可回滚锚点。打 tag 前先跑基线:`cargo test --workspace` = **695 passed / 0 failed**、`check-arch.sh` = **12/12**、`cargo build` 成功。**这三个数是整个迁移的回归基准。** +- 🔴 **Git 服务器一度 502**(`127.0.0.1:13300` upstream connect failed)⇒ tag 先落本地、push 失败;服务器恢复后重推成功。**打 tag 前先 `git push` 试探连通性**,别让 tag 卡在本地。 +- 🔴 **三处跨 crate 循环依赖(实测定位,非推断)**: + - **环 A**:`platform/auth.rs:336/403/337` ↔ `compat/helper.rs:22/23` —— 解法比预想简单:**`sspf_contract::headers::is_face_b` 早就存在**(带 3 条单测),`helper.rs:89` 只是转发 ⇒ `auth.rs` 改一行断一条边;残余是面 B `current_user`(`helper.rs:391`)仍需**注册表回调**才能断。 + - **环 B**:`helper.rs:31` ↔ `system.rs:26` —— helper 下沉成 `sspf-compat-core`;`menu_node`/`official_view_path` 留 system。 + - **环 C**:`helper.rs:32` ↔ `permission.rs:29`(**22 个符号**)—— `USER_DETAIL_COLUMNS`/`organize_name_of` 留 permission。 + - ✅ **已验证 `platform/` 内部 17 个文件无环**(依赖全单向向下)⇒ M2 核心下沉**不受环影响**,可独立推进。 +- 🔴 **最大风险不是代码,是闸门**:`check-contract-scan.py:827/839` 与 `check-boundary-scan.py` 把 `src/backend/src/platform` **路径写死** ⇒ 搬迁后脚本扫不到文件 ⇒ **永远"通过"** ⇒ **虚假安全感**(`check-arch.sh` AR9 的自证注释里已警告过「这类尺子比没有更危险」)。M4 之后必须同步改脚本并重跑 `--self-test`。 +- **计划**:`docs/CRATES-MIGRATION.md`(543 行)—— 7 批次(M1 解耦 → M2 `sspf-core` → M3 `sspf-compat-core` → M4 六个 compat 包 → M5 `sspf-lowcode-exec` → M6 `sspf-mcp-adapter` → M7 收口+AR10–AR13),每批次独立 commit + 独立 tag,不合绿不进下一批。 +- 🔴 **踩坑(工具)**:`grep -o "use crate::[a-z_:]*"` 对 `use crate::platform::auth::require_login_face_b;` 这类**长路径**返回空 ⇒ 一度误判「helper 不依赖 auth、环不存在」。**结论:查依赖必须用 Grep 工具(ripgrep)或有界正则,别用 `grep -o` 配贪婪/字符类**;凡是要写进计划的依赖结论,**逐条 `sed -n 'Np'` 核对行号**。 +- **数字**:壳(routes+main+bootstrap+modules+转发)**5,664 行** vs 要搬走的平台能力 **≈61,500 行**;crates **7 → 15 个**;`src/backend/src` 90,471 行,目标 ≤ 8,000。 +- **待确认决策(4 个,§11)**:`platform/` 转发壳删不删 / compat 拆 6 个还是 3 个 / `mcp_compat.rs` 放 crates 还是留壳 / `tests/` 要不要跟着拆。