|
|
@@ -3,6 +3,7 @@
|
|
|
## 版本信息
|
|
|
| 版本 | 日期 | 描述 | 作者 |
|
|
|
|------|------|------|------|
|
|
|
+| 1.7 | 2025-11-04 | 补充Epic 002所有用户故事的详细任务分解 | John (PM) |
|
|
|
| 1.6 | 2025-11-04 | 补充Epic 001所有用户故事的详细任务分解 | John (PM) |
|
|
|
| 1.5 | 2025-11-04 | 补充Epic 005详细内容,包括主流程图、用户故事和任务分解 | John (PM) |
|
|
|
| 1.4 | 2025-11-04 | 补充Epic 004详细内容,包括主流程图、用户故事和任务分解 | John (PM) |
|
|
|
@@ -542,36 +543,310 @@ graph TD
|
|
|
- **我希望** 能够看到文物在展会中的位置地图
|
|
|
- **以便** 快速找到目标文物进行AR扫描
|
|
|
|
|
|
+#### 故事002-001 详细任务分解
|
|
|
+
|
|
|
+**任务002-001-001: 文物定位地图UI设计**
|
|
|
+- **类型**: UI
|
|
|
+- **描述**: 设计文物定位地图页面,展示展会平面图、文物位置标记、用户当前位置
|
|
|
+- **验收标准**: 地图布局清晰,文物标记醒目,位置信息准确,交互流畅
|
|
|
+
|
|
|
+**任务002-001-002: 展会地图数据模型设计**
|
|
|
+- **类型**: 数据库
|
|
|
+- **描述**: 设计展会地图数据表结构,包含展会平面图、文物位置坐标、展区划分等字段
|
|
|
+- **验收标准**: 数据模型完整,支持多展会地图配置,位置坐标存储准确
|
|
|
+
|
|
|
+**任务002-001-003: 地图数据加载API开发**
|
|
|
+- **类型**: API
|
|
|
+- **描述**: 开发地图数据加载接口,根据用户选择的展会返回对应的地图配置和文物位置
|
|
|
+- **验收标准**: 接口响应快速,数据格式规范,地图配置准确
|
|
|
+
|
|
|
+**任务002-001-004: 用户位置定位功能**
|
|
|
+- **类型**: 前端
|
|
|
+- **描述**: 实现用户位置定位功能,使用小程序定位API获取用户当前位置并在地图上显示
|
|
|
+- **验收标准**: 定位准确,位置更新及时,权限处理完善
|
|
|
+
|
|
|
+**任务002-001-005: 文物位置标记交互**
|
|
|
+- **类型**: UI
|
|
|
+- **描述**: 实现文物位置标记的点击交互,点击标记显示文物信息和AR扫描入口
|
|
|
+- **验收标准**: 交互流畅,信息展示完整,跳转逻辑正确
|
|
|
+
|
|
|
+**任务002-001-006: 地图缩放和拖拽功能**
|
|
|
+- **类型**: 前端
|
|
|
+- **描述**: 实现地图的缩放和拖拽功能,支持用户查看不同区域的地图细节
|
|
|
+- **验收标准**: 缩放流畅,拖拽自然,性能优化良好
|
|
|
+
|
|
|
+**任务002-001-007: 地图导航路径规划**
|
|
|
+- **类型**: 算法
|
|
|
+- **描述**: 实现从用户当前位置到目标文物的路径规划算法,显示最短路径
|
|
|
+- **验收标准**: 路径规划准确,算法效率高,路径显示清晰
|
|
|
+
|
|
|
+**任务002-001-008: 地图样式和主题配置**
|
|
|
+- **类型**: UI
|
|
|
+- **描述**: 设计地图样式和主题,支持不同展会的定制化地图外观
|
|
|
+- **验收标准**: 样式美观,主题统一,定制化配置灵活
|
|
|
+
|
|
|
+**任务002-001-009: 地图功能单元测试**
|
|
|
+- **类型**: 测试
|
|
|
+- **描述**: 编写地图功能的单元测试,覆盖地图加载、位置定位、路径规划等场景
|
|
|
+- **验收标准**: 测试覆盖率>90%,边界情况测试完整
|
|
|
+
|
|
|
+**任务002-001-010: 地图功能集成测试**
|
|
|
+- **类型**: 测试
|
|
|
+- **描述**: 进行地图功能的端到端测试,验证地图显示、定位、导航等整体功能
|
|
|
+- **验收标准**: 功能测试通过,性能满足要求,用户体验良好
|
|
|
+
|
|
|
### 故事002-002: AR相机扫描功能
|
|
|
- **作为** 展会参观者
|
|
|
- **我希望** 能够使用手机相机扫描文物
|
|
|
- **以便** 通过AR技术识别文物并获取徽章
|
|
|
|
|
|
+#### 故事002-002 详细任务分解
|
|
|
+
|
|
|
+**任务002-002-001: AR相机页面UI设计**
|
|
|
+- **类型**: UI
|
|
|
+- **描述**: 设计AR相机扫描页面,包含相机预览、扫描框、操作按钮、提示信息
|
|
|
+- **验收标准**: 界面简洁,操作直观,符合AR扫描使用场景
|
|
|
+
|
|
|
+**任务002-002-002: 微信AR SDK集成**
|
|
|
+- **类型**: 前端
|
|
|
+- **描述**: 集成微信小程序AR SDK,配置文物识别模型和特征数据
|
|
|
+- **验收标准**: SDK集成成功,AR功能可用,识别配置正确
|
|
|
+
|
|
|
+**任务002-002-003: 相机启动和权限处理**
|
|
|
+- **类型**: 前端
|
|
|
+- **描述**: 实现相机启动逻辑,处理相机权限申请和授权状态管理
|
|
|
+- **验收标准**: 权限处理完善,相机启动稳定,错误提示友好
|
|
|
+
|
|
|
+**任务002-002-004: 实时图像分析和识别**
|
|
|
+- **类型**: 算法
|
|
|
+- **描述**: 实现实时图像分析功能,调用AR SDK进行文物识别和特征匹配
|
|
|
+- **验收标准**: 识别准确率高,响应时间快,资源占用合理
|
|
|
+
|
|
|
+**任务002-002-005: 扫描框和引导设计**
|
|
|
+- **类型**: UI
|
|
|
+- **描述**: 设计扫描框和用户引导,帮助用户正确对准文物进行扫描
|
|
|
+- **验收标准**: 引导清晰,扫描框设计合理,用户体验良好
|
|
|
+
|
|
|
+**任务002-002-006: 扫描状态管理**
|
|
|
+- **类型**: 前端
|
|
|
+- **描述**: 实现扫描状态管理,包括扫描中、识别成功、识别失败等状态处理
|
|
|
+- **验收标准**: 状态管理准确,状态转换流畅,用户反馈及时
|
|
|
+
|
|
|
+**任务002-002-007: 扫描历史记录**
|
|
|
+- **类型**: 数据库
|
|
|
+- **描述**: 设计扫描历史记录数据表,记录用户扫描时间、目标文物、识别结果
|
|
|
+- **验收标准**: 数据记录完整,查询效率高,历史数据管理规范
|
|
|
+
|
|
|
+**任务002-002-008: AR扫描性能优化**
|
|
|
+- **类型**: 性能
|
|
|
+- **描述**: 优化AR扫描性能,包括图像处理优化、内存管理、电池消耗控制
|
|
|
+- **验收标准**: 性能指标达标,资源消耗合理,用户体验流畅
|
|
|
+
|
|
|
+**任务002-002-009: AR扫描单元测试**
|
|
|
+- **类型**: 测试
|
|
|
+- **描述**: 编写AR扫描功能的单元测试,覆盖相机操作、图像识别、状态管理等场景
|
|
|
+- **验收标准**: 测试覆盖率>90%,边界情况测试完整
|
|
|
+
|
|
|
+**任务002-002-010: AR扫描集成测试**
|
|
|
+- **类型**: 测试
|
|
|
+- **描述**: 进行AR扫描功能的端到端测试,验证相机启动、文物识别、结果反馈等整体流程
|
|
|
+- **验收标准**: 流程测试通过,性能满足要求,识别准确率达标
|
|
|
+
|
|
|
### 故事002-003: 相机权限管理
|
|
|
- **作为** 展会参观者
|
|
|
- **我希望** 小程序能够请求相机使用权限
|
|
|
- **以便** 顺利进行AR扫描操作
|
|
|
|
|
|
+#### 故事002-003 详细任务分解
|
|
|
+
|
|
|
+**任务002-003-001: 权限申请页面UI设计**
|
|
|
+- **类型**: UI
|
|
|
+- **描述**: 设计相机权限申请页面,说明权限用途、引导用户授权、提供拒绝后的处理方案
|
|
|
+- **验收标准**: 页面设计友好,权限说明清晰,引导操作明确
|
|
|
+
|
|
|
+**任务002-003-002: 权限状态检测功能**
|
|
|
+- **类型**: 前端
|
|
|
+- **描述**: 实现相机权限状态检测功能,检查用户是否已授权相机权限
|
|
|
+- **验收标准**: 状态检测准确,权限查询可靠,错误处理完善
|
|
|
+
|
|
|
+**任务002-003-003: 权限申请流程实现**
|
|
|
+- **类型**: 前端
|
|
|
+- **描述**: 实现相机权限申请流程,包括权限请求、用户授权、授权结果处理
|
|
|
+- **验收标准**: 申请流程完整,用户交互友好,授权结果处理正确
|
|
|
+
|
|
|
+**任务002-003-004: 权限拒绝处理机制**
|
|
|
+- **类型**: 前端
|
|
|
+- **描述**: 实现权限拒绝后的处理机制,包括重新申请引导、功能受限提示、设置页面跳转
|
|
|
+- **验收标准**: 拒绝处理友好,重新申请流程清晰,功能受限提示明确
|
|
|
+
|
|
|
+**任务002-003-005: 权限状态持久化**
|
|
|
+- **类型**: 存储
|
|
|
+- **描述**: 实现权限状态的持久化存储,避免重复申请相同权限
|
|
|
+- **验收标准**: 状态存储可靠,持久化机制完善,状态同步准确
|
|
|
+
|
|
|
+**任务002-003-006: 权限管理单元测试**
|
|
|
+- **类型**: 测试
|
|
|
+- **描述**: 编写权限管理功能的单元测试,覆盖权限申请、状态检测、拒绝处理等场景
|
|
|
+- **验收标准**: 测试覆盖率>90%,权限相关场景测试完整
|
|
|
+
|
|
|
### 故事002-004: 文物识别反馈
|
|
|
- **作为** 展会参观者
|
|
|
- **我希望** 能够看到清晰的识别成功或失败反馈
|
|
|
- **以便** 了解扫描结果和下一步操作
|
|
|
|
|
|
+#### 故事002-004 详细任务分解
|
|
|
+
|
|
|
+**任务002-004-001: 识别成功反馈UI设计**
|
|
|
+- **类型**: UI
|
|
|
+- **描述**: 设计识别成功反馈页面,包含成功动画、文物信息展示、徽章获取提示
|
|
|
+- **验收标准**: 反馈效果生动,信息展示完整,用户成就感强
|
|
|
+
|
|
|
+**任务002-004-002: 识别失败反馈UI设计**
|
|
|
+- **类型**: UI
|
|
|
+- **描述**: 设计识别失败反馈页面,包含失败提示、重试建议、操作引导
|
|
|
+- **验收标准**: 失败提示友好,重试引导清晰,用户不气馁
|
|
|
+
|
|
|
+**任务002-004-003: 识别结果数据模型设计**
|
|
|
+- **类型**: 数据库
|
|
|
+- **描述**: 设计识别结果数据表结构,包含识别时间、目标文物、识别状态、用户反馈等字段
|
|
|
+- **验收标准**: 数据模型完整,识别结果记录准确,查询效率高
|
|
|
+
|
|
|
+**任务002-004-004: 识别反馈API开发**
|
|
|
+- **类型**: API
|
|
|
+- **描述**: 开发识别反馈接口,处理识别结果并返回相应的反馈信息
|
|
|
+- **验收标准**: 接口响应快速,反馈信息准确,错误处理完善
|
|
|
+
|
|
|
+**任务002-004-005: 动画效果实现**
|
|
|
+- **类型**: 前端
|
|
|
+- **描述**: 实现识别成功和失败的动画效果,增强用户交互体验
|
|
|
+- **验收标准**: 动画流畅,效果生动,性能优化良好
|
|
|
+
|
|
|
+**任务002-004-006: 反馈声音设计**
|
|
|
+- **类型**: 音频
|
|
|
+- **描述**: 设计识别成功和失败的声音反馈,增强用户感知
|
|
|
+- **验收标准**: 声音设计合适,音量控制合理,用户体验良好
|
|
|
+
|
|
|
+**任务002-004-007: 反馈单元测试**
|
|
|
+- **类型**: 测试
|
|
|
+- **描述**: 编写识别反馈功能的单元测试,覆盖成功、失败、异常等场景
|
|
|
+- **验收标准**: 测试覆盖率>90%,反馈场景测试完整
|
|
|
+
|
|
|
### 故事002-005: 普通徽章获取
|
|
|
- **作为** 展会参观者
|
|
|
- **我希望** 扫描文物成功后自动获得普通徽章
|
|
|
- **以便** 开始我的徽章收集之旅
|
|
|
|
|
|
+#### 故事002-005 详细任务分解
|
|
|
+
|
|
|
+**任务002-005-001: 徽章数据模型设计**
|
|
|
+- **类型**: 数据库
|
|
|
+- **描述**: 设计徽章数据表结构,包含徽章ID、名称、类型、图标、获取条件、关联文物等字段
|
|
|
+- **验收标准**: 数据模型完整,支持徽章类型和获取条件管理
|
|
|
+
|
|
|
+**任务002-005-002: 用户徽章关系模型设计**
|
|
|
+- **类型**: 数据库
|
|
|
+- **描述**: 设计用户徽章关系数据表,记录用户获得的徽章、获取时间、获取方式
|
|
|
+- **验收标准**: 关系模型设计合理,数据一致性保证,查询效率高
|
|
|
+
|
|
|
+**任务002-005-003: 徽章获取API开发**
|
|
|
+- **类型**: API
|
|
|
+- **描述**: 开发徽章获取接口,在文物识别成功后自动为用户添加对应普通徽章
|
|
|
+- **验收标准**: 获取逻辑正确,数据更新及时,并发处理安全
|
|
|
+
|
|
|
+**任务002-005-004: 徽章获取动画设计**
|
|
|
+- **类型**: UI
|
|
|
+- **描述**: 设计徽章获取动画效果,增强用户获得徽章的成就感和愉悦感
|
|
|
+- **验收标准**: 动画效果生动,用户体验良好,性能优化到位
|
|
|
+
|
|
|
+**任务002-005-005: 徽章重复获取防护**
|
|
|
+- **类型**: 后端
|
|
|
+- **描述**: 实现徽章重复获取防护机制,确保同一文物不会重复获得普通徽章
|
|
|
+- **验收标准**: 防护机制完善,重复获取检测准确,用户体验友好
|
|
|
+
|
|
|
+**任务002-005-006: 徽章获取记录管理**
|
|
|
+- **类型**: 数据库
|
|
|
+- **描述**: 实现徽章获取记录管理,记录每次徽章获取的详细信息和上下文
|
|
|
+- **验收标准**: 记录管理完整,查询功能完善,数据追溯可靠
|
|
|
+
|
|
|
+**任务002-005-007: 徽章获取单元测试**
|
|
|
+- **类型**: 测试
|
|
|
+- **描述**: 编写徽章获取功能的单元测试,覆盖正常获取、重复获取、异常情况等场景
|
|
|
+- **验收标准**: 测试覆盖率>90%,获取逻辑测试完整
|
|
|
+
|
|
|
### 故事002-006: 文物AR特征配置
|
|
|
- **作为** 展会管理员
|
|
|
- **我希望** 能够配置文物的AR识别特征
|
|
|
- **以便** 提高AR扫描的准确性和成功率
|
|
|
|
|
|
+#### 故事002-006 详细任务分解
|
|
|
+
|
|
|
+**任务002-006-001: AR特征配置页面UI设计**
|
|
|
+- **类型**: UI
|
|
|
+- **描述**: 设计AR特征配置页面,支持管理员上传文物图片、配置识别特征、设置识别参数
|
|
|
+- **验收标准**: 配置界面直观,操作流程清晰,特征管理方便
|
|
|
+
|
|
|
+**任务002-006-002: AR特征数据模型设计**
|
|
|
+- **类型**: 数据库
|
|
|
+- **描述**: 设计AR特征数据表结构,包含特征ID、关联文物、特征数据、识别参数、配置时间等字段
|
|
|
+- **验收标准**: 数据模型完整,特征数据存储安全,关联关系正确
|
|
|
+
|
|
|
+**任务002-006-003: 特征上传和处理API开发**
|
|
|
+- **类型**: API
|
|
|
+- **描述**: 开发特征上传和处理接口,支持文物图片上传、特征提取、特征数据存储
|
|
|
+- **验收标准**: 上传功能稳定,特征提取准确,数据处理安全
|
|
|
+
|
|
|
+**任务002-006-004: 特征配置管理API开发**
|
|
|
+- **类型**: API
|
|
|
+- **描述**: 开发特征配置管理接口,支持特征的增删改查操作,配置参数验证
|
|
|
+- **验收标准**: 管理功能完整,参数验证严格,配置更新及时
|
|
|
+
|
|
|
+**任务002-006-005: 特征同步机制实现**
|
|
|
+- **类型**: 后端
|
|
|
+- **描述**: 实现特征数据同步机制,将配置的特征数据同步到小程序端供AR识别使用
|
|
|
+- **验收标准**: 同步机制可靠,数据一致性保证,同步效率高
|
|
|
+
|
|
|
+**任务002-006-006: 特征配置单元测试**
|
|
|
+- **类型**: 测试
|
|
|
+- **描述**: 编写特征配置功能的单元测试,覆盖特征上传、配置管理、数据同步等场景
|
|
|
+- **验收标准**: 测试覆盖率>90%,配置流程测试完整
|
|
|
+
|
|
|
### 故事002-007: 文物地图管理
|
|
|
- **作为** 展会管理员
|
|
|
- **我希望** 能够管理文物在展会中的位置信息
|
|
|
- **以便** 生成准确的定位地图供用户使用
|
|
|
|
|
|
+#### 故事002-007 详细任务分解
|
|
|
+
|
|
|
+**任务002-007-001: 文物位置管理页面UI设计**
|
|
|
+- **类型**: UI
|
|
|
+- **描述**: 设计文物位置管理页面,支持在地图上拖拽设置文物位置、配置位置坐标、管理展区划分
|
|
|
+- **验收标准**: 管理界面直观,位置设置准确,地图交互流畅
|
|
|
+
|
|
|
+**任务002-007-002: 位置数据模型设计**
|
|
|
+- **类型**: 数据库
|
|
|
+- **描述**: 设计位置数据表结构,包含位置ID、关联文物、坐标信息、展区信息、配置时间等字段
|
|
|
+- **验收标准**: 数据模型完整,坐标数据存储准确,关联关系正确
|
|
|
+
|
|
|
+**任务002-007-003: 位置配置API开发**
|
|
|
+- **类型**: API
|
|
|
+- **描述**: 开发位置配置接口,支持文物位置的增删改查操作,坐标数据验证
|
|
|
+- **验收标准**: 配置功能完整,数据验证严格,位置更新及时
|
|
|
+
|
|
|
+**任务002-007-004: 地图配置生成功能**
|
|
|
+- **类型**: 后端
|
|
|
+- **描述**: 实现地图配置生成功能,根据文物位置数据生成小程序使用的地图配置文件
|
|
|
+- **验收标准**: 配置生成准确,文件格式规范,生成效率高
|
|
|
+
|
|
|
+**任务002-007-005: 地图预览功能实现**
|
|
|
+- **类型**: UI
|
|
|
+- **描述**: 实现地图预览功能,管理员可以实时查看配置后的地图效果
|
|
|
+- **验收标准**: 预览效果真实,地图显示准确,预览交互流畅
|
|
|
+
|
|
|
+**任务002-007-006: 位置管理单元测试**
|
|
|
+- **类型**: 测试
|
|
|
+- **描述**: 编写位置管理功能的单元测试,覆盖位置配置、地图生成、预览功能等场景
|
|
|
+- **验收标准**: 测试覆盖率>90%,管理流程测试完整
|
|
|
+
|
|
|
|
|
|
|
|
|
**Epic 003: 徽章收集系统实现**
|
|
|
@@ -932,5 +1207,5 @@ graph TD
|
|
|
---
|
|
|
|
|
|
**文档状态**: 已更新
|
|
|
-**最后更新**: 2025-11-04 (版本1.6)
|
|
|
+**最后更新**: 2025-11-04 (版本1.7)
|
|
|
**下次评审**: 2025-11-11
|