# 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 的多端一体方案

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

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

后台管理端

https://demo.sunadmin.top

账号：demo
密码：123456

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

H5 移动端

_{扫码访问移动端演示}
_{账号：13800138000　密码：123456}

## 🖼️ 项目截图

_{后台仪表盘 · 概览卡片 / 快捷入口}	_{页面装修 · 拖拽设计器 / 实时预览}
_{文章管理 · 分类 / 列表 / 富文本}	_{应用中心 · 模块安装 / 启停 / 配置}
_{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、多端模块化后台基座的开发者更容易发现这个项目，也会成为我们持续完善文档、模块生态和工程体验的一点小小动力。 ## 📬 联系与交流如果你在使用过程中遇到问题，或希望交流模块开发、商业合作、项目落地等事宜，可以通过以下方式联系。 | 方式 | 说明 | |--------------|---------------------------| | 官方网站 | | | 商务、商业授权或其他事宜 | 扫描下方二维码与我们取得联系 |

微信联系二维码