开源多租户SaaS快速开发框架技术文档

【免费下载链接】madong-Admin后台管理框架-SaaS版本 基于Webman的权限管理系统 项目地址: https://gitcode.com/motion-code/madong

1. 安装指南

环境准备

在开始安装前，请确保您的服务器满足以下最低要求：

系统要求：

• PHP >= 8.1（需安装mbstring/json/pdo/openssl/redis/pcntl扩展）
• MySQL >= 5.7
• Redis >= 4.0
• Git >= 2.x
• Composer >= 2.x

推荐环境配置：

• 操作系统：Linux (Ubuntu 20.04+/CentOS 7+)
• Web服务器：Nginx 1.18+
• 内存：4GB以上
• 存储：50GB以上可用空间

2. 项目安装方式

通过Git克隆项目

git clone https://github.com/your-repo-url.git
cd project-name

安装依赖

composer install --no-dev

环境配置

1. 复制环境变量文件：

cp .env.example .env

2. 编辑.env文件配置数据库和Redis连接：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_db_name
DB_USERNAME=your_db_user
DB_PASSWORD=your_db_password

REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=null

初始化系统

php webman migrate
php webman seed

启动服务

开发环境：

php webman serve

生产环境（推荐）：

php webman start -d

3. 项目使用说明

系统登录

1. 访问安装后的系统地址（默认：http://localhost:8787）
2. 使用默认管理员账号登录：
   • 用户名：admin
   • 密码：123456

核心功能模块

多租户管理：

• 创建/编辑租户
• 配置租户订阅计划
• 管理租户数据源

RBAC权限系统：

1. 创建角色并分配权限
2. 配置菜单权限和操作权限
3. 设置数据权限范围

组织架构管理：

• 部门树形结构管理
• 用户账号创建与分配
• 岗位职责配置

系统监控

• 实时查看操作日志
• 监控异常登录行为
• 系统消息推送中心

4. 项目API使用文档

认证方式

所有API请求需在Header中添加：

Authorization: Bearer {access_token}

核心API端点

用户认证：

POST /api/auth/login
参数：
{
    "username": "string",
    "password": "string"
}

租户管理：

GET /api/tenants - 获取租户列表
POST /api/tenants - 创建新租户
GET /api/tenants/{id} - 获取租户详情
PUT /api/tenants/{id} - 更新租户信息

权限管理：

GET /api/roles - 获取角色列表
POST /api/roles/permissions - 为角色分配权限
GET /api/permissions/tree - 获取权限树形结构

消息推送：

POST /api/messages/push
参数：
{
    "target": "user_id|role_id|tenant_id",
    "content": "string",
    "type": "notification|alert"
}

API响应格式

成功响应：

{
    "code": 200,
    "data": {},
    "message": "success"
}

错误响应：

{
    "code": 400,
    "message": "错误描述"
}

最佳实践

多租户数据隔离

系统采用数据库级隔离策略，每个租户可配置独立数据源或共享数据源通过字段隔离。

性能优化建议

1. 启用Redis缓存高频访问数据
2. 合理配置Webman进程数（通过config/server.php）
3. 定期清理操作日志表

安全建议

1. 修改默认管理员密码
2. 定期备份数据库
3. 限制敏感API的访问频率

本技术文档将持续更新，建议定期查看项目Wiki获取最新信息。

【免费下载链接】madong-Admin后台管理框架-SaaS版本 基于Webman的权限管理系统 项目地址: https://gitcode.com/motion-code/madong