如需 标准版本【单用户独立版本】，请访问服务端仓库：madong-code/madong-admin
介绍
Madong-Saas 是基于 PHP Webman 常驻内存框架的多租户 SaaS 服务后端，为前端应用提供稳定、高效的 API 服务。
- 后端采用清晰的业务分层架构（DAO / Service / Controller）与插件系统；
- 原生支持 多租户（SaaS），提供租户隔离与按租户资源配置；
- 前端基于
mono大仓（Monorepo）版本；可复用标准版本的前端，但因服务接口存在差异，需针对性调整部分接口。
前后端分离部署，前端目录需单独下载或创建。
仓库地址
本项目为 服务后端（核心），配套前端、容器与工具仓库如下（默认从 GitHub 拉取，网络受限时可改用 Gitee / GitCode 镜像）：
组件库：madong/query（数据查询）、madong/helper（通用帮助）、madong/swagger（API 文档）已作为 Composer 依赖引入。
运行环境
- PHP 8.2-8.4（需扩展：
pdo、redis、gd、zip，建议启用event） - Composer >= 2.x
- MySQL 5.7+ / 8.0
- Redis 5.0+
- Nginx / Apache（生产环境可选）
快速开始
按标准目录布局，将本仓库克隆到 madong/backend，前端克隆到同级目录 madong/template。
# 1. 克隆服务后端 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 并完成数据表初始化
前端（管理端）克隆至 madong/template，部署请参考 madong-mono 仓库说明；容器化部署请参考 docker-webman。
目录结构
madong/ # 项目根目录
├── backend/ # 服务后端（本仓库）
└── template/ # 前端模板（管理端 / 门户站点）
版本
| 版本 | 说明 |
|---|---|
| 5.x | 当前版本，后端独立成库（本仓库），多租户 SaaS 架构 |
| 4.x 及更早 | 全栈单仓库版本，见标签 v4.x-final |
如何贡献
非常欢迎你的加入！提一个 Issue 或提交 Pull Request。
- Fork 代码
- 创建分支：
git checkout -b feature/xxxx - 提交：
git commit -am 'feat(function): add xxxxx' - 推送：
git push origin feature/xxxx - 提交 Pull Request
Git 提交规范
参考 Conventional Commits：feat / fix / style / perf / refactor / revert / test / docs / chore / ci / types / wip。