Comandos Interactivos

Comandos Interactivos

Laravel RoutingKit proporciona comandos de consola interactivos que hacen que la gestión de rutas sea intuitiva y eficiente.

Comando Principal: rk:route

Sintaxis

php artisan rk:route
# o su abreviación
php artisan rk:ro

Proceso Interactivo

Al ejecutar el comando, se te guiará paso a paso:

1. 🎯 Identificador de Ruta: Nombre único para la ruta
2. 🔐 Permisos: Asignar permisos específicos
3. 🌐 URL: Definir la URL de acceso
4. ⚡ Método HTTP: GET, POST, PUT, DELETE, etc.
5. 🎮 Controlador: Controlador Livewire o tradicional
6. 👥 Roles: Asignar roles que pueden acceder
7. 📋 Items: Elementos adicionales (opcional)

Ejemplo de Flujo Interactivo

$ php artisan rk:route

 ┌ Identificador de la ruta ──────────────────────────────┐
 │ dashboard_central                                       │
 └─────────────────────────────────────────────────────────┘

 ┌ Permiso de acceso ─────────────────────────────────────┐
 │ acceder-dashboard_central                               │
 └─────────────────────────────────────────────────────────┘

 ┌ URL de la ruta ────────────────────────────────────────┐
 │ /dashboard_central                                      │
 └─────────────────────────────────────────────────────────┘

 ┌ Método HTTP ───────────────────────────────────────────┐
 │ › GET                                                   │
 │   POST                                                  │
 │   PUT                                                   │
 │   DELETE                                                │
 └─────────────────────────────────────────────────────────┘

 ┌ Controlador ───────────────────────────────────────────┐
 │ App\Livewire\Central\Dashboard\Home\Home                │
 └─────────────────────────────────────────────────────────┘

 ┌ Roles (separados por coma) ────────────────────────────┐
 │ admin_general                                           │
 └─────────────────────────────────────────────────────────┘

✅ Ruta creada exitosamente!

Estructura de Ruta Generada

El comando genera una estructura como esta:

RkRoute::make('dashboard_central')
    ->setAccessPermission('acceder-dashboard_central')
    ->setUrl('/dashboard_central')
    ->setUrlMethod('get')
    ->setUrlController('App\Livewire\Central\Dashboard\Home\Home')
    ->setRoles(['admin_general'])
    ->setItems([])
    ->setEndBlock('dashboard_central'),

Estructura Extensa

Esta estructura puede parecer extensa comparada con Laravel nativo, pero está diseñada para permitir interacción desde consola y gestión automática de permisos y roles.

Otros Comandos Disponibles

Ver Ayuda

php artisan rk:route --help
php artisan rk:ro --help

Listar Rutas Existentes

# Ver todas las rutas registradas
php artisan route:list --name=rk

Ventajas del Sistema Interactivo

✅ Validación Automática

• Verifica que los permisos existan
• Valida la sintaxis del controlador
• Comprueba que los roles estén definidos

✅ Consistencia

• Nomenclatura estandarizada
• Estructura uniforme
• Documentación automática

✅ Productividad

• Menos errores manuales
• Creación más rápida
• Reutilización de patrones

Personalización del Flujo

Puedes modificar el comportamiento del comando editando la configuración en config/routing-kit.php:

config/routing-kit.php

return [
    'default_method' => 'GET',
    'default_middleware' => ['web', 'auth'],
    'default_namespace' => 'App\\Http\\Controllers\\',
    // más configuraciones...
];

Próximos Pasos

• 🎯 Aprende sobre permisos y roles
• ⚙️ Configura estructuras de archivos
• 💡 Ve ejemplos prácticos