Skip to content

Latest commit

 

History

History
314 lines (227 loc) · 9.84 KB

File metadata and controls

314 lines (227 loc) · 9.84 KB

GameLink 产品需求文档 (PRD)

版本:v3.0 | 更新日期:2025-12-25


目录

  1. 产品概述
  2. 市场分析
  3. 用户画像
  4. 功能需求
  5. 数据模型
  6. 业务流程
  7. 技术架构
  8. 非功能性需求
  9. 项目进度
  10. 验收标准

1. 产品概述

1.1 产品愿景

GameLink 是一个现代化的游戏陪玩服务平台,致力于为游戏玩家提供高质量的陪玩服务,同时为陪玩师提供稳定的收入来源和职业发展平台。

1.2 产品定位

  • 目标市场:中国游戏陪玩服务市场
  • 核心价值:智能匹配、安全交易、优质服务
  • 差异化优势:系统统一定价、三维度抽成体系、完善的争议处理机制

1.3 核心功能

功能 描述
智能订单分配 用户与陪玩师自动匹配,支持抢单池和客服分配两种模式
多角色系统 三层架构(用户/陪玩师/管理员)+ RBAC 权限控制
实时通信 基于 WebSocket 的即时消息,支持公共聊天室和订单群聊(不支持私聊)
支付结算 完整支付流程,包括订单、退款和收益结算
数据监控 实时订单状态、收益统计和系统指标

1.4 商业模式

收入来源 说明
平台抽成 15-25%(三维度计算)
系统定价 ¥20-60+/小时(按段位)
认证费用 陪玩师入驻认证
推广服务 陪玩师推广曝光

抽成计算三维度

维度 说明 优先级
项目抽成 服务项目级别的基础抽成(默认 20%) 基础
陪玩师个人抽成 特定陪玩师的专属抽成比例 覆盖项目抽成
上月排名抽成 根据上月排名的阶梯式抽成减免(激励机制) 叠加减免

2. 市场分析

2.1 目标用户群体

  • 年龄:18-35岁游戏玩家
  • 主要游戏类型:MOBA、FPS、RPG、卡牌

2.2 差异化策略

  1. 系统统一定价:按段位定价,保证价格透明
  2. 三维度抽成:激励优质陪玩师,排名越高抽成越低
  3. 完善的争议处理:双客服机制,保障双方权益
  4. 不支持私聊:所有沟通在公共聊天室或订单群聊,保障交易安全

3. 用户画像

3.1 用户(User)

特征 说明
年龄 18-35岁
核心需求 找到技术好、态度好的陪玩师;快速匹配;安全支付
使用场景 想上分、想找人一起玩、想学习游戏技巧

3.2 陪玩师(Player)

特征 说明
年龄 18-28岁
游戏段位 钻石及以上
核心需求 稳定的订单来源;合理的收入分成;公平的评价体系

3.3 管理员(Admin)

特征 说明
角色 平台运营人员、客服人员、财务人员
核心需求 高效的订单管理;完善的数据统计;便捷的争议处理

4. 功能需求

4.1 用户端功能

功能模块 功能点 优先级
首页浏览 游戏列表、陪玩师列表、搜索、排行榜 P0-P2
订单功能 创建订单、支付、订单列表、取消、退款、争议 P0-P1
评价功能 提交评价、一键评价、单独评价、修改评价 P0-P2
钱包功能 余额查询、充值、交易记录 P0-P1
聊天功能 公共聊天室、订单群聊 P0-P1

4.2 陪玩师端功能

功能模块 功能点 优先级
入驻认证 入驻申请、实名认证、段位认证 P0
订单管理 待接订单、接单、我的订单、完成订单 P0
收益管理 收益统计、提现申请、提现记录 P0
状态管理 在线状态、接单开关 P0
团队功能 创建团队、团队接单、收入分配 P2(预留)

4.3 管理后台功能

功能模块 功能点 优先级
仪表盘 数据概览、趋势图表、实时监控 P0-P1
用户管理 用户列表、详情、封禁/解封、标签 P0-P1
陪玩师管理 列表、入驻审核、段位审核、实名审核 P0
订单管理 订单列表、详情、退款审核、争议处理 P0
财务管理 提现审核、佣金配置、结算管理 P0-P1
内容管理 游戏管理、段位管理、服务项目、敏感词 P0-P1
系统管理 角色管理、权限管理、菜单管理、操作日志 P0-P1

5. 数据模型

5.1 核心实体

