企业级 SaaS 极速后台管理系统 · 正式开源 · 三端独立仓库 · Apache-2.0 / MIT
从尝鲜招募到正式开源,Madong-Saas 5.x 现已正式发布。
此前 5.x 以"尝鲜招募"的形式在小范围内测,经过持续的架构打磨与三端拆分重构,今天我们把完整源码正式放到 GitHub 上,无需申请、无需授权,克隆即可用。
Apache-2.0Madong-SaaS 5.x 是一套基于 Webman 2.x + Vue 3 的企业级 SaaS 后台管理系统,内置完整的多租户架构、插件系统、Web 终端、代码生成器等高级能力,提供从零到一的商业项目快速启动方案。
5.x 最大的结构变化:从全栈单仓库拆分为三端独立仓库,各端独立迭代、独立部署、独立版本节奏。
| 端 | 说明 | 仓库地址 | 协议 |
|---|---|---|---|
| 核心服务端 | 多租户 SaaS 服务端,基于 Webman 常驻内存框架 | madong-admin-saas | Apache-2.0 |
| 平台 & 管理端 | 平台管理与租户管理后台前端(Monorepo SPA) | madong-mono | MIT |
| Web 门户 | 门户站点前端(Nuxt 4.x SSR/SSG) | web-nuxt | MIT |
核心服务端 https://github.com/madong-code/madong-admin-saas
平台&管理端 https://github.com/madong-code/madong-mono
Web 门户 https://github.com/madong-code/web-nuxt
配套组件库:madong/query(数据查询组件)、madong/helper(通用帮助组件)、madong/swagger(API 文档组件),已作为 Composer 依赖引入后端。
历史版本痛点:
config/database.php5.x 解决方案:
TenantConnectionManager 动态管理租户数据库连接heartbeat_interval / idle_timeout / max_connections)single / field / database 三种隔离模式,库隔离模式下动态创建连接,自动复用主库配置模板// 5.x 动态连接池架构
TenantConnectionManager::setCurrentConnection($tenantId);
// 自动创建连接池,兼容框架 pool 配置
// 支持 thousands 级租户无压力
配置驱动:config/terminal.php,支持多用户、多会话、权限控制。
三种隔离模式:
| 模式 | 说明 | 适用场景 |
|---|---|---|
| single | 单租户模式(不隔离) | 独立部署,无租户概念 |
| field | 字段隔离(共享表,通过 tenant_id 字段区分) |
中小规模,成本优先 |
| database | 库隔离(每个租户独立数据库) | 大规模,安全优先 |
5.x 新增能力:
TenantConnectionManager 自动创建/释放连接TenantContext 全局管理租户信息TenantScope 自动注入 tenant_id 条件Admin::class)backend/plugin/
├── demo/ # 示例插件
└── portal/ # 门户插件
门户站点同样可插拔:web-nuxt 约定扫描 src/plugin/*/plugins 目录,通知机制做成 provider 注册表,插件移除自动跳过、外部可扩展接入,核心与插件彻底解耦。
一键生成全套代码:
php webman gen:crud --table=order --module=order
# 自动生成全套 CRUD 代码,直接可用
历史版本痛点:必须遵循完整 MVC 架构(Controller → Service → DAO → Model),层次太多,插件开发效率低。
5.x 解决方案:两种模式自由选择。
madong/query(适合快速插件开发)madong/query 处理数据库查询轻量级模式示例(控制器直写):
<?php
namespace App\Plugin\MyPlugin\Controller;
use App\AdminApi\Schema\Request\MyPlugin\ListRequest;
use App\Model\Order;
use support\Request;
use support\Response;
use madong\query\traits\WithQueryParams;
class OrderController extends BaseController
{
use WithQueryParams;
// Swagger 注解路由(统一路由注册方式)
#[OA\Get(
path: '/adminapi/my-plugin/orders',
description: '订单列表',
tags: ['我的插件'],
security: [['Bearer' => []]],
)]
public function index(ListRequest $request): Response
{
// 直接使用 madong/query 处理查询
return json($this->paginateWithParams(Order::query(), $request->validated(), [
'allowed_fields' => ['order_no', 'status', 'created_at'],
'keyword_fields' => ['order_no', 'customer_name'],
'default_sort' => ['created_at' => 'desc'],
]));
}
}
完整 MVC 模式示例(复杂业务):
<?php
namespace App\AdminApi\Controller\Order;
use App\AdminApi\Service\OrderService;
use App\AdminApi\Schema\Request\Order\ListRequest;
use support\Request;
use support\Response;
class OrderController extends Crud
{
protected OrderService $service;
public function __construct(OrderService $service)
{
$this->service = $service;
}
#[OA\Get(
path: '/adminapi/orders',
description: '订单列表',
tags: ['订单管理'],
security: [['Bearer' => []]],
)]
public function index(ListRequest $request): Response
{
return $this->service->paginate($request->validated());
}
}
两种模式对比:
| 特性 | 完整 MVC 模式 | 轻量级模式 |
|---|---|---|
| 适用场景 | 复杂业务逻辑 | 快速插件开发 |
| 层次 | Controller → Service → DAO → Model | Controller + Model |
| 查询方式 | Service 调用 DAO | Controller 直接使用 madong/query |
| 路由注解 | Swagger 注解(统一方式) | Swagger 注解(统一方式) |
| API 文档 | 自动生成 | 自动生成 |
| 开发效率 | 较低(需要创建多个文件) | 较高(控制器直写) |
| 代码生成器 | 支持(生成全套代码) | 支持(仅生成 Controller 和 Model) |
#[Permission] 属性:细粒度到每个 API 接口#[Permission('order:list', '订单列表')]
public function list(): Response
{
// 只有拥有 'order:list' 权限的用户才能访问
}
让后台系统直接成为 AI 可调用的工具集:
core/communication/mcp,含内置工具集app/mcp 定义业务侧可调用工具serve / call / list 三个命令开箱即用mcp/sdk、nyholm/psr7、symfony/finder 依赖配套 madong-admin-saas-skills AI 技能包,让 AI 编辑器(CodeBuddy / Cursor / Trae / Copilot)直接按项目规范写代码。
is_tab 页签标识管理端 / 平台端采用 pnpm + Turbo 的 Monorepo 架构:
apps/(应用)、packages/(共享包)、internal/(内部工具)、playground/(演练场)、scripts/、docs/Vben Admin 5 体系,Element Plus + vxe-tableapps/ 下建目录即可自动接入Web 门户端(Nuxt 4.x):
menu-builder + routes-collector,前后端菜单合并去重.env.development / .env.integrated / .env.production,生产路由支持 hybrid 模式┌─────────────────────────────────────────────────────────┐
│ 用户层 │
│ Admin 后台 Platform 平台管理 Web 门户 API │
└─────────────────────────────────────────────────────────┘
│ │ │
▼ ▼ ▼
┌──────────────────┐ ┌──────────────┐ ┌──────────────────┐
│ madong-mono │ │ madong-mono │ │ web-nuxt │
│ 管理端 (SPA) │ │ 平台端 (SPA) │ │ Nuxt 4 门户端 │
│ Vue3 + Vben5 │ │ Vue3 + Vben5│ │ SSR / SSG │
└──────────────────┘ └──────────────┘ └──────────────────┘
└────────────────────┬───────────────────┘
▼
┌─────────────────────────────────────────────────────────┐
│ madong-admin-saas(Webman 2.x) │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 控制器层 │ │ 服务层 │ │ DAO 层 │ │ 模型层 │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Schema │ │ 验证层 │ │ 事件系统 │ │ MCP 服务 │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
│ ┌───────────────────────────────────────────────────┐ │
│ │ 插件系统(Plugin 生命周期管理) │ │
│ └───────────────────────────────────────────────────┘ │
│ ┌───────────────────────────────────────────────────┐ │
│ │ 多租户架构(TenantConnectionManager) │ │
│ │ · 动态连接池 · 三种隔离模式 · 几千租户无压力 │ │
│ └───────────────────────────────────────────────────┘ │
│ ┌───────────────────────────────────────────────────┐ │
│ │ Web 终端(xterm.js) · SSE 实时通信 · 队列 / 定时任务 │ │
│ └───────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
▼
┌─────────────────────────────────────────────────────────┐
│ 数据层:MySQL(业务数据) Redis(缓存/队列) │
└─────────────────────────────────────────────────────────┘
服务端:
pdo、redis、gd、zip,建议启用 event)前端:Node.js >= 20(建议使用 .node-version 指定版本)+ pnpm
# 1. 按标准目录布局克隆(madong/backend + madong/template)
git clone https://github.com/madong-code/madong-admin-saas.git madong/backend
cd madong/backend
# 2. 安装依赖
composer install
# 3. 启动服务(需提前准备好 MySQL 与 Redis)
# Windows
php windows.php
# Linux / macOS
php start.php start -d
# 4. 可视化安装
# 浏览器访问 http://127.0.0.1:8500 进入安装向导,
# 按页面提示填写数据库 / Redis 连接信息与管理员账号,
# 系统将自动生成 .env 并完成数据表初始化
git clone https://github.com/madong-code/madong-mono.git
cd madong-mono
pnpm install
pnpm run dev
Monorepo 中新增前端应用,只需在 apps/ 下建目录即可自动接入,共享依赖与配置。
git clone https://github.com/madong-code/web-nuxt.git
cd web-nuxt
pnpm install
pnpm run dev # 开发服务器(热更新)
pnpm run build # 构建生产版本
pnpm run preview # 预览生产构建
pnpm run lint # ESLint 代码检查
容器化部署请参考 docker-webman(Webman 官方 Docker 运行环境镜像,开箱即用)。
madong/ # 项目根目录
├── backend/ # 服务后端(madong-admin-saas)
│ ├── app/ # 业务代码(adminapi / api / platform 控制器、service、dao、model)
│ ├── config/ # 框架与业务配置
│ ├── core/ # 核心框架层(含 communication/mcp)
│ ├── plugin/ # 插件目录
│ ├── public/ # 公共资源与安装入口
│ ├── resource/ # 语言包等资源
│ ├── support/ # 启动引导与助手函数
│ ├── start.php # Linux/macOS 启动入口
│ ├── windows.php # Windows 启动入口
│ └── webman # 命令行入口
└── template/ # 前端模板(管理端 / 门户站点)
核心模块分组(6 大分组):
| 分组 | 说明 | 核心模块 |
|---|---|---|
| foundation | 基础支撑 | MVC 基类、异常处理、工具类 |
| infrastructure | 基础设施 | 缓存、日志、监控、调度 |
| security | 安全认证 | JWT、验证码、方法级权限 |
| communication | 通信通知 | 邮件、短信、WebSocket、MCP、SSE |
| io | 文件 IO | Excel 导出、文件上传、雪花 ID |
| business | 业务模块 | 代码生成器、插件系统、多租户、路由组织 |
| 特性 | 历史版本 | 5.x 版本 |
|---|---|---|
| 仓库结构 | 全栈单仓库 | 三端独立仓库(服务端 / 管理端 / 门户端) |
| 连接池 | 静态配置 config/database.php |
动态连接池,兼容框架 Pool,几千租户无压力 |
| Web 终端 | ❌ 无 | ✅ 基于 xterm.js,在线执行命令、查看日志 |
| 多租户 | 基础字段隔离 | 三种隔离模式 + 动态连接管理 + 白名单 |
| 插件系统 | ❌ 无 | ✅ 完整生命周期管理,门户端同样支持插件 |
| 代码生成器 | 基础 CRUD | ✅ 14 种生成器,全套代码一键生成 |
| 权限控制 | 路由级权限 | ✅ 方法级权限(PHP 8.2+ Attribute) |
| 实时通信 | ❌ 无 | ✅ SSE 服务端推送 + 菜单角标 |
| 开发模式 | 必须完整 MVC | ✅ 完整 MVC 或轻量级控制器直写 |
| 查询方式 | 手动拼接 SQL | ✅ madong/query 自动解析查询参数 |
| 路由注解 | ❌ 无 | ✅ 统一 Swagger 注解,自动生成 API 文档 |
| 安装部署 | 手动配置 .env | ✅ 8500 端口可视化安装向导,自动生成 .env |
| AI 能力 | ❌ 无 | ✅ 内置 MCP 服务 + AI 技能包 |
| 开源方式 | 尝鲜招募(需申请) | ✅ GitHub 全量开源,克隆即可用 |
Madong-Saas 5.x · 企业级 SaaS 极速后台管理系统
基于 Webman 2.x + Vue 3 · 动态连接池 · 多租户架构 · 插件系统 · Web 终端 · 代码生成器 · MCP 服务
核心服务端 👉 https://github.com/madong-code/madong-admin-saas
平台 & 管理端 👉 https://github.com/madong-code/madong-mono
Web 门户 👉 https://github.com/madong-code/web-nuxt
如果这个项目对你有帮助,欢迎 Star ⭐ / Fork / 提交 Issue 与 PR。
好东西
代码的好坏,用一次就知道,欢迎更多朋友来“拆箱”有任何槽点也尽管甩过来~
推荐 支持开源 参与开源 共建生态
推荐是起点,参与才是答案——社区等你来“拆箱”共建。
5.x来了,尝鲜走起
感谢支持👍
先领个内测用户,免得又错过了跟kucoder一样最后变成闭源项目了。
关于开源闭源这事
我只能说:只要社区还在用、还在聊、还在提issue,这个项目就值得一直开源下去。 AI时代开源运营确实不容易,但正因为不容易,才更需要像你这样愿意主动参与的人——进来一起盯着,比什么承诺都管用
牛逼
这两个字我先收下了,下次更新时希望能换成一个 PR 😉
支持,给力!!!
给力不敢当
你用着顺手就是最大的给力,多来提意见哈!
大家好,刚加入社区,作为一名新人认真学习了项目文档,有个困惑想虚心请教各位前辈。
如果有前辈在本项目里结合AI做过二次开发,方便谈谈实操中的体会和遇到的问题吗,借此机会多向大家学习。
搭配Skills AI很友好了,大的功能模块用AI先规划
你的担忧正是当下 AI 开发中的核心痛点,在 AI 辅助开发的前提下,我的观点很明确:倘若重度依靠 AI 编码,尽量不要选用外部第三方框架。
只有两种稳妥方案
1.要么依托 AI 自主完成代码编写
2.直接采用官方维护的 webman‑admin,以此保障代码统一性,降低大模型因外部框架代码不熟悉引发逻辑漏洞。
同时感谢 calvin 内测用户的分享实践心得。
ai时代坚守开源实属不易,给作者点赞
演示站 账号密码是多少
平台端:superadmin 123456
管理端:admin 123456
必须支持大佬的每次迭代更新
支持支持,为ai盛行年代还在坚持开源大佬加油
支持