在大多数产品中，用户体系都是第一个要搭、却最难一次做对的模块：登录方式从单一密码逐步扩展到短信、微信、游客，用户表随之反复改结构；会话管理从无状态 JWT 到需要强制下线、跨端感知，越往后越难补救；不同业务线各写一套认证逻辑，风格与安全底线参差不齐。
本项目把这些重复劳动沉淀为一份**用户中心领域的最佳实践**：以 User（自然人）/ Account（登录凭证）分离为核心模型，将密码、短信、微信、游客等登录方式拆成互不耦合、可独立取舍的模块，并内置有状态会话、RBAC 权限与统一分层架构。使用者的愿景不是"部署一个庞大系统"，而是**按需裁剪、即拷即用**——需要哪些能力就取哪些代码，组合后天然一致，并始终守住密钥不入库、敏感信息不落盘的安全底线。
> 业务边界的边界：本模板专注**用户身份、认证鉴权、凭证管理、角色权限**这些通用能力，不包含用户画像、积分、会员等级、消息推送等业务特定功能，这些可在其之上自行扩展。
**User-Center** 是一套**可裁剪、可组装的通用用户中心后端模板**，专注解决产品早期到成长期最常见的身份认证与权限管理需求。它以 **User（自然人）/ Account（登录凭证）分离**为核心数据模型，将密码登录、短信验证码登录、微信授权登录、游客匿名登录等认证方式拆分为**互不耦合的独立模块**——需要哪种就拷贝哪种，组合后天然一致，无需为"未来可能"提前引入复杂度。
在会话管理上，内置**有状态 Session 机制**，支持强制下线、跨端感知、信任设备白名单等运营刚需；在权限控制上，提供开箱即用的 **RBAC 角色-权限模型**，覆盖用户-角色-权限三级授权体系。整体采用 `ctr → service → db` 三层分层架构，依赖方向清晰，各层职责明确，既保证代码可维护性，又避免过度抽象带来的理解成本。
**适用场景**：需要快速搭建用户体系的 SaaS 产品、多端应用、多业务线统一认证平台。**不适用场景**：需要用户画像、积分会员、消息推送等业务特定功能的场景（这些可在本模板之上自行扩展）。
## 技术栈
| 类别 | 选型 | 版本 |
|------|------|------|
| 语言 | Go | >= 1.22 |
| Web 框架 | Gin | >= v1.9 |
| ORM | GORM | >= v1.25 |
| 数据库 | MySQL | >= 8.0 |
| 缓存 | Redis (go-redis/v9) | >= v9.0 |
| 配置格式 | TOML | >= v1.3 |
| 日志 | Zap | >= v1.27 |
| 鉴权 | AES-GCM + Redis 有状态会话 | 自实现 |
| 密码加密 | bcrypt (x/crypto) | — |
| 短信服务 | 腾讯云 SMS SDK | >= v1.3 |
| API 文档 | Swagger (swaggo) | >= v1.16 |
## 快速开始
### 前置条件
- Go >= 1.22
- Docker & Docker Compose
- Make（可选）
评论