# generated: 2026-01-11
# 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-11T12: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
  2-6-stability-validation: done
  epic-2-retrospective: done

  # Epic 3: 文件上传工具开发与验证
  # 目标: 遵循"先验证再扩展"策略，优先开发文件上传工具，解决当前测试超时阻塞问题
  # 模式: 工具开发 → 真实 E2E 测试验证 → 问题修复 → 稳定性验证
  # 回顾文档: _bmad-output/implementation-artifacts/epic-3-retrospective.md
  epic-3: done
  3-1-file-upload-tool: done             # 开发文件上传工具函数（含 UI 组件架构改进）
  3-2-upload-unit-tests: done             # 编写文件上传工具的单元测试
  3-3-upload-e2e-integration: done       # 在 web/tests/e2e 中验证文件上传工具
  3-4-collect-feedback-fix: done         # 收集反馈并修复问题（修复了 Select 工具处理带 * 标签的问题）
  3-5-multiple-file-upload: done         # 支持多文件同时上传
  3-6-upload-stability-test: done        # 文件上传稳定性验证 (6次连续运行 100% 通过)
  epic-3-retrospective: done              # 回顾完成于 2026-01-11

  # Epic 4: 表单工具开发与验证
  # 模式: 工具开发 → 真实 E2E 测试验证 → 稳定性验证
  epic-4: in-progress
  4-1-form-helper-tool: ready-for-dev          # 开发表单辅助工具函数
  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-dialog-tool: backlog  # 开发动态列表和对话框工具函数
  5-2-list-dialog-unit-tests: backlog   # 编写列表和对话框的单元测试
  5-3-list-dialog-e2e-integration: backlog  # 在 web/tests/e2e 中验证
  5-4-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       # 完善 README、API 文档和示例
  7-2-vscode-snippets: backlog           # VS Code Snippets 和开发体验
  epic-7-retrospective: optional

  # Epic 8: 区域管理 E2E 测试 (Epic B - 业务测试 Epic)
  # 目标: 测试开发者可以为区域管理功能编写完整的 E2E 测试
  # 业务分组: Epic B（业务测试 Epic）
  # 范围: 省/市/区/街道的添加、编辑、删除和级联选择功能
  # 依赖: Epic 9 完成（确保测试隔离和并行执行策略已验证）
  epic-8: in-progress
  8-1-region-page-object: done         # 创建区域管理 Page Object
  8-2-region-list-test: done          # 编写区域列表查看测试（代码审查已完成）
  8-3-add-region-test: in-progress      # 编写添加区域测试
  8-4-edit-region-test: backlog          # 编写编辑区域测试
  8-5-delete-region-test: backlog        # 编写删除区域测试
  8-6-cascade-select-test: backlog       # 编写级联选择完整流程测试
  8-7-run-tests-collect-issues: backlog  # 运行测试并收集问题和改进建议
  8-8-extend-utils-if-needed: backlog    # 扩展工具包（如需要）
  8-9-region-stability-test: backlog     # 区域管理稳定性验证
  epic-8-retrospective: optional

  # Epic 9: 残疾人管理完整 E2E 测试覆盖（含并行隔离）
  # 目标: 为残疾人管理功能编写完整的、真正验证业务功能的 E2E 测试
  # 背景: 现有测试只是组件验证，需要补充完整的业务功能测试
  # 模式: 业务测试优先，工具按需扩展（遵循新 PRD 方向）
  # 优先级: HIGH - 阻塞 Epic B（区域管理测试）
  # 详情参见: _bmad-output/implementation-artifacts/epic-9-plan.md
  epic-9: in-progress
  9-1-photo-upload-tests: done              # 照片上传功能完整测试（所有8个测试通过）
  9-2-bankcard-tests: done              # 银行卡管理功能测试（添加、编辑、删除）
  9-3-note-tests: review               # 备注管理功能测试（添加、修改、删除）
  9-4-visit-tests: backlog               # 回访记录管理测试（创建、查看、编辑）
  9-5-crud-tests: backlog                # 完整流程测试（新增、编辑、删除、查看）
  9-6-parallel-isolation: backlog        # 测试隔离与并行执行验证
  9-7-stability-validation: backlog      # 稳定性验证（10 次连续运行）
  epic-9-retrospective: optional

  # Epic 10: 订单管理 E2E 测试 (Epic C - 业务测试 Epic)
  # 目标: 测试开发者可以为订单管理功能编写完整的 E2E 测试
  # 业务分组: Epic C（业务测试 Epic）
  # 范围: 订单 CRUD、状态流转、人员关联、附件管理功能
  # 背景: 订单管理是招聘系统的核心业务功能，涉及复杂表单、状态流转、人员关联等场景
  # 依赖: Epic 1 和 Epic 2 完成（Select 工具基础）
  # 详情参见: _bmad-output/planning-artifacts/epics.md (Epic 10)
  epic-10: in-progress
  10-1-order-page-object: done                  # 创建订单管理 Page Object
  10-2-order-list-tests: done                  # 编写订单列表查看测试（代码审查完成，所有HIGH和MEDIUM问题已修复）
  10-3-order-filter-tests: ready-for-dev   # 编写订单搜索和筛选测试
  10-4-order-create-tests: backlog         # 编写创建订单测试
  10-5-order-edit-tests: backlog           # 编写编辑订单测试
  10-6-order-delete-tests: backlog         # 编写删除订单测试
  10-7-order-status-tests: backlog         # 编写订单状态流转测试
  10-8-order-detail-tests: backlog         # 编写订单详情查看测试
  10-9-order-person-tests: backlog         # 编写人员关联功能测试
  10-10-order-attachment-tests: backlog    # 编写附件管理测试
  10-11-order-complete-tests: backlog      # 编写订单完整流程测试
  10-12-run-tests-collect-issues: backlog  # 运行测试并收集问题和改进建议
  10-13-extend-utils-if-needed: backlog   # 扩展工具包（如需要）
  10-14-order-stability-test: backlog     # 订单管理稳定性验证
  epic-10-retrospective: optional

# Epic 组织架构 (2026-01-11):
# =========================
# Epic A: 残疾人管理 E2E 测试 🔄 进行中
#   - Epic 1: 测试工具包基础框架与 Select 支持 ✅
#   - Epic 2: 在现有 E2E 测试中验证 Select 工具 ✅
#   - Epic 3: 文件上传工具开发与验证 ✅
#   - Epic 9: 残疾人管理完整 E2E 测试覆盖（含并行隔离）🔄 进行中
#
# Epic B: 区域管理 E2E 测试 🔄 进行中
#   - Epic 8: 区域管理 E2E 测试
#
# Epic C: 订单管理 E2E 测试 🔄 进行中
#   - Epic 10: 订单管理 E2E 测试 (核心业务功能)
#
# Epic D: e2e-test-utils 包维护 🌟 支持性任务
#   - Epic 4: 表单工具开发与验证 🔄 进行中
#   - Epic 5: 列表和对话框工具开发与验证
#   - Epic 6: 完整验证（已合并到 Epic 9）
#   - Epic 7: 文档与开发者体验
#
# 新 PRD 方向（2026-01-11 修订）：
# - 业务测试优先（主目标）
# - 工具自然演进（副目标）
# - Epic 优先级建议：Epic B（简单）→ Epic C（复杂核心业务）

# 技术改进完成状态 (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