permission package, remove user-session migration

Author: AzGasim

packages/full/composer.json

@@ -64,6 +64,7 @@
         "moox/notifications": "dev-main",
         "moox/packagist": "dev-main",
         "moox/page": "dev-main",
+        "moox/permission": "dev-main",
         "moox/post": "dev-main",
         "moox/press": "dev-main",
         "moox/press-trainings": "dev-main",

packages/permission/README.md

@@ -2,152 +2,32 @@
 
 # Moox Permission
 
-This is my package permission
+Moox Permission is a thin layer around [Filament Shield](https://github.com/bezhanSalleh/filament-shield). It pulls in Shield via Composer and provides the shared `DefaultPolicy` used across Moox packages.
 
-## Quick Installation
-
-These two commmands are all you need to install the package:
+## Installation
 
 ```bash
 composer require moox/permission
-php artisan mooxpermission:install
+php artisan moox:install
 ```
 
-Curious what the install command does? See manual installation below.
-
-## What it does
-
-<!--whatdoes-->
-
-Here are some things missing, like an overview with screenshots about this package, or simply a link to the package's docs.
-
-<!--/whatdoes-->
-
-## Manual Installation
-
-Instead of using the install-command `php artisan mooxpermission:install` you are able to install this package manually step by step:
-
-```bash
-// Publish and run the migrations:
-php artisan vendor:publish --provider="Moox\Permission\PermissionServiceProvider" --tag="moox-permission-migrations"
-php artisan migrate
-
-// Publish the config file with:
-php artisan vendor:publish --provider="Moox\Permission\PermissionServiceProvider" --tag="moox-permission-config"
-```
-
-## Using the Default Policy
-
-The default policy handles all defaults for Moox Resources in Filament:
-
-```php
-<?php
-
-namespace Moox\Permission\Policies;
-
-use App\Models\User;
-
-class DefaultPolicy
-{
-    public function viewAll(User $user)
-    {
-        return $user->hasPermissionTo('view all');
-    }
-
-    public function editAll(User $user)
-    {
-        return $user->hasPermissionTo('edit all');
-    }
-
-    public function deleteAll(User $user)
-    {
-        return $user->hasPermissionTo('delete all');
-    }
+The installer publishes Shield/Spatie configuration, runs the permission migrations, and registers `FilamentShieldPlugin` in your panel (via `composer.json` → `extra.moox.install.plugins`).
 
-    public function create(User $user)
-    {
-        return $user->hasPermissionTo('create');
-    }
-
-    public function viewOwn(User $user, $model)
-    {
-        return $user->hasPermissionTo('view own') && $model->user_id === $user->id;
-    }
-
-    public function editOwn(User $user, $model)
-    {
-        return $user->hasPermissionTo('edit own') && $model->user_id === $user->id;
-    }
-
-    public function deleteOwn(User $user, $model)
-    {
-        return $user->hasPermissionTo('delete own') && $model->user_id === $user->id;
-    }
-
-    public function emptyTrash(User $user)
-    {
-        return $user->hasPermissionTo('empty trash');
-    }
-
-    public function changeSettings(User $user)
-    {
-        return $user->hasPermissionTo('change settings');
-    }
-}
-```
-
-The default policy is used by most Moox packages.
-
-If you use Moox Builder to create a package, the default policy works out of the box and all default permissions are pre-configured to sane defaults.
-
-## Extending the Default Policy
-
-If you need to create a policy for a specific resource, you can extend the DefaultPolicy and override any methods where custom logic is required.
-
-```php
-use Moox\Permission\Policies\DefaultPolicy;
-
-class ItemPolicy extends DefaultPolicy
-{
-    // Custom logic for editing own items
-    public function editOwn(User $user, $item)
-    {
-        // Maybe add additional checks here
-        return parent::editOwn($user, $item);
-    }
-
-    // Additional custom methods if needed
-}
-
-```
-
-You then need to register the policy in the published Moox Core config (/config/core.php):
-
-```php
-return [
-    'packages' => [
-        'audit' => [
-            'package' => 'Moox Audit',
-            'models' => [
-                'Audit' => [
-                    'policy' => \Moox\Audit\Policies\AuditPolicy::class,
-                ],
-            ],
-        ],
-        // more packages
-```
+Shield-specific setup (`shield:generate`, roles, super admin) stays in Shield itself — not in this package.
 
-## Changelog
+## Optional permissions
 
-Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
+Moox policies follow the same pattern as `HasRolesTrait` in `moox/user`:
 
-## Security Vulnerabilities
+- Shield not installed / tables missing → allow
+- Permission not generated yet → allow
+- Permission exists → check `can()`
 
-Please review [our security policy](https://github.com/mooxphp/moox/security/policy) on how to report security vulnerabilities.
+That way resources stay usable after install until you explicitly generate and assign permissions.
 
-## Credits
+## Default Policy
 
--   [All Contributors](../../contributors)
+`Moox\Permission\Policies\DefaultPolicy` is the shared fallback for Moox resources when no dedicated policy exists.
 
 ## License
 

packages/permission/composer.json

@@ -1,11 +1,12 @@
 {
     "name": "moox/permission",
-    "description": "This is my package permission",
+    "description": "Moox layer for Filament Shield and shared authorization defaults.",
     "keywords": [
         "Laravel",
         "Filament",
-        "Filament plugin",
-        "Laravel package"
+        "permissions",
+        "roles",
+        "shield"
     ],
     "homepage": "https://moox.org/",
     "license": "MIT",
@@ -18,7 +19,7 @@
     ],
     "require": {
         "moox/core": "dev-main",
-        "spatie/laravel-permission": "^7.0"
+        "bezhansalleh/filament-shield": "^4.0"
     },
     "require-dev": {
         "moox/devtools": "dev-main"
@@ -35,9 +36,14 @@
             ]
         },
         "moox": {
-            "stability": "stable"
+            "stability": "stable",
+            "install": {
+                "plugins": [
+                    "BezhanSalleh\\FilamentShield\\FilamentShieldPlugin"
+                ]
+            }
         }
     },
     "minimum-stability": "stable",
     "prefer-stable": true
-}
+}