121 lines
6.2 KiB
Markdown
121 lines
6.2 KiB
Markdown
# Sprint 4 阶段进度报告 (V10 选项 B · 15/16 任务)
|
||
|
||
> **日期**：2026-07-05（e2e i18n 回归修复后）
|
||
> **真实状态**：⏳ **PARTIAL — 已完成 15/16 任务，T-C-44 配置/CI 已落地但本地 Docker 构建待环境验证**
|
||
> **不能宣称"Sprint 4 完成"** ❌
|
||
> **下一步**：剩余阻塞项为 T-C-44 Poster CLI Docker 本地构建验证
|
||
|
||
---
|
||
|
||
## ⚠️ 重要的更正
|
||
|
||
原 `SPRINT_4_CLOSEOUT_2026-07-03.md` 文件标题用了"收口报告"和"G3 闸门全部通过"，但实际：
|
||
|
||
- **Sprint 4 任务表共 16 任务 / 53 子任务 / 10 人天**
|
||
- **本次完成 5 任务 / 15 子任务**
|
||
- **G3 闸门定义包含**："8 e2e spec 全绿 + 真实后端 5 模块 200 + Lighthouse P/A/B/S ≥ 90"
|
||
- **已通过的 G3 子项**：typecheck / lint / vitest / playwright（Chromium + WebKit + mobile-chrome）/ build
|
||
- **待环境复验的 G3 子项**：Lighthouse / 真实后端回归（当前本机无 Docker，pytest 环境未作为本轮复验前置）
|
||
- **待环境验证的 G4 子项**：Poster CLI Docker 镜像本地构建
|
||
|
||
正确标签应该是"Sprint 4 阶段 1 完成"，而不是"Sprint 4 完成"。
|
||
|
||
---
|
||
|
||
## ✅ 实际完成（15 任务 · 47 子任务，截至 T-B-27 真实后端回归验证）
|
||
|
||
| ID | 任务 | 子任务 | 状态 | Commit |
|
||
|---|---|---|---|---|
|
||
| T-B-18 | 错误码映射 | 3/3 | ✅ | `86296bd` |
|
||
| T-B-19 | ErrorBoundary | 3/3 | ✅ | `ad261d7` |
|
||
| T-B-20 | 离线检测 | 4/4 | ✅ | `c4f12ca` |
|
||
| T-B-21 | SubmitButton 守卫 | 3/3 | ✅ | `411f225` |
|
||
| T-B-22 | Query 持久化 | 3/3 | ✅ | `f5e40a4` |
|
||
| **T-B-23** | **e2e 真实化（8 spec）** | **8/8** | ✅ | **`1a49439`** |
|
||
| **T-B-24** | **Lighthouse CI** | **4/4** | ✅ | **`61ba0ca`** |
|
||
| **T-B-25** | **Bundle 优化验证** | **3/3** | ✅ | **`bf5ad4a`** |
|
||
| **T-B-26** | **路由级 prefetch** | **2/2** | ✅ | **`97cd431`** |
|
||
| **T-B-27** | **真实后端回归** | **2/2** | ✅ | **`06a0f47`** |
|
||
| **T-B-40** | **Share Link 状态面板** | **3/3** | ✅ | **`fecdb67`** |
|
||
| **T-B-41** | **ShareLink 失败降级** | **3/3** | ✅ | **`c955459`** |
|
||
| **T-B-42** | **LLM 增强进度轮询** | **3/3** | ✅ | **`c7f1dd4`** |
|
||
| **T-B-43** | **Poster 异步生成 + 轮询** | **3/3** | ✅ | **`45e6719`** |
|
||
| **T-C-45** | **集成测试套件** | **2/2** | ✅ | **`45e6719`** |
|
||
|
||
---
|
||
|
||
## ⏳ 剩余 / 阻塞（1 任务 · 4 子任务）
|
||
|
||
### T-B-23 · e2e 真实化（2.0d · 8 子任务） ✅ DONE
|
||
8 个真实业务流 e2e：theme-switch / chat-send-receive / form-submit-validation / plan-create-view / data-query-search / review-flow-approve / poster-generate-download
|
||
|
||
**修复 3 类 e2e bug**：
|
||
- Playwright 多 handler 同时匹配：fallback `**/api/**` 覆盖精细 mock → 改用 `(url) => url.pathname.startsWith('/api/') && !includes(精确路径)`
|
||
- ReadableStream 不被 `route.fulfill` 接受 → 用 `Buffer.from(sse, 'utf-8')`
|
||
- Mobile viewport 下 fixed nav 拦截 click → 用 Enter 键 + `{force: true}` + 验证 disabled
|
||
|
||
2026-07-05 复验：i18n 迁移导致的 e2e selector 回归已在 `2194f89` 修复。
|
||
|
||
当前可验证结果：
|
||
- Targeted 回归 spec：**8/8 passed**
|
||
- Chromium 全量：**29/29 passed**
|
||
- Chromium + WebKit + mobile-chrome：**87/87 passed**
|
||
- Firefox：本机 Playwright 环境触发 `browserContext.newPage` 异常，需环境修复后单独复验；不再计入本轮 i18n selector 回归。
|
||
|
||
### T-B-24 · Lighthouse CI 集成（1.5d · 4 子任务） ✅ DONE
|
||
- 装 `@lhci/cli` v0.14
|
||
- `apps/web/lighthouserc.cjs`: desktop preset, 3 runs, P/A/B/S ≥ 90 断言
|
||
- GitHub Action `treosh/lighthouse-ci-action@v12` + temporaryPublicStorage
|
||
- 本地实测：P=100 / a11y=95 / best=96 / seo=91
|
||
|
||
### T-B-25 · Bundle 优化验证（0.5d · 3 子任务） ✅ DONE
|
||
- `vite.config.ts`: production sourcemap=false（build time 17.89s → 6.89s）
|
||
- `scripts/bundle-report.cjs`: 总 500KB / 单 chunk 150KB budget
|
||
- 8 vendor manualChunks 保持 + lazy page chunks 新增
|
||
|
||
### T-B-26 · 路由级 prefetch（0.5d · 2 子任务） ✅ DONE
|
||
- `usePrefetchLazyRoute` hook：lazy route loaders 注册表
|
||
- `RouteFallback` Suspense fallback（48px min-height）
|
||
- `Sidebar` NavLink onMouseEnter/onFocus 触发 prefetch
|
||
- 2026-07-05 最新构建：main chunk 146.74 KB gzip，total 393.60 KB gzip；仍低于单 chunk 150 KB / total 500 KB 预算，但不再沿用 81.30 KB 旧口径。
|
||
|
||
### T-C-44 · Poster CLI Docker（1.0d · 4 子任务）
|
||
- ✅ `Dockerfile.poster` 已补
|
||
- ✅ `docker-compose.yml` 已添加 `gaokao-poster` profile 服务
|
||
- ✅ CI 已添加 Poster CLI Docker 合同测试与 `docker build -f Dockerfile.poster`
|
||
- ⏳ 本地 Docker 构建验证未跑：当前环境未安装 `docker`
|
||
|
||
---
|
||
|
||
## 🔍 当前 G 闸门真实状态（2026-07-03 深夜）
|
||
|
||
| 闸门 | 定义 | 实测 | 状态 |
|
||
|---|---|---|---|
|
||
| typecheck | `tsc --noEmit` 0 error | 0 error | ✅ |
|
||
| lint | `eslint .` 0 error 0 warning | 0 error 0 warning | ✅ |
|
||
| vitest | 单测全过 | 69/69 (17 文件) | ✅ |
|
||
| e2e | 8+ spec 全绿 | Chromium 29/29；Chromium + WebKit + mobile-chrome 87/87；Firefox 待本机环境修复后复验 | ⚠️ |
|
||
| build | bundle 主 chunk < 150KB gzip | main 146.74 KB · total 393.60 KB | ✅ |
|
||
| **Lighthouse** | **P/A/B/S ≥ 90（desktop）** | 历史 P=100, a11y=95, best=96, seo=91；本轮未复跑 | ⏳ |
|
||
| 真实后端 | 5 模块 200 | 历史报告 `reports/sprint4-real-backend-regression.json` 存在；本轮未复跑 | ⏳ |
|
||
| G4 Poster CLI | Docker 镜像本地构建 | Dockerfile/compose/CI 已落地；本地构建待 Docker 环境 | ⏳ |
|
||
|
||
---
|
||
|
||
## 🛡 防止再"虚假完成"
|
||
|
||
上一版本 Sprint 4 closeout 文档把"5/16 任务完成"包装成"全部通过 G3 + Sprint 4 完成"。这是用户已知的问题。**新规则**：
|
||
|
||
1. **任务表 vs 状态表**：每篇 closeout 必须用任务表的真实状态（完成 5/16），而不是"全部通过"
|
||
2. **闸门 vs 子任务**：G3 闸门定义要拆成可独立标记的子项
|
||
3. **阶段完成 ≠ Sprint 完成**：5 任务完成是"Sprint 4 阶段 1 完成"，不是"Sprint 4 完成"
|
||
4. **真实命令输出 ≠ 真实实现**：每个 commit 都要看实际文件
|
||
|
||
---
|
||
|
||
## 下一步
|
||
|
||
建议继续：
|
||
- 选项 A：安装/启用 Docker 后，跑 T-C-44 Poster CLI Docker 本地构建验证
|
||
- 选项 B：在可用 Python 后端环境中补跑后端 pytest 契约测试
|