1. 立项原因与产品问题
该项目旨在解决海龟汤（情境推理游戏）爱好者缺乏优质线上互动平台的问题。传统线下海龟汤游戏受限于地理位置，而现有线上
平台缺乏实时语音、多人互动等核心功能。本项目通过构建在线海龟汤游戏平台，支持多人实时语音聊天、文字问答、房主主持等
功能，为用户提供沉浸式的推理游戏体验。
2. 行业场景与业务背景
本项目属于社交游戏/在线娱乐行业，聚焦于情境推理游戏细分领域。海龟汤作为一种流行的社交推理游戏，通过主持人给出神秘
情境，玩家通过提问（仅能用"是"或"否"回答）逐步推理还原完整故事。该平台集成了房间管理、语音聊天、题库浏览、用户创作
等完整业务功能，服务于Z世代用户的在线社交娱乐需求，融合了即时通讯、UGC内容创作、实时互动游戏等多元业务场景。
1. 具体功能模块
核心模块包括：
- 用户系统模块：用户注册、登录认证、个人中心、用户信息管理
- 房间管理模块：房间创建、房间列表、加入/离开房间、房间状态管理
- 海龟汤题库模块：汤库浏览、搜索筛选、标签分类、内容详情查看
- 创作中心模块：海龟汤创作、标签编辑、作品发布、内容管理
- 实时语音模块：WebRTC语音通话、麦位管理（8个麦位）、麦克风控制、网络质量监控
- 游戏交互模块：主持人盛汤、玩家提问、主持人回答（是/否）、问答记录、汤底公布
- 即时通讯模块：房间聊天、系统消息、用户互动消息
- 评分系统模块：用户评分、内容分级（G/PG/PG13/R）、平均评分展示
2. 主要功能描述
用户功能：
- 支持账号注册登录，用户可设置昵称、头像，管理个人信息
- 个人中心展示用户创作的海龟汤作品、参与记录
房间功能：
- 用户可创建公开或私密房间（支持密码保护），设置房间名称
- 房间列表展示活跃房间，显示玩家人数、房主信息、创建时间
- 房主拥有房间管理权限，可关闭房间、踢出玩家
海龟汤游戏：
- 主持人功能：从题库选择海龟汤、盛汤显示汤面、回答玩家提问（是/否）、公布汤底、重新开始游戏
- 玩家功能：浏览汤面信息、通过文字提问推理、查看问答记录、举手发言
- 题库支持按标签、难度、评分等多维度筛选搜索
实时语音：
- 8个麦位设计，玩家可自由上麦/下麦
- 支持麦克风静音/取消静音切换
- 实时显示玩家说话状态（麦位动画效果）
- 网络质量监控（丢包率、延迟），自动调整音质保证通话稳定
创作功能：
- 用户可创作原创海龟汤，设置标题、汤面、汤底、难度标签
- 支持选择多个标签分类（恐怖、悬疑、搞笑等）
- 创作内容实时更新
本人作为独立开发者，全程负责项目的全栈开发工作：
- 需求分析与产品设计：完成海龟汤游戏平台的整体功能设计、用户流程规划、数据库表结构设计
- 前端开发：使用React框架开发所有页面组件（首页、房间页、题库页、创作中心、用户中心等），实现响应式布局和交互逻辑
- 后端开发：基于Node.js + Express构建RESTful API，实现用户认证、房间管理、海龟汤CRUD、实时通信等核心业务逻辑
- 数据库设计：设计MySQL数据库表结构，引入Redis缓存层优化数据访问性能
- 实时通信功能：开发WebSocket服务实现房间消息推送，集成WebRTC实现多人实时语音通话
- 系统测试与部署：完成前后端联调、功能测试、性能优化，解决跨域、WebSocket连接、并发等关键技术问题
2. 技术栈与架构
技术栈：
- 前端：React 19、Redux Toolkit、React Router 7、Ant Design 5、Tailwind CSS、Axios
- 后端：Node.js、Express、MySQL2、bcryptjs、WebSocket（socket.io）
- 数据库：MySQL（主数据存储）、Redis（缓存层）
- 实时通信：WebRTC（语音通话）、WebSocket（即时消息）
实现亮点：
1. Redis缓存优化：引入Redis缓存热门海龟汤数据和用户会话，显著减少数据库查询压力，提升响应速度
2. WebSocket + WebRTC双通道：WebSocket处理房间状态同步和文字聊天，WebRTC实现低延迟多人语音通话，架构清晰高效
3. 跨服务通信机制：通过Redis发布/订阅系统实现HTTP服务与WebSocket服务的跨进程通信，解决用户离开房间的状态同步问
评论