模块 实体 说明
用户 User, Wallet, UserBlock, UserLoginLog 用户基本信息、钱包、拉黑、登录日志
陪玩师 Player, PlayerCertification, PlayerRankRecord, GameRank 陪玩师信息、认证、段位
订单 Order, OrderItem, OrderPlayer, Payment 订单、明细、陪玩师记录、支付
评价 Review, ReviewReply, ReviewAppeal 评价、回复、申诉
争议 OrderDispute, DisputeTemplate, ChatSnapshot 争议、模板、聊天快照

5.2 关键枚举

枚举
OrderStatus pending/confirmed/in_progress/completed/canceled/refunded/disputed
PaymentMethod wechat/alipay/wallet/combined
DisputeResolution refund/partial/reassign/reject/pending

完整数据模型详见 .kiro/steering/04-data-models.md


6. 业务流程

6.1 订单流程

用户下单 → 支付 → 等待接单 → 陪玩师接单 → 服务进行中 → 服务完成 → 用户评价

6.2 订单状态流转

pending → confirmed(支付成功)→ in_progress(接单)→ completed(完成)
    ↓           ↓                    ↓                    ↓
 canceled    canceled            disputed              refunded

6.3 收入结算流程

订单完成 → 收入进入冻结余额 → T+7 售后期 → 无争议 → 解冻到可用余额 → 可提现

7. 技术架构

7.1 技术栈

层级 技术
后端 Go 1.25.5+, Gin, GORM, JWT, WebSocket, Wire
前端 React 18, TypeScript, Vite, Ant Design 6.0
数据库 PostgreSQL 16+, Redis 7+
部署 Docker, Nginx, GitHub Actions
安全 AES-256-CBC + SHA-256, JWT + RBAC

7.2 后端分层

Handler → Service → Repository → Model

8. 非功能性需求

类别 要求
性能 API P95 < 200ms,支持 1000+ 并发
可用性 99.9%,故障恢复 < 30min
安全 传输加密、JWT认证、RBAC权限、审计日志
兼容性 Chrome 90+, Firefox 88+, Safari 14+

9. 项目进度

最后更新:2025-01-05

9.1 当前状态

指标 当前值 目标 状态
后端模块完成度 100% (36/36 模块) 100% ✅ 完成
前端完成度 75% 100% 🟡 进行中
PRD 功能覆盖 (后端) 100% (55/55 功能点) 100% ✅ 完成
PRD 功能覆盖 (含前端) 91% (49/54 功能点) 100% 🟡 进行中
测试覆盖率 ~80% 80%+ ✅ 达标
CI/CD ✅ 完善 - ✅ 完成

9.2 模块状态 (实际完成情况)

分类 完成 进行中 仅Model 总计 完成率
核心模块 19 0 0 19 100%
新增业务模块 4 0 0 4 100%
营销模块 6 0 0 6 100%
辅助模块 7 0 0 7 100%
总计 36 0 0 36 100%

9.3 PRD 功能覆盖 (详细统计)

9.3.1 后端实现覆盖 (100%)

总功能点 后端完成 完成率
用户端 17 17 100% ✅
陪玩师端 14 14 100% ✅
管理后台 24 24 100% ✅
总计 55 55 100%

9.3.2 含前端实现覆盖 (91%)

总功能点 前后端完成 仅后端 完成率
用户端 17 17 0 100% ✅
陪玩师端 14 11 3 79% ⚠️
管理后台 24 21 3 88% ⚠️
总计 55 49 6 91% ⚠️

9.4 待实现前端功能

优先级 功能模块 后端状态 前端缺失 功能点
P1 实名/段位认证(陪玩师端) ✅ 完成 ❌ 缺失 实名认证、段位认证、审核页面
P1 段位管理(管理后台) ✅ 完成 ❌ 缺失 段位CRUD页面
P2 团队功能(陪玩师端) ✅ 完成 ❌ 缺失 创建团队、成员管理、收入分配

10. 验收标准

类别 验收标准
功能 订单/支付/评价/争议流程正常
性能 API P95 < 200ms,1000 并发
安全 JWT认证、RBAC权限、数据加密
测试 单元测试覆盖率 ≥ 80%

附录

A. 相关文档

文档 路径
数据模型 .kiro/steering/04-data-models.md
枚举类型 .kiro/steering/04c-enums-indexes.md
营销模块 .kiro/steering/04a-marketing-models.md
团队模块 .kiro/steering/04b-team-models.md
通知模块 .kiro/steering/04d-notification-models.md
项目管理 .kiro/steering/06-project-management.md
测试规范 .kiro/steering/05-testing-standard.md

B. 术语表

术语 说明
陪玩师 提供游戏陪玩服务的用户
老板 下单购买服务的用户
座位 多人订单中的单个服务位置
段位 游戏中的等级/排名
T+7 订单完成后7天的售后期

文档维护:GameLink 产品团队 最后更新:2025-12-25 | 版本:v3.0