08 Módulo de Departamentos y Estructura Organizacional 🏢 CRUD en Laravel - Sistema de Activos Fijos
Duración: 32 minDescripción
🎓 Lección 08: Módulo de Departamentos y Relaciones Uno a Muchos (1:N) en Laravel 13
Esta lección cubre la estructuración del módulo de departamentos y su vinculación jerárquica con las sucursales de la empresa mediante relaciones de uno a muchos (1:N) en Eloquent. A lo largo de la práctica se implementa el modelado en DBML con integridad referencial, la optimización de consultas con carga impaciente (Eager Loading), el sembrado determinista con factories y el perfeccionamiento de la interfaz administrativa paginada.
🚀 Pasos Clave con Timestamps
- 🏛️ Estructura Jerárquica y Relación Uno a Muchos (1:N) (⏱️ 00:00): Fundamentación de la subdivisión de sedes físicas en áreas operativas (sistemas, contabilidad, recursos humanos, almacén) mediante una relación 1:N donde una sucursal posee múltiples departamentos y cada departamento pertenece a una única sucursal.
- 💾 Persistencia de Parámetros Globales en Seeders (⏱️ 01:10): Configuración de DatabaseSeeder y AjusteSeeder para asignar la divisa en bolivianos (Bs), enlazar el archivo físico del logotipo corporativo en storage/app/public/logos/ y asegurar la restauración íntegra del sistema tras cada ejecución de php artisan migrate:fresh --seed.
- 🏭 Generación de Fábrica y Sembrador de Sucursales (⏱️ 02:40): Creación de SucursalFactory y SucursalSeeder para poblar de forma automática 10 sedes operativas con ubicaciones realistas para realizar pruebas de interfaz y filtrado.
- 🏗️ Creación de Modelo, Migración y Controlador de Recursos (⏱️ 03:30): Generación simultánea del modelo en singular Departamento, su migración relacional y el controlador correspondiente mediante el comando php artisan make:model departamento -mcr.
- 📐 Modelado Entidad-Relación en DBML (⏱️ 04:15): Documentación en diagrama.dbml de la clave primaria id, la clave foránea sucursal_id, nombre, descripcion anulable y el enum estado (activo/inactivo), visualizando la cardinalidad relacional antes de tocar la base de datos.
- 🗄️ Definición de Clave Foránea e Integridad Referencial en Cascada (⏱️ 05:30): Configuración en la migración de foreignId('sucursal_id')->constrained('sucursals')->onDelete('cascade'), verificando el nombre plural exacto de la tabla padre y ejecutando php artisan migrate para actualizar MySQL.
- 🌱 Sembrado Masivo de 50 Departamentos Relacionados (⏱️ 06:40): Implementación de DepartamentoFactory y DepartamentoSeeder vinculados a las sucursales existentes para generar 50 departamentos realistas (47 activos y 3 inactivos), garantizando entornos de desarrollo listos para pruebas de carga.
- 🛣️ Enrutamiento Web del Módulo y Protección de Sesión (⏱️ 08:00): Registro de las siete rutas de recursos bajo el prefijo /admin/departamentos en routes/web.php, asociadas a DepartamentoController y protegidas por el middleware auth.
- 📂 Estructuración de Vistas Blade y Menú Lateral (⏱️ 09:10): Creación del directorio resources/views/admin/departamentos/ con las plantillas index, create, show y edit, incorporando el ítem de navegación con icono alusivo en la barra lateral.
- 🔗 Relaciones Eloquent y Prevención del Problema N+1 (⏱️ 11:00): Definición de los métodos hasMany() en el modelo Sucursal y belongsTo() en Departamento, incorporando la carga impaciente con Departamento::with('sucursal') en el controlador para resolver la relación eficientemente.
- 📝 Operaciones CRUD y Selección de Sede Padre (⏱️ 13:00): Implementación del formulario con un <select> que lista las sucursales disponibles, almacenando únicamente el identificador foráneo sucursal_id y emitiendo notificaciones SweetAlert2 tras guardar.
- ⚡ Optimización de UX: Ordenamiento Descendente y Paginación (⏱️ 15:30): Ajuste de las consultas en los controladores para ordenar de forma descendente (los registros más recientes al inicio de la tabla) y corrección del renderizado CSS de la paginación de 10 en 10 elementos.
🛠️ Comandos y Rutas Principales
| Componente / Acción | Comando Artisan / Sintaxis de Ruta | Archivo / Controlador | Propósito Técnico |
|---|---|---|---|
| Estructura Departamentos | php artisan make:model departamento -mcr | Terminal / Artisan | Crear modelo Departamento, migración y controlador RESTful |
| Migración Relacional | php artisan migrate | database/migrations/..._create_departamentos_table.php | Crear tabla departamentos con clave foránea vinculada a sucursals |
| Población en Cascada | php artisan migrate:fresh --seed | database/seeders/DatabaseSeeder.php | Restablecer base de datos y sembrar roles, ajustes, 10 sucursales y 50 departamentos |
| Listado Principal | GET /admin/departamentos | DepartamentoController@index | Mostrar departamentos con nombre de sucursal asociada, tarjetas KPI y buscador |
| Formulario de Registro | GET /admin/departamentos/create | DepartamentoController@create | Cargar formulario inyectando la colección de sucursales para el select |
| Guardar Departamento | POST /admin/departamentos | DepartamentoController@store | Validar campos, persistir sucursal_id y disparar alerta SweetAlert2 |
| Detalle de Área | GET /admin/departamentos/{id} | DepartamentoController@show | Consultar información detallada del departamento y su sede padre |
| Editar Departamento | GET /admin/departamentos/{id}/edit | DepartamentoController@edit | Abrir formulario de modificación con sucursal seleccionada |
| Actualizar Registro | PUT /admin/departamentos/{id} | DepartamentoController@update | Modificar sede, nombre, descripción o conmutar estado activo/inactivo |
| Baja de Registro | DELETE /admin/departamentos/{id} | DepartamentoController@destroy | Eliminar el departamento de la base de datos bajo confirmación modal |
🔒 Buenas Prácticas y Seguridad
- 🔗 Integridad Referencial con Tabla Pluralizada: Al configurar claves foráneas manuales en Laravel, especifica de forma explícita el nombre real de la tabla padre cuando no siga el estándar inglés plural estricto (constrained('sucursals')), previniendo fallos de migración por tablas inexistentes como sucursales.
- ⚡ Eliminación del Problema de Consultas N+1 (Eager Loading): Utiliza siempre Departamento::with('sucursal')->paginate(10) en el método index en lugar de resolver la relación directamente en la vista Blade ($departamento->sucursal->nombre); esto reduce decenas de consultas repetitivas a solo dos llamadas SQL optimizadas.
- ⚠️ Manejo Controlado de Eliminación en Cascada: El uso de onDelete('cascade') garantiza la limpieza de llaves huérfanas al suprimir una sucursal, pero en entornos de producción con activos asignados debe evaluarse el bloqueo previo (restrict) o el borrado lógico (soft deletes) para no perder el historial de ubicaciones.
- 👁️ Priorización Cronológica en Tablas Administrativas (UX): Ordenar los listados de forma descendente (orderBy('id', 'desc') o latest()) permite a los operadores comprobar inmediatamente la creación o actualización de un registro en la primera página sin recurrir a la paginación final.