# generated: 2026-01-10
# project: 188-179-template-6
# project_key: 188-179-template-6
# tracking_system: file-system
# story_location: _bmad-output/implementation-artifacts

# STATUS DEFINITIONS:
# ==================
# Epic Status:
#   - backlog: Epic not yet started
#   - in-progress: Epic actively being worked on
#   - done: All stories in epic completed
#
# Epic Status Transitions:
#   - backlog -> in-progress: Automatically when first story is created (via create-story)
#   - in-progress -> done: Manually when all stories reach 'done' status
#
# Story Status:
#   - backlog: Story only exists in epic file
#   - ready-for-dev: Story file created in stories folder
#   - in-progress: Developer actively working on implementation
#   - review: Ready for code review (via Dev's code-review workflow)
#   - done: Story completed
#
# Retrospective Status:
#   - optional: Can be completed but not required
#   - done: Retrospective has been completed
#
# WORKFLOW NOTES:
# ===============
# - Epic transitions to 'in-progress' automatically when first story is created
# - Stories can be worked in parallel if team capacity allows
# - SM typically creates next story after previous one is 'done' to incorporate learnings
# - Dev moves story to 'review', then runs code-review (fresh context, different LLM recommended)

generated: 2026-01-10T08:00:00Z
project: 188-179-template-6
project_key: 188-179-template-6
tracking_system: file-system
story_location: _bmad-output/implementation-artifacts

development_status:
  # Epic 1: 测试工具包基础框架与 Select 支持
  epic-1: done
  1-1-create-package-structure: done
  1-2-implement-types-errors: done
  1-3-static-select-tool: done
  1-4-async-select-tool: done
  1-5-main-export-docs: done
  1-6-select-unit-tests: done
  epic-1-retrospective: done

  # Epic 2: 在现有 E2E 测试中验证 Select 工具
  # 详情参见: _bmad-output/implementation-artifacts/epic-2-retrospective.md
  epic-2: done
  2-1-install-e2e-utils: done
  2-2-rewrite-static-select: done
  2-3-rewrite-async-select: done
  2-4-run-tests-collect-feedback: done
  2-5-fix-found-issues: done
  epic-2-retrospective: done

  # Epic 3: 文件上传工具开发与验证
  # 目标: 遵循"先验证再扩展"策略，优先开发文件上传工具，解决当前测试超时阻塞问题
  # 模式: 工具开发 → 真实 E2E 测试验证 → 问题修复 → 稳定性验证
  epic-3: in-progress
  3-1-file-upload-tool: done             # 开发文件上传工具函数（含 UI 组件架构改进）
  3-2-upload-unit-tests: backlog         # 编写文件上传工具的单元测试
  3-3-upload-e2e-integration: backlog    # 在 web/tests/e2e 中验证文件上传工具
  3-4-collect-feedback-fix: backlog      # 收集反馈并修复问题
  3-5-upload-stability-test: backlog     # 文件上传稳定性验证 (10次连续运行)
  epic-3-retrospective: optional

  # Epic 4: 表单工具开发与验证
  # 模式: 工具开发 → 真实 E2E 测试验证 → 稳定性验证
  epic-4: backlog
  4-1-form-helper-tool: backlog          # 开发表单辅助工具函数
  4-2-form-unit-tests: backlog           # 编写表单工具的单元测试
  4-3-form-e2e-integration: backlog      # 在 web/tests/e2e 中验证表单工具
  4-4-form-stability-test: backlog       # 表单稳定性验证
  epic-4-retrospective: optional

  # Epic 5: 列表和对话框工具开发与验证
  # 模式: 工具开发 → 真实 E2E 测试验证 → 稳定性验证
  epic-5: backlog
  5-1-dynamic-list-tool: backlog         # 开发动态列表工具函数
  5-2-dialog-tool: backlog               # 开发对话框操作函数
  5-3-list-dialog-unit-tests: backlog    # 编写列表和对话框的单元测试
  5-4-list-dialog-e2e-integration: backlog  # 在 web/tests/e2e 中验证
  5-5-list-dialog-stability-test: backlog   # 稳定性验证
  epic-5-retrospective: optional

  # Epic 6: 完整验证（残疾人管理）
  # 状态: backlog - 等待所有工具开发和验证完成
  epic-6: backlog
  6-1-complete-flow-test: backlog
  6-2-stability-test: backlog
  epic-6-retrospective: optional

  # Epic 7: 完善文档与开发者体验
  epic-7: backlog
  7-1-improve-readme-docs: backlog
  7-2-vscode-snippets: backlog
  epic-7-retrospective: optional

# Epic 重新编号说明 (2026-01-10):
# =====================================
# 基于 Epic 1 和 Epic 2 的成功经验，采用"先验证再扩展"策略
# 每个工具都遵循: 工具开发 → E2E 验证 → 稳定性验证
#
# Epic 1: Select 工具开发 ✅
# Epic 2: Select 工具验证 ✅
# Epic 3: 文件上传工具开发与验证 🆕
#   - 解决当前测试超时阻塞问题
# Epic 4: 表单工具开发与验证 🆕
# Epic 5: 列表和对话框工具开发与验证 🆕
# Epic 6: 完整验证（残疾人管理）
# Epic 7: 文档与开发者体验

# 技术改进完成状态 (2026-01-10):
# ================================
# - HIGH: 配置 ESLint 规则捕获常见问题 ✅
# - HIGH: 更新架构文档记录 TypeScript + Playwright 陷阱 ✅
# - HIGH: 创建开发者自查清单 ✅
# 详情参见:
#   - packages/e2e-test-utils/eslint.config.js
#   - _bmad-output/planning-artifacts/architecture.md (新增 TypeScript+Playwright 陷阱部分)
#   - packages/e2e-test-utils/docs/DEVELOPER_CHECKLIST.md