Hei Gin 框架介绍
Hei Gin 是 HEI 快速开发框架的 Go 单体应用版本，基于 Gin + Ent（entgo.io）构建，提供开箱即用的快速开发解决方案。
适用场景
- 后台管理系统（Admin Panel）
- API 服务
- 微服务单体原型
- 中小型业务系统
技术栈
| 类型 | 技术 |
|---|---|
| 核心框架 | Go 1.25+ / Gin 1.12+ |
| ORM | Ent (entgo.io) |
| 数据库 | MySQL 8.0+ |
| 缓存 | Redis 6.0+ (go-redis) |
| 认证 | JWT + SM2 国密 + bcrypt |
| 文件存储 | 本地 / MinIO / AWS S3 |
| 分布式 ID | Snowflake |
| IP 地理定位 | ip2region |
核心特性
- 双端认证体系：B 端（管理端）和 C 端（客户端）独立的 JWT 认证与权限中间件
- SM2 国密加密：登录密码传输使用国密 SM2 加密
- bcrypt 密码哈希：存储密码使用 bcrypt 加盐哈希
- RBAC 权限控制：用户 → 角色 → 权限 + 用户直授权限，双层模型
- 权限自动发现：启动时自动扫描路由注册的权限并缓存到 Redis
- 权限匹配器：支持
*单级和**多级通配符匹配 - 数据权限：支持组织/组维度的行级数据范围控制
- 操作日志：全量操作记录，支持请求参数和返回结果录制，SM3 防篡改签名
- 防重复提交：基于 Redis 的接口防重复调用
- 链路追踪：基于 X-Trace-Id 的全链路追踪
- 图形验证码：B 端/C 端独立的验证码服务
- 统一响应：标准 JSON 响应格式
- 异常处理：全局 Recovery + 业务异常 BusinessException
- 文件存储：本地、MinIO、S3 三种后端可切换
- 雪花 ID：分布式唯一 ID 生成器
- IP 定位：基于 ip2region 的客户端 IP 地理定位