# 元点Admin - 基于ThinkPHP8+Vue3+UniApp的全栈管理系统框架 **Repository Path**: yuandianxitong/ydadmin ## Basic Information - **Project Name**: 元点Admin - 基于ThinkPHP8+Vue3+UniApp的全栈管理系统框架 - **Description**: 🎉🎉🎉 元点Admin 是一款开箱即用的通用后台管理系统,采用主流的前后端分离架构,后端基于 ThinkPHP 8 提供 RESTful API,前端使用 Vue 3 + Element Plus 构建管理界面,移动端通过 UniApp 实现多端适配(微信小程序 / APP / H5)。 - **Primary Language**: PHP - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 6 - **Forks**: 1 - **Created**: 2026-03-12 - **Last Updated**: 2026-04-01 ## Categories & Tags **Categories**: Uncategorized **Tags**: Element-UI, ElementUI管理后台, ThinkPHP8管理后台, uni-app, 前后分离系统 ## README

元点Admin

元点Admin — 开源通用后台管理系统

基于 ThinkPHP 8 + Vue 3 + TypeScript + Element Plus + UniApp 的前后端分离管理系统

在线演示 · 文档中心 · 问题反馈

PHP ThinkPHP Vue 3 Element Plus MySQL uni-app License

--- ## 系统简介 元点Admin 是一款**免费商用**、开箱即用的通用后台管理系统,采用主流的前后端分离架构,后端基于 ThinkPHP 8 提供 RESTful API,前端使用 Vue 3 + Element Plus 构建管理界面,移动端通过 UniApp 实现多端适配(微信小程序 / APP / H5)。基于 MIT 协议开源,个人和企业均可免费使用,无需授权费用。 系统内置完善的 RBAC 权限体系、CRUD 代码生成器和多渠道集成能力,适用于企业管理后台、SaaS 平台、电商运营等多种业务场景。开发者可基于此快速搭建业务系统,专注于核心业务逻辑开发。 ## 技术栈 | 端 | 技术 | |---|---| | 后端 | ThinkPHP 8.0 / PHP 8.0+ / MySQL | | 前端 | Vue 3 / TypeScript / Element Plus / Vite / Pinia / UnoCSS | | 移动端 | UniApp / Vue 3 / Wot Design Uni | ## 功能特性 - **RBAC 权限** — 管理员 / 角色 / 权限 / 菜单,支持按钮级权限控制和数据范围 - **系统管理** — 部门、数据字典、文件管理、通知管理、定时任务、系统配置 - **日志审计** — 登录日志、操作日志自动记录 - **内容管理** — 协议、公告、用户反馈 - **应用管理** — 区域管理(省市区三级)、APP 版本管理 - **渠道管理** — 微信公众号(菜单/自动回复)、小程序配置 - **消息系统** — 多通道消息模板(短信/微信/站内信)、发送记录 - **支付集成** — 微信支付 / 支付宝(APP/小程序/H5) - **代码生成** — 可视化 CRUD 代码生成器,一键生成前后端完整代码 - **API 文档** — 内置 OpenAPI 文档自动生成 ## 架构设计 ``` 请求 → Controller → Service → Repository → Model ↓ Listener(事件驱动副作用) Job(异步队列任务) ``` - Controller 接收请求、参数校验,调用 Service - Service 编排业务逻辑、管理事务、触发事件 - Repository 封装所有数据库查询 - Model 定义 ORM 映射和关联关系 - Listener 处理副作用(日志、通知、缓存清理) - Controller / Service 基类内置自动依赖注入 ## 快速开始 ### 环境要求 - PHP >= 8.0(含 PDO、mbstring、fileinfo、curl、openssl、GD、ZipArchive 扩展) - MySQL >= 5.7 - Node.js >= 16 - Composer ### Docker 部署(推荐) ```bash git clone https://github.com/yuandianxitong/ydadmin.git cd ydadmin/docker cp .env.docker .env docker-compose up -d ``` 启动后访问 `http://localhost/install/` 完成安装向导。 安装完成后访问 `http://localhost/admin/` 进入管理后台。 > 默认管理员账号:`admin`,密码:`admin888` ### 手动安装 ```bash # 克隆项目 git clone https://github.com/yuandianxitong/ydadmin.git cd ydadmin # 安装后端依赖 cd server composer install ``` 将 Web 服务器(Nginx / Apache)的站点根目录指向 `server/public/`,然后浏览器访问: ``` http://your-domain/install/ ``` 按照安装向导完成系统初始化(环境检测 → 数据库配置 → 管理员账号 → 自动建表和导入初始数据)。 安装完成后,管理后台已预编译在 `server/public/admin/` 目录下,直接访问: ``` http://your-domain/admin/ ``` > 默认管理员账号:`admin`,密码:`admin888` ### 二次开发 如需修改前端界面,进入 `admin/` 目录进行开发: ```bash cd admin npm install npm run dev # 本地开发服务器(热更新) npm run build # 构建生产版本 ``` 构建产物会输出到 `server/public/admin/`,上传至服务器即可生效。 移动端开发: ```bash cd uniapp pnpm install pnpm dev:h5 # H5 开发 pnpm dev:mp-weixin # 微信小程序开发 ``` ## 代码生成 ```bash # CLI 方式 cd server php think make:crud table_name --module=模块名 --model=模型名 # 或通过管理后台「开发工具 → 代码生成器」可视化操作 ``` 自动生成:Model、Repository、Service、Controller、Validate、Route、前端 API、列表页、表单组件。 ## 项目结构 ``` ├── admin/ # 前端(Vue 3) │ ├── src/ │ │ ├── api/ # API 接口 │ │ ├── views/ # 页面组件 │ │ ├── store/ # 状态管理 │ │ ├── router/ # 路由(动态生成) │ │ └── utils/ # 工具函数 │ └── ... ├── server/ # 后端(ThinkPHP 8) │ ├── app/ │ │ ├── adminapi/ # 管理端 API(Controller / Validate / Route) │ │ ├── api/ # C端 API │ │ ├── model/ # 模型层 │ │ ├── repository/ # 数据访问层 │ │ ├── service/ # 业务逻辑层 │ │ ├── listener/ # 事件监听器 │ │ └── event.php # 事件注册 │ ├── core/ # 框架核心(基类 / 认证 / 支付 / 存储) │ └── public/ │ └── install/ # 安装程序 ├── uniapp/ # 移动端(UniApp) ├── .github/ # CI/CD ├── LICENSE └── README.md ``` ## 系统截图 ### 管理后台 | | | |---|---| | ![登录页](https://docs.dev007.cn/admin/demo/admin01.png) | ![控制台](https://docs.dev007.cn/admin/demo/admin02.png) | | ![系统管理](https://docs.dev007.cn/admin/demo/admin03.png) | ![更多功能](https://docs.dev007.cn/admin/demo/admin04.png) | ### PC 端 | | | |---|---| | ![PC首页](https://docs.dev007.cn/admin/demo/pc01.png) | ![PC详情](https://docs.dev007.cn/admin/demo/pc02.png) | ### 移动端 | | | | | |---|---|---|---| | ![移动端首页](https://docs.dev007.cn/admin/demo/mobile01.png) | ![移动端功能](https://docs.dev007.cn/admin/demo/mobile02.png) | ![移动端详情](https://docs.dev007.cn/admin/demo/mobile03.png) | ![移动端个人中心](https://docs.dev007.cn/admin/demo/mobile04.png) | ## 开源协议 [MIT License](LICENSE) ## 联系我们

联系我们

## 链接 - 在线演示: [https://admin.dev007.cn](https://admin.dev007.cn) - 文档中心: [http://docs.dev007.cn/admin/](http://docs.dev007.cn/admin/) - GitHub: [https://github.com/yuandianxitong/ydadmin](https://github.com/yuandianxitong/ydadmin) - Gitee: [https://gitee.com/yuandianxitong/ydadmin](https://gitee.com/yuandianxitong/ydadmin)