docs: 同步批次 12.6 收尾(HANDOFF + HOWTO + CLAUDE + memory)
记下:两档验证的分工(--fast 该接的接上了 / --lib 接上的活真能应答)、 两处反自证结果、以及「不同步 Save/Delete」「不在 new-pack.sh 里跑」两条边界。
This commit is contained in:
1 parent
324e82be0d
commit
21c69ee85d
4 files changed
+121
-10
No files matched your search
+16
-9
@@ -7,9 +7,14 @@
|
||||
> ```bash
|
||||
> bash scripts/new-pack.sh crm Customer --name "客户" \
|
||||
> --columns "name:VARCHAR(200),level:VARCHAR(50)" --with-frontend
|
||||
> bash scripts/verify.sh --fast # ≈17s 全绿才继续
|
||||
> bash scripts/verify.sh --fast # 纯静态:文件和接线一致
|
||||
> bash scripts/verify.sh --lib # + 单测 + **包冒烟**(真起库、真打 List)
|
||||
> ```
|
||||
>
|
||||
> 🔴 **两道都要过**:`--fast` 只证明「该接的地方都接上了」,**证明不了「接的活能应答」**
|
||||
> —— 表没建出来 / 面 B 路由没 merge / `module_key` 指向不存在的菜单,这三种
|
||||
> **静态闸门全绿**,只有 `--lib` 里的包冒烟(`tests/pack_smoke_it.rs`)会红。
|
||||
>
|
||||
> 它建 `packs/<app>/`(**真源**)+ `modules/<app>.rs`(面 A 适配器),
|
||||
> 再把**四处生成位置**补齐(`packs_gen.rs` / `modules/mod.rs` 五段 /
|
||||
> `Cargo.toml` 依赖段 / `docs/contract.md` 三段)。
|
||||
@@ -35,18 +40,20 @@
|
||||
8. src/backend/Cargo.toml >>>GEN:PACK_DEPS 段
|
||||
9. docs/contract.md 附录 A [MODULE] / [MENU] / [ENDPOINT] 的生成段
|
||||
10. frontend/src/{api,views}/… + App.tsx 的 <Route>(new-page.sh,--with-frontend)
|
||||
⇒ bash scripts/verify.sh --fast 必须全 ✅
|
||||
⇒ bash scripts/verify.sh --fast 必须全 ✅(文件与接线)
|
||||
⇒ bash scripts/verify.sh --lib 必须全 ✅(+ 包冒烟:List 真应答)
|
||||
```
|
||||
|
||||
🔴 **漏了会怎样**(这就是为什么不再让人手抄):
|
||||
|
||||
| 漏哪一步 | 现象 | 报错吗 |
|
||||
|---|---|---|
|
||||
| 6(`packs_gen.rs`) | 面 B 端点 404,列表永远空 | ❌ **不报** |
|
||||
| 7(`ALL_MENUS`) | 菜单不种 ⇒ 守卫查不到菜单 ⇒ **越权放行** | ❌ **不报** |
|
||||
| 7(`router()`) | 面 A 404 ⇒ MVP 前端页面空着 | ❌ **不报** |
|
||||
| 8(Cargo 依赖) | 编译失败 | ✅ 报 |
|
||||
| 9(契约) | `check-contract` 红 | ✅ 报 |
|
||||
| 漏哪一步 | 现象 | 报错吗 | 谁兜住 |
|
||||
|---|---|---|---|
|
||||
| 6(`packs_gen.rs`) | 面 B 端点 404,列表永远空 | ❌ **不报** | `verify.sh --lib` 包冒烟 |
|
||||
| 7(`ALL_MENUS`) | 菜单不种 ⇒ 守卫查不到菜单 ⇒ **越权放行** | ❌ **不报** | 单测 `every_pack_loads_with_…`(结构性) |
|
||||
| 7(`router()`) | 面 A 404 ⇒ MVP 前端页面空着 | ❌ **不报** | `verify.sh --lib` 包冒烟 |
|
||||
| DDL 少一列 | 投影 SQL 报错 ⇒ 列表恒 `{"code":400}` | ❌ **不报** | `verify.sh --lib` 包冒烟 |
|
||||
| 8(Cargo 依赖) | 编译失败 | ✅ 报 | 编译 |
|
||||
| 9(契约) | `check-contract` 红 | ✅ 报 | `verify.sh --fast` |
|
||||
|
||||
🔴 **平台层(`src/platform/`)与入口文件(`src/backend/src/main.rs`)一个字都不用改** ——
|
||||
加业务模块**不碰平台层**,由尺子 `bash scripts/check-boundary.sh`(CP1–CP6)钉住:
|
||||
|
||||
Reference in new issue
Block a user