# yadmin **Repository Path**: yyq0325/yadmin ## Basic Information - **Project Name**: yadmin - **Description**: An admin framework by AI - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-04-01 - **Last Updated**: 2026-04-01 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # YAdmin - 基于 Laravel 的后台管理系统 > ⚠️ **特别声明**：本项目 99% 的代码由 AI 编写，是一个 AI 辅助开发的典型案例。我们欢迎社区成员使用 AI 工具继续完善这个项目！ ## 📖 项目介绍 YAdmin 是一个现代化的后台管理系统，基于 Laravel 13 + Inertia.js + Vue 3 + Element Plus 构建。系统采用前后端分离架构，提供完整的权限管理、菜单管理、系统配置和日志记录等功能。 ### ✨ 核心特性 - **🔐 完整的权限管理**：支持用户管理、角色管理、菜单权限分配 - **📊 系统监控**：系统日志记录、操作审计 - **⚙️ 灵活配置**：系统配置管理，支持多种配置类型 - **🎨 现代化 UI**：基于 Element Plus 的精美界面 - **📱 响应式设计**：支持多种屏幕尺寸 - **🚀 高性能**：基于 Inertia.js 的单页应用体验 ### 🛠️ 技术栈 - **后端**：PHP 8.4 + Laravel 13 - **前端**：Vue 3 + Inertia.js v2 + Element Plus - **样式**：Tailwind CSS v3 - **数据库**：MySQL 8.0+ - **构建工具**：Vite ## 🚀 快速开始 ### 环境要求 - PHP >= 8.4 - MySQL >= 8.0 - Node.js >= 18 - Composer ### 安装步骤 1. **克隆项目** ```bash git clone https://github.com/yyyq0325-ai/yadmin.git cd yadmin ``` 2. **安装 PHP 依赖** ```bash composer install ``` 3. **安装前端依赖** ```bash npm install ``` 4. **配置环境变量** ```bash cp .env.example .env php artisan key:generate ``` 编辑 `.env` 文件，配置数据库连接： ```env DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=yadmin DB_USERNAME=root DB_PASSWORD=your_password ``` 5. **运行数据库迁移和种子** ```bash php artisan migrate --seed ``` 6. **构建前端资源** ```bash npm run build ``` 7. **启动开发服务器** ```bash php artisan serve ``` 访问 `http://localhost:8000`，使用以下默认账号登录： - **邮箱**：admin@example.com - **密码**：admin123 ## 📁 项目结构 ``` yadmin/ ├── app/ │ ├── Http/ │ │ ├── Controllers/ # 控制器 │ │ │ └── Admin/ # 后台控制器 │ │ └── Middleware/ # 中间件 │ ├── Models/ # 模型 │ │ ├── BaseModel.php # 基础模型 │ │ ├── User.php # 用户模型 │ │ ├── Role.php # 角色模型 │ │ ├── Menu.php # 菜单模型 │ │ └── SystemLog.php # 系统日志模型 │ └── Traits/ # Trait │ └── HasFormattedTimestamps.php # 时间格式化 Trait ├── config/ # 配置文件 ├── database/ │ ├── migrations/ # 数据库迁移 │ └── seeders/ # 数据库种子 ├── resources/ │ ├── js/ # 前端代码 │ │ ├── components/ # 组件 │ │ ├── layouts/ # 布局 │ │ └── pages/ # 页面 │ └── views/ # 视图 ├── routes/ # 路由 └── tests/ # 测试 ``` ## 🔧 功能模块 ### 权限管理 - **用户管理**：创建、编辑、删除用户，分配角色 - **角色管理**：创建角色，分配菜单权限 - **菜单管理**：树形菜单管理，支持按钮权限 ### 系统管理 - **系统配置**：支持字符串、数字、布尔值、JSON 等多种类型 - **系统日志**：记录操作日志，支持查看和清空 ## 🤖 AI 开发说明 本项目是一个 AI 辅助开发的典型案例，99% 的代码由 AI 编写。我们鼓励社区成员： - 使用 AI 工具继续完善项目 - 提交 AI 生成的代码改进 - 分享 AI 开发经验 - 探索 AI 在软件开发中的应用 ### AI 工具推荐 - **代码生成**：GitHub Copilot、Cursor、Trae - **代码审查**：CodeRabbit、DeepCode - **文档生成**：Mintlify、ReadMe ## 🤝 贡献指南 我们欢迎所有形式的贡献，无论是新功能、Bug 修复还是文档改进。 ### 贡献步骤 1. Fork 本仓库 2. 创建你的特性分支 (`git checkout -b feature/AmazingFeature`) 3. 提交你的更改 (`git commit -m 'Add some AmazingFeature'`) 4. 推送到分支 (`git push origin feature/AmazingFeature`) 5. 打开一个 Pull Request ### 代码规范 - 遵循 PSR-12 代码规范 - 使用 PHP CS Fixer 进行代码格式化 - 编写清晰的注释和文档 ## 📝 开源协议 本项目基于 [MIT](LICENSE) 协议开源。 ## 👨‍💻 作者 - **邮箱**：279844657@qq.com - **GitHub**：[yyyq0325-ai](https://github.com/yyyq0325-ai) ## 🙏 致谢 感谢以下开源项目： - [Laravel](https://laravel.com/) - [Vue.js](https://vuejs.org/) - [Inertia.js](https://inertiajs.com/) - [Element Plus](https://element-plus.org/) - [Tailwind CSS](https://tailwindcss.com/) --- > 💡 **提示**：如果你使用 AI 工具改进了这个项目，请在提交信息中注明使用的 AI 工具，让我们一起探索 AI 辅助开发的未来！