# hyper

**Repository Path**: jybtx/hyper

## Basic Information

- **Project Name**: hyper
- **Description**: 先丢上来放着
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-22
- **Last Updated**: 2025-06-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Golang Gin Framework Backend Management System

## 项目简介
这是一个基于Gin框架开发的后台管理系统，提供完整的用户认证、权限管理、API路由、中间件、数据库操作、队列处理等功能，适用于构建企业级Web应用。

## 主要特性
- 基于Gin框架的高性能Web架构
- 完整的RBAC权限控制系统（管理员、角色、权限）
- 支持JWT认证和单点登录
- 提供AES/RSA加密解密功能
- 支持Kafka/RabbitMQ/Redis消息队列
- 包含数据库迁移和数据填充功能
- 完善的日志记录和错误处理机制
- 支持多语言和国际化

## 目录结构
```
app/                # 核心业务逻辑
├── Consoles        # 控制台命令
├── Http            # Web层处理
│   ├── Controllers # 控制器
│   ├── Middleware  # 中间件
├── Jobs            # 任务调度
├── Models          # 数据模型
├── Providers       # 服务提供者
├── Requests        # 请求验证
routes/             # 路由定义
migrations/         # 数据库迁移文件
seeders/            # 数据填充
supports/           # 核心支持包
├── auth            # 认证相关
├── cryption        # 加密解密
├── database        # 数据库连接
├── helpers         # 辅助函数
├── jwt             # JWT处理
├── logger          # 日志记录
├── password        # 密码处理
├── queue           # 消息队列
├── redis           # Redis操作
├── response        # 响应处理
├── validators      # 参数验证
```

## 安装指南
1. 克隆项目
```bash
git clone <项目地址>
```

2. 安装依赖
```bash
go mod tidy
```

3. 配置环境变量
```bash
cp .env.example .env
```

4. 数据库迁移
```bash
go run main.go migrate
```

5. 数据填充
```bash
go run main.go seed
```

6. 启动服务
```bash
go run main.go
```

## 使用说明
### 用户认证
- 注册: `POST /admin/register`
- 登录: `POST /admin/login`
- 获取当前用户信息: `GET /admin/me`
- 登出: `POST /admin/logout`

### 中间件
- JWT认证: `AuthMiddleware`
- 跨域处理: `CorsMiddleware`
- 请求限流: `LimitMiddleware`
- 日志记录: `LoggerMiddleware`
- 异常恢复: `RecoveryMiddleware`

### API路由
- 管理后台路由: `routes/admin.go`
- 前台API路由: `routes/api.go`
- Web路由: `routes/web.go`

### 数据库操作
使用GORM进行数据库操作，已配置以下模型：
- 管理员: `Models.Admin`
- 菜单: `Models.Menu`
- 权限: `Models.Permission`
- 角色: `Models.Role`
- 用户: `Models.User`

### 消息队列
支持以下消息队列:
- Kafka: `supports/queue/factories/kafka.go`
- RabbitMQ: `supports/queue/factories/rabbitmq.go`
- Redis: `supports/queue/factories/redis.go`

## 贡献指南
1. Fork项目
2. 创建新分支
3. 提交代码
4. 创建Pull Request

## 许可证
本项目采用MIT License，请查看[LICENSE](LICENSE)文件获取详细信息。