gaokao-volunteer-system/SPRINT_4_PROGRESS_2026-07-03.md

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 契约测试