Game Manager - 游戏管理系统

Game Manager 是一个基于 Spring Boot 3.5.9 + JDK 17/21 构建的现代化游戏管理系统。本系统采用模块化设计，支持多游戏平台接入、玩家管理、交易记录、数据统计等完整的游戏管理功能。

• 🎮 多平台游戏接入：支持接入多个游戏供应商（如 JLS 平台），灵活的适配器设计
• 👥 完整的玩家管理：玩家注册、登录、账户余额管理、等级体系
• 💰 交易记录管理：下注、结算、退款、调整等完整交易流程
• 📊 数据分析统计：租户数据统计、游戏数据分析、收入报表
• 🔐 企业级安全：支持 Spring Security、多租户隔离、签名验证
• 🔄 微服务架构：网关路由、服务治理、分布式事务
• ☁️ 云原生支持：Docker 容器化、Kubernetes 编排就绪

game-manager/
├── gm-dependencies/              # Maven 依赖版本管理
├── gm-framework/                 # 框架核心包
│   ├── yudao-common/             # 通用工具包
│   ├── yudao-spring-boot-starter-* # 各种 Spring Boot Starter
│   └── ...
├── gm-server/                    # 应用服务端 (主服务)
├── gm-gateway/                   # API 网关
├── gm-module-system/             # 系统管理模块（用户、租户、权限等）
├── gm-module-infra/              # 基础设施模块（文件、定时任务等）
├── gm-module-member/             # 玩家中心模块
├── gm-module-game/               # 游戏核心模块 ⭐
│   ├── src/main/java/.../adapter/game/
│   │   ├── base/                 # 游戏适配器基类
│   │   ├── jls/                  # JLS 平台适配器实现
│   │   └── ...
│   ├── src/main/java/.../model/  # 数据模型
│   └── ...
├── script/                       # 部署脚本、Docker 配置、数据库脚本
│   ├── docker/                   # Docker 配置
│   ├── shell/                    # Shell 脚本
│   └── jenkins/                  # CI/CD 配置
├── sql/                          # 数据库脚本
│   ├── mysql/                    # MySQL 脚本
│   ├── postgresql/               # PostgreSQL 脚本
│   └── ...（其他数据库）
└── pom.xml                       # 项目主 POM 文件

• JDK 17 或更高版本（推荐 JDK 17/21）
• Maven 3.8+
• MySQL 5.7 或更高版本
• Redis 5.0 或更高版本
• Docker（可选，用于部署）

在 gm-server/src/main/resources/application.yml 或 application-dev.yml 中配置：

spring:
  application:
    name: gm-server
  datasource:
    url: jdbc:mysql://localhost:3306/game_manager?useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password: 123456
  redis:
    host: localhost
    port: 6379
    password: 
  
server:
  port: 9095

# 1. 克隆项目
git clone <repository-url>
cd game-manager

# 2. 使用 Maven 编译
mvn clean package -DskipTests

# 3. 编译指定模块
mvn clean package -f gm-server/pom.xml

# 4. 跳过测试（加快编译）
mvn clean install -DskipTests

cd gm-server
mvn spring-boot:run

cd gm-server/target
java -jar gm-server-*.jar

# 构建镜像
docker build -t game-manager:latest -f gm-server/Dockerfile .

# 运行容器
docker run -d \
  --name game-manager \
  -p 9095:9095 \
  -e SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/game_manager \
  -e SPRING_REDIS_HOST=redis \
  game-manager:latest

# 1. 创建数据库
mysql -u root -p < sql/mysql/init.sql

# 2. 导入表结构
mysql -u root -p game_manager < sql/mysql/tables.sql

# 3. 导入初始数据
mysql -u root -p game_manager < sql/mysql/data.sql

应用启动成功后，访问以下地址：

• 应用健康检查：http://localhost:9095/actuator/health
• API 文档：http://localhost:9095/swagger-ui.html 或 http://localhost:9095/doc.html
• 应用主页：http://localhost:9095/

系统采用适配器模式设计，支持多游戏平台无缝接入。

PlatformRequest (请求)
       ↓
BaseAdapter (基类)
       ↓
JLsAdapter / XXXAdapter (具体实现)
       ↓
PlatformResponse (响应)

• BaseAdapter：游戏适配器基类，定义接口规范
• JLsAdapter：JLS 平台适配器实现示例
• PlatformRequest：平台请求数据结构
• PlatformResponse：平台响应数据结构
• SportContext：游戏上下文信息

• 玩家账户创建与管理
• 账户余额实时更新
• 交易历史记录
• 玩家等级与等级体系
• 多租户隔离

• 下注管理：记录所有玩家下注
• 结算处理：自动结算游戏结果
• 退款流程：支持异常退款
• 账户调整：手动调整玩家账户
• 交易审计：完整的交易日志

• 租户每日数据统计
• 游戏收入报表
• 玩家行为分析
• 实时监控面板

• 签名验证：所有请求需要签名验证（SignUtils）
• 多租户隔离：不同租户数据完全隔离
• 权限控制：基于 Spring Security 的权限管理
• 数据加密：敏感数据加密存储

POST /api/game/balance
Content-Type: application/json

{
  "action": "balance",
  "username": "user123",
  "currency": "CNY",
  "sign": "xxxxx"
}

POST /api/game/bet
Content-Type: application/json

{
  "action": "bet",
  "username": "user123",
  "betId": "bet_001",
  "betAmount": 100,
  "roundId": "round_001",
  "gameCode": "game001",
  "sign": "xxxxx"
}

POST /api/game/settle
Content-Type: application/json

{
  "action": "bet_result",
  "betId": "bet_001",
  "resultType": "WIN",
  "winAmount": 200,
  "sign": "xxxxx"
}

更多 API 详情请查看 Swagger 文档：http://localhost:9095/swagger-ui.html

A： 检查以下几点：

• 确认 MySQL 服务已启动
• 检查 application.yml 中的数据库配置（URL、用户名、密码）
• 确保数据库已创建，表已初始化
• 检查防火墙是否放行 3306 端口

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/game_manager?useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true

A：

• 确认 Redis 服务已启动（redis-server）
• 检查 Redis 配置：

spring:
  redis:
    host: localhost
    port: 6379
    timeout: 10000

A： 确保：

• 使用正确的 VendorKey 进行签名
• 签名算法与平台方协议一致
• 检查 SignUtils.verifySign() 的实现

A： 检查：

• 请求头中是否包含租户标识（通常在 Token 中）
• 配置是否启用了多租户功能
• 数据库查询是否添加了租户条件

A： 参考下面的扩展指南。

假设要添加 "XYZ" 游戏平台：

@Service
@Slf4j
public class XyzAdapter extends BaseAdapter {
    
    @Override
    public PlatformResponse doForward(PlatformRequest param, VendorTenantDO vendorTenantDO) {
        // 实现平台特定的业务逻辑
        return PlatformResponse.success();
    }
    
    @Override
    protected SportContext buildContext(PlatformRequest param, VendorTenantDO vendorTenantDO) {
        SportContext ctx = new SportContext();
        // 构建上下文
        return ctx;
    }
    
    // 实现其他抽象方法...
}

在 PlatformCodeEnum 中添加：

public enum PlatformCodeEnum {
    JLS("jls", "JLS Platform"),
    XYZ("xyz", "XYZ Platform"),
    // ...
}

在数据库 game_vendor 表中添加平台记录。

根据 XYZ 平台的 API 文档，实现具体的请求/响应处理。

1. 在 ActionEnum 中添加新的操作类型
2. 在对应的 Adapter 中实现处理逻辑
3. 更新数据库表结构（if needed）

# 运行单元测试
mvn test

# 运行特定测试类
mvn test -Dtest=JLsAdapterTest

# 跳过测试打包
mvn clean package -DskipTests

FROM openjdk:17-jdk-slim
WORKDIR /app
COPY gm-server/target/gm-server-*.jar app.jar
EXPOSE 9095
ENTRYPOINT ["java", "-jar", "app.jar"]

docker build -t game-manager:latest .

docker run -d \
  --name game-manager \
  -p 9095:9095 \
  --link mysql:mysql \
  --link redis:redis \
  -e SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/game_manager \
  -e SPRING_REDIS_HOST=redis \
  game-manager:latest

version: '3.8'

services:
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_DATABASE: game_manager
      MYSQL_ROOT_PASSWORD: 123456
    ports:
      - "3306:3306"
    volumes:
      - mysql_data:/var/lib/mysql

  redis:
    image: redis:7.0
    ports:
      - "6379:6379"

  game-manager:
    build: .
    ports:
      - "9095:9095"
    environment:
      SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/game_manager
      SPRING_REDIS_HOST: redis
    depends_on:
      - mysql
      - redis

volumes:
  mysql_data:

启动：

docker-compose up -d

（待补充 K8s 部署配置）

• 📘 Spring Boot 官方文档
• 📗 MyBatis Plus 文档
• 📙 芋道项目文档
• 📕 Swagger API 文档

欢迎提交 Issue 和 Pull Request！

1. Fork 本项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

• 遵循《阿里巴巴 Java 开发手册》
• 添加适当的代码注释
• 编写单元测试
• 提交前运行 mvn clean package

本项目采用 MIT License 开源协议，个人与企业可 100% 免费使用。

详见 LICENSE 文件。

感谢以下项目的灵感与参考：

• RuoYi-Vue-Pro
• Yudao-Cloud
• Spring Boot Labs

如有任何问题或建议，欢迎联系：

• 📧 Email：support@example.com
• 💬 Issues：提交 GitHub Issues
• 📱 微信：（预留）

• 支持更多游戏平台
• 增强实时监控面板
• 完善支付系统集成
• 大屏数据可视化
• 移动端 App（UniApp）
• AI 风控系统
• 国际化支持（i18n）

最后更新：2026-03-30

项目版本：2026.01-SNAPSHOT

⭐️ 如果这个项目对你有帮助，请给个 Star，谢谢！