chore(e2e,docs): 新脚本的清理只删自己建的模板行(不碰演示态)+ docs/09 §8 补接线检查

This commit is contained in:
2026-10-08 14:47:11 +08:00
parent 9e78e1d239
commit db8aecc30a
2 changed files with 17 additions and 3 deletions
+9 -1
View File
@@ -242,11 +242,19 @@ XT_TENANT_DOMAIN_ENABLED=true # 如果要按域名区分单位
| 阶段 | 本地怎么验 | 结果 |
|---|---|---|
| `check` | 直接跑那三个校验脚本 + 把 CI 里的 heredoc 片段原样执行 | ✅ |
| `check` | 直接跑那**五个**校验脚本(契约 / 实体列 / 文档 / 手册 / **接线**)+ 把 CI 里的 heredoc 片段原样执行 | ✅ |
| `build` | `mvn package`、`pnpm typecheck`、`pnpm build` | ✅ |
| `e2e` | 起 `test` profile 确认能起来(`check-test-profile.py`);全套 E2E 在 `dev` 上跑 | ✅ |
| `生产环境自检` | **真的起三次 jar**(三种误配形态) | ✅ 9/9 |
> **接线检查(`scripts/check-wiring.py`)为什么值得单独放一个阶段**:它查的是
> "**声明了但没接上**"(权限码没人校验、错误码没人引用、通知模板没有发送点、
> 菜单键前端没有对应项)—— 这一族错**编译 / lint / review 全都不红**,
> 只有"从入口走一遍"才暴露(F-1/F-31/F-50/F-52/F-101/F-106 都是它)。
> 它自己的假阳性也要当心:本轮修了三次(只数注解漏掉服务层、按标识符数引用被同名常量骗过、
> **注释里的提及被当成接线**)—— 所以它现在**先去 Java 注释再数**,
> 并且有意不接线的逐条写在脚本上方的例外表里(带理由),**不静默跳过**。
**本地验不到的**(要在真实 runner 上跑):
`services:` 的容器别名解析、`apt-get`/`pip3` 在 runner 镜像里可用性、
artifacts 路径、以及**所有 shell 片段的语法**(开发机是 Windows,