Browse Source

📝 docs(prd): update Epic 004 with detailed content

- add version 1.4 record in version history
- add complete Epic 004 main flow chart using mermaid
- add 4 user stories for social interaction features
- add 22 detailed task breakdowns for implementation
- update social interaction section in development plan
- update document status to version 1.4
yourname 1 month ago
parent
commit
09f61b32b8
1 changed files with 193 additions and 3 deletions
  1. 193 3
      docs/prd.md

+ 193 - 3
docs/prd.md

@@ -3,6 +3,7 @@
 ## 版本信息
 | 版本 | 日期 | 描述 | 作者 |
 |------|------|------|------|
+| 1.4 | 2025-11-04 | 补充Epic 004详细内容,包括主流程图、用户故事和任务分解 | John (PM) |
 | 1.3 | 2025-11-04 | 补充Epic 003详细内容,包括主流程图、用户故事和任务分解 | John (PM) |
 | 1.2 | 2025-11-04 | 补充Epic 002详细内容,包括主流程图、用户故事和任务分解 | John (PM) |
 | 1.1 | 2025-11-04 | 补充Epic 001详细内容,包括主流程图、用户故事和任务分解 | John (PM) |
@@ -762,6 +763,194 @@ graph TD
 **Epic目标**: 实现徽章集市、现场对对碰、社交分享等社交互动功能
 **成功标准**: 徽章交换成功率>80%,社交分享率>30%,用户互动满意度>4/5
 
