hex-digital/admin-module

为我们的Laravel项目提供核心管理功能的模块。


README

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads

本模块为我们Laravel项目提供了核心管理功能。本模块会自动处理安装和配置Filament、管理管理员以及管理管理员角色和权限。

安装

要开始使用管理模块,您可以通过composer安装该包

composer require hex-digital/admin-module

接下来,您需要发布模块及其依赖项的配置文件、迁移和资源。为了简化这一过程,模块附带了一个安装命令

php artisan admin-module:install

每次您升级模块或Filament时,都需要运行admim:modulefilament:upgrade命令。我们建议将其添加到composer.json的post-update-cmd中

"post-update-cmd": [
    // ...
    "@php artisan filament:upgrade",
    "@php artisan admin-module:publish",
],

现在,您应该运行迁移并同步权限

php artisan migrate
php artisan permission:sync

最后,您可以使用以下命令创建新的管理员账户

php artisan make:filament-user

访问您的管理员面板/admin进行登录,然后您就可以开始构建了。

用法

模型与资源

管理模块附带了一个用于认证的Admin模型。您可以通过设置admin-module.admins.model配置来覆盖此模型。

在底层,我们使用Spatie Roles and Permissions包来授权管理员。管理模块提供了一个用于管理管理员和角色的资源。

您可以通过编辑配置来自定义这些模型/资源。

权限

管理模块提供了一个permission:sync命令,允许您同步权限,然后将其分配给角色。默认情况下,该模块提供了管理管理员和角色的权限。但是,您可以将自己的权限添加到admin-module.permissions配置中。

测试

composer test

变更日志

请参阅CHANGELOG了解最近更改的详细信息。

贡献

请参阅CONTRIBUTING了解详细信息。

安全漏洞

如果您发现安全漏洞,请发送电子邮件至dev@hexdigital.com。所有安全漏洞都将得到及时处理。

致谢

许可

MIT许可(MIT)。请参阅许可文件获取更多信息。