===================================================================
 ALIGANT ERP V5 - REDISEÑO ROLES/PERMISOS + USUARIOS CON RUT
===================================================================
- Permisos AUTO-generados desde config/permisos.php (no se editan slugs).
- Roles: matriz de módulos x acciones (Ver, Crear, Editar, Eliminar, Exportar).
  Al guardar, los permisos internos se generan/sincronizan solos.
- Permisos: ahora es un catálogo de SOLO LECTURA.
- Usuarios: + RUT con validación de DV, contraseña/confirmar,
  sucursales múltiples, rol y estado activo/inactivo.

-------------------------------------------------------------------
 1) DÓNDE PEGA CADA ARCHIVO (copiar sobre el proyecto, respetando rutas)
   Raíz:  C:\xampp2\htdocs\aligant_erp_v5\
-------------------------------------------------------------------
NUEVOS:
  config\permisos.php
  app\Support\Permisos.php
  app\Support\Rut.php                         (si ya lo tenías, es idéntico)
  app\Rules\Rut.php                           (si ya lo tenías, es idéntico)
  database\migrations\2025_03_02_000001_add_rut_to_users_table.php
  resources\views\partials\rut.blade.php      (si ya lo tenías, es idéntico)

REEMPLAZAN:
  routes\web.php                              (permisos queda solo como índice)
  app\Models\User.php                         (agrega 'rut' a fillable)
  app\Http\Controllers\RoleController.php
  app\Http\Controllers\PermissionController.php
  app\Http\Controllers\UserController.php
  app\Http\Requests\RoleRequest.php
  app\Http\Requests\UserRequest.php
  resources\views\roles\_form.blade.php
  resources\views\roles\create.blade.php
  resources\views\roles\edit.blade.php
  resources\views\permisos\index.blade.php
  resources\views\usuarios\_form.blade.php
  resources\views\usuarios\index.blade.php
  resources\views\usuarios\create.blade.php
  resources\views\usuarios\edit.blade.php
  resources\views\usuarios\show.blade.php

-------------------------------------------------------------------
 2) COMANDOS PARA QUE SURJAN LOS CAMBIOS
-------------------------------------------------------------------
  php artisan migrate          (agrega la columna 'rut' a users)
  php artisan optimize:clear   (limpia config, rutas y vistas)
  -> y recarga con Ctrl+F5

-------------------------------------------------------------------
 3) CÓMO FUNCIONA AHORA
-------------------------------------------------------------------
  - Para AGREGAR un módulo o una acción al sistema de permisos, edita
    SOLO config\permisos.php. La matriz de Roles y el catálogo de
    Permisos se actualizan solos (y los slugs modulo.accion se crean
    automáticamente al guardar un rol o al abrir Permisos).
  - En Roles, marca/desmarca las casillas por módulo y guarda. Listo.
  - "Exportar" aparece como casilla (uso futuro); ya genera el permiso
    modulo.exportar si lo marcas.

-------------------------------------------------------------------
 4) NOTAS
-------------------------------------------------------------------
  - El RUT del usuario es obligatorio y se valida (DV) en front y back;
    se guarda normalizado (12345678-5) y se muestra 12.345.678-5.
  - La columna users.rut es nullable+unique: los usuarios que ya existían
    quedan con RUT vacío; la primera vez que edites uno, deberás
    ingresarle un RUT válido (incluido tu usuario administrador).
  - Ya NO se crean permisos con formularios de slug: la ruta de crear/editar
    permisos fue retirada; Permisos quedó como catálogo de lectura.

===================================================================
