# SunAdmin多端模块化业务平台 **Repository Path**: huizhou-sanzhong/sunadmin ## Basic Information - **Project Name**: SunAdmin多端模块化业务平台 - **Description**: 🚀 SunAdmin 多端模块化业务平台,既是开发基座,也是应用平台 —— 基于 Laravel 13、Vue 3 与 uni-app Vue3 的多端一体方案 - **Primary Language**: PHP - **License**: Apache-2.0 - **Default Branch**: 1.x - **Homepage**: https://www.sunzoon.com - **GVP Project**: No ## Statistics - **Stars**: 4 - **Forks**: 0 - **Created**: 2026-05-26 - **Last Updated**: 2026-06-15 ## Categories & Tags **Categories**: Uncategorized **Tags**: Laravel, PHP, Vue, uni-app, 后台管理系统 ## README

SunAdmin 多端模块化业务平台

🚀 既是开发基座,也是应用平台 —— 基于 Laravel 13、Vue 3 与 uni-app Vue3 的多端一体方案

官网 · 文档 · 演示站 · 更新日志

PHP 8.3+ Laravel 13 Vue 3 Vite TypeScript uni-app Vue 3 Apache 2.0

SunAdmin 是一套**多端模块化业务平台**,由 Laravel 13 后端、Vue 3 Admin 管理端、uni-app Vue 3 客户端组成。它对开发者是"开发基座"——把权限、配置、内容、上传、支付、移动端和 AI 等常见业务基础设施提前组合到一起;对运营者是"应用平台"——通过后台应用中心安装、启用、停用业务模块。 ## 🪜 两层定位 | 层 | 面向 | 当前能力 | 后续扩展方向 | | --- | --- | --- | --- | | 开发基座 | 开发团队 / 自研者 | 模块化结构、权限/支付/AI/上传等基础设施齐备,可直接二次开发 | 同样可通过应用中心选购现成模块加速开发;但**如对框架本身有二开改动,需自行处理与新模块、未来框架升级的兼容问题** | | 应用平台 | 运营者 / 采购方 | 后台"应用中心"安装、启用、停用、卸载本地模块 | 在线下载、付费购买、模块升级、模块作者生态 | ## 🌐 演示体验

后台管理端

https://demo.sunadmin.top

账号:demo
密码:123456

演示站仅供产品展示效果,请勿录入真实业务数据。

H5 移动端

