08 Módulo de Departamentos y Estructura Organizacional 🏢 CRUD en Laravel - Sistema de Activos Fijos

Duración: 32 min
Módulo: Parámetros de Empresa y Estructura Organizacional Lección 3 de 3

¡Contenido Exclusivo!

Adquiere este curso para tener acceso inmediato a esta y a **todas las lecciones Premium**.

Inscribirse Ahora por $10.00 Acceso instantáneo de por vida y código fuente incluido.

Descripció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ónComando Artisan / Sintaxis de RutaArchivo / ControladorPropósito Técnico
Estructura Departamentosphp artisan make:model departamento -mcrTerminal / ArtisanCrear modelo Departamento, migración y controlador RESTful
Migración Relacionalphp artisan migratedatabase/migrations/..._create_departamentos_table.phpCrear tabla departamentos con clave foránea vinculada a sucursals
Población en Cascadaphp artisan migrate:fresh --seeddatabase/seeders/DatabaseSeeder.phpRestablecer base de datos y sembrar roles, ajustes, 10 sucursales y 50 departamentos
Listado PrincipalGET /admin/departamentosDepartamentoController@indexMostrar departamentos con nombre de sucursal asociada, tarjetas KPI y buscador
Formulario de RegistroGET /admin/departamentos/createDepartamentoController@createCargar formulario inyectando la colección de sucursales para el select
Guardar DepartamentoPOST /admin/departamentosDepartamentoController@storeValidar campos, persistir sucursal_id y disparar alerta SweetAlert2
Detalle de ÁreaGET /admin/departamentos/{id}DepartamentoController@showConsultar información detallada del departamento y su sede padre
Editar DepartamentoGET /admin/departamentos/{id}/editDepartamentoController@editAbrir formulario de modificación con sucursal seleccionada
Actualizar RegistroPUT /admin/departamentos/{id}DepartamentoController@updateModificar sede, nombre, descripción o conmutar estado activo/inactivo
Baja de RegistroDELETE /admin/departamentos/{id}DepartamentoController@destroyEliminar 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.