项目介绍#

🎯 项目概述#

XinAdmin 是一个企业级 PHP 全栈快速开发框架，基于 Laravel 12 和 React 19 开发的现代化后台管理系统。项目采用 前后端完全分离 架构，遵循 MIT 开源协议，永久免费开源，无需授权即可商业使用。

✨ 项目特点#

🚀 现代化技术栈#

• 后端: PHP 8.2 + Laravel 12 + MySQL + Redis
• 前端: React 19 + TypeScript + Vite 7 + Ant Design 5
• 认证: Laravel Sanctum Token 认证
• 状态管理: Zustand 5（切片架构）
• 路由: React Router 7（支持动态路由）
• 样式: TailwindCSS 4
• 国际化: i18next + Laravel 多语言支持

🏗️ 优秀的架构设计#

• 创新的注解路由系统：类似 Spring Boot 风格的注解路由 (AnnoRoute)，使 PHP 开发更加优雅
• 三层架构模式：Controller-Service-Repository 清晰的分层设计
• CRUD 高度封装：BaseController、BaseRepository、BaseService 提供通用 CRUD 能力
• 前后端分离：遵循 RESTful 规范，API 设计规范统一

👑 强大的权限控制系统#

• 双端认证：同时支持管理员端和普通用户端
• 角色权限管理：灵活的角色-权限-用户关联关系
• 动态菜单：后端配置自动生成前端菜单树
• 按钮级权限：精细化到页面按钮的权限控制
• 权限指令：内置 AuthButton、AuthRoute 等权限组件

📁 完整的文件管理系统#

• 多存储支持：支持本地存储、AWS S3、阿里云 OSS
• 丰富的文件操作：上传、下载、复制、移动、重命名、删除等
• 智能回收站：软删除、恢复、彻底删除功能
• 文件分组：灵活的文件夹管理
• 类型验证：图片、视频、音频、文档、压缩包等多种类型支持
• 批量操作：支持批量复制、移动、删除等操作

📚 数据字典系统#

• 灵活的字典配置：支持创建业务所需的任意字典
• 字典项管理：丰富的字典项展示类型（标签、文字、徽标等）
• 状态支持：default、success、error、processing、warning 多种状态
• 开箱即用：内置常用字典配置

⚙️ 系统配置管理#

• 分组配置：按功能模块分组管理系统配置
• 动态表单：支持多种表单类型配置
• 变更监听：Eloquent Observer 自动监听配置变更

🎨 丰富的主题配置#

• 多种布局方式：侧边栏、顶部、混合布局三选一
• 灵活的主题定制：基于 Ant Design 的丰富主题配置
• 响应式设计：完美支持桌面端和移动端
• 深浅主题切换：内置亮色和暗色主题

🌍 完善的国际化支持#

• 多语言支持：后端 Laravel 多语言 + 前端 i18next
• 全覆盖本地化：所有内置功能均实现国际化
• 语言自适应：自动识别用户语言偏好

📱 优秀的开发体验#

• 开箱即用的组件：XinTable、AuthButton、AuthRoute 等
• 完整的代码示例：丰富的示例页面和组件用法
• 清晰的代码结构：语义化的目录命名和代码组织
• 详细的注释文档：代码注释覆盖核心功能

🎁 内置功能#

功能模块	说明
仪表盘	基于 AntV 的开箱即用仪表盘方案，提供演示页面
示例组件	图标、表格、列表、表单等常用组件的完整示例
前台会员	前台会员权限管理、分组管理、列表和余额记录等
管理员	管理员分组、权限、列表和个人信息设置
系统设置	服务器参数快速设置表单，支持自定义分组和表单类型
文件管理	完整的文件上传解决方案，支持多存储、文件夹、分组等
字典管理	系统常用固定数据维护管理
部门管理	树形部门结构管理，支持公司、部门、岗位三种类型
角色管理	角色权限管理，为不同的角色分配权限
登录日志	自动记录用户登录信息（IP、地点、浏览器、操作系统等）

🎯 适用场景#

XinAdmin 特别适合以下项目场景：

• ✅ 企业级后台管理系统 - 权限控制完整，功能模块丰富
• ✅ SaaS 多租户系统 - 支持双端认证，灵活的权限配置
• ✅ 电商运营平台 - 完整的文件管理、数据字典等模块
• ✅ 工作流系统 - 树形部门结构、权限细粒度控制
• ✅ 大数据仪表盘 - 内置图表组件、主题定制
• ✅ 快速开发需求 - CRUD 完全封装，开发效率高

🌟 为什么选择 XinAdmin#

相比其他框架的优势#

1. 编码效率高 - CRUD 自动生成，减少 70% 的重复代码
2. 学习曲线平缓 - 基于业界流行的 Laravel 和 React，生态成熟
3. 扩展性强 - 模块化设计，易于二次开发
4. 开源免费 - 永久免费商用
5. 社区活跃 - 官方积极维护，问题及时解决
6. 文档完整 - 代码注释详细，文档教程齐全

🤝 社区支持#

遇到问题？获取帮助的途径：

• 📖 官方文档: https://xinadmin.cn/

• 💬 GitHub Discussions: https://github.com/xin-admin/xin-admin/discussions

• 🐛 提交 Issue: https://github.com/xin-admin/xin-admin/issues

• 👥 QQ 官方群: XinAdmin 官方社区

准备好了吗？ 让我们开始使用 XinAdmin 构建您的下一个项目吧！👉 快速开始 | 开源协议