# laradmin

**Repository Path**: ycgpp/laradmin

## Basic Information

- **Project Name**: laradmin
- **Description**: laravel+vue3+uniapp，laravel作为后端开发框架，vue3作为前端开发框架，uniapp作为移动端开发框架
- **Primary Language**: PHP
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 16
- **Forks**: 7
- **Created**: 2024-09-22
- **Last Updated**: 2026-06-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Laravel, Vue, uni-app, Element-UI, admin

## README

<div align="center">

# LarAdmin

基于 Laravel 13 + Swoole + Vue 3 + Element Plus 的高性能后台管理系统 / CMS

[![Laravel](https://img.shields.io/badge/Laravel-13.0-red.svg)](https://laravel.com)
[![PHP](https://img.shields.io/badge/PHP-8.2+-blue.svg)](https://php.net)
[![Vue](https://img.shields.io/badge/Vue-3.5-brightgreen.svg)](https://vuejs.org)
[![Element Plus](https://img.shields.io/badge/Element_Plus-2.14-blue.svg)](https://element-plus.org)
[![Swoole](https://img.shields.io/badge/Swoole-5.1-orange.svg)](https://www.swoole.com)
[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

</div>

## 项目简介

LarAdmin 是一个基于 Laravel 13 + Swoole + Vue 3 的高性能后台管理系统，采用模块化架构设计，提供完整的认证授权、系统管理、内容管理及业务扩展能力。项目集成 `hhxsv5/laravel-s` 实现 Swoole 长生命周期服务，大幅提升系统并发性能与响应速度。

包含三个前端应用：

- **管理后台 SPA**：Vue 3 + Element Plus + VXE Table，位于 `resources/admin/`
- **公开网站**：Nuxt 4 SSR，位于 `resources/web/`
- **移动端应用**：UniApp + Vue 3，支持 App + 多端小程序，位于 `resources/mobile/`

## 核心特性

- **高性能运行时**：基于 Swoole 协程，支持高并发、低延迟
- **模块化架构**：采用 `nwidart/laravel-modules` 实现业务模块化管理
- **RBAC 权限**：完整的用户、角色、权限、部门管理体系，权限 Redis 缓存级联失效
- **动态内容建模**：CMS 模块支持动态定义内容类型与字段，自动建表、自动注册菜单
- **多存储驱动**：内置 Local / S3 / MinIO / OSS / RustFS 五种存储驱动
- **现代管理界面**：Vue 3 Composition API + Element Plus + VXE Table
- **三种布局模式**：basic（经典侧边栏）、dual（双栏导航）、top（水平导航）自由切换
- **可拖拽仪表盘**：Widget 系统，支持 StatCard、ChartLine、ChartBar、TodoList、RecentActivity
- **暗色模式**：全局 CSS 变量切换，Element Plus / VXE Table 深度适配
- **国际化**：vue-i18n，中 / 英双语支持
- **实时通信**：内置 WebSocket，支持 JWT 鉴权、频道订阅、广播与系统通知
- **数据导入导出**：基于 Laravel Excel 的批量数据导入导出能力
- **操作审计**：完整的操作日志记录与审计功能
- **可视化任务调度**：定时任务的图形化管理与监控

## 技术栈

### 后端

| 依赖 | 版本 | 用途 |
|------|------|------|
| PHP | ^8.2 | 运行时（Docker 使用 8.3） |
| Laravel | ^13.0 | 框架核心 |
| hhxsv5/laravel-s | ^3.8 | Swoole 集成 |
| tymon/jwt-auth | ^2.2 | JWT 认证 |
| nwidart/laravel-modules | ^12.0 | 模块化开发 |
| intervention/image | ^3.11 | 图片处理 |
| maatwebsite/excel | ^3.1 | Excel 导入导出 |

### 管理后台前端（`resources/admin/`）

| 依赖 | 版本 | 用途 |
|------|------|------|
| Vue | ^3.5 | 框架核心 |
| Vite | ^8.0 | 构建工具 |
| Element Plus | ^2.14 | UI 框架 |
| VXE Table | ^4.19 | 高性能表格 |
| Pinia | ^3.0 | 状态管理 |
| Vue Router | ^4.6 | 路由 |
| Vue I18n | ^9.14 | 国际化 |
| @vueuse/core | ^14.3 | 组合式工具库 |
| Axios | ^1.16 | HTTP 请求 |
| grid-layout-plus | ^1.1 | 仪表盘拖拽布局 |

### 公开网站前端（`resources/web/`）

| 依赖 | 版本 | 用途 |
|------|------|------|
| Nuxt | ^4.4 | SSR 框架 |
| @nuxt/image | ^2.0 | 图片优化 |

### 移动端（`resources/mobile/`）

| 依赖 | 版本 | 用途 |
|------|------|------|
| @dcloudio/uni-ui | ^1.5 | UniApp UI 组件库 |
| luch-request | ^3.1 | 网络请求 |
| mp-html | ^2.5 | 富文本解析 |

## 项目结构

```
laradmin/
├── app/                              # 基础模块（Auth 认证 / System 系统）
│   ├── Http/Controllers/             # 控制器（Admin 后台 / Api 公开接口）
│   ├── Models/                       # 数据模型
│   ├── Services/                     # 业务服务层（含 Storage 存储驱动）
│   ├── Exports/ Imports/             # Excel 导入导出
│   ├── Middleware/                   # 中间件（鉴权 / 日志 / 限流）
│   └── Traits/                       # 公共 Trait（Response / Model）
├── modules/                          # 业务模块目录（nwidart/laravel-modules）
│   └── Cms/                          # CMS 内容管理模块
├── resources/
│   ├── admin/                        # 管理后台 SPA（Vue 3 + Element Plus）
│   ├── web/                          # 公开网站（Nuxt 4 SSR）
│   └── mobile/                       # 移动端（UniApp + Vue 3）
├── routes/                           # 路由（admin.php / api.php / web.php）
├── config/                           # 配置（laravels / jwt / modules 等）
├── database/                         # 迁移与填充
└── storage/                          # 模块激活状态等运行时文件
```

## 开源协议

本项目采用 [MIT](LICENSE) 协议开源。