Madong Saas 多租户企业级极速开发框架 5.x 正式发布|动态连接池支撑数千租户 · Webman 2.x + Vue 3 全栈开源

kzhzjdyw888

企业级 SaaS 极速后台管理系统 · 正式开源 · 三端独立仓库 · Apache-2.0 / MIT


🎉 正式发布

从尝鲜招募到正式开源,Madong-Saas 5.x 现已正式发布。

此前 5.x 以"尝鲜招募"的形式在小范围内测,经过持续的架构打磨与三端拆分重构,今天我们把完整源码正式放到 GitHub 上,无需申请、无需授权,克隆即可用。

Madong-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 依赖引入后端。


🎯 5.x 核心升级(vs 历史版本)

1. 🔥 动态连接池架构(重大突破)

历史版本痛点:

  • 数据库连接配置静态写在 config/database.php
  • 无法动态管理租户数据库连接
  • 大规模租户场景下连接管理混乱

5.x 解决方案:

  • ✅ 动态连接池:TenantConnectionManager 动态管理租户数据库连接
  • ✅ 兼容框架 Pool:无缝对接 Webman 连接池配置(heartbeat_interval / idle_timeout / max_connections)
  • ✅ 几千个租户没压力:支持 single / field / database 三种隔离模式,库隔离模式下动态创建连接,自动复用主库配置模板
  • ✅ 自定义数据源:每个租户可配置独立的数据库主机、端口、用户名、密码、数据库名
  • ✅ 连接复用优化:智能检测连接状态,避免无效连接,死连接自动回收
// 5.x 动态连接池架构
TenantConnectionManager::setCurrentConnection($tenantId);
// 自动创建连接池,兼容框架 pool 配置
// 支持 thousands 级租户无压力

2. 🖥️ Web 终端(全新功能)

  • ✅ 基于 xterm.js:完整的 Web SSH 终端体验
  • ✅ 在线执行命令:支持 bash / php / composer 等命令
  • ✅ 查看日志:实时查看应用日志、错误日志
  • ✅ 管理进程:启动/停止/重启 Webman 进程
  • ✅ Symfony Console 集成:支持自定义命令,扩展系统能力

配置驱动:config/terminal.php,支持多用户、多会话、权限控制。


3. 🏢 多租户架构升级

三种隔离模式:

模式 说明 适用场景
single 单租户模式(不隔离) 独立部署,无租户概念
field 字段隔离(共享表,通过 tenant_id 字段区分) 中小规模,成本优先
database 库隔离(每个租户独立数据库) 大规模,安全优先

5.x 新增能力:

  • ✅ 动态连接管理:TenantConnectionManager 自动创建/释放连接
  • ✅ 租户上下文:TenantContext 全局管理租户信息
  • ✅ 自动注入:TenantScope 自动注入 tenant_id 条件
  • ✅ 白名单机制:指定模型跳过租户过滤(如 Admin::class)
  • ✅ 跨租户查询:超级管理员可查看所有数据

4. 🔌 插件系统(完整机制)

  • ✅ 独立安装 / 卸载 / 启用 / 禁用
  • ✅ 后端逻辑:控制器、服务、模型、迁移文件
  • ✅ 前端页面:自动注册到 Vue 路由和菜单
  • ✅ 依赖管理:插件间依赖声明和检查
  • ✅ 数据库迁移:独立迁移文件,自动执行
  • ✅ 菜单动态注册:插件可动态注册菜单到后端驱动菜单系统
backend/plugin/
├── demo/           # 示例插件
└── portal/         # 门户插件

门户站点同样可插拔:web-nuxt 约定扫描 src/plugin/*/plugins 目录,通知机制做成 provider 注册表,插件移除自动跳过、外部可扩展接入,核心与插件彻底解耦。


5. ⚡ 代码生成器(14 种)

一键生成全套代码:

  1. Controller(API 层)
  2. Service(服务层)
  3. DAO(数据访问层)
  4. Model(模型层)
  5. Validate(验证层)
  6. Schema(DTO)
  7. 前端页面(Vue 3)
  8. 路由配置
  9. i18n 翻译文件(后端 PHP + 前端 JSON)
  10. 数据库迁移
  11. 事件(Event)
  12. 监听器(Listener)
  13. 枚举(Enum)
  14. 权限定义
php webman gen:crud --table=order --module=order
# 自动生成全套 CRUD 代码,直接可用

6. 💡 轻量级开发模式(插件开发推荐)

历史版本痛点:必须遵循完整 MVC 架构(Controller → Service → DAO → Model),层次太多,插件开发效率低。

5.x 解决方案:两种模式自由选择。

  • 完整 MVC 模式:Controller → Service → DAO → Model(适合复杂业务逻辑)
  • 轻量级模式:Controller + madong/query(适合快速插件开发)
  • ✅ 跳过 Service/DAO 层:控制器直接使用 madong/query 处理数据库查询
  • ✅ 统一 Swagger 注解路由:所有路由通过 Swagger 注解自动注册,无需手动配置

轻量级模式示例(控制器直写):

<?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)

7. 🔐 方法级权限(PHP 8.2+ Attribute)

  • ✅ 原生 #[Permission] 属性:细粒度到每个 API 接口
  • ✅ 自动注册:通过 Swagger 注解自动注册路由和权限
  • ✅ RBAC 模型:角色-权限-用户,完整权限体系
  • ✅ 菜单权限:后端驱动菜单渲染,自动校验权限
#[Permission('order:list', '订单列表')]
public function list(): Response
{
    // 只有拥有 'order:list' 权限的用户才能访问
}

8. 🤖 MCP 服务能力(5.x 新增)

让后台系统直接成为 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)直接按项目规范写代码。


9. 📡 SSE 实时通信

  • ✅ 服务端推送:基于 SSE(Server-sent Events)
  • ✅ 实时通知:消息通知、待办提醒
  • ✅ 菜单角标:菜单级角标事件 / 监听 / 推送服务与变量解析器,支持 is_tab 页签标识
  • ✅ 安装进度:插件安装、数据库迁移进度实时展示
  • ✅ 队列监控:Redis 队列任务执行状态实时推送

10. 🎨 前端工程化(Monorepo)

管理端 / 平台端采用 pnpm + Turbo 的 Monorepo 架构:

  • 目录划分:apps/(应用)、packages/(共享包)、internal/(内部工具)、playground/(演练场)、scripts/、docs/
  • UI 体系:Vben Admin 5 体系,Element Plus + vxe-table
  • 工程化:ESLint + Oxlint + Oxfmt + Stylelint + lefthook + commitlint + Changesets + cspell
  • 能力:多应用共享依赖与配置,新增应用只需在 apps/ 下建目录即可自动接入

Web 门户端(Nuxt 4.x):

  • ✅ 认证系统:登录 / 注册、验证码、路由守卫
  • ✅ 会员中心:个人资料、签到补签、积分余额
  • ✅ 混合菜单:menu-builder + routes-collector,前后端菜单合并去重
  • ✅ 主题系统:深色 / 浅色模式切换
  • ✅ 国际化:Vue I18n 中英文双语
  • ✅ 多环境:.env.development / .env.integrated / .env.production,生产路由支持 hybrid 模式
  • ✅ 私有资源:私有空间地址换取 + 签名直链

⚡ 技术栈

后端

  • PHP 8.2+ + Webman 2.x(基于 Workerman 常驻内存)
  • MySQL 5.7+ / 8.0+ + Redis 5.0+
  • Swagger API 文档自动生成(统一路由注册方式)
  • madong/query:查询参数解析与过滤库
  • JWT 双 Token 认证(Access Token + Refresh Token)
  • Redis 队列 + 事件系统 + 定时任务
  • 动态连接池:兼容框架 Pool,支持 thousands 级租户
  • MCP:AI 工具调用能力

前端

  • Vue 3.5+ + Vite 6.x + TypeScript 5.x(管理后台 / 平台端)
  • Nuxt 4.x(Web 门户)
  • Element Plus 2.9+ + vxe-table 4.12+
  • Pinia 2.x + Vue Router 4.x
  • Monorepo(pnpm + Turbo)架构
  • UnoCSS + SCSS(门户端样式方案)

🏗️ 系统架构

┌─────────────────────────────────────────────────────────┐
│                        用户层                           │
│   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(缓存/队列)        │
└─────────────────────────────────────────────────────────┘

🚀 快速开始

环境要求

服务端:

  • PHP >= 8.2(需扩展:pdo、redis、gd、zip,建议启用 event)
  • Composer >= 2.x
  • MySQL 5.7+ / 8.0,Redis 5.0+

前端: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/ 下建目录即可自动接入,共享依赖与配置。

三、启动 Web 门户

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 业务模块 代码生成器、插件系统、多租户、路由组织

🎯 适用场景

  • SaaS 平台:开箱即用的多租户架构,快速搭建 SaaS 应用
  • 企业后台:完整 RBAC 权限 + 菜单管理,适合企业级后台系统
  • 企业官网:基于 Nuxt 4.x 的门户站点,SEO 友好
  • 插件化系统:需要动态扩展功能的系统,插件可独立开发、独立部署
  • AI 集成:内置 MCP 服务,后台能力可直接被 AI 调用
  • 快速原型:代码生成器一键生成 CRUD,大幅缩短开发周期

📚 文档与资源


🎁 5.x 版本亮点总结

特性 历史版本 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。

2577 12 4
12个评论

calvin

好东西

  • kzhzjdyw888 2026-07-10

    代码的好坏,用一次就知道,欢迎更多朋友来“拆箱”有任何槽点也尽管甩过来~

会飞的鱼

推荐 支持开源 参与开源 共建生态

  • kzhzjdyw888 2026-07-10

    推荐是起点,参与才是答案——社区等你来“拆箱”共建。

10bang

5.x来了,尝鲜走起

pixel

先领个内测用户,免得又错过了跟kucoder一样最后变成闭源项目了。

  • kzhzjdyw888 2026-07-10

    关于开源闭源这事
    我只能说:只要社区还在用、还在聊、还在提issue,这个项目就值得一直开源下去。 AI时代开源运营确实不容易,但正因为不容易,才更需要像你这样愿意主动参与的人——进来一起盯着,比什么承诺都管用

TM

牛逼

  • kzhzjdyw888 2026-07-10

    这两个字我先收下了,下次更新时希望能换成一个 PR 😉

支持,给力!!!

  • kzhzjdyw888 2026-07-10

    给力不敢当
    你用着顺手就是最大的给力,多来提意见哈!

懒猫饼

大家好,刚加入社区,作为一名新人认真学习了项目文档,有个困惑想虚心请教各位前辈。

  • 项目划分了 Controller‑Service‑DAO‑Model 多层结构,架构划分规范严谨。只是目前AI编码普遍受限于上下文token,简单的CRUD场景问题不大;面对复杂业务时,代码分散在不同文件内,AI很难完整梳理调用链路,编写代码时偶尔会出现层级衔接不当、逻辑缺失这类情况。
  • 尽管框架提供了轻量模式,可以简化层级适配AI开发,但倘若团队统一沿用标准MVC开发规范,借助AI进行日常开发会不会间接影响开发效率。

如果有前辈在本项目里结合AI做过二次开发,方便谈谈实操中的体会和遇到的问题吗,借此机会多向大家学习。

  • calvin 2026-07-09

    搭配Skills AI很友好了,大的功能模块用AI先规划

  • kzhzjdyw888 2026-07-10

    你的担忧正是当下 AI 开发中的核心痛点,在 AI 辅助开发的前提下,我的观点很明确:倘若重度依靠 AI 编码,尽量不要选用外部第三方框架。
    只有两种稳妥方案
    1.要么依托 AI 自主完成代码编写
    2.直接采用官方维护的 webman‑admin,以此保障代码统一性,降低大模型因外部框架代码不熟悉引发逻辑漏洞。

    同时感谢 calvin 内测用户的分享实践心得。

Administration

ai时代坚守开源实属不易,给作者点赞

  • 暂无评论
晚安。

演示站 账号密码是多少

  • kzhzjdyw888 2026-07-27

    平台端:superadmin 123456
    管理端:admin 123456

FoxHunter

必须支持大佬的每次迭代更新

  • 暂无评论
tinylihu

支持支持,为ai盛行年代还在坚持开源大佬加油

  • 暂无评论
JackDx

支持

  • 暂无评论

kzhzjdyw888

880
积分
0
获赞数
0
粉丝数
2023-06-07 加入
🔝