249 lines
7.8 KiB
Markdown
249 lines
7.8 KiB
Markdown
<!-- 历史快照提示：本文件保留为历史审计材料，不再代表当前项目状态。 -->
|
||
> ⚠️ **历史快照（非当前真相源）**：本文件仅保留当时审查/收口结论。当前状态与执行顺序以 `docs/CURRENT_STATE.md`、`docs/ACTIVE_REMEDIATION_2026-07-05_REVIEW.md`、`docs/ACTIVE_EXECUTION_BOARD_2026-07-05_REVIEW_REMEDIATION.md`、`docs/plans/2026-07-05-review-remediation-systemic-fix-plan.md` 和 `reports/REVIEW_REPORT_2026-07-05_COMPREHENSIVE_PROJECT_REVIEW.md` 为准。
|
||
|
||
---
|
||
|
||
# Sprint 6 任务拆解（W10-11 · 12 人天 · 56 子任务）— V10 选项 B
|
||
|
||
> **技术栈**：Vite 5 + React 19 + Zustand 4 + TanStack Query 5 + RHF 7 + Zod
|
||
> **目标**：查询/审核业务 UI（SharePanel / DataQueryForm / ReviewFlow / LLMEnhancement / PosterPreview）
|
||
> **闸门**：G6（视觉一致性 design pass + Chromatic 0 像素 diff）
|
||
> **V10 变化**：保持 12d（S6 是业务密集型，工时难压）
|
||
> **PM 决策（2026-07-03）**：整体重写为新实现；Playwright 视觉回归 + Chromatic 验收
|
||
|
||
---
|
||
|
||
## ⚠️ V10 关键变化（与 V2 对比）
|
||
|
||
| 维度 | V2 | V10 选项 B |
|
||
|---|---|---|
|
||
| DataQueryForm 4 变体 | 1.0d | **1.0d**（不变） |
|
||
| DataQueryResult 4 变体 | 1.0d | **1.0d**（不变） |
|
||
| 业务组件库 | 7 | 7（不变） |
|
||
| a11y 集成 | S6 末 | **S5 已完成**，S6 复用 |
|
||
| 总估时 | 11d | **12d**（略增：加 1d Chromatic 验证） |
|
||
|
||
---
|
||
|
||
## 0. Sprint 6 概览
|
||
|
||
| 任务 | 主任务 | 估时 | 子任务数 |
|
||
|---|---|---|---|
|
||
| T-D-11 | axe-core 集成（复用 S5） | 0d | 0 |
|
||
| T-D-12 | 屏幕阅读器 + 键盘测试 | 0.5d | 3 |
|
||
| T-D-13 | 替换 alert() 为 Toast | 0.25d | 2 |
|
||
| T-D-14 | SharePanel 组件 | 0.75d | 5 |
|
||
| T-D-15 | ShareStatusPanel 组件 | 0.5d | 4 |
|
||
| T-D-16 | DataQueryForm（4 变体） | 1.0d | 6 |
|
||
| T-D-17 | DataQueryResult（4 变体） | 1.0d | 6 |
|
||
| T-D-18 | ReviewFlow 组件 | 0.75d | 4 |
|
||
| T-D-19 | LLMEnhancement 组件 | 0.75d | 4 |
|
||
| T-D-20 | PosterPreview 组件 | 0.5d | 4 |
|
||
| T-D-21 | 暗色变体审计 | 1.0d | 4 |
|
||
| T-D-22 | Chromatic 视觉回归（S6 增量） | 1.0d | 4 |
|
||
| T-D-23 | ESLint 0 warning 守门 | 0.5d | 3 |
|
||
| **合计** | **13 任务（含 1 复用）** | **9.5d + 缓冲 2.5d = 12d** | **49** |
|
||
|
||
---
|
||
|
||
## T-D-11 · axe-core 集成（复用 S5 · 0d · 0 子任务）
|
||
|
||
> **V10 收益**：Sprint 5 已集成，S6 直接复用
|
||
|
||
---
|
||
|
||
## T-D-12 · 屏幕阅读器 + 键盘测试（0.5d · 3 子任务）
|
||
|
||
### ST-S6-D-12.1 VoiceOver 测试（0.25d）
|
||
- **覆盖**：5 业务组件关键路径
|
||
|
||
### ST-S6-D-12.2 NVDA 测试（0.125d）
|
||
|
||
### ST-S6-D-12.3 键盘导航测试（0.125d）
|
||
- **覆盖**：Tab / Shift+Tab / Enter / Esc / 方向键
|
||
|
||
---
|
||
|
||
## T-D-13 · 替换 alert() 为 Toast（0.25d · 2 子任务）
|
||
|
||
### ST-S6-D-13.1 grep + 替换（0.125d）
|
||
- **命令**：`grep -rn "alert(" apps/web/src/`
|
||
- **替换**：`toast.error(message)` / `toast.success(message)`
|
||
|
||
### ST-S6-D-13.2 验证无 alert() 残留（0.125d）
|
||
|
||
---
|
||
|
||
## T-D-14 · SharePanel 组件（0.75d · 5 子任务）
|
||
|
||
### ST-S6-D-14.1 写组件骨架（0.25d）
|
||
- **V10 集成**：RHF + Zod
|
||
- **UI/交互 1:1**：与原型分享面板一致
|
||
|
||
### ST-S6-D-14.2 写表单字段（0.125d）
|
||
- 分享链接有效期（7/30/永久）
|
||
- 访问密码
|
||
- 备注
|
||
|
||
### ST-S6-D-14.3 接入 `useShareLinkCreate`（0.125d）
|
||
### ST-S6-D-14.4 写 story（0.125d）
|
||
### ST-S6-D-14.5 写 e2e（0.125d）
|
||
|
||
---
|
||
|
||
## T-D-15 · ShareStatusPanel 组件（0.5d · 4 子任务）
|
||
|
||
### ST-S6-D-15.1 写 3 统计卡片（0.125d）
|
||
### ST-S6-D-15.2 写访问趋势 mini chart（0.125d）
|
||
### ST-S6-D-15.3 写 story（0.125d）
|
||
### ST-S6-D-15.4 写 e2e（0.125d）
|
||
|
||
---
|
||
|
||
## T-D-16 · DataQueryForm（4 变体 · 1.0d · 6 子任务）
|
||
|
||
### ST-S6-D-16.1 写 scoreLine 变体（0.125d）
|
||
- **字段**：省份 / 年份 / 类型
|
||
|
||
### ST-S6-D-16.2 写 rankEstimator 变体（0.125d）
|
||
- **字段**：位次 / 选科 / 年份
|
||
|
||
### ST-S6-D-16.3 写 majors 变体（0.125d）
|
||
- **字段**：专业类 / 学历 / 院校
|
||
|
||
### ST-S6-D-16.4 写 schools 变体（0.125d）
|
||
- **字段**：院校 / 省份 / 类型
|
||
|
||
### ST-S6-D-16.5 接入 TanStack Query mutations（0.25d）
|
||
- **V10 收益**：4 变体复用同一表单骨架
|
||
|
||
### ST-S6-D-16.6 写 story（0.25d）
|
||
|
||
---
|
||
|
||
## T-D-17 · DataQueryResult（4 变体 · 1.0d · 6 子体）
|
||
|
||
### ST-S6-D-17.1 写 scoreLine 变体（0.125d）
|
||
- **展示**：分数段分布表 + chart
|
||
|
||
### ST-S6-D-17.2 写 rankEstimator 变体（0.125d）
|
||
- **展示**：等效分数 + 院校推荐
|
||
|
||
### ST-S6-D-17.3 写 majors 变体（0.125d）
|
||
- **展示**：专业列表 + 院校
|
||
|
||
### ST-S6-D-17.4 写 schools 变体（0.125d）
|
||
- **展示**：院校卡片
|
||
|
||
### ST-S6-D-17.5 接入虚拟滚动（0.25d）
|
||
- **V10 收益**：TanStack Virtual 万行流畅
|
||
|
||
### ST-S6-D-17.6 写 story（0.25d）
|
||
|
||
---
|
||
|
||
## T-D-18 · ReviewFlow 组件（0.75d · 4 子任务）
|
||
|
||
### ST-S6-D-18.1 写审核步骤指示器（0.25d）
|
||
- **V10 集成**：复用 S5-D-13 Stepper
|
||
|
||
### ST-S6-D-18.2 写审核表单（RHF 版 · 0.25d）
|
||
- **字段**：审批意见 / 风险等级 / 备注
|
||
|
||
### ST-S6-D-18.3 接入 useReview* hooks（0.125d）
|
||
### ST-S6-D-18.4 写 story + e2e（0.125d）
|
||
|
||
---
|
||
|
||
## T-D-19 · LLMEnhancement 组件（0.75d · 4 子任务）
|
||
|
||
### ST-S6-D-19.1 写 Provider 选择器（0.25d）
|
||
- **V10 集成**：复用 T-B-17 LLM provider
|
||
|
||
### ST-S6-D-19.2 写流式结果展示（0.25d）
|
||
- **V10 集成**：SSE + Markdown 渲染
|
||
|
||
### ST-S6-D-19.3 接入 useAuditEnhanceMutation（0.125d）
|
||
### ST-S6-D-19.4 写 story + e2e（0.125d）
|
||
|
||
---
|
||
|
||
## T-D-20 · PosterPreview 组件（0.5d · 4 子任务）
|
||
|
||
### ST-S6-D-20.1 写海报渲染（0.125d）
|
||
- **V10 集成**：html2canvas
|
||
|
||
### ST-S6-D-20.2 写 QR Code 嵌入（0.125d）
|
||
### ST-S6-D-20.3 接入 usePosterGenerateMutation（0.125d）
|
||
### ST-S6-D-20.4 写 story + e2e（0.125d）
|
||
|
||
---
|
||
|
||
## T-D-21 · 暗色变体审计（1.0d · 4 子任务）⚠️ V10 关键
|
||
|
||
### ST-S6-D-21.1 截图所有 7 业务组件 dark mode（0.25d）
|
||
|
||
### ST-S6-D-21.2 Chromatic diff 检测（0.25d）
|
||
- **验收**：0 像素 diff
|
||
|
||
### ST-S6-D-21.3 修复对比度问题（0.25d）
|
||
- **目标**：WCAG AA（4.5:1）
|
||
|
||
### ST-S6-D-21.4 提交 Chromatic 基线（0.25d）
|
||
|
||
---
|
||
|
||
## T-D-22 · Chromatic 视觉回归（S6 增量 · 1.0d · 4 子任务）⚠️ V10 新增
|
||
|
||
### ST-S6-D-22.1 7 业务组件 × 3 主题（0.25d）
|
||
- light / dark / system × 7 组件 = 21 截图
|
||
|
||
### ST-S6-D-22.2 移动端 viewport（0.25d）
|
||
- 375px / 768px / 1024px × 7 组件 = 21 截图
|
||
|
||
### ST-S6-D-22.3 交互态截图（0.25d）
|
||
- hover / focus / active / disabled / loading / error
|
||
|
||
### ST-S6-D-22.4 提交基线（0.25d）
|
||
|
||
---
|
||
|
||
## T-D-23 · ESLint 0 warning 守门（0.5d · 3 子任务）
|
||
|
||
### ST-S6-D-23.1 清理 S6 引入的 any（0.25d）
|
||
### ST-S6-D-23.2 清理 S6 引入的 unused（0.125d）
|
||
### ST-S6-D-23.3 守住 Sprint 1-5 已修复规则（0.125d）
|
||
|
||
---
|
||
|
||
## V10 验收清单（Sprint 6 G6 闸门）
|
||
|
||
```
|
||
G6 闸门（必须全部通过）：
|
||
[ ] 7 业务组件全部完成 + story 全覆盖
|
||
[ ] axe-core 0 critical 0 serious
|
||
[ ] pnpm typecheck 0 error 0 any
|
||
[ ] pnpm lint 0 error 0 warning
|
||
[ ] pnpm test:storybook 全绿
|
||
[ ] pnpm chromatic 视觉基线 7 组件 × 3 主题 × 3 viewport × 6 态 = 378 截图
|
||
[ ] WCAG AA 对比度全通过
|
||
[ ] DataQueryForm 万行结果 < 200ms 渲染
|
||
```
|
||
|
||
---
|
||
|
||
## V10 风险（Sprint 6 特有）
|
||
|
||
| ID | 风险 | 等级 | 缓解 |
|
||
|---|---|---|---|
|
||
| V10-S6-R1 | 4 变体 DataQueryForm 代码重复 | 中 | 提取 `<QueryForm variant=...>` 单一组件 |
|
||
| V10-S6-R2 | 暗色变体对比度不达标 | 中 | 用 design token 强制；S6-D-21 强制审计 |
|
||
| V10-S6-R3 | Chromatic 配额超限 | 低 | 累计 S2-S5 用 4 次，剩 6 次给 S6-S8 |
|
||
|
||
---
|
||
|
||
**Sprint 6 文档状态**：V10 选项 B 重写完成
|
||
**总工时**：12 人天（V2 是 11 人天，+1d Chromatic 验证）
|
||
**总子任务**：49 个（V2 是 55 个）
|
||
**下一步**：Sprint 5 完成后立即启动
|