07 Módulo de Sucursales y Sedes 🏢 CRUD Completo en Laravel - Sistema de Activos Fijos

Duración: 24 min
Módulo: Parámetros de Empresa y Estructura Organizacional Lección 2 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 07: Módulo de Sucursales y Gestión de Ubicaciones Físicas en Laravel

Esta lección cubre la construcción del módulo de sucursales para descentralizar el inventario de activos fijos en sedes, plantas operativas y agencias. El desarrollo integra el modelado en base de datos, el diseño de rutas y controladores de recursos, la dinamización del encabezado institucional y la gestión completa del CRUD con interfaz adaptativa en Adminator y SweetAlert2.

🚀 Pasos Clave con Timestamps

  • 🏢 Justificación y Alcance del Módulo de Sucursales (⏱️ 00:00): Fundamentación de la necesidad de estructurar las ubicaciones físicas de una empresa real, permitiendo registrar casas matrices, agencias departamentales, plantas y almacenes donde se distribuirán los activos fijos.
  • 🏗️ Generación de Modelo, Migración y Controlador de Recursos (⏱️ 01:25): Creación simultánea del modelo en singular sucursal, su archivo de migración y el controlador de recursos mediante el comando Artisan php artisan make:model sucursal -mcr.
  • 📐 Esquematización en DBML y Reglas de la Tabla sucursals (⏱️ 02:10): Definición del esquema en el archivo diagrama.dbml estableciendo la clave primaria id, el campo nombre con restricción de unicidad (unique) para evitar nombres duplicados, direccion y telefono anulables, y el atributo estado inicializado por defecto en 'activo'.
  • 🗄️ Migración de Esquema a MySQL (⏱️ 03:40): Ejecución de php artisan migrate para compilar e insertar la tabla sucursals dentro de la base de datos control_activos_fijos.
  • 🧭 Actualización del Menú Lateral en Adminator (⏱️ 04:30): Incorporación del ítem de navegación "Sucursales" dentro del archivo sidebar.blade.php bajo la sección de roles y permisos, asignándole un icono arquitectónico representativo mediante la asistencia de Antigravity.
  • 🛣️ Enrutamiento del CRUD en routes/web.php (⏱️ 05:45): Declaración del enrutamiento web completo asociado a SucursalController (index, create, store, show, edit, update y destroy), garantizando la protección perimetral con el middleware de autenticación.
  • 📁 Estructuración de Vistas Modulares en Blade (⏱️ 07:15): Creación del directorio resources/views/admin/sucursales/ con sus cuatro archivos base: index.blade.php, create.blade.php, show.blade.php y edit.blade.php.
  • 🖼️ Dinamización del Logo y Nombre de Empresa en el Layout (⏱️ 09:20): Configuración del encabezado general para sustituir la marca fija por los datos del modelo Ajuste, renderizando de forma condicional el logotipo corporativo almacenado y el nombre de la empresa.
  • 📊 Construcción del Listado Principal y Métricas (index) (⏱️ 11:30): Ensamblado de la vista principal provista de tarjetas de indicadores clave (total de sedes, activas e inactivas), barra de búsqueda en tiempo real y tabla paginada de 10 en 10 registros.
  • 📝 Registro de Sedes y Feedback con SweetAlert2 (create / store) (⏱️ 13:10): Implementación del formulario de alta y almacenamiento por instanciación en el controlador, verificando el guardado de registros como "Casa Matriz" con notificaciones emergentes de éxito.
  • 🔄 Consulta de Detalles y Actualización de Estado (show / edit / update) (⏱️ 14:45): Visualización de parámetros individuales y actualización reactiva de la sede en base de datos, incluyendo la conmutación de estado entre activo e inactivo.
  • 🗑️ Eliminación Controlada y Estilización Semántica de Botones (⏱️ 16:20): Incorporación de la acción destructiva resguardada con diálogo modal de confirmación en SweetAlert2 y estilización visual de botones de acción usando colores semánticos (info para ver, success para editar y danger para eliminar).

🛠️ Comandos y Rutas Principales

Componente / AcciónComando Artisan / Sintaxis de RutaArchivo / ControladorPropósito Técnico
Generador de Componentesphp artisan make:model sucursal -mcrTerminal / ArtisanCrear modelo Sucursal, migración y controlador con métodos RESTful
Migración de Tablasphp artisan migratedatabase/migrations/..._create_sucursals_table.phpRegistrar la tabla sucursals en MySQL con campos unique y valores por defecto
Listado y FiltrosGET /admin/sucursalesSucursalController@indexMostrar tabla de sucursales con tarjetas KPI y paginador
Formulario de RegistroGET /admin/sucursales/createSucursalController@createRenderizar formulario de ingreso para nuevas sucursales
Persistencia de SedePOST /admin/sucursalesSucursalController@storeValidar campos, instanciar modelo y disparar alerta SweetAlert2
Inspección de DatosGET /admin/sucursales/{id}SucursalController@showConsultar dirección, teléfonos y estado de una sucursal específica
Formulario de EdiciónGET /admin/sucursales/{id}/editSucursalController@editCargar vista de modificación con los datos actuales
Actualizar SedePUT /admin/sucursales/{id}SucursalController@updatePersistir cambios de nombre, dirección o estado activo/inactivo
Baja de RegistroDELETE /admin/sucursales/{id}SucursalController@destroyRemover el registro tras confirmación obligatoria en modal

🔒 Buenas Prácticas y Seguridad

  • 🛡️ Restricción de Unicidad en la Capa de Datos: Definir $table->string('nombre')->unique() en la migración impide la creación accidental de múltiples sucursales con nombres idénticos, evitando ambigüedades operativas al momento de asignar o transferir activos físicos.
  • 🌐 Desacoplamiento e Integración del Modelo Ajustes: Consumir los datos del logotipo y nombre de la empresa desde el modelo global Ajuste en lugar de codificarlos de manera fija (hardcoded) en el layout de Adminator garantiza que la identidad institucional se actualice automáticamente en todo el sistema.
  • 🎨 Consistencia Semántica en la Experiencia de Usuario (UX): Estandarizar la iconografía y la paleta de colores para las acciones del CRUD (info para consulta, success para edición y danger para borrado) disminuye la curva de aprendizaje y previene clics erróneos sobre operaciones críticas.
  • ⚠️ Prevención de Borrados Accidentales mediante SweetAlert2: Reemplazar los enlaces directos o alertas nativas del navegador por cuadros de diálogo modales con confirmación explícita mitiga la eliminación no planificada de sedes operativas en producción.