# GNOMOX · AquaDerma Commerce Engine 1.0

Versión del 1 de octubre de 2026. Aplicación HTML/CSS/JavaScript estática, sin backend y sin dependencias de red para calcular o dibujar gráficas. Interfaz blanca y compacta, con controles clásicos, tablas y bordes rectos; sin tarjetas redondeadas.

## Abrir y usar

1. Descomprime el ZIP. Abre `index.html`, o sube el contenido de la carpeta a una subcarpeta de tu hosting, por ejemplo `/motor/`.
2. Arranca en **DEMO**, con 120 días de actividad sintética y las asignaciones reales del catálogo de 56 videos. Ningún resultado de la demo describe las ventas reales de AquaDerma.
3. En **Datos y conexión**, descarga el snapshot, sustituye sus entradas, valídalo e impórtalo. Las mismas entradas pueden llegar por HTTP cuando exista el backend.
4. Ajusta horizonte y supuestos; pulsa **Recalcular escenario**. Los supuestos compartidos persisten entre pantallas.
5. En la pantalla de la decisión, pulsa **Exportar decisión .md**. Revisa y descarga el paquete, luego adjúntalo a la IA. El archivo contiene instrucciones, datos pertinentes, cálculos, restricciones y límites. No requiere una API de IA.

No hay instalación ni compilación. El navegador guarda el snapshot y parámetros en localStorage cuando puede; ese almacenamiento no reemplaza una base ni un respaldo. Descarga JSON para conservar trabajo o compartirlo. Abierto como archivo local, la consulta de fuentes externas y el portapapeles pueden estar limitados; usa el hosting HTTPS para esos flujos.

## Pantallas

| Pantalla | Decisión | Exportación |
|---|---|---|
| Resumen | Qué problema necesita atención | Indicadores y restricciones generales |
| Demanda | Cuánto esperar y qué tan incierto | Historia, validación, distribución y supuestos |
| Reposición | Cuándo, cuánto y cómo sostener operación | Componentes, POs, caja, políticas; precio/marketing sólo como mitigación |
| Precios | Qué escenarios mejoran contribución | Economía unitaria, elasticidad hipotética y restricciones |
| Marketing | Presión comercial y señales por ángulo | Métricas, temperaturas, mapas por bloque y límite de stock |
| Caja y costos | Qué puede financiarse | Costos, compromisos, cobros, reserva y trayectorias |
| Mercado | Qué señales externas vale la pena captar | Fuentes, acceso y datos externos cargados |
| Pruebas simples | Qué aprendimos de oferta/landing | Sólo registro y posterior del experimento |
| Datos y conexión | Qué capturar y conectar | Tablas, requisitos de integración y calidad |

## Qué funciona ahora

- Validación e importación de snapshot JSON; edición local, persistencia y descarga.
- Baselines EWMA, día de semana y tráfico/conversión; ponderación por error temporal.
- Simulación reproducible de trayectorias, incertidumbre compartida y demanda por componente.
- Consumo conjunto de BOM: los packs requieren filtro y cartuchos disponibles.
- Lead time triangular con shock de demora; POs existentes con fecha y recepción probabilísticas.
- Riesgo de ruptura, ROP, stock de seguridad, cobertura y exceso; comparación de carteras de compra bajo caja, MOQ y capacidad.
- Escenarios de precio, pauta, publicaciones y FX; economía por oferta, contribución y caja.
- Gráficas con P10/P50/P90, historia por estado de venta y descarga CSV.
- Registro de contenido basado en el master 56; indicadores descriptivos por ángulo y temperatura.
- Mapas por bloques de landing con exposición y clics; no finge un replay o mapa de coordenadas.
- Posterior Beta-Binomial simple de A/B con valor económico por visitante.
- Exportación Markdown independiente por pantalla; nada se ejecuta automáticamente.
- Lector de API pública del Banco Mundial con importación JSON alternativa. La red/CORS puede impedir la llamada; no hay datos de respaldo presentados como frescos.

## Qué queda para conectar

Autenticación, RLS, base de datos, webhooks, pipeline de limpieza, conciliación financiera, consultas Metricool/GA4, extracción de BCB/INE, logging centralizado, tareas programadas y seguimiento de decisiones. Se entregan contratos y diseño; no se crean ni modifican objetos en Supabase.

Los proveedores privados necesitan servidor. Nunca se deben poner tokens de Metricool, Google o claves `service_role` en el HTML. El frontend espera un endpoint de snapshot agregado. La implementación actual de lectura usa sesión por cookie del mismo origen; para Edge Functions de otro origen se debe añadir el puente de sesión adecuado en la integración.

## Límites que afectan decisiones

1. **No hay datos operativos reales aportados.** Los costos, existencias, compromisos y rendimientos de la demo son inventados y rotulados. Precios 265/325/385/120 Bs son referencias del contexto, no una lista vigente confirmada.
2. **No hay elasticidad aprendida.** Precio y marketing alteran demanda bajo hipótesis explícitas. No permiten anunciar causalidad ni un precio óptimo real.
3. **Las probabilidades no están calibradas en producción.** Buen backtest de valores medios no valida bandas. Hay que medir cobertura a 7, 28, 56 y 90 días con futuros resultados.
4. **No hay optimización global.** Se comparan carteras discretas en un horizonte finito. El motor puede concluir que ninguna alcanza servicio y caja. La compra más grande no es necesariamente la mejor.
5. **Caja es conservadora, no liquidación fiscal.** IVA recuperable, IT compensable por IUE, cobros, pagos y costos deben conciliarse con contabilidad.
6. **Las ventas de mañana son demanda confirmable, no garantía de entrega.** Las trayectorias comerciales asumen cumplimiento de las ventas servidas y cobran después del plazo configurado; devoluciones/rechazos se provisionan monetariamente, no como una segunda cadena probabilística de estados.
7. **Un solo pool físico.** V1 soporta hasta 4 componentes, 10 ofertas y 180 días visibles. Para ciudades/almacenes independientes deben añadirse transferencias y tiempos de reposición internos; no mezclar existencias inaccesibles en el pool.
8. **Las señales macro no activan compras.** FX y demoras entran como parámetros, no como una falsa predicción del dólar. Banco Mundial es contexto anual. No hay trading ni pronóstico cambiario.
9. **Sin datos, no hay predicción operativa.** Con menos de 7 días limpios por oferta se bloquea la visualización operacional. Siete días es un piso de interfaz, no garantía estadística; 56 días limpios es un objetivo inicial, no regla científica universal.

## Archivos

- `assets/engine.js`: funciones matemáticas puras, utilizables también en Node.
- `assets/app.js`: interfaz, gráficas SVG, importación y exportaciones.
- `assets/catalog.js`: 56 asignaciones del master aportado, sin generar nuevos guiones.
- `assets/demo.js`: datos sintéticos reproducibles.
- `assets/contracts.js`: tablas, fuentes y KPI.
- `contracts/`: JSON Schema y contrato HTTP del backend futuro.
- `examples/`: snapshot y ejemplos de decisiones generados por esta versión.
- `docs/`: investigación, fórmulas, datos e integración.
- `tests/`: pruebas del motor y verificación de interfaz.

`node tests/engine.test.cjs` ejecuta las pruebas matemáticas sin instalar paquetes. `node tests/ui-contract.test.cjs --examples` verifica los contratos de las nueve pantallas en un DOM simulado y regenera las exportaciones de ejemplo. Esto no sustituye una prueba visual en un navegador real. El software de producción no necesita Node. Véase `docs/QA.md` para el alcance de la verificación.