# laravel-cms-server

**Repository Path**: imlinnai/laravel-cms-server

## Basic Information

- **Project Name**: laravel-cms-server
- **Description**: Laravel CMS系统 服务端（未完善/持续更新）
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-20
- **Last Updated**: 2025-07-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 课程学习项目

## README



# 后台管理系统 API

## 项目概述
基于 Laravel 框架构建的 RESTful API 服务，提供用户认证、文件管理及数据交互等核心功能。采用现代化技术栈实现高可用接口服务，支持前后端分离架构。

## 核心功能
- 🔐 JWT 身份认证系统
- 📁 多类型文件上传与管理
- 📊 统一标准化响应格式
- ⚡ 高性能路由处理
- 🔒 Sanctum API 授权
- 📝 请求验证与异常处理
- 🛠️ 系统健康检查
- ⚙️ 系统设置管理

## 技术架构
```
Laravel 10.x
MySQL 8.0
PHP 8.1+
JWT 认证
Laravel Sanctum
RESTful API 规范
```

## 环境要求
- PHP 8.1+ 含必要扩展
- Composer 2.5+
- MySQL 8.0+
- Node.js 18.x (可选)

## 快速安装
```bash
cp .env.example .env
composer install
php artisan key:generate
php artisan migrate --seed
php artisan serve
```

## API 接口列表

### 系统健康检查
- `GET /api/health/status` - 检查系统运行状态
- `GET /api/health/database` - 检查数据库连接状态

### 用户认证
- `POST /api/auth/register` - 用户注册
- `POST /api/auth/login` - 用户登录
- `POST /api/auth/logout` - 用户登出
- `PUT /api/auth/edit` - 编辑用户信息
- `PUT /api/auth/changePassword` - 修改密码
- `POST /api/auth/avatar` - 上传头像
- `GET /api/auth/detail` - 获取用户详情
- `GET /api/auth/getAvatar` - 获取头像
- `GET /api/auth/getPermissions` - 获取用户权限
- `GET /api/auth/getMenus` - 获取菜单列表
- `GET /api/auth/getPermissionsCount` - 获取权限数量

### 系统设置
- `GET /api/settings/get` - 获取系统设置
- `POST /api/settings/update` - 更新系统设置
- `GET /api/settings/dashboard_title_get` - 获取仪表盘标题
- `POST /api/settings/dashboard_title_update` - 更新仪表盘标题
- `GET /api/settings/ngx_check_get` - 获取 Nginx 检查状态
- `POST /api/settings/ngx_check_update` - 更新 Nginx 检查状态
- `GET /api/settings/db_check_get` - 获取数据库检查状态
- `POST /api/settings/db_check_update` - 更新数据库检查状态

### 后台管理

#### 角色管理
- `GET /api/admin/role/list` - 获取角色列表
- `POST /api/admin/role/create` - 创建角色
- `PUT /api/admin/role/edit` - 编辑角色
- `DELETE /api/admin/role/delete` - 删除角色

#### 用户管理
- `GET /api/admin/user/list` - 获取用户列表
- `POST /api/admin/user/create` - 创建用户
- `PUT /api/admin/user/edit` - 编辑用户
- `DELETE /api/admin/user/delete` - 删除用户
- `PATCH /api/admin/user/setRole` - 设置用户角色

#### 权限管理
- `GET /api/admin/permission/get` - 获取权限列表
- `POST /api/admin/permission/save` - 保存权限

#### 文章管理
- `GET /api/article/list` - 获取文章列表
- `POST /api/article/create` - 创建文章
- `PUT /api/article/edit` - 编辑文章
- `DELETE /api/article/delete` - 删除文章
- `GET /api/article/file` - 获取文章文件
- `POST /api/article/upload` - 上传文章文件

## 开发指南
1. 创建功能分支
2. 编写单元测试
3. 遵循 PSR 编码规范
4. 提交 PR 至 develop 分支

## 贡献协议
请参考 [Laravel 贡献指南](https://laravel.com/docs/contributions)