README

面向 Laravel 12 的后台开发 Composer 包，提供常用管理功能、资源生成命令和 Vue 页面模板，帮助开发者搭建与扩展业务后台。

本包需要集成到配套的 Laravel 应用中使用；页面模板依赖宿主项目的前端组件与构建配置，不是可独立部署的完整管理站点。

主要功能

后台列表、表单、详情及常用操作组件。
控制器、模型、页面等资源的脚手架生成。
插件骨架、业务页面及配置管理支持。
用户、角色、菜单、附件与操作日志等基础能力。
配套页面模板及移动端样式支持。

环境要求

项目	要求
PHP	8.2 及以上，兼容 PHP 8.x
Laravel	12.x
Composer	2.x
前端	使用页面模板时，需配套 Vue 3 前端及宿主组件

数据库、缓存、认证及前端依赖由宿主应用统一配置，具体要求以宿主项目为准。

安装与使用

在已配置本包可用包源的宿主应用根目录执行：

composer require dabashan/dbs-admin

需要配套界面资源时，在具备 web/ 前端结构的宿主项目中发布：

php artisan vendor:publish --tag=dbs-admin-ui

创建业务资源示例：

php artisan make:admin Category --migration

生成后，请根据业务需要完善字段与校验规则，并核对路由、权限和数据库迁移，再执行：

php artisan migrate

页面资源生成或更新后，按宿主项目的说明完成前端构建。

常用命令

命令	用途
`make:admin`	生成后台业务资源
`make:plugin`	创建插件骨架
`make:plugin-page`	生成插件业务页面
`plugin:package`	打包插件
`plugin:sync-manifest`	同步插件配置

使用 php artisan help <命令> 查看参数，例如：

php artisan help make:admin

目录结构

dbs-admin/
├── src/                 # PHP 源码
│   ├── Commands/        # 脚手架命令
│   ├── Controllers/     # 控制器与管理功能
│   ├── Form/            # 表单组件
│   ├── Grid/            # 列表组件
│   ├── Models/          # 数据模型
│   ├── Providers/       # 服务提供者
│   ├── Services/        # 应用服务
│   ├── Show/            # 详情组件
│   └── Traits/          # 公共能力
├── stubs/               # 代码与页面模板
├── tests/               # 测试与验证
├── composer.json        # 包信息与依赖声明
└── README.md            # 项目说明

反馈

使用问题或改进建议可通过 GitHub Issues 提交。请提供版本、复现步骤与必要的错误信息，并移除账号、密钥及业务数据。

许可证

本包在 composer.json 中声明采用 Apache-2.0 许可证。第三方依赖与配套项目遵循各自的许可证。

dabashan / dbs-admin

Package info

Security

Statistics