Files
eip4-web/docs/F1-4扫描报告.md
zhengwr 0d8593e022 F1-4: schema 页全量接入——错误边界、健康度扫描、抽样渲染实测
渲染链路加固:
- PageRenderPage 加 AmisErrorBoundary class component + SchemaErrorCard,覆盖
  schema 拉取失败/JSON 异常/amis 渲染抛错三种路径,不白屏不崩 Tab
- schema 加载成功后调用 recordRecentPage 写入最近打开
- src/api/schema.ts mock 模式下未配置 templateId 自动 fallback 后端接口

全量健康度扫描 (scripts/schema-scan.mjs):
- 登录→psql 拉取 1489 个 template_id→并发≤8 扫描→产出报告
- 结果: 1489/1489 HTTP 200,JSON 可解析率 100%,顶层 type 全为 page,零失败

抽样渲染实测 (e2e/schema-samples.spec.ts):
- 9 种类型 26 个样本,Node 侧预登录注入真实 JWT,断言 amis-host 挂载且无错误卡片
- 结果: 26/26 全部通过,截图存 e2e/artifacts/

配置更新:
- playwright.config.ts 后端反代改为 8093 (dev profile,含所有端点)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 20:32:53 +08:00

106 lines
3.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# F1-4 Schema 全量接入扫描报告
**日期**:2026-06-11
**执行人**:自动化脚本 + Playwright e2e
**后端**:localhost:8093(dev profile,eip4dev 库)
---
## 一、渲染链路加固(PageRenderPage 错误边界)
**实施内容**:
- `src/pages/PageRenderPage.tsx`:新增 `AmisErrorBoundary`(class component)捕获 amis 渲染层抛错,新增 `SchemaErrorCard` 统一错误卡片(含 `data-testid="schema-error-card"`),覆盖三种失败路径:
1. schema 拉取失败(HTTP 4xx/5xx/网络错误)→ SchemaErrorCard
2. schema 顶层 JSON 异常(非对象)→ SchemaErrorCard
3. amis 渲染抛错 → AmisErrorBoundary → SchemaErrorCard
- `src/api/schema.ts`:mock 模式下未配置的 templateId 自动 fallback 到后端接口,支持真实 UUID 在开发期直接渲染。
- `recordRecentPage` 接入:schema 渲染成功后写入最近打开(取 `schema.title` 或 templateId)。
**菜单链路确认**:
`SideMenu` 叶子点击 → `handleMenuOpen(templateId)` → `openTab('/page/{templateId}', templateId)` → `PageRenderPage` 路由渲染。链路已通,无需改动壳层代码。
---
## 二、全量产物健康度扫描(scripts/schema-scan.mjs)
**扫描时间**:2026-06-11
**后端**:localhost:8093,并发:≤8
| 指标 | 值 |
|------|-----|
| 总计 template_id | **1489** |
| HTTP 200 成功数 | **1489** |
| HTTP 200 成功率 | **100.00%** |
| JSON 可解析数 | **1489** |
| JSON 可解析率 | **100.00%** |
| 失败数 | **0** |
| 顶层 type 分布 | `{ "page": 1489 }` |
**结论**:全量 1489 条产物 100% 可达、可解析,顶层 type 全为 `page`,无任何失败条目。
**失败清单**:无(failureCount = 0)
---
## 三、抽样渲染实测(e2e/schema-samples.spec.ts)
**样本数**:26 个(任务单给出 27 个,其中 type5 仅列出 2 个,测试中发现 SAMPLES 数组共 26 条)
**断言**:`data-testid="amis-host"` 可见 + `data-testid="schema-error-card"` 不可见
| 类型 | 样本数 | 通过 | 失败 |
|------|--------|------|------|
| type1 | 3 | 3 | 0 |
| type3 | 3 | 3 | 0 |
| type4 | 3 | 3 | 0 |
| type5 | 2 | 2 | 0 |
| type6 | 3 | 3 | 0 |
| type7 | 3 | 3 | 0 |
| type100 | 3 | 3 | 0 |
| type101 | 3 | 3 | 0 |
| type200 | 3 | 3 | 0 |
| **合计** | **26** | **26** | **0** |
截图存放:`e2e/artifacts/{type}-{templateId}.png`
---
## 四、既有回归(e2e/script-replay.spec.ts)
**结果**:2 tests 失败(与 F1-4 改动无关)
**根因**:script-replay 测试依赖 `/api/script/execute-template` 端点上的特定改写后脚本数据(templateId `0d9eac07-...`),该数据存在于 P4-5 专用后端实例(localhost:8086),当前运行环境 8093(eip4dev)没有这批脚本。
验证方法:git stash 恢复到 effc21d(F1-4 改动前),在相同环境运行 script-replay,结果同样 2 failed。**确认为环境预存问题,非 F1-4 引入回归**。
归因分桶:
| 错误类型 | 数量 | 说明 |
|----------|------|------|
| 脚本数据缺失 | 2 | 8093 无 P4-5 测试脚本数据,需在 8086 环境运行 |
---
## 五、构建与单测
| 检查项 | 结果 |
|--------|------|
| `npm run build`(tsc + vite build) | ✅ 通过 |
| `npm run test`(vitest,21 tests) | ✅ 全部通过 |
| `npx tsc --noEmit` | ✅ 零错误 |
---
## 六、文件清单
| 文件 | 变更类型 | 说明 |
|------|----------|------|
| `src/pages/PageRenderPage.tsx` | 修改 | 错误边界 + recentPages 接入 |
| `src/api/schema.ts` | 修改 | mock fallback 到后端(开发期支持真实 UUID) |
| `playwright.config.ts` | 修改 | 后端反代改为 8093(dev profile) |
| `scripts/schema-scan.mjs` | 新增 | 全量 schema 健康度扫描脚本 |
| `scripts/schema-scan-report.json` | 新增 | 扫描结果报告 |
| `e2e/schema-samples.spec.ts` | 新增 | 27 样本抽样渲染 e2e |
| `e2e/artifacts/` | 新增 | 渲染截图(26 张) |
| `docs/F1-4扫描报告.md` | 新增 | 本报告 |