ricardocrem20/modu

Modularizacin

dev-main 2022-02-19 01:39 UTC

MIT

• Ricardo Garcia

README

La modularización cuenta con la siguiente estructura

Módulos

Son los módulos principales del sistema.

Áreas

Las áreas hacen parte de los módulos, y son esas partes más pequeñas en la estructura del sistema.

Roles

Los roles son asignados a los usuarios, y tienen permisos asignados a los módulos.

Tipo de roles

Los roles se pueden categorizar por tipos, de acuerdo a su necesidad.

Permisos

Los permisos son asignados a los usuarios, de acuerdo a las áreas que desea asignar.

Usuarios

Los usuarios padrean tener asignados roles por tipo y módulos, y de acuerdo a los módulos permisos a las áreas.

Instalación

Este paquete necesita también la instalación de Laravel Passport.

composer require ricardocrem20/modu

Configuración

1. Ve a la el directorio 'app/Providers/AuthServiceProvider.php' y en la función 'boot' defina el siguiente 'Gate'

use App\Models\User;

public function boot()
{
    $this->registerPolicies();

    if (!$this->app->routesAreCached()) {
        Passport::routes();
    }
    
    Gate::define('tieneAcceso', function ($user, $permiso) {
        return $user->tienePermiso($permiso, $user->id);
    });
}

1. Ve a la siguiente migración 'database/migrations/########_create_users_table.php' y debe quedar así:

public function up()
{
    Schema::create('users', function (Blueprint $table) {
        $table->id();
        $table->enum('tipo_identificacion', ['CC',  'TI'])->nullable();
        $table->string('identificacion', 15)->unique()->nullable();
        $table->string('nombre', 90);
        $table->string('nombres', 45)->nullable();
        $table->string('apellidos', 45)->nullable();
        $table->string('email', 60)->unique();
        $table->timestamp('email_verified_at')->nullable();
        $table->string('password');
        $table->string('foto_perfil')
            ->default('http://modu.test/storage/img/perfiles/default.png');
        $table->rememberToken();
        $table->timestamps();
    });
}

1. En el siguiente directorio 'app/Models/User.php' agrega

use Ricardo\Modu\Traits\UserTrait;

class User extends Authenticatable
{
  use HasApiTokens, HasFactory, Notifiable, UserTrait;
}

1. Ejecute las migraciones con sus siembras

php artisan migrate --seed
o
php artisan migrate:fres --seed

En la base de datos, debe de haberse creado datos, y un usuario que es el siguiente

user: [e-mail]
password: password 

1. Ejecute el Passport Laravel y publique el storage

php artisan passport:install

php artisan storage:link

Si te jala algún error no olvides ejecutar

php artisan optimize

Implementación

En cada función del controlador que necesites darle algún permiso agregue lo siguiente

Gate::authorize('tieneAcceso', 'slug_del_permiso');

Las rutas deben de estar dentro de

Route::group(['middleware' => 'auth:api'], function() {
  // Routes
}

Licencia

La licencia del MIT (MIT). Consulte Archivo de licencia para obtener más información.