计划书模块优化-tasks.md
3.76 KB
计划书模块优化任务清单
创建时间: 2026-02-14 分支: feature/优化计划书配置 预计总时长: 3-4 小时
📊 总体进度
- 第 1 步: 错误处理增强 (30 分钟)
- 第 2 步: 添加字段分组 (45 分钟)
- 第 3 步: 循环依赖检测 (30 分钟)
- 第 4 步: 简化转换逻辑 (60 分钟)
- 第 5 步: 添加集成测试 (60 分钟)
📝 任务详情
第 1 步：错误处理增强 (30 分钟)
目标: 增强 usePlanView.js 的错误处理和边界情况
文件: src/composables/usePlanView.js
子任务:
- 添加 proposal.id 空值检查
- 添加 proposalFiles 空数组检查
- 添加 try-catch 错误捕获
- 添加 onError 回调支持
- 添加错误日志记录
- 更新 JSDoc 注释
验收标准:
- 当 proposal.id 为空时显示友好提示
- 当 proposalFiles 为空时显示友好提示
- 所有错误都被正确捕获和记录
- onError 回调正确执行
第 2 步：添加字段分组 (45 分钟)
目标: 为 plan-fields.js 添加逻辑分组，提升配置可读性
文件: src/config/plan-fields.js
子任务:
- 定义 FIELD_GROUPS 枚举
- 为每个字段添加 group 属性
- 创建 getFieldsByGroup(group) 工具函数
- 更新 JSDoc 注释
- 更新相关测试用例
验收标准:
- 字段正确分组（BASIC/COVERAGE/WITHDRAWAL）
- getFieldsByGroup 函数正常工作
- 测试覆盖新增函数
第 3 步：循环依赖检测 (30 分钟)
目标: 为 useFieldDependencies.js 添加循环依赖检测
文件: src/composables/useFieldDependencies.js
子任务:
- 实现 detectCircularDeps 函数
- 在 initFieldStates 中调用检测
- 添加开发环境警告日志
- 更新 JSDoc 注释
- 添加测试用例
验收标准:
- 能正确检测到循环依赖
- 检测时在控制台输出清晰的错误信息
- 不影响正常功能的性能
- 测试覆盖循环依赖场景
第 4 步：简化转换逻辑 (60 分钟)
目标: 简化 useFieldValueTransform.js 的转换逻辑
文件: src/composables/useFieldValueTransform.js
子任务:
- 将 transformFormData 抽取到 planFieldTransformers.js
- 使用策略模式重构 transform 函数
- 减少重复代码
- 更新 JSDoc 注释
- 更新相关测试用例
验收标准:
- 代码行数减少 20% 以上
- 所有现有测试仍然通过
- 新增测试覆盖边界情况
- 转换逻辑更清晰易懂
第 5 步：添加集成测试 (60 分钟)
目标: 添加计划书模块的集成测试
文件: src/composables/__tests__/usePlanView.integration.test.js
子任务:
- 创建集成测试文件
- 编写 viewProposal 完整流程测试
- 编写字段依赖关系测试
- 编写字段转换测试
- 编写错误处理测试
- 确保测试覆盖率 > 80%
验收标准:
- 测试覆盖主要用户流程
- 测试覆盖边界情况
- 所有测试通过
- 测试可重复执行
🔍 快速跳转
📝 备注
- 每完成一个子任务，就在对应的 [ ] 中打勾 ✓
- 每完成一大步（5个子任务），就在总体进度中打勾 ✓
- 遇到问题时，在对应任务下添加记录