商品介绍

本系统是一套专为牌友对局设计的辅助记分工具，包含微信小程序端（玩家使用）和 Web 管理后台（管理员使用），支持多端数据联动与实时记分。

一、 小程序端（玩家功能）

1. 房间管理

创建房间：支持自定义房间名、选择游戏类型（斗地主、麻将、德州等）、设置人数上限（2-10人）、底分及封顶分。快速加入：输入 6 位数字房间号或直接扫描二维码快速进入对局。最近队友：创建房间时可一键邀请最近对局过的好友，无需重复查找。

2. 核心记分功能

实时同步：多人在同一房间内，一人记分，所有人屏幕实时更新。语音播报：内置智能语音助手，记分时自动播报“张三 +100，李四 -50”，防止记错。对局记录：详细记录每一局的得分详情，支持撤销错误操作。结算单生成：对局结束一键生成精美结算战报，汇总总输赢及局数统计。

3. 个人中心与历史

对局历史：记录所有参与过的房间，点击可查看详细得分轨迹。数据导出：支持将历史对局数据导出为 CSV 文件，方便在 Excel 中进行深度统计。建议反馈：遇到问题可直接在小程序端提交反馈，直达后台管理员。

二、 Web 管理后台（管理功能）

1. 仪表盘（控制台）

实时概览：统计全系统累计房间数、活跃用户数及今日新增对局。系统体检：实时监控服务器环境（PHP 版本、MySQL 状态、磁盘及内存使用率）。数据清理：提供“一键清空测试数据”功能，方便系统上线前快速重置。

2. 业务管理

房间/对局管理：查看所有正在进行的对局，支持强制结束异常房间。用户名册：管理小程序注册用户，查看其历史积分记录。建议反馈处理：实时接收小程序用户的反馈，支持标记“已阅”状态。

3. 系统安全与配置

API 安全配置：支持随机生成 API 授权密钥（Auth Key），确保小程序与服务器通信安全。动态公告：后台修改“顶部滚动公告”后，小程序端房间页实时更新显示。图形验证码：登录页面内置图形验证码，有效防止机器人暴力破解。

三、 快速上手指南

1. 部署与连接

后台部署：将 web 文件夹上传至服务器，访问 install 目录完成数据库初始化。配置通信：在后台“系统配置”中生成 API 密钥，并将其填入小程序根目录的 config.js 中。域名设置：在 config.js 的 baseUrl 填入您的服务器地址。

2. 玩家使用流程

房主：打开小程序 -> 点击“创建房间” -> 设置规则 -> 分享房间号/二维码。成员：输入房间号/扫码 -> 加入房间。记分：点击“记分”图标 -> 输入得分 -> 所有人同步查看。结束：对局完成后，点击“结算”查看总成绩。

3. 后台管理流程

登录：输入用户名、密码及图形验证码。监控：通过仪表盘查看系统是否运行正常。维护：在“管理员列表”中可修改自己的登录用户名或重置密码。