🐍 Python 版 (Gitee) | 🐍 Python 版 (GitHub)
--- ## ✨ 项目简介 Foadmin 是一款现代化的企业级后台管理系统。本项目为 **PHP 版本**，基于 **Vue 3** 和 **ThinkPHP 8** 构建。我们致力于为开发者提供高效、灵活、易用的管理后台解决方案。 > 🐍 如果你正在寻找 Python 版本，请访问：[Gitee](https://gitee.com/foadmin/foadmin) | [GitHub](https://github.com/foadmin-git/foadmin) --- ## 🛠️ 技术栈 | 层级 | 技术 | 说明 | |:---:|:---:|:---| | 前端框架 | Vue 3 + Vite 7 | 渐进式 JavaScript 框架 | | UI 组件 | Element Plus | 基于 Vue 3 的组件库 | | CSS 方案 | Tailwind CSS | 原子化 CSS 框架 | | 图表 | ECharts | 数据可视化图表库 | | 富文本 | WangEditor | 轻量级 Web 富文本编辑器 | | 后端框架 | ThinkPHP 8 | 高性能 PHP 全栈框架 | | ORM | think-orm 3.0+ | ThinkPHP 原生 ORM | | 数据库 | MySQL 8.0+ | 关系型数据库 | | 认证 | JWT (firebase/php-jwt) | 无状态令牌认证 | | 邮件 | PHPMailer | 邮件发送服务 | --- ## 📐 系统架构 ``` php-foadmin/ ├── admin/ # 前端 (Vue 3 + Vite) │ ├── src/ │ │ ├── api/ # 接口请求层 │ │ ├── assets/ # 静态资源 │ │ ├── components/ # 公共组件 │ │ ├── directives/ # 自定义指令（权限控制等） │ │ ├── plugins/ # 插件配置 │ │ ├── router/ # 路由配置 │ │ ├── store/ # 状态管理 (Pinia) │ │ ├── utils/ # 工具函数 │ │ └── views/ # 页面视图 │ └── vite.config.js ├── api/ # 后端 (ThinkPHP 8) │ ├── app/ │ │ ├── controller/ # 控制器层 │ │ ├── middleware/ # 中间件（认证、权限、审计等） │ │ ├── model/ # 数据模型层 │ │ ├── service/ # 业务逻辑层 │ │ ├── validate/ # 验证器 │ │ └── utils/ # 工具类 │ ├── config/ # 配置文件 │ ├── route/ # 路由定义 │ └── .env # 环境变量 └── mysql/ # 数据库脚本 └── foadmin.sql ``` --- ## 🎯 功能模块 | 模块 | 功能 | 说明 | |:---|:---|:---| | 🔐 用户与权限 | 用户管理、角色管理、权限分配 | RBAC 权限模型 | | 🏢 组织架构 | 部门目录、职级体系、组织管理 | 树形组织架构 | | ⚙️ 系统配置 | 参数配置、数据字典、邮件设置、定时任务 | 灵活的系统配置 | | 📝 日志审计 | 操作日志、登录日志、审计日志（列表+可视化分析） | 全链路审计追踪 | | 🖼️ 媒体管理 | 文件管理、标签管理、内容审核、格式转换 | 统一媒体资源管理 | | 📊 系统监控 | 系统信息、运行监控 | 实时系统状态 | --- ## 📸 系统预览  --- ## 🚀 快速开始 ### 环境要求 - **PHP** 8.0+ - **Node.js** 18+ - **MySQL** 8.0+ - **Composer** 2.0+ ### 1. 克隆项目 ```bash git clone https://github.com/foadmin-git/php-foadmin.git cd php-foadmin ``` ### 2. 后端部署 ```bash cd api # 安装 PHP 依赖 composer install # 配置环境变量（数据库、JWT 等） cp .env.example .env # 编辑 .env 填写你的数据库信息 # 导入数据库 # 将 mysql/foadmin.sql 导入到你的 MySQL 数据库 # 启动服务（开发模式） php think run ``` 后端默认运行在 `http://localhost:8000` ### 3. 前端部署 ```bash cd admin # 安装依赖 npm install # 启动开发服务器 npm run dev ``` 前端默认运行在 `http://localhost:5173` ### 4. 访问系统 打开浏览器访问 `http://localhost:5173`，使用默认账号登录： - 超级管理员：`admin` / `admin123` --- ## 📖 开发文档 ### 目录规范 #### 后端 (api/) | 目录 | 说明 | |:---|:---| | `app/controller/` | 控制器，处理 HTTP 请求，调用 Service 层 | | `app/middleware/` | 中间件，包含认证 (`Auth.php`)、权限 (`Permission.php`)、审计 (`Audit.php`)、CORS (`Cors.php`) 等 | | `app/model/` | 数据模型，对应数据库表 | | `app/service/` | 业务逻辑层，核心业务处理 | | `app/validate/` | 验证器，请求参数校验 | | `app/utils/` | 工具类 | | `config/` | 框架配置文件 | | `route/app.php` | 路由定义 | #### 前端 (admin/) | 目录 | 说明 | |:---|:---| | `src/api/` | 接口封装，每个模块对应一个 API 文件 | | `src/views/` | 页面视图，按功能模块组织 | | `src/components/` | 公共组件（富文本编辑器、媒体选择器等） | | `src/store/` | Pinia 状态管理 | | `src/router/` | Vue Router 路由配置 | | `src/directives/` | 自定义指令（`v-perm` 权限控制、`v-demo-disable` 演示禁用） | ### API 开发规范 #### 控制器示例 ```php // api/app/controller/User.php namespace app\controller; use app\BaseController; use app\service\UserService; class User extends BaseController { protected $service; public function __construct(UserService $service) { $this->service = $service; } // GET /api/admin/user/list public function list() { $params = $this->request->get(); $result = $this->service->getList($params); return json($result); } } ``` #### 路由定义 ```php // api/route/app.php use think\facade\Route; // 用户管理 Route::group('admin/user', function () { Route::get('list', 'User/list'); // 用户列表 Route::post('create', 'User/create'); // 创建用户 Route::put('update', 'User/update'); // 更新用户 Route::delete('delete', 'User/delete'); // 删除用户 })->middleware(['auth', 'permission']); ``` #### 中间件执行顺序 ``` Cors → StaticFileAccess → Auth → Permission → DemoUser → Audit → LoginLog → ResponseFormat ``` ### 前端开发规范 #### 权限指令 ```vue© 2024 厦门市知序技术服务工作室 | Powered by ThinkPHP 8 + Vue 3