---
title: 更新日志 | 版本迭代记录与路线图 - MengStack开源框架
---

# 更新日志

## 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

### 技术栈

| 组件 | 版本 |
|------|------|
| Go | 1.23 |
| Gin | 1.10 |
| GORM | 1.25 |
| PostgreSQL | 14+ |
| Redis | 7+ |
| uber-go/fx | 1.23 |
| Zap | 1.27 |
| Viper | 1.19 |
| golang-jwt | 5.2 |

---

## 路线图

### v0.2.0 — RBAC 权限模型

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

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

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

### v0.4.0 — 配置管理增强

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

### v0.5.0 — 用户示例模块

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

### v1.0.0 — 正式发布

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