+#### Epic 004 主流程图
+```mermaid
+graph TD
+    A[用户进入社交互动] --> B{互动方式选择}
+    B -->|徽章集市| C[进入徽章集市]
+    C --> D[浏览可交换徽章]
+    D --> E[选择交换对象]
+    E --> F[发起交换请求]
+    F --> G[对方确认交换]
+    G --> H[交换成功]
+    H --> I[更新双方徽章]
+
+    B -->|现场对对碰| J[启动对对碰]
+    J --> K[搜索附近用户]
+    K --> L[选择交换对象]
+    L --> M[发起交换请求]
+    M --> N[对方确认交换]
+    N --> O[交换成功]
+    O --> P[更新双方徽章]
+
+    B -->|社交分享| Q[选择分享徽章]
+    Q --> R[选择分享平台]
+    R --> S[生成分享卡片]
+    S --> T[用户确认分享]
+    T --> U[分享成功]
+    U --> V[获得分享奖励徽章]
+    V --> W[更新用户徽章]
+
+    I --> X[记录交换历史]
+    P --> X
+    W --> X
+    X --> Y[更新社交统计]
+
+    Z[管理员配置社交规则] --> AA[设置交换规则]
+    AA --> AB[配置分享奖励]
+    AB --> AC[设置互动限制]
+    AC --> AD[同步到小程序]
+```
+
+#### Epic 004 用户故事
+
+**故事004-001: 徽章集市交换功能**
+- **作为** 展会参观者
+- **我希望** 能够在徽章集市中与其他玩家交换徽章
+- **以便** 获得我缺少的徽章,完成收集目标
+
+**故事004-002: 现场对对碰交换功能**
+- **作为** 展会参观者
+- **我希望** 能够与现场其他用户进行近距离徽章交换
+- **以便** 快速找到交换伙伴,增强现场互动体验
+
+**故事004-003: 社交平台分享功能**
+- **作为** 展会参观者
+- **我希望** 能够将稀有徽章分享到社交平台
+- **以便** 展示我的成就并获得额外奖励徽章
+
+**故事004-004: 交换记录查看**
+- **作为** 展会参观者
+- **我希望** 能够查看我的徽章交换历史记录
+- **以便** 了解我的社交互动情况和交换统计
+
+**故事004-005: 社交互动统计**
+- **作为** 展会参观者
+- **我希望** 能够看到我的社交互动统计数据
+- **以便** 了解我的社交活跃度和影响力
+
+**故事004-006: 社交规则配置**
+- **作为** 展会管理员
+- **我希望** 能够配置徽章交换的规则和限制
+- **以便** 管理社交互动的公平性和秩序
+
+**故事004-007: 分享奖励配置**
+- **作为** 展会管理员
+- **我希望** 能够配置社交分享的奖励规则
+- **以便** 激励用户分享和传播展会内容
+
+#### Epic 004 详细任务分解
+
+**任务004-001: 徽章交换数据模型设计**
+- **种类**: 后端API
+- **所在端**: 后端
+- **描述**: 设计徽章交换数据模型,包括交换请求、交换记录、交换状态等
+
+**任务004-002: 徽章集市API开发**
+- **种类**: 后端API
+- **所在端**: 后端
+- **描述**: 实现徽章集市功能接口,包括可交换徽章查询、交换请求发起、交换确认等
+
+**任务004-003: 现场对对碰API开发**
+- **种类**: 后端API
+- **所在端**: 后端
+- **描述**: 实现现场对对碰功能接口,包括附近用户搜索、蓝牙/WiFi直连交换等
+
+**任务004-004: 社交分享API开发**
+- **种类**: 后端API
+- **所在端**: 后端
+- **描述**: 实现社交分享功能接口,包括分享卡片生成、分享记录跟踪、奖励发放等
+
+**任务004-005: 小程序徽章集市页面开发**
+- **种类**: UI开发
+- **所在端**: 小程序
+- **描述**: 创建徽章集市页面,支持徽章浏览、交换请求、交换确认等操作
+
+**任务004-006: 小程序对对碰页面开发**
+- **种类**: UI开发
+- **所在端**: 小程序
+- **描述**: 创建现场对对碰页面,支持附近用户搜索、交换发起、实时通信等
+
+**任务004-007: 小程序社交分享页面开发**
+- **种类**: UI开发
+- **所在端**: 小程序
+- **描述**: 创建社交分享页面,支持徽章选择、平台选择、分享预览等
+
+**任务004-008: 交换记录页面开发**
+- **种类**: UI开发
+- **所在端**: 小程序
+- **描述**: 创建交换记录页面,展示用户的交换历史、统计信息等
+
+**任务004-009: 社交统计页面开发**
+- **种类**: UI开发
+- **所在端**: 小程序
+- **描述**: 创建社交统计页面,展示用户的社交互动数据和排名信息
+
+**任务004-010: 微信分享SDK集成**
+- **种类**: 前端集成
+- **所在端**: 小程序
+- **描述**: 集成微信分享SDK,支持分享到微信好友、朋友圈等平台
+
+**任务004-011: 蓝牙/WiFi直连功能实现**
+- **种类**: 前端逻辑
+- **所在端**: 小程序
+- **描述**: 实现蓝牙或WiFi直连功能,支持现场用户间的直接通信和交换
+
+**任务004-012: 附近用户发现算法**
+- **种类**: 后端API
+- **所在端**: 后端
+- **描述**: 实现附近用户发现算法,基于位置信息或网络信号识别附近用户
+
+**任务004-013: 交换安全机制实现**
+- **种类**: 后端API
+- **所在端**: 后端
+- **描述**: 实现徽章交换的安全机制,防止作弊和重复交换
+
+**任务004-014: 分享奖励逻辑实现**
+- **种类**: 后端API
+- **所在端**: 后端
+- **描述**: 实现社交分享奖励逻辑,包括奖励徽章发放、次数限制等
+
+**任务004-015: 社交规则管理后台开发**
+- **种类**: UI开发
+- **所在端**: 管理后台
+- **描述**: 开发社交规则管理界面,支持交换规则配置、限制设置等
+
+**任务004-016: 分享奖励管理后台开发**
+- **种类**: UI开发
+- **所在端**: 管理后台
+- **描述**: 开发分享奖励管理界面,支持奖励规则配置、徽章设置等
+
+**任务004-017: 社交数据统计后台开发**
+- **种类**: UI开发
+- **所在端**: 管理后台
+- **描述**: 开发社交数据统计界面,展示用户互动数据、分享统计等
+
+**任务004-018: 实时通信机制优化**
+- **种类**: 后端优化
+- **所在端**: 后端
+- **描述**: 优化实时通信机制,提高交换请求的响应速度和稳定性
+
+**任务004-019: 社交功能单元测试编写**
+- **种类**: 测试
+- **所在端**: 后端/小程序
+- **描述**: 为社交互动功能编写单元测试,确保交换逻辑和分享功能的正确性
+
+**任务004-020: 集成测试执行**
+- **种类**: 测试
+- **所在端**: 后端/小程序
+- **描述**: 执行社交互动端到端集成测试,验证徽章交换和分享的完整流程
+
+**任务004-021: 性能压力测试**
+- **种类**: 测试
+- **所在端**: 后端
+- **描述**: 进行高并发社交互动压力测试,确保系统在大量用户同时交换时的稳定性
+
+**任务004-022: 用户体验测试执行**
+- **种类**: 测试
+- **所在端**: 小程序
+- **描述**: 邀请真实用户测试社交互动功能,收集反馈并优化体验
+
 **Epic 005: 奖励兑换和后台管理**
 **Epic目标**: 构建奖励兑换系统和展会内容管理后台
 **成功标准**: 实体奖励兑换流程顺畅,后台配置操作简便,数据统计准确
@@ -788,9 +977,10 @@ graph TD
 
 **Epic 004 - 社交互动**:
 - 徽章集市交换功能
-- 现场对对碰技术实现
+- 现场对对碰技术实现(蓝牙/WiFi直连)
 - 社交平台分享集成
-- 互动记录和统计
+- 交换记录和统计管理
+- 社交规则和奖励配置
 
 **Epic 005 - 奖励和管理**:
 - 实体奖励兑换流程
@@ -875,5 +1065,5 @@ graph TD
 ---
 
 **文档状态**: 已更新
-**最后更新**: 2025-11-04 (版本1.3)
+**最后更新**: 2025-11-04 (版本1.4)
 **下次评审**: 2025-11-11