06 Módulo de Ajustes Globales y Datos de la Empesa del Sistema en Laravel - Sistema de Activos Fijos

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

¡Contenido Exclusivo!

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

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

Descripción

🎓 Lección 06: Módulo de Configuraciones Globales, Almacenamiento Seguro y Localización en Laravel

Esta lección aborda la implementación del módulo de ajustes y variables globales del sistema (nombre de empresa, NIT/RUC, divisa, logotipo e inicio del año fiscal contable) para alimentar reportes y depreciaciones. Además, cubre la integración de SweetAlert2, el manejo profesional de archivos con discos públicos de Laravel y la traducción integral del sistema al español.

🚀 Pasos Clave con Timestamps

  • 🏛️ Propósito y Alcance del Módulo de Configuraciones (⏱️ 00:00): Definición de las variables globales reutilizables (NIT, divisa, logo corporativo e inicio del año fiscal) que impactan de forma automática en los cálculos contables de depreciación y reportes.
  • 👥 Ampliación del Seeder con Roles Operativos (⏱️ 01:20): Incorporación en RoleSeeder de nuevos roles especializados para el ciclo de vida de los activos (Encargado de activos fijos, Contador, Auditor de inventario, Encargado de mantenimiento, Custodio y Auditor externo).
  • 🏗️ Generación de Modelo, Migración y Controlador de Recursos (⏱️ 02:15): Creación simultánea del modelo en singular Ajuste, su archivo de migración y su controlador de recursos mediante el comando unificado php artisan make:model Ajuste -mcr.
  • 📐 Modelado Visual de Base de Datos con DBML (⏱️ 03:20): Documentación del esquema relacional en diagrama.dbml mediante la extensión DBML Entity Relationship Diagram para estructurar los campos primarios, tipos de datos y valores por defecto antes de migrar.
  • ⚙️ Configuración de $fillable y Migración de la Tabla ajustes (⏱️ 05:00): Declaración de atributos asignables masivamente en el modelo Ajuste y ejecución de php artisan migrate para crear la tabla número 15 en la base de datos MySQL.
  • 🧭 Enrutamiento Conciso y Ajuste del Menú Lateral (⏱️ 06:30): Registro de solo dos rutas web indispensables (index para visualización y store para persistencia/actualización) e incorporación del ítem con icono de engranaje (rosquita) en el sidebar de Adminator.
  • 🔔 Integración de SweetAlert2 para Notificaciones y Confirmaciones (⏱️ 09:10): Inyección de SweetAlert2 vía CDN en el layout principal para emitir alertas modales profesionales ante operaciones exitosas y reemplazar las alertas nativas en la eliminación de roles.
  • 💱 Selector Dinámico de Divisas con divisas.json (⏱️ 11:40): Descarga del archivo divisas.json en public/ y conversión del campo de divisa en un <select> interactivo con monedas internacionales (ej. Bolivianos BOB, Pesos Colombianos COP, etc.).
  • 🖼️ Almacenamiento Profesional del Logo y Enlace Simbólico (⏱️ 13:50): Creación del enlace público con php artisan storage:link, gestión de subida con Storage::disk('public'), previsualización reactiva de la imagen y borrado del logotipo previo al actualizar.
  • 🌐 Traducción del Framework y Validaciones al Español (lang/es) (⏱️ 15:40): Generación de la estructura de localización lang/es/ para traducir credenciales de autenticación, paginación y mensajes de validación nativos al español.
  • 🌱 Persistencia Limpia con migrate:fresh --seed y Rol Pivote (⏱️ 17:30): Reconstrucción determinista de la base de datos sembrando los roles, creando el superusuario administrativo y verificando su asignación en la tabla relacional pivote model_has_roles.

🛠️ Comandos y Rutas Principales

Componente / AcciónComando de Consola / TerminalRuta HTTP / VerboPropósito Técnico
Estructura Ajustesphp artisan make:model Ajuste -mcrN/A (Generador de archivos)Generar modelo, migración y controlador para el módulo
Migración BDphp artisan migrateN/A (Base de Datos)Crear la tabla ajustes con campos fiscales y multimedia
Almacenamiento Públicophp artisan storage:linkpublic/storage -> storage/app/publicEnlazar la carpeta privada de almacenamiento con el acceso web público
Población Deterministaphp artisan migrate:fresh --seedN/A (Base de Datos)Reiniciar la BD, ejecutar seeders y vincular el rol pivote SUPERADMINISTRADOR
Vista de ConfiguraciónControlador AjusteControllerGET /admin/ajustesRenderizar el formulario único de ajustes globales
Guardar ParámetrosControlador AjusteControllerPOST /admin/ajustesValidar entradas, subir/reemplazar logo y persistir datos

🔒 Buenas Prácticas y Seguridad

  • 💾 Almacenamiento Desacoplado y Reemplazo de Archivos: Almacena imágenes en el disco público de Laravel (storage/app/public/logos) a través del enlace simbólico en lugar de guardarlas directamente en la carpeta raíz public/. Al actualizar el logotipo, elimina el archivo anterior del almacenamiento para evitar saturación de archivos huérfanos en el servidor.
  • 🎯 Validación Estricta de Archivos Multimedia: Restringe las subidas de logotipos a formatos de imagen válidos con un tamaño máximo estricto (por ejemplo, max:2048 para 2 MB), mitigando riesgos de denegación de servicio o inyección de archivos no autorizados.
  • 🏷️ Persistencia Idempotente de Superusuarios: Configura RoleSeeder y DatabaseSeeder para vincular de inmediato al usuario administrador mediante $user->assignRole('SUPERADMINISTRADOR'). Esto garantiza que tras ejecutar migrate:fresh el entorno mantenga su integridad en la tabla model_has_roles sin depender de registros manuales.
  • 🌐 Centralización de Parámetros Fiscales: Almacenar variables maestras (tasa o divisa base, NIT/RUC e inicio de período fiscal) en una tabla única previene la dispersión de constantes fijas (hardcoded) en el código, asegurando consistencia en la generación de reportes PDF/Excel y módulos de depreciación.