Laravel Filament Admin Panel

🎉 基于 Laravel 10 + Filament v3.x 构建的现代化后台管理系统

✨ 功能特性

• 🛠️ 完整的用户管理系统 - CRUD 操作、权限控制、批量操作
• 🎨 现代化界面 - 基于 Filament v3.x 的响应式管理界面
• 🔌 RESTful API - 完整的 API 接口，支持前后端分离
• 🚀 开箱即用 - SQLite 数据库，无需复杂配置
• 🌐 中文支持 - 完整的中文界面和验证消息
• 📱 移动端适配 - 响应式设计，支持移动设备访问

🏗️ 项目结构

├── app/
│   ├── Filament/Resources/          # Filament 资源文件
│   │   └── UserResource.php        # 用户管理资源
│   ├── Http/
│   │   ├── Controllers/Api/         # API 控制器
│   │   ├── Requests/               # 表单验证请求
│   │   └── Resources/              # API 资源类
│   ├── Models/                     # Eloquent 模型
│   ├── Providers/                  # 服务提供者
│   └── Services/                   # 业务逻辑服务层
├── config/                         # 配置文件
├── database/
│   ├── migrations/                 # 数据库迁移
│   └── seeders/                   # 数据库种子
└── routes/
    ├── api.php                    # API 路由
    └── web.php                    # Web 路由

🚀 快速开始

1. 安装依赖

确保你已安装 Composer，然后运行：

composer install

2. 环境配置

项目已配置使用 SQLite 数据库，无需额外配置。如需使用其他数据库，请修改 .env 文件。

3. 生成应用密钥

php artisan key:generate

4. 运行数据库迁移和种子

php artisan migrate --seed

5. 启动开发服务器

php artisan serve

6. 访问系统

• 主页: http://localhost:8000
• 管理后台: http://localhost:8000/admin
• API 文档: http://localhost:8000/api/v1/users

👤 默认账号

系统已预置以下测试账号：

角色	邮箱	密码	权限
管理员	admin@example.com	password	完整管理权限
普通用户	user@example.com	password	基础权限

📡 API 接口

用户管理 API

方法	路径	描述
GET	/api/v1/users	获取用户列表（支持分页、搜索、筛选）
POST	/api/v1/users	创建新用户
GET	/api/v1/users/{id}	获取用户详情
PUT	/api/v1/users/{id}	更新用户信息
DELETE	/api/v1/users/{id}	删除用户

API 请求示例

# 获取用户列表
curl -X GET "http://localhost:8000/api/v1/users?per_page=10&search=admin"

# 创建用户
curl -X POST "http://localhost:8000/api/v1/users" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "新用户",
    "email": "newuser@example.com",
    "password": "password123",
    "is_admin": false
  }'

🛠️ 开发指南

添加新的资源模块

1. 创建模型和迁移：

php artisan make:model YourModel -m

2. 创建 Filament 资源：

php artisan make:filament-resource YourModel --generate

3. 创建 API 控制器：

php artisan make:controller Api/YourModelController --api

4. 创建服务类：

php artisan make:class Services/YourModelService

代码规范

• 遵循 PSR-12 代码风格
• 业务逻辑封装在 Service 层
• 使用 FormRequest 进行数据验证
• API 响应使用 Resource 类包装

🔧 配置说明

数据库配置

默认使用 SQLite，数据库文件位于 database/database.sqlite。

如需使用 MySQL，请修改 .env 文件：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password

Filament 配置

Filament 配置文件位于 config/filament.php，可自定义：

• 管理面板路径（默认：/admin）
• 品牌名称和 Logo
• 主题颜色
• 认证设置

📝 更新日志

v1.0.0 (2024-08-31)

• ✅ 初始版本发布
• ✅ 完整的用户管理系统
• ✅ Filament v3.x 集成
• ✅ RESTful API 接口
• ✅ 中文语言支持
• ✅ SQLite 数据库配置

🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

📄 许可证

本项目基于 MIT 许可证开源。