Files
ssw-platform/docs
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
..