H5 端二维码
扫码访问移动端演示
账号:13800138000 密码:123456
## 🖼️ 项目截图
后台仪表盘截图(占位)
后台仪表盘 · 概览卡片 / 快捷入口
页面装修截图(占位)
页面装修 · 拖拽设计器 / 实时预览
文章管理截图(占位)
文章管理 · 分类 / 列表 / 富文本
应用中心截图(占位)
应用中心 · 模块安装 / 启停 / 配置
H5 首页截图(占位)
H5 首页 · 装修渲染 / 多端兼容
H5 个人中心截图(占位)
H5 个人中心 · 用户资料 / 业务入口
## ✨ 核心能力 - **后端基础**:Laravel 13 工程结构、Sanctum Token 认证、Spatie 注解路由、模块自动扫描、Controller / Action / Service / Dao / Model / Enum 分层、统一响应结构、统一异常码 - **权限与组织**:管理员、角色、菜单、按钮权限、动态路由、部门、岗位 - **内容运营**:文章分类与文章、协议、公告、媒体库、页面装修与移动端装修渲染、搜索配置 - **用户能力**:用户资料、用户地址 - **系统配置**:分组配置、数据字典、缓存管理、站点开关、存储驱动、微信公众号 / 小程序、AI 模型 - **多语言**:后台语言管理、菜单 / 字典 / 配置等多语言数据维护、Admin 端界面切换 - **上传存储**:图片 / 视频 / 文件上传,本地、七牛、阿里云 OSS、腾讯云 COS,媒体 URL 自动转换 - **支付能力**:统一支付单、退款单、回调日志、业务处理器分发;默认集成微信支付模块 - **AI 与 MCP**:后台动态配置模型供应商、文本生成、向量、知识库 RAG、AI 助手、多轮上下文、MCP 工具调用、官方 MCP Server - **AI Skills**:预留了一套面向 AI 工具的协作规则,用于让 Codex、Claude、Cursor、Trae、通义灵码、Copilot Chat、OpenCode 等工具更快理解项目结构、编码风格和常见约定。 - **模块化**:`module.json` 模块清单、`publish-manifest.json` 资源发布、模块命令、模块运行包构建 - **应用中心**:后台模块管理 UI(安装 / 启用 / 停用 / 卸载)。 - **接口契约**:统一响应格式、统一异常码、一键导出 OpenAPI 3.0 JSON。 - **多端联动**:三端使用同一套业务接口契约 ## 🧰 技术栈 ### 后端 - PHP 8.3+ - Laravel 13 - Laravel Sanctum - Spatie Route Attributes - Laravel AI / Laravel MCP ### Admin 管理端 - Vue 3 + TypeScript - Vite - Element Plus - Pinia + Vue Router - vue-i18n - ECharts - vxe-table - Tailwind CSS ### uni-app 客户端 - uni-app Vue 3 + TypeScript - DCloud Vite CLI - Pinia - uview-plus - z-paging(分页列表) - Tailwind CSS + weapp-tailwindcss ## 🗂️ 工程结构 ```text SunAdmin ├─ .ai/ AI 协作规则源文件(项目、后端、管理端、uni-app、文档规则) ├─ app/ Laravel 应用公共层(Core、Http、Support 等) ├─ bootstrap/ 框架启动文件 ├─ config/ 框架与业务配置 ├─ database/ 全局迁移、Seeder ├─ docs/ 项目原始文档与说明资料 ├─ frontend/ │ ├─ admin/ Vue 3 管理后台源码 │ └─ uniapp/ uni-app Vue 3 客户端源码 ├─ modules/ 业务模块目录 │ └─ System/ 系统核心模块 │ ├─ module.json 模块清单 │ ├─ Ai/Tools Laravel AI Agent 工具 │ ├─ Application/ Actions / Services / Jobs │ ├─ Dao/ 数据访问层 │ ├─ Database/ 模块迁移与 Seeder │ ├─ Domain/ Models / Enums / Casts │ ├─ Http/ Controllers / Requests │ ├─ Mcp/Tools Laravel MCP Server 工具 │ └─ Providers/ 模块启动注册器 ├─ public/ │ ├─ admin/ Admin 生产构建产物 │ ├─ h5/ uni-app H5 生产构建产物 │ └─ modules/ 模块运行包发布目录 ├─ resources/ Blade、传统静态资源 ├─ routes/ web / ai / console 路由入口 ├─ storage/ Laravel 运行时目录 ├─ tests/ 自动化测试 ├─ AGENTS.md 通用 AI Agent 规则入口,引用 .ai 规则 └─ README.md 项目总说明 ``` `AGENTS.md` 是通用 AI Agent 规则入口,长期维护的规则统一放在 `.ai/` 下。 ## 🔧 环境要求 - PHP `>= 8.3` - Composer `>= 2.2` - MySQL `>= 5.7` 或兼容数据库 - Redis(可选,生产建议启用) - Node.js `>= 22`(推荐) - npm `>= 11` - HBuilderX(uni-app 小程序 / App 编译) ## 🚀 快速开始 ### 通过安装向导初始化 访问: ```text http(s)://你的域名/install ``` 向导会引导完成数据库、缓存、管理员账号、应用密钥与基础数据初始化。需重装时删除根目录 `install.lock` 后再访问。 初始化完成后: - 后台管理端:`http(s)://你的域名/admin` - H5 端:`http(s)://你的域名/h5` - 小程序:编译产物后上传到小程序平台访问 ### 后端开发 ```bash # 安装后端依赖 composer install # 启动 Laravel 本地开发服务 php artisan serve # 如使用本地上传存储,创建公开访问软链 php artisan storage:link ``` 首次安装请使用安装向导。安装向导会创建后台管理员账号;单独执行 `php artisan migrate` / `php artisan db:seed` 不会完成完整初始化流程。 ### Admin 管理端开发 ```bash cd frontend/admin npm install npm run dev # 启动开发服务,默认 :8000 npm run build # 构建产物自动发布到 public/admin ``` 也可在项目根目录使用 `npm run admin:install` / `npm run admin:dev` / `npm run admin:build`。 ### uni-app 客户端开发 ```bash cd frontend/uniapp # uni-app 工具链对 npm 版本敏感,建议指定 npm 11 npx npm@11.13.0 install npm run dev:h5 # H5 开发,访问 http://localhost:8001/h5 npm run dev:mp-weixin # 微信小程序,用微信开发者工具导入 dist/dev/mp-weixin npm run dev:app # App 开发 ``` 构建:`npm run build:h5` 会把 H5 产物自动发布到 `public/h5`。 ## 🧪 模块管理命令 ```bash # 安装模块(执行迁移、发布资源、注册菜单) php artisan module:install {Module} # 强制覆盖已发布资源 php artisan module:install {Module} --force # 卸载模块(保留数据) php artisan module:uninstall {Module} # 卸载并删除模块数据表 php artisan module:uninstall {Module} --drop-data # 启用 / 停用模块 php artisan module:enable {Module} php artisan module:disable {Module} # 构建模块 Admin 运行包 php artisan module:build-runtime {Module} --admin # 构建所有模块运行包 php artisan module:build-runtime --all ``` ## 📡 接口文档导出 一键导出 OpenAPI 3.0 JSON,供 Apifox / Postman / Swagger 等接口管理工具导入: ```bash php artisan openapi:export # → 默认输出到 storage/app/openapi.json ``` ## 📄 开源许可 SunAdmin 由 [Sunzoon / 惠州市三众科技有限公司](https://www.sunzoon.com) 维护,当前公开版本基于 [Apache License 2.0](LICENSE) 发布。 ### 关键事项 - 仓库中的 [LICENSE](LICENSE) 与 [NOTICE](NOTICE) 文件分别承载正式许可证文本与项目级分发说明 - 复制、修改、分发本项目及其衍生版本时,应按 Apache-2.0 要求保留版权声明,包括 Sunzoon / 惠州市三众科技有限公司 的相关信息 - 本项目以**开源社区版**形式提供,不包含商业交付、定制开发、运维托管、SLA 或其他服务承诺;如有单独商务协议,以双方协议为准 - 本节仅为许可摘要,不构成法律意见;完整条款以 [LICENSE](LICENSE)、[NOTICE](NOTICE) 及第三方依赖各自许可证为准 ### 许可摘要 | 主题 | 简述 | 详情 | |---|---|---| | 一、许可范围 | 可在 Apache-2.0 下自由使用、复制、修改、分发本项目,包括个人、企业、商业、内部项目场景;源代码形式与编译后产物均适用 | [LICENSE](LICENSE) | | 二、版权保留 | 复制或分发时应保留现有版权声明、许可证文本与必要的 NOTICE 说明;如有源码修改,建议在变更文件或发布说明中标识修改内容与时间 | [NOTICE](NOTICE) | | 三、专利授权与终止 | 包含贡献者授予的专利许可;若您就本项目或其贡献发起专利诉讼并主张侵权,相关专利许可可能依许可证条款自动终止 | [LICENSE](LICENSE) | | 四、商标与品牌 | Apache-2.0 **不自动授予** `SunAdmin`、`Sunzoon` 及其 Logo、品牌视觉、宣传物料的商标或品牌使用权;如需用于对外品牌传播,请联系 Sunzoon | — | | 五、第三方组件 | Composer、npm、uni-app 生态和其他第三方依赖仍适用各自许可证;使用、构建、修改或重新分发时须同时遵守第三方依赖的许可要求 | 各依赖仓库 | | 六、责任与担保 | 按"现状"提供,不对适销性、特定用途适用性、不侵权等作出明示或默示担保;使用风险由您自行承担 | [LICENSE](LICENSE) | | 七、模块与应用 | 模块、运行包、应用中心扩展和第三方服务可能有独立依赖、平台规则、费用或合规要求;安装、启用前应确认其适用范围与运行要求 | 模块说明 | | 八、合法使用 | 使用本项目及其衍生版本时应遵守适用法律法规,不得用于任何法律法规、监管要求或平台规则禁止的用途;由此产生的一切风险、争议、处罚及法律责任由使用者自行承担 | — | | 九、开源协作 | 向本项目提交代码、文档、图片、模块或其他贡献时,除非另有明确声明,通常视为同意该贡献在 Apache-2.0 下被项目接收和分发,并确认自己有权提交相关内容 | — | ### 生产使用提醒 - 安装向导、示例配置、默认账号、默认数据和测试密钥仅用于初始化或开发验证,生产上线前应完成替换、清理和安全加固 - 启用短信、支付、AI、对象存储、微信生态、地图、物流等第三方服务时,部署者应自行完成账号资质、密钥管理、平台规则、费用结算、数据安全、业务合规与审计留痕 - 系统运行过程中可能处理管理员、用户资料、地址、订单、支付、退款、日志、AI 调用记录等数据,部署者应自行承担隐私政策、用户授权、数据留存、备份、删除、访问控制和合规审计责任 - 使用本项目及其衍生版本不得从事违反法律法规、监管要求或平台规则的事项;不当使用产生的一切后果由使用者自行承担 - 安装完成不等于生产环境安全加固。上线前应配置 HTTPS、环境变量密钥、目录权限、队列、定时任务、日志保护、存储公开访问规则、支付回调安全和服务器防护策略 - 升级框架、模块或第三方依赖前,应先备份数据,并在测试环境验证数据库迁移、接口兼容、前端运行包和业务流程 - 二次开发或重新分发时,不得暗示该版本由 Sunzoon 官方发布或提供背书;同时仍应保留 Apache-2.0 要求的版权、许可证和 NOTICE 信息 - 启动安装即表示您已知悉本项目基于 Apache License 2.0 开源发布,而非额外的商业限制授权模式 ## ⭐ 支持项目 如果 SunAdmin 对你的项目、学习或二次开发有帮助,欢迎顺手点一个 Star。 Star 不只是一个数字,它能让更多需要 Laravel、Vue 3、uni-app、多端模块化后台基座的开发者更容易发现这个项目,也会成为我们持续完善文档、模块生态和工程体验的一点小小动力。 ## 📬 联系与交流 如果你在使用过程中遇到问题,或希望交流模块开发、商业合作、项目落地等事宜,可以通过以下方式联系。 | 方式 | 说明 | |--------------|---------------------------| | 官方网站 | | | 商务、商业授权或其他事宜 | 扫描下方二维码与我们取得联系 |

微信联系二维码

## © 版权信息 ``` SunAdmin Copyright 2026 Sunzoon / Huizhou Sunzoon Technology Co., Ltd. (惠州市三众科技有限公司) Licensed under the Apache License, Version 2.0 ```