06 Módulo de Ajustes Globales y Datos de la Empesa del Sistema en Laravel - Sistema de Activos Fijos
Duración: 43 minDescripció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ón | Comando de Consola / Terminal | Ruta HTTP / Verbo | Propósito Técnico |
|---|---|---|---|
| Estructura Ajustes | php artisan make:model Ajuste -mcr | N/A (Generador de archivos) | Generar modelo, migración y controlador para el módulo |
| Migración BD | php artisan migrate | N/A (Base de Datos) | Crear la tabla ajustes con campos fiscales y multimedia |
| Almacenamiento Público | php artisan storage:link | public/storage -> storage/app/public | Enlazar la carpeta privada de almacenamiento con el acceso web público |
| Población Determinista | php artisan migrate:fresh --seed | N/A (Base de Datos) | Reiniciar la BD, ejecutar seeders y vincular el rol pivote SUPERADMINISTRADOR |
| Vista de Configuración | Controlador AjusteController | GET /admin/ajustes | Renderizar el formulario único de ajustes globales |
| Guardar Parámetros | Controlador AjusteController | POST /admin/ajustes | Validar 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.