feat(authorization): refactor role management to use RoleCode enum, update migrations, seeders, and tests

database/migrations/2026_07_28_000100_add_role_and_tenant_codes_to_users_table.php

@@ -1,5 +1,6 @@
 <?php
 
+use App\Domains\Authorization\Enums\RoleCode;
 use Illuminate\Database\Migrations\Migration;
 use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\DB;
@@ -13,21 +14,14 @@ return new class extends Migration
 
         DB::table('roles')->insertOrIgnore([
             [
-                'codigo' => 'admin',
+                'codigo' => RoleCode::Admin->value,
                 'nombre' => 'Administrador general',
                 'descripcion' => 'Administra la plataforma y todos sus tenants.',
                 'created_at' => $now,
                 'updated_at' => $now,
             ],
             [
-                'codigo' => 'tenant_admin',
-                'nombre' => 'Administrador del tenant',
-                'descripcion' => 'Administra la operación de su propio tenant.',
-                'created_at' => $now,
-                'updated_at' => $now,
-            ],
-            [
-                'codigo' => 'user',
+                'codigo' => RoleCode::User->value,
                 'nombre' => 'Usuario',
                 'descripcion' => 'Cliente final limitado a sus propios datos y operaciones.',
                 'created_at' => $now,
@@ -36,7 +30,7 @@ return new class extends Migration
         ]);
 
         Schema::table('users', function (Blueprint $table): void {
-            $table->string('rol_codigo')->default('user')->after('id');
+            $table->string('rol_codigo')->default(RoleCode::User->value)->after('id');
             $table->string('tenant_codigo')->nullable()->after('rol_codigo');
 
             $table->foreign('rol_codigo')

database/migrations/2026_07_31_000000_remove_tenant_admin_role.php

@@ -0,0 +1,35 @@
+<?php
+
+use App\Domains\Authorization\Enums\RoleCode;
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    private const REMOVED_ROLE_CODE = 'tenant_admin';
+
+    public function up(): void
+    {
+        DB::table('users')
+            ->where('rol_codigo', self::REMOVED_ROLE_CODE)
+            ->update([
+                'rol_codigo' => RoleCode::User->value,
+                'tenant_codigo' => null,
+            ]);
+
+        DB::table('roles')
+            ->where('codigo', self::REMOVED_ROLE_CODE)
+            ->delete();
+    }
+
+    public function down(): void
+    {
+        DB::table('roles')->insertOrIgnore([
+            'codigo' => self::REMOVED_ROLE_CODE,
+            'nombre' => 'Administrador del tenant',
+            'descripcion' => 'Administra la operación de su propio tenant.',
+            'created_at' => now(),
+            'updated_at' => now(),
+        ]);
+    }
+};

database/seeders/AuthorizationSeeder.php

@@ -2,6 +2,7 @@
 
 namespace Database\Seeders;
 
+use App\Domains\Authorization\Enums\RoleCode;
 use App\Domains\Authorization\Models\Permission;
 use App\Domains\Authorization\Models\Role;
 use Illuminate\Database\Seeder;
@@ -106,44 +107,17 @@ class AuthorizationSeeder extends Seeder
      * @var array<string, array{nombre: string, descripcion: string, permisos: list<string>}>
      */
     private const ROLES = [
-        'admin' => [
+        RoleCode::Admin->value => [
             'nombre' => 'Administrador general',
             'descripcion' => 'Administra la plataforma y todos sus tenants.',
             'permisos' => [],
         ],
-        'adminapp' => [
+        RoleCode::AdminApp->value => [
             'nombre' => 'Administrador de la aplicación',
             'descripcion' => 'Accede a los menús administrativos de la aplicación.',
             'permisos' => [],
         ],
-        'tenant_admin' => [
-            'nombre' => 'Administrador del tenant',
-            'descripcion' => 'Administra la operación de su propio tenant.',
-            'permisos' => [
-                'tenant.ver',
-                'tenant.editar',
-                'usuarios.ver',
-                'usuarios.gestionar',
-                'roles.ver',
-                'catalogo.ver',
-                'catalogo.gestionar',
-                'inventario.ver',
-                'inventario.ajustar',
-                'pedidos.ver',
-                'pedidos.gestionar',
-                'pedidos.cancelar',
-                'pagos.ver',
-                'pagos.gestionar',
-                'tickets.ver',
-                'tickets.gestionar',
-                'contenido.gestionar',
-                'integraciones.ver',
-                'integraciones.gestionar',
-                'reportes.ver',
-                'reportes.exportar',
-            ],
-        ],
-        'user' => [
+        RoleCode::User->value => [
             'nombre' => 'Usuario',
             'descripcion' => 'Cliente final limitado a sus propios datos y operaciones.',
             'permisos' => [],
@@ -168,7 +142,7 @@ class AuthorizationSeeder extends Seeder
                 ]
             );
 
-            $permissionCodes = $code === 'admin'
+            $permissionCodes = $code === RoleCode::Admin->value
                 ? array_keys(self::PERMISSIONS)
                 : $attributes['permisos'];
 

database/seeders/MenuSeeder.php

@@ -2,6 +2,7 @@
 
 namespace Database\Seeders;
 
+use App\Domains\Authorization\Enums\RoleCode;
 use App\Domains\Authorization\Models\Role;
 use App\Domains\Menu\Models\Menu;
 use App\Domains\Tenant\Models\Tenant;
@@ -140,11 +141,11 @@ class MenuSeeder extends Seeder
             ->pluck('code');
 
         Role::query()
-            ->whereIn('codigo', ['admin', 'adminapp'])
+            ->whereIn('codigo', [RoleCode::Admin->value, RoleCode::AdminApp->value])
             ->each(fn (Role $role) => $role->menus()->sync($allRoleMenuCodes));
 
         Role::query()
-            ->where('codigo', 'user')
+            ->where('codigo', RoleCode::User->value)
             ->each(fn (Role $role) => $role->menus()->sync($userMenuCodes));
 
         $tenants = Tenant::all();