# laravel-filamentphp-base

**Repository Path**: wslyiyi/laravel-filamentphp-base

## Basic Information

- **Project Name**: laravel-filamentphp-base
- **Description**: filamentphp 主题，符合国内用户习惯，审美
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-08-26
- **Last Updated**: 2025-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Laravel FilamentPHP 基础模板

这是一个基于 Laravel 和 FilamentPHP 的基础模板项目，旨在为开发人员提供一个开箱即用的后台管理系统模板。

## 项目特点

- 基于 Laravel 12 和 FilamentPHP 4.x 构建
- 包含用户、角色和权限管理模块
- 提供基础设置和配置功能
- 支持多语言（包含中文）
- 集成常用前端组件和样式
- 提供响应式布局和现代 UI 设计

## 主要功能

- 用户管理：创建、编辑、删除管理员用户
- 角色管理：创建角色并分配权限
- 权限管理：细粒度权限控制
- 系统设置：全局配置管理
- 仪表盘：基础统计和数据可视化
- 多语言支持：zh_CN 等语言包

## 技术栈

- Laravel 12
- FilamentPHP 4.x
- PHP 8.4
- MySQL/MariaDB
- Alpine.js
- Tailwind CSS
- Docker (用于开发环境)

## 安装指南

1. 克隆仓库：
```bash
git clone https://gitee.com/wslyiyi/laravel-filamentphp-base.git
```

2. 进入项目目录并安装依赖：
```bash
cd laravel-filamentphp-base
composer install
npm install
npm run build
```

3. 创建并配置 `.env` 文件：
```bash
cp .env.example .env
php artisan key:generate
```

4. 数据库迁移：
```bash
php artisan migrate
```

5. 安装 FilamentPHP：
```bash
php artisan filament:install --panels
```

6. 启动开发服务器：
```bash
php artisan serve
```

## 使用说明

- 后台访问地址：`/admins`
- 默认管理员登录：`admin@example.com` / `password`
- 前端资源构建：`npm run dev` 或 `npm run build`

## 目录结构

```
├── app/                  # Laravel 应用核心代码
│   ├── Console/            # 命令行工具
│   ├── Enums/              # 枚举类
│   ├── Filament/           # Filament 模块
│   ├── Models/             # 数据模型
│   └── Providers/          # 服务提供者
├── resources/              # 资源文件
│   ├── css/                # 样式文件
│   └── views/              # Blade 模板
├── public/                 # 公共资源
│   ├── css/                # 编译后的 CSS
│   └── js/                 # 编译后的 JS
├── database/               # 数据库相关文件
│   ├── factories/          # 模型工厂
│   ├── migrations/         # 数据库迁移
│   └── seeders/            # 数据填充
├── .docker/                # Docker 配置文件
├── config/                 # 配置文件
├── lang/                   # 多语言支持
└── tests/                  # 测试代码
```

## 开发规范

- 代码风格：遵循 Laravel 和 FilamentPHP 的编码规范
- 提交规范：使用常规的 Git 提交信息
- 文档更新：保持 README 和其他文档的及时更新

## 贡献指南

欢迎贡献代码和改进项目！请遵循以下步骤：

1. Fork 项目
2. 创建新分支
3. 提交代码更改
4. 创建 Pull Request

## 许可证

本项目遵循 MIT 许可证。详情请查看 LICENSE 文件。