# game_admin **Repository Path**: iluim/game_admin ## Basic Information - **Project Name**: game_admin - **Description**: 云游戏运营后台 - **Primary Language**: Go - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 1 - **Created**: 2025-09-03 - **Last Updated**: 2025-09-05 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 云游戏管理平台 (Cloud Game Management Platform) 一个基于 go-zero 框架的云游戏管理平台，提供完整的后端 API 服务和前端管理界面。 ## 项目概述 该项目是一个专为云游戏平台设计的综合管理系统，采用模块化微服务架构，包含前端管理界面、客户端API、管理后台API和核心RPC服务四个主要模块。系统提供了完整的云游戏运营所需的管理功能，从游戏接入到用户管理，从订单处理到数据统计，支持高并发和可扩展性。 ## 🏗️ 架构设计 ``` ┌─────────────────────────────────────────────────────────────┐ │ 云游戏管理平台 │ ├─────────────────────────────────────────────────────────────┤ │ 🖥️ 前端管理界面 📱 客户端应用 │ │ soybean-admin Client Apps │ │ (Vue3 + Naive UI) (游戏客户端) │ └─────────────────┬─────────────────┬─────────────────────────┘ │ │ ┌─────▼─────┐ ┌─────▼─────┐ │🔧 管理后台API│ │🌐 客户端API │ │api/admin │ │api/web │ │(管理员鉴权) │ │(部分鉴权) │ └─────┬─────┘ └─────┬─────┘ │ │ └─────────┬───────┘ │ ┌───────▼───────┐ │⚡ 核心RPC服务 │ │rpc/core │ │(数据库交互) │ └───────────────┘ ``` ## 📦 模块说明 | 模块 | 技术栈 | 说明 | 详细文档 | |------|--------|------|----------| | **🖥️ soybean-admin** | Vue3 + Naive UI + TypeScript | 前端管理界面，基于 [soybean-admin](https://github.com/soybeanjs/soybean-admin) | [查看文档](./soybean-admin/README.md) | | **🌐 api/web** | Go + go-zero | 客户端API接口，部分开放，用户相关接口需鉴权 | [查看文档](./api/web/README.md) | | **🔧 api/admin** | Go + go-zero | 管理后台API接口，全接口鉴权（管理员权限） | [查看文档](./api/admin/README.md) | | **⚡ rpc/core** | Go + gRPC + GORM | 核心RPC服务，统一数据库交互和业务逻辑 | [查看文档](./rpc/core/README.md) | ## 🚀 快速开始 ### 环境要求 - **Go**: 1.24+ - **Node.js**: 18+ - **pnpm**: 10.5.0+ - **MySQL**: 8.0+ 或 **PostgreSQL**: 13+ - **Redis**: 6.0+ ### 部署顺序 1. **启动核心RPC服务** ```bash cd rpc/core cp etc/core.yaml.example etc/core.yaml # 配置数据库连接 go run core.go ``` 2. **启动API服务** ```bash # 管理后台API cd api/admin cp etc/admin.yaml.example etc/admin.yaml go run admin.go # 客户端API (可选) cd api/web cp etc/web.yaml.example etc/web.yaml go run web.go ``` 3. **启动前端界面** ```bash cd soybean-admin pnpm install pnpm run dev ``` ### 🐳 Docker 一键部署（推荐） #### 方式一：自动化脚本（推荐） ```bash # Windows 用户 deploy/scripts/docker-deploy.bat # Linux/macOS 用户 chmod +x deploy/scripts/docker-deploy.sh deploy/scripts/docker-deploy.sh ``` #### 方式二：手动部署 ```bash # 构建并启动所有服务 docker-compose -f deploy/docker/docker-compose.yaml up -d --build # 查看服务状态 docker-compose -f deploy/docker/docker-compose.yaml ps ``` 📖 **详细部署文档**: [deploy/README.md](deploy/README.md) ## 🎯 核心功能 ### 🎮 游戏管理 - ✅ 游戏基本信息管理（游戏ID、名称、类型） - ✅ 游戏标签系统（多标签支持，AND/OR查询模式） - ✅ 输入设备配置（键盘、手柄配置） - ✅ 游戏资源管理（Logo、封面图片） - ✅ 游戏状态控制（上线/下线） - ✅ 安通平台游戏同步 ### 📱 应用管理 - ✅ 应用信息维护（AppKey、AppSecret） - ✅ 登录方式配置（手机号等） - ✅ 支付方式配置（微信支付） - ✅ 支付配置管理（商户号、证书等） - ✅ 应用状态控制 ### 🎯 Banner管理 - ✅ Banner展示管理 - ✅ 跳转类型配置（游戏、URL） - ✅ 图片资源管理 - ✅ 排序和状态控制 ### 👥 用户管理 - ✅ 用户账户管理（用户ID、昵称、手机号） - ✅ 账户时长管理（剩余时长、充值记录） - ✅ 用户状态控制（启用/禁用） - ✅ 游玩记录查询 - ✅ 强制下机功能 ### 🎲 游戏运行管理 - ✅ 实时游戏会话监控 - ✅ 游戏开始/结束通知处理 - ✅ 虚拟按键配置管理 - ✅ 游戏时长统计 ### 🛒 支付管理 - ✅ 商品管理（时长商品等） - ✅ 订单管理（状态跟踪、支付处理） - ✅ 价格配置 - ✅ 微信支付回调处理 ### 🔥 推荐管理 - ✅ 新游推荐配置 - ✅ 推荐排序管理 - ✅ 发布时间控制 ### 📊 数据统计 - ✅ 用户统计（新增、活跃、总数） - ✅ 支付统计（收入、订单数、新用户付费） - ✅ 时间范围查询 ### 🔧 系统管理 - ✅ 管理员账户管理 - ✅ 系统配置管理 - ✅ 文件上传功能 - ✅ 权限控制 ## 🏗️ 技术架构 ### 后端架构 ``` ┌─────────────────┐ ┌─────────────────┐ │ api/admin │ │ api/web │ │ (管理后台API) │ │ (客户端API) │ │ │ │ │ │ ┌─────────────┐ │ │ ┌─────────────┐ │ │ │ handler │ │ │ │ handler │ │ │ │ logic │ │ │ │ logic │ │ │ │ middleware │ │ │ │ middleware │ │ │ └─────────────┘ │ │ └─────────────┘ │ └─────────┬───────┘ └─────────┬───────┘ │ gRPC │ gRPC └─────────┬────────────┘ │ ┌───────────▼────────────┐ │ rpc/core │ │ (核心RPC服务) │ │ │ │ ┌───────────────────┐ │ │ │ 业务逻辑层 │ │ │ │ 数据访问层 │ │ │ │ 第三方SDK集成 │ │ │ └───────────────────┘ │ └───────────┬───────────┘ │ ┌───────────▼────────────┐ │ MySQL + Redis │ └────────────────────────┘ ``` ### 前端架构 ``` soybean-admin (Vue3 管理界面) ├── src/ │ ├── views/ # 页面组件 │ │ ├── app/ # 应用管理 │ │ ├── game/ # 游戏管理 │ │ ├── user/ # 用户管理 │ │ ├── payment/ # 支付管理 │ │ ├── resource/ # 资源管理 │ │ └── stat/ # 统计分析 │ ├── service/ # API 服务层 │ ├── components/ # 公共组件 │ └── router/ # 路由配置 ``` ## 📚 详细文档 - **[前端管理界面文档](./soybean-admin/README.md)** - Vue3 + Naive UI 管理界面 - **[客户端API文档](./api/web/README.md)** - 客户端接口服务 - **[管理后台API文档](./api/admin/README.md)** - 管理员后台接口 - **[核心RPC服务文档](./rpc/core/README.md)** - 数据库交互和业务逻辑 ## 🔧 开发指南 ### 新增功能开发流程 1. **在 rpc/core 中定义数据模型和业务逻辑** 2. **在 api/admin 或 api/web 中添加API接口** 3. **在 soybean-admin 中实现前端页面** 详细开发指南请参考各模块的README文档。 ### 代码规范 - **Go 后端**: 遵循 go-zero 规范，使用 `xcode.New(ErrorCode,ErrorMessage)` 处理错误 - **Vue 前端**: 使用 TypeScript + Composition API，遵循 soybean-admin 规范 ## 🚀 部署指南 ### Docker Compose 部署 ```yaml # docker-compose.yml version: '3.8' services: mysql: image: mysql:8.0 # ... 配置 redis: image: redis:7 # ... 配置 core-rpc: build: ./rpc/core # ... 配置 admin-api: build: ./api/admin # ... 配置 web-api: build: ./api/web # ... 配置 soybean-admin: build: ./soybean-admin # ... 配置 ``` ### 生产环境部署 详细部署文档请参考：[部署文档](./docs/部署文档.md) ## 🛡️ 安全特性 - **JWT 认证**: 基于Token的身份验证 - **权限控制**: 接口级权限验证 - **数据加密**: 敏感数据加密存储 - **SQL 注入防护**: 参数化查询 - **XSS 防护**: 输入验证和输出转义 ## 📈 性能优化 - **数据库**: 索引优化，连接池管理 - **缓存**: Redis 缓存热点数据 - **并发**: goroutine 并发处理 - **前端**: 代码分割，懒加载 ## 🤝 贡献指南 1. Fork 项目到您的GitHub 2. 创建功能分支 (`git checkout -b feature/AmazingFeature`) 3. 提交您的修改 (`git commit -m 'Add some AmazingFeature'`) 4. 推送到分支 (`git push origin feature/AmazingFeature`) 5. 创建 Pull Request ## 📄 许可证 MIT License - 详见 [LICENSE](LICENSE) 文件 ## 📞 技术支持 - **项目Issues**: [GitHub Issues](https://github.com/your-repo/game-admin/issues) - **技术讨论**: 欢迎在Issue中讨论技术问题 - **文档反馈**: 如发现文档问题，请及时反馈 --- **云游戏管理平台** - 专业的云游戏运营管理解决方案 🎮 > 基于 [soybean-admin](https://github.com/soybeanjs/soybean-admin) 构建的现代化管理界面