🔌 Módulo del Sistema (_main/)
Toda la inteligencia lógica está centralizada en módulos aislados en src/_main/:
- constants.js: Inyección segura de variables de entorno y URLs dinámicas.
- firebaseInit.js: Gateway de inicialización de los servicios Firebase.
- routerPaths.js: Diccionario estricto de rutas y guardias de seguridad.
- router.js: Motor de ruteo dinámico programático e inmune a XSS.
- auth.js: Control de sesión con doble factor lógico por Whitelist y tokens OAuth.
- storage.js: Persistencia cifrada (AES-GCM de 256 bits y PBKDF2) y base de datos.
- i18n.js: Traducción segura con TreeWalker y sanitización avanzada contra XSS mediante DOMPurify.
- analytics.js: Telemetría centralizada y taxonomía unificada de eventos.
- util.js: Herramientas estructurales y UUIDs criptográficamente fuertes.
- googleDrive.js: Integración desacoplada con Google Drive API v3 (gestión de carpetas y archivos).
- markdown.js: Parser local de Markdown para renderizar reportes y documentos.
⚙️ Configuración Centralizada
Personaliza y escala tu aplicación a través del archivo bap.config.json sin alterar el código fuente del núcleo:
- JSON Unificado: Única fuente de verdad inyectada en memoria durante la compilación.
- Rutas: Definición dinámica de rutas seguras para la vista y la base de datos.
- Telemetría: Extensión declarativa de la taxonomía de Firebase Analytics.
- Componentes: Autodescubrimiento y prefijado seguro de componentes (el core está reservado bajo el prefijo
bap-).
🛡️ Firebase Integrado
Integración nativa directa con los servicios en la nube de Google Firebase para dar soporte robusto a proyectos listos para producción:
- Hosting: Alojamiento estático ultrarrápido y seguro.
- Auth: Autenticación nativa utilizando el proveedor Google Identity.
- Realtime DB: Control de Whitelist de accesos y persistencia.
- Analytics: Diccionario taxonómico unificado de telemetría.
- App Check: Protección contra bots y abusos mediante App Check y reCAPTCHA.
⚙️ Pipeline con Gulp
Un potente compilador automatizado mediante scripts de consola. Asegura tu código de cliente y optimiza la velocidad antes de desplegar:
- Minificación: Compresión al extremo de HTML, CSS y JS.
- Ofuscación: Protección intelectual de la lógica del cliente.
- Inyección: Reemplazo automático de variables de versión en HTML.
- Distribución: Copiado y estructuración automática de assets y manifiestos.
🔐 Seguridad y Criptografía
Medidas avanzadas integradas nativamente en el core para protección de datos y defensa en profundidad de grado de producción:
- Inmunidad XSS: Inmunidad a inyecciones XSS mediante creación programática del DOM y sanitización avanzada de HTML con DOMPurify.
- Cifrado AES-GCM: Cifrado asíncrono AES-GCM de 256 bits y derivación de claves PBKDF2 en almacenamiento local.
- UUIDs Fuertes: Generador de UUIDs no predecibles utilizando la Web Crypto API del navegador.
- Cabeceras de Red: Cabeceras de servidor rígidas (CSP, X-Frame-Options, nosniff) configuradas en Firebase.
🧪 Pruebas Unitarias (Testing)
Infraestructura de testing moderna y de alta velocidad incorporada en el ciclo de desarrollo:
- Vitest: Ejecución ultrarrápida usando Vitest.
- JSDOM: Emulación completa del DOM (JSDOM) para probar Custom Elements aislados.
- Mocks: Mocks integrados para simular servicios de Firebase (Auth, RTDB, Analytics).
- Cobertura: Generación automática de reportes de cobertura (V8).