Skip to content

更新日志 ​

v0.1.0 (2026-10-02) ​

初始版本 — 项目骨架 + 认证模块

新增 ​

  • 三层隔离架构:Kernel / App / Modules 层间依赖方向单一
  • 模块四层模式:Domain / Application / Infrastructure / Interfaces
  • 依赖注入:基于 uber-go/fx 的自动依赖解析和生命周期管理
  • 配置管理:Viper 分层配置,支持 YAML + 环境变量覆盖
  • 结构化日志:Zap 结构化输出,请求级 trace_id
  • 多租户支持:基于 X-Tenant-ID 的租户隔离中间件
  • 认证模块:
    • 用户注册(邮箱 + 用户名 + 密码)
    • 用户登录(邮箱 + 密码)
    • JWT 双 Token 机制(Access + Refresh)
    • Token 刷新
    • 密码修改
    • 用户资料查询
  • 统一响应格式:{code, message, data, trace_id}
  • Swagger API 文档:swaggo 注解驱动,自动生成 Swagger UI
  • Docker Compose:PostgreSQL + Redis + 应用一键启动
  • 健康检查:PostgreSQL + Redis 连接状态检测
  • CORS 中间件:跨域请求支持
  • 请求追踪:每个请求自动分配 trace_id

技术栈 ​

组件版本
Go1.23
Gin1.10
GORM1.25
PostgreSQL14+
Redis7+
uber-go/fx1.23
Zap1.27
Viper1.19
golang-jwt5.2

路线图 ​

v0.2.0 — RBAC 权限模型 ​

  • Role / Permission 数据模型
  • 用户角色分配
  • RBAC 中间件
  • 权限校验装饰器

v0.3.0 — 组织管理 + 审计日志 ​

  • 组织 CRUD
  • 用户-组织关系
  • 操作审计日志

v0.4.0 — 配置管理增强 ​

  • 运行时配置 API
  • 全局默认 + 租户覆盖
  • 配置变更历史

v0.5.0 — 用户示例模块 ​

  • 完整用户 CRUD
  • 单元测试 + 集成测试
  • 示例代码

v1.0.0 — 正式发布 ​

  • 完整测试覆盖
  • 安全审计
  • 性能基准测试
  • 生产部署文档