madong-code / madong-admin-saas

> 如需 **标准版本【单用户独立版本】**，请访问服务端仓库：madong-code/madong-admin
# Madong-Saas 多租户 SaaS 服务后端
基于 Webman 常驻内存框架开发的多租户 SaaS 版服务端
**中文** | English
## 介绍
Madong-Saas 是基于 PHP **Webman** 常驻内存框架的多租户 SaaS 服务后端，为前端应用提供稳定、高效的 API 服务。
- 后端采用清晰的业务分层架构（DAO / Service / Controller）与插件系统；
- 原生支持 **多租户（SaaS）**，提供租户隔离与按租户资源配置；
- 前端基于 `mono` 大仓（Monorepo）版本；可复用标准版本的前端，但因服务接口存在差异，需针对性调整部分接口。
> 前后端分离部署，前端目录需单独下载或创建。
## 仓库地址
本项目为 **服务后端（核心）**，配套前端、容器与工具仓库如下（默认从 GitHub 拉取，网络受限时可改用 Gitee / GitCode 镜像）：
| 模块 | GitHub | Gitee 镜像 | GitCode 镜像 |
| :----- | :--- | :--- | :--- |
| 服务端 | https://github.com/madong-code/madong-admin-saas | https://gitee.com/motion-code/madong-admin-saas | https://gitcode.com/motion-code/madong-admin-saas |
| Mono【平台、租户、安装】 | https://github.com/madong-code/madong-mono | https://gitee.com/motion-code/madong-mono | https://gitcode.com/motion-code/madong-mono |
| Web | https://github.com/madong-code/web-nuxt | https://gitee.com/motion-code/web-nuxt | https://gitcode.com/motion-code/web-nuxt |
| Skills | https://github.com/madong-code/madong-admin-saas-skills | https://gitee.com/motion-code/madong-admin-saas-skills | https://gitcode.com/motion-code/madong-admin-saas-skills |
| 容器 | https://github.com/madong-code/docker-webman | https://gitee.com/motion-code/docker-webman | https://gitcode.com/motion-code/docker-webman |
> 组件库：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`。
 [code] 
前端（管理端）克隆至 `madong/template`，部署请参考 madong-mono 仓库说明；容器化部署请参考 docker-webman。
## 目录结构
 [code] 
## 版本
| 版本 | 说明 |
| :--- | :--- |
| 5.x | 当前版本，后端独立成库（本仓库），多租户 SaaS 架构 |
| 4.x 及更早 | 全栈单仓库版本，见标签 `v4.x-final` |
## 如何贡献
非常欢迎你的加入！提一个 Issue 或提交 Pull Request。
1. Fork 代码
2. 创建分支：`git checkout -b feature/xxxx`
3. 提交：`git commit -am 'feat(function): add xxxxx'`
4. 推送：`git push origin feature/xxxx`
5. 提交 Pull Request
## Git 提交规范
参考 Conventional Commits：`feat` / `fix` / `style` / `perf` / `refactor` / `revert` / `test` / `docs` / `chore` / `ci` / `types` / `wip`。
## 开源协议
Apache-2.0