Story 1.4: 建立任务管理和执行闭环

字数

2795 字

阅读时间

12 分钟

Status

Draft

Story

As a 用户, I want 将AI建议转化为可执行的任务并跟踪进度, so that 我能够真正落实心理健康改善行动。

Acceptance Criteria

1. AC1: 支持从AI建议一键创建任务
2. AC2: 提供任务分类、优先级设置和截止日期管理
3. AC3: 实现任务执行状态跟踪和完成度统计
4. AC4: 支持任务提醒和打卡功能
5. AC5: 生成任务完成报告和成就反馈

Tasks / Subtasks

• [ ] Task 1: 实现任务创建和管理功能 (AC: 1, 2)

  • [ ] 开发从AI建议一键创建任务的流程
  • [ ] 实现任务分类和标签系统
  • [ ] 添加优先级设置和截止日期管理
  • [ ] 支持任务模板和快速创建
  • [ ] 实现任务编辑和删除功能

• [ ] Task 2: 构建任务执行跟踪系统 (AC: 3, 4)

  • [ ] 开发任务状态管理（待执行/进行中/已完成/已跳过/延期）
  • [ ] 实现番茄计时器和专注模式
  • [ ] 添加任务提醒和推送通知
  • [ ] 开发任务打卡和签到功能
  • [ ] 实现执行进度追踪和统计

• [ ] Task 3: 开发任务复盘和反馈系统 (AC: 5)

  • [ ] 设计任务复盘表单和流程
  • [ ] 实现情绪前后对比评分
  • [ ] 添加执行体会和困难记录
  • [ ] 开发任务完成报告生成
  • [ ] 实现成就反馈和徽章解锁

• [ ] Task 4: 建立多来源任务整合 (Integration Enhancement)

  • [ ] 整合AI建议、社区行动卡、真人指派等任务来源
  • [ ] 实现任务来源标识和追踪
  • [ ] 开发跨平台任务同步机制
  • [ ] 添加任务关联和依赖管理
  • [ ] 实现任务数据分析和洞察

• [ ] Task 5: 实现任务数据可视化 (AC: 3, 5)

  • [ ] 开发任务完成度统计图表
  • [ ] 实现任务执行趋势分析
  • [ ] 添加任务类别和时间分布分析
  • [ ] 开发个人成长数据面板
  • [ ] 实现数据导出和分享功能

• [ ] Task 6: 完善数据模型和服务层 (AC: 1, 2, 3, 4, 5)

  • [ ] 设计和实现behavior_tasks数据库集合
  • [ ] 创建task_timer_sessions计时记录集合
  • [ ] 创建task_reviews复盘记录集合
  • [ ] 扩展tasks.js服务，支持完整任务管理
  • [ ] 实现任务与情绪打卡的关联

• [ ] Task 7: 实现taskWorkflow云函数 (AC: 1, 2, 3, 4, 5)

  • [ ] 实现主要任务CRUD操作
  • [ ] 添加任务状态流转逻辑
  • [ ] 实现任务提醒和通知功能
  • [ ] 添加任务统计和分析API
  • [ ] 实现与建议和社区系统的集成

• [ ] Task 8: 集成现有功能验证 (Integration Verification)

  • [ ] 验证与taskWorkflow云函数的数据同步
  • [ ] 确认任务数据正确写入behavior_tasks数据库集合
  • [ ] 测试任务推送通知的准确性和及时性
  • [ ] 验证与今天页任务预览的集成
  • [ ] 测试与周报系统的数据流转

• [ ] Task 9: 编写单元测试和集成测试

  • [ ] 为任务管理功能编写测试用例
  • [ ] 为番茄计时器编写测试
  • [ ] 编写任务状态流转测试
  • [ ] 创建复盘功能测试
  • [ ] 添加性能和数据一致性测试

Dev Notes

Previous Story Insights

基于前三个故事的情绪打卡、AI建议和社区功能，本故事需要将所有来源的建议和行动整合为统一的任务管理系统，形成完整的"情绪→建议→任务→复盘"闭环。

Data Models

behavior_tasks集合设计 [Source: docs/功能文档/功能-任务卡执行闭环.md#数据需求]

• 主要字段：
  • task_id: string - 任务唯一标识
  • user_id: string - 用户标识
  • title: string - 任务标题
  • description: string - 任务描述
  • source: string - 任务来源（suggestion/community/action_card/self/human）
  • category: string - 任务分类
  • status: string - 任务状态（pending/in_progress/completed/skipped/delayed）
  • priority: string - 优先级（high/medium/low）
  • estimated_duration_minutes: number - 预计执行时长
  • due_at: date - 截止时间
  • origin_reference_id: string - 来源对象ID
  • checklist_steps: array - 检查清单步骤

task_timer_sessions集合 [Source: docs/功能文档/功能-任务卡执行闭环.md#数据需求]

• 主要字段：
  • session_id: string - 计时会话唯一标识
  • task_id: string - 关联任务ID
  • start_at: date - 开始时间
  • end_at: date - 结束时间
  • paused_duration: number - 暂停时长（秒）
  • completed: boolean - 是否完成

task_reviews集合 [Source: docs/功能文档/功能-任务卡执行闭环.md#数据需求]

• 主要字段：
  • review_id: string - 复盘唯一标识
  • task_id: string - 关联任务ID
  • pre_mood_score: number - 执行前情绪评分
  • post_mood_score: number - 执行后情绪评分
  • feedback_text: string - 文字反馈
  • difficulty_rating: number - 难度评分
  • needs_human_followup: boolean - 是否需要真人跟进

API Specifications

服务层接口扩展 [Source: miniprogram/services/tasks.js]

• getTodayTasks() - 获取今日任务列表
• createTaskFromSuggestion(payload) - 从建议创建任务
• createTask(params) - 创建新任务
• updateTaskStatus(taskId, status) - 更新任务状态
• startTaskTimer(taskId) - 开始任务计时
• completeTask(taskId, reviewData) - 完成任务并提交复盘
• getTaskSummary(params) - 获取任务统计和洞察
• getUiTaskList() - 获取UI任务列表（带状态分组）

云函数接口 [Source: cloudfunctions/taskWorkflow/index.js]

• action: 'create' - 创建任务
• action: 'update' - 更新任务
• action: 'startTimer' - 开始计时
• action: 'complete' - 完成任务
• action: 'getStats' - 获取统计数据
• action: 'setReminder' - 设置提醒

Component Specifications

任务卡片组件 [Source: docs/页面文档/页面-任务.md#模块3]

• 任务标题和描述展示
• 来源徽章和状态标识
• 操作按钮组（开始/暂停/完成/跳过）
• 进度指示器和时间显示
• 截止时间提醒

番茄计时器组件 [Source: docs/页面文档/页面-任务.md#模块4]

• 倒计时显示和控制
• 暂停/继续/结束功能
• 专注模式和环境音
• 计时历史记录
• 完成提醒和复盘引导

复盘表单组件 [Source: docs/功能文档/功能-任务卡执行闭环.md#交互说明]

• 情绪前后对比滑块
• 执行体会文本输入
• 困难和收获记录
• 真人跟进选择
• 附件上传功能

File Locations

新增/修改文件位置 [Source: CLAUDE.md#模块结构图]

• 前端页面：miniprogram/pages/tasks/index.js - 任务Tab主逻辑
• 分包页面：miniprogram/packages/tasks/task-detail/ - 任务详情分包
• 服务层：miniprogram/services/tasks.js - 任务服务（已存在，需大幅扩展）
• 云函数：cloudfunctions/taskWorkflow/index.js - 任务工作流（需要完整实现）
• 组件：miniprogram/components/task-card/, miniprogram/components/tomato-timer/ - 任务组件（新增）
• 数据库：behavior_tasks, task_timer_sessions, task_reviews 集合（新增）

Testing Requirements

测试策略 [Source: CLAUDE.md#测试策略]

• 任务管理功能测试：创建、更新、删除、状态流转
• 番茄计时器测试：计时精度、暂停恢复、完成提醒
• 复盘功能测试：表单提交、数据验证、反馈收集
• 集成测试：与建议系统、社区系统的数据流转
• 性能测试：大量任务情况下的响应时间

Technical Constraints

性能要求 [Source: docs/prd.md#非功能需求]

• 系统响应时间必须在2秒内完成基础操作
• 支持至少1000并发用户
• 数据库查询响应时间小于500ms
• 任务提醒需要及时准确推送

数据一致性要求 [Source: docs/prd.md#技术约束和集成要求]

• 任务状态变更需要实时同步到所有相关页面
• 计时数据需要准确记录，防止数据丢失
• 复盘数据需要与情绪打卡数据关联
• 支持离线模式下的基础任务管理

用户体验要求

• 任务操作流程需要简洁直观
• 番茄计时器需要支持后台运行
• 复盘表单需要易于填写和理解
• 统计数据需要可视化展示

Integration Strategy

与AI建议系统集成 [Source: docs/功能文档/功能-微建议与任务生成.md]

• 支持一键从建议创建任务
• 任务执行结果反馈到建议系统
• 基于执行历史优化建议质量
• 实现建议到任务的完整追踪

与社区系统集成 [Source: docs/功能文档/功能-任务卡执行闭环.md]

• 支持从社区行动卡创建任务
• 任务完成后回写社区反馈
• 实现社区经验分享功能
• 支持社区任务推荐和发现

与情绪打卡系统集成

• 任务完成时可选择关联情绪打卡
• 基于情绪状态推荐合适任务
• 任务执行结果影响情绪分析
• 实现情绪-任务关联分析

Testing

Testing Standards

测试文件位置 [Source: CLAUDE.md#测试策略]

• 单元测试：miniprogram/services/__tests__/tasks.test.js
• 云函数测试：cloudfunctions/taskWorkflow/__tests__/index.test.js
• 组件测试：miniprogram/components/__tests__/task-*.test.js
• 集成测试：__tests__/integration/task-workflow.test.js
• 番茄计时器测试：__tests__/integration/tomato-timer.test.js

测试框架和模式

• 使用Jest进行单元测试
• 模拟计时器功能进行时间测试
• 使用Mock数据覆盖各种任务场景
• 性能测试模拟大量任务数据

具体测试要求

• 任务CRUD操作的完整性测试
• 任务状态流转的正确性测试
• 番茄计时器的准确性测试
• 复盘功能的数据收集测试
• 多来源任务的整合测试
• 提醒和推送功能的及时性测试

Change Log

Date	Version	Description	Author
2025-10-18	1.0	初始版本创建	Winston (Architect)

Dev Agent Record

Agent Model Used

(待开发时填写)

Debug Log References

(待开发时填写)

Completion Notes List

(待开发时填写)

File List

(待开发时填写)

QA Results

(待QA测试时填写)

贡献者

Cai Hongyu

文件历史

最后编辑于 5 个月前查看完整历史

8d893-docs(MindGuard): 新增架构文档和用户故事集