wurenzhi
22308fe042
- 删除无用的文件和错误日志 - 创建统一的 imports 模块集中管理依赖 - 重构组件使用新的 imports 方式 - 修复文档路径大小写问题 - 优化类型定义和接口导出 - 更新依赖版本 - 改进错误处理和API配置 - 统一组件导出方式
6.1 KiB
6.1 KiB
任务中心索引
入口: ../README.md
任务文件
| 文件 | 内容 | 说明 |
|---|---|---|
| completed.md | 项目状态与开发指南 | 包含所有任务完成记录和项目状态 |
| code_mapping.md | 任务与代码实现映射 | 建立任务与代码的映射关系 |
| P3_development.md | P3 待开发任务 | 包含所有待开发的功能任务 |
归档任务
| 文件 | 内容 | 说明 |
|---|---|---|
| P0_critical.md | P0 阻塞性任务 | 核心基础功能（已完成） |
| P1_important.md | P1 高优先级任务 | 重要业务功能（已完成） |
| P2_enhancement.md | P2 优化类任务 | 体验优化和增强功能（已完成） |
📋 任务状态定义
| 状态 | 说明 | 转换条件 |
|---|---|---|
pending |
待领取，未开始 | 初始状态 |
in_progress |
已领取，进行中 | 领取任务时设置 |
completed |
已完成 | 验收标准全部通过 |
blocked |
阻塞中 | 有未解决的依赖或阻塞问题 |
📋 领取规则
领取任务时（必须执行）
- 优先领取任务包: 必须优先领取同一闭环的完整任务链
- 最小粒度: 单次领取不少于 3 个相关任务
- 更新占用状态表: 在具体任务文档顶部添加
| Agent | 占用模块 | 涉及任务 | 主要文件 | 开始时间 | 状态 | |-------|----------|----------|----------|----------|------| | AI-X | 模块名 | 任务ID | 文件路径 | YYYY-MM-DD HH:MM | 🔒 进行中 | - 更新任务状态: 将每个领取的任务详情中的状态改为
in_progress| **状态** | in_progress |
完成任务时（必须执行）
- 更新任务详情: 将任务状态改为
completed| **状态** | completed | - 勾选验收标准: 将所有
- [ ]改为- [x] - 更新占用状态表: 将状态从 "🔒 进行中" 改为 "✅ 已完成" 或删除该行
- 添加完成记录: 在 completed.md 中添加完成记录
⚠️ 重要提醒
- 禁止: 只更新占用表而不更新任务状态
- 禁止: 任务状态与实际进度不符
- 必须: 保持占用表、任务状态、验收标准三者一致
📝 维护规则
任务完成时必须更新
| 更新内容 | 位置 | 责任人 |
|---|---|---|
任务状态改为 completed，勾选验收标准 |
对应 P* 文件 | AI |
| 添加完成记录 | completed.md | AI |
| 释放占用声明 | 本文件下方 | AI |
| 更新项目统计 | README.md | Brain |
变更记录格式
| 日期 | 版本 | 类型 | 变更内容 | 维护人 |
|------|------|------|---------|--------|
| 2026-03-23 | v1.0 | 初始 | 文档创建 | AI-1 |
| 2026-03-23 | v1.1 | 新增 | 添加广告API集成任务包(BE-AD001~005) | AI-1 |
变更类型: 初始 / 新增 / 修改 / 修复
占用声明格式
领取时：
| Agent | 占用模块 | 涉及任务 | 主要文件 | 开始时间 | 状态 |
|-------|----------|----------|----------|----------|------|
| AI-1 | 订单模块 | FE-001 | OrderService.ts | 2026-03-23 10:00 | 🔒 进行中 |
完成时：删除占用行或修改状态为 ✅ 已完成
🔍 代码审查机制
审查流程
-
任务启动前审查
- 检查是否与现有代码重复
- 确认服务层功能边界
- 验证是否需要创建新文件
- 确认服务文件分类位置: 根据功能确定服务文件的分类目录
-
开发过程审查
- 确保代码符合项目规范
- 检查服务层功能单一性
- 验证错误处理和异常管理
- 检查导入路径: 确保服务移动后导入路径正确
-
任务完成后审查
- 验证功能实现完整性
- 检查代码质量和性能
- 确认测试覆盖率
- 更新服务映射: 确保任务与代码实现的映射关系正确
审查重点
| 审查项 | 说明 | 标准 |
|---|---|---|
| 服务层重复 | 检查是否与现有服务功能重叠 | 功能边界清晰，无重复实现 |
| 服务分类 | 检查服务文件是否放在正确的分类目录 | 按功能分类，目录结构清晰 |
| 代码质量 | 检查代码风格和结构 | 符合项目编码规范 |
| 安全性 | 检查安全漏洞和风险 | 无安全隐患 |
| 性能 | 检查性能优化点 | 响应时间合理 |
| 文档 | 检查注释和文档 | 文档完整清晰 |
审查标准
- 服务文件: 功能单一，职责明确，放在正确的分类目录
- 代码风格: 一致的命名和缩进
- 错误处理: 完整的异常捕获和处理
- 测试覆盖: 核心功能有测试用例
- 文档完整性: 服务类有JSDoc注释
🚫 常见问题与预防措施
任务管理问题
| 问题 | 症状 | 预防措施 |
|---|---|---|
| 任务与代码重复 | 功能重叠，维护困难 | 任务启动前审查，检查现有代码 |
| 服务文件位置错误 | 目录结构混乱 | 遵循服务文件分类规范，确认分类位置 |
| 导入路径错误 | 编译失败 | 移动服务后更新所有引用路径 |
| 任务状态不一致 | 进度跟踪困难 | 严格按照领取和完成规则更新状态 |
| 代码质量差 | 可读性差，bug多 | 遵循代码审查机制，确保代码质量 |
服务开发最佳实践
-
服务文件管理
- 按功能分类到对应目录
- 保持服务功能单一，职责明确
- 定期清理冗余服务文件
-
代码质量保证
- 遵循编码规范和命名约定
- 实现完整的错误处理和异常管理
- 为核心功能编写测试用例
-
文档维护
- 服务类添加完整的JSDoc注释
- 及时更新任务与代码的映射关系
- 维护服务文件分类和目录结构
🔗 相关文档
查看各任务文档获取详细状态和进度信息