Skip to content

MengStack v2.0 ​

MengStack 是面向多租户 SaaS 应用的 Go 通用底座。

概述 ​

MengStack 把账号、权限、租户、组织、审计、配置、消息、插件等所有 Web 应用共享的能力一次性做好,让你只专注于业务逻辑。

核心特性 ​

🏢 多租户内建 ​

支持三种隔离策略,通过配置切换:

  • 共享表 + tenant_id(默认,适合大多数场景)
  • Schema 隔离(高安全需求)
  • 独立数据库(企业级隔离)
go
// 请求头传入租户 ID
// X-Tenant-ID: tenant-abc-123

// 框架自动解析并注入上下文
tenantID := tenant.FromContext(c.Request.Context())

🔌 插件架构 ​

通过扩展点和 .mengplugin 包格式扩展功能,不改动内核代码:

go
func (p *MyPlugin) Permissions() plugin.Permissions {
    return plugin.Permissions{
        Database: []string{"my_table"},
        Events:   []string{"order.created"},
        Routes:   []string{"/api/v1/orders/*"},
    }
}

📦 四层分层 ​

domain → application → infrastructure → interfaces
层职责禁止
Domain实体、领域接口import gorm/http/redis
Application用例编排、事务直接操作数据库
Infrastructure数据库/缓存实现含业务逻辑
Interfaces参数校验、调 service写业务逻辑

🔐 安全默认 ​

  • JWT 双 Token(Access + Refresh)
  • RBAC 权限管理
  • bcrypt 密码哈希
  • 参数化查询(防 SQL 注入)
  • XSS 过滤
  • 三级限流

🌍 国际化 ​

i18n 框架内置,支持多语言切换。

快速开始 ​

1. 环境准备 ​

  • Go 1.26+
  • PostgreSQL 16+
  • Redis 7+

2. 获取发行版 ​

bash
# 克隆纯内核基座(9 大核心模块 + 示例插件,不含业务插件,可独立编译启动)
git clone https://mengstackgit.softunis.com/softunis/mengstack-kernel-dist.git
cd mengstack-kernel-dist

发行版为公开仓库,无需认证即可克隆

3. 配置环境 ​

bash
cp .env.example .env
# 编辑 .env,填入数据库密码和 JWT 密钥

4. 启动服务 ​

bash
# 安装依赖
go mod download

# 运行迁移 + 启动
make run

5. 访问服务 ​

端点地址
APIhttp://localhost:2222
健康检查http://localhost:2222/health
Swagger 文档http://localhost:2222/swagger/index.html

项目结构 ​

.
├── cmd/
│   ├── server/          # 主服务入口
│   ├── migrate/         # 数据库迁移工具
│   └── smrm/            # CLI 脚手架工具
├── internal/
│   ├── app/             # 应用基础设施
│   ├── config/          # 配置加载
│   ├── kernel/          # ★ 内核(开源部分)
│   └── modules/         # 业务模块
│       ├── auth/        # 认证
│       ├── rbac/        # 角色权限
│       ├── org/         # 组织架构
│       ├── audit/       # 审计日志
│       └── ...
├── migrations/          # 数据库迁移脚本
└── configs/             # 配置模板

核心模块 ​

认证模块 (auth) ​

POST /api/v1/auth/register  → 注册
POST /api/v1/auth/login     → 登录
POST /api/v1/auth/refresh   → 刷新令牌
POST /api/v1/auth/logout    → 登出
GET  /api/v1/auth/me        → 获取当前用户

RBAC 模块 ​

基于角色的权限控制,支持:

  • 角色管理
  • 权限分配
  • 用户-角色绑定

审计模块 ​

记录所有操作日志,支持:

  • 操作审计
  • 日志查询
  • 日志导出

常用命令 ​

bash
make build        # 编译
make run          # 启动开发服务
make test         # 运行测试
make test-cover   # 测试覆盖率
make lint         # 代码检查
make swagger      # 重新生成 Swagger 文档
make migrate      # 运行数据库迁移

技术栈 ​

组件选型说明
语言Go 1.26+编译为单文件
Web 框架Gin高性能 HTTP 路由
ORMGORM v2PostgreSQL 数据访问
数据库PostgreSQL 16多租户原生支持
缓存Redis 7会话/缓存/队列
依赖注入Uber fx编译期装配
配置Viper分层配置
日志Zap结构化日志
认证JWT双 Token
迁移golang-migrate版本化变更
API 文档Swag自动生成 Swagger

下一步 ​

相关资源 ​

Released under the Apache 2.0 License.