# game_admin **Repository Path**: iakuf/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**: 3 - **Forks**: 1 - **Created**: 2025-07-18 - **Last Updated**: 2025-12-31 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 云游戏管理平台 一个基于 Go-Zero 微服务架构的云游戏管理平台，提供完整的游戏管理、用户管理、支付管理和资源管理等功能。 ## 🏢 开发团队 **开发公司**: 深圳市安通科技有限公司 **官方网站**: [https://www.everylinks.com/](https://www.everylinks.com/) ## 📋 项目概述 云游戏管理平台是一个现代化的游戏管理系统，采用微服务架构设计，支持高并发、高可用的云游戏服务。平台提供了完整的管理后台和前端API接口，支持游戏发布、用户管理、支付处理、资源配置等核心功能。 ### 🎯 核心功能 - **游戏管理**: 游戏信息管理、标签管理、配置管理 - **用户管理**: 用户账户管理、时长管理、使用记录 - **支付管理**: 商品管理、订单处理、支付流程 - **资源管理**: Banner配置、展示位管理 - **应用管理**: 应用信息管理、支付配置 - **文件上传**: 支持本地存储、阿里云OSS、腾讯云COS ### 🏗️ 技术架构 ``` ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ 管理后台API │ │ 前端Web API │ │ 文件上传服务 │ │ (port: 7789) │ │ (port: 7790) │ │ │ └─────────┬───────┘ └─────────┬───────┘ └─────────┬───────┘ │ │ │ └──────────────────────┼──────────────────────┘ │ ┌─────────────┴───────────┐ │ 核心RPC服务 │ │ (port: 7788) │ └─────────────┬───────────┘ │ ┌─────────────┴───────────┐ │ │ ┌─────┴─────┐ ┌─────┴─────┐ │ MySQL │ │ Redis │ │ 数据库 │ │ 缓存 │ └───────────┘ └───────────┘ ``` ## 📁 项目结构 ``` game_admin/ ├── api/ # API服务层 │ ├── admin/ # 管理后台API │ │ ├── desc/ # API描述文件 │ │ ├── internal/ # 内部逻辑 │ │ │ ├── config/ # 配置管理 │ │ │ ├── handler/ # 请求处理器 │ │ │ ├── logic/ # 业务逻辑 │ │ │ ├── middleware/ # 中间件 │ │ │ ├── svc/ # 服务上下文 │ │ │ └── types/ # 类型定义 │ │ └── admin.go # 服务入口 │ └── web/ # 前端Web API │ │ ├── desc/ # API描述文件 │ │ ├── internal/ # 内部逻辑 │ │ │ ├── config/ # 配置管理 │ │ │ ├── handler/ # 请求处理器 │ │ │ ├── logic/ # 业务逻辑 │ │ │ ├── middleware/ # 中间件 │ │ │ ├── svc/ # 服务上下文 │ │ │ └── types/ # 类型定义 │ │ └── web.go # 服务入口 ├── rpc/ # RPC服务层 │ └── core/ # 核心RPC服务 │ ├── desc/ # RPC描述文件 │ ├── internal/ # 内部逻辑 │ │ ├── config/ # 配置管理 │ │ ├── logic/ # 业务逻辑 │ │ ├── server/ # 服务器实现 │ │ └── svc/ # 服务上下文 │ └── core.go # 服务入口 ├── pkg/ # 公共包 │ ├── captcha/ # 验证码服务 │ ├── encrypt/ # 加密服务 │ ├── jwt/ # JWT认证 │ ├── orm/ # ORM封装 │ ├── pb_core/ # Protobuf定义 │ ├── sdk/ # SDK工具包 │ │ ├── at/ # 安通SDK │ │ ├── oauth/ # 授权SDK(微信/google) │ │ ├── pay/ # 支付SDK(微信/支付宝) │ │ ├── sms/ # 短信SDK(腾讯云/阿里云) │ │ └── storage/ # 存储服务(本地/OSS/COS) │ ├── utils/ # 工具函数 │ └── xcode/ # 错误码定义 ├── deploy/ # 部署相关 │ ├── docker/ # Docker配置 │ ├── nginx/ # Nginx配置 │ ├── scripts/ # 部署脚本 │ └── data/ # 数据文件 ├── go.mod # Go模块定义 ├── go.sum # Go依赖校验 └── README.md # 项目说明(本文件) ``` ## 🛠️ 技术栈 ### 后端技术 - **框架**: Go-Zero (微服务框架) - **语言**: Go 1.24+ - **数据库**: MySQL 5.7+ - **缓存**: Redis 6.0+ - **ORM**: GORM v2 - **认证**: JWT - **消息队列**: Asynq ### 存储服务 - **本地存储**: 文件系统存储 - **阿里云OSS**: 对象存储服务 - **腾讯云COS**: 对象存储服务 ### 第三方集成 - **支付**: 支付宝、微信支付 (gopay) - **短信**: 阿里云SMS、腾讯云SMS - **验证码**: base64Captcha ## 🚀 快速开始 ### 环境要求 - Go 1.24+ - MySQL 5.7+ - Redis 6.0+ - Docker & Docker Compose (可选) ### 本地开发 1. **克隆项目** ```bash git clone cd game_admin ``` 2. **安装依赖** ```bash go mod download ``` 3. **配置数据库** ```bash # 修改 配置 api/admin/etc/admin.yaml api/web/etc/web.yaml rpc/core/etc/core.yaml ``` 4. **启动服务** ```bash # 启动核心RPC服务 cd rpc/core && go run core.go # 启动管理后台API cd api/admin && go run admin.go # 启动前端Web API cd api/web && go run web.go ``` 3. **访问服务** - 管理后台API: http://localhost:7789 - 前端Web API: http://localhost:7790 ## 📖 API文档 ### 服务端口 | 服务名称 | 端口 | 说明 | 文档 | |---------|------|------|------| | Core RPC | 7788 | 核心业务RPC服务 | - | | Admin API | 7789 | 管理后台API接口 | `/api/docs` | | Web API | 7790 | 前端Web API接口 | `/api/docs` | ### 主要模块 - [应用管理模块](./docs/app-management.md) - 应用信息和支付配置管理 - [游戏管理模块](./docs/game-management.md) - 游戏信息、标签和配置管理 - [用户管理模块](./docs/user-management.md) - 用户账户和时长管理 - [支付管理模块](./docs/payment-management.md) - 商品和订单管理 - [资源管理模块](./docs/resource-management.md) - Banner和展示位管理 - [支付回调文档](./docs/payment-callback.md) - 支付回调处理 ## 📦 部署指南 详细的部署说明请参考 [部署文档](./docs/部署文档.md)，支持以下部署方式： ### 生产环境部署 - 支持高可用部署 - 支持水平扩容 - 支持滚动升级 - 支持监控告警 ## 🔐 安全特性 - **JWT认证**: 支持访问令牌和刷新令牌 - **权限控制**: 基于角色的访问控制 - **数据加密**: 敏感数据加密存储 - **SQL注入防护**: 使用参数化查询 - **XSS防护**: 输入输出过滤 - **CORS配置**: 跨域请求控制 ## 📊 监控和日志 - **应用监控**: 基于OpenTelemetry的链路追踪 - **性能监控**: 接口响应时间和吞吐量监控 - **错误监控**: 异常和错误日志收集 - **业务监控**: 关键业务指标监控 ## 🤝 开发规范 ### 代码规范 - 遵循Go官方代码规范 - 使用gofmt格式化代码 - 添加必要的注释和文档 - 编写单元测试 ### Git规范 - 使用语义化提交信息 - 功能分支开发 - Code Review流程 - 自动化CI/CD ## 📄 许可证 本项目由安通科技公司开发，版权所有。 ## 📞 联系我们 - **公司**: 深圳市安通科技有限公司 - **官网**: [https://www.everylinks.com/](https://www.everylinks.com/) - **技术支持**: 请通过官网联系我们 --- **注意**: 在生产环境部署前，请务必修改默认的数据库密码、Redis密码和JWT密钥等安全配置。