🔌 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.
• 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.

⚙️ 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).

📁 Despliegue & CDN

Configuración multisitio y distribución de recursos estáticos pesados en Firebase Hosting.

📁 Core & Módulos

Detalle técnico del motor de enrutamiento, criptografía, autenticación, utilidades y traducción.

📁 Componentes Web

Especificaciones técnicas completas, configuraciones y ejemplos interactivos de los 9 Web Components core.

📁 Páginas y Subpáginas

Estructura de ruteo estático, jerarquías de directorios, anidación y metodología de carga.

📁 Diseño & CSS

Variables CSS premium de color, tipografía de vanguardia, modo claro/oscuro y formularios.

📁 Suite de Pruebas

Arquitectura de tests unitarios y de integración sobre JSDOM con Vitest y simulaciones de red.

📁 Ciclo de Desarrollo

Scripts de terminal para pruebas unitarias, modo watch, servidor local y despliegue.