# NovaSIS — Showreel 30s

Pieza publicitaria de motion graphics de 30 segundos para NovaSIS ERP. Narra
el arco "caos administrativo → sistema ordenado" en cinco actos: el caos
(planillas, WhatsApp, post-its), el colapso en el isotipo de marca, la
cadena de un proceso real (venta → stock → cobranzas → contabilidad →
NovaIA), la escala (multisucursal / multiempresa) y el cierre con el lockup
de marca.

Construida con HTML/CSS animado, capturada frame a frame con Chromium
headless (`render.mjs`) y ensamblada con ffmpeg (`build.sh`). Sin Remotion
(licencia comercial paga) ni motor de animación externo — ver
`docs/superpowers/specs/2026-10-14-showreel-novasis-30s-design.md` §6.1
para la decisión completa.

## Master mudo — por qué no hay audio

La pieza se entrega **sin banda sonora**. No hay forma de obtener música
licenciada para este trabajo, y sintetizar una base con ffmpeg habría
abaratado una pieza comercial — peor que no tener audio.

La compensación es que **toda la pieza está coreografiada sobre una grilla
de 120 BPM** (1 beat = 0,5 s = 15 frames, 60 beats en total). Cada entrada,
salida y corte cae exactamente sobre un múltiplo de beat — `src/timeline.js`
es la única fuente de verdad del timing, ninguna escena hardcodea segundos.
Esto significa que **cualquier track licenciado a 120 BPM** se puede
superponer al master y los cortes van a caer solos, sin reeditar un solo
frame de video.

El mapa de beats completo está más abajo. Es la documentación que hace
real esa promesa.

## Comandos

```bash
pnpm preview   # servidor local — revisar la pieza en vivo, con scrub de timeline
pnpm render    # captura determinista de 900 frames PNG -> frames/
pnpm build     # render + ffmpeg -> dist/novasis-showreel-30s.mp4 + verificacion
pnpm verify    # corre sin reconstruir: las cuatro comprobaciones sobre dist/ y frames/
pnpm test      # suite de unit/integration tests (node --test)
```

`pnpm build` es el único comando que hace falta para obtener el entregable
final. Internamente corre `build.sh`: render completo → ensamblado ffmpeg →
`verify.mjs`. Falla (código de salida ≠ 0) si falla alguno de los gates
duros — contenedor, determinismo estructural, regresión de contenido o
contraste/datos reales —; la envolvente de píxeles (parte de determinismo)
es informativa y nunca hace fallar el build (ver "Verificación automática"
más abajo).

### Parámetros de salida

`dist/novasis-showreel-30s.mp4`: **30,00 s · 1920×1080 · 30 fps · 900
frames · H.264 yuv420p**, codificado con
`-c:v libx264 -crf 17 -preset slow -pix_fmt yuv420p -r 30 -movflags +faststart`.
CRF 17 es visualmente sin pérdida para gráficos sintéticos con gradientes
(spec §6.4).

### Reproducibilidad: en contenido, no bit-exacta

**La pieza es reproducible en contenido, no bit-exacta pixel a pixel.**
Dos builds del mismo código producen la misma narrativa, el mismo timing y
el mismo contenido en cada frame — pero no el mismo archivo PNG byte a
byte en todos los casos: el rasterizador de Chromium/Skia introduce un
jitter de antialiasing sub-perceptual en dos ventanas de la pieza con
transform continuo sobre trazos SVG o gradientes, con un rango observado de
**hasta 93/255 en un canal y hasta 0,117% de los píxeles de un frame**
(medido en corridas reales, ver detalle abajo). Es una propiedad medida del
motor de render, no un criterio que esta pieza cumpla ni una garantía que
se pueda dar. El detalle completo — qué se midió, por qué, y qué chequea
`verify.mjs` en su lugar — está en la sección "Verificación automática" más
abajo (punto 2, determinismo).

**Ese número no es un contrato.** `verify.mjs` lo mide y lo reporta en cada
corrida, pero no lo usa como condición de pase/falla — dos intentos de
fijar un techo (8/255, después 64/255) quedaron superados por la corrida
siguiente, lo que confirma que no hay un techo estable que perseguir.

## Mapa de beats (120 BPM)

**1 beat = 0,5 s = 15 frames · 60 beats · 900 frames.** Esta tabla es la
referencia para el editor que sincroniza el track: cualquier corte, golpe o
acento musical en un múltiplo de beat de esta lista cae exactamente sobre
un corte, entrada o salida visual de la pieza.

| Acto                 | Beats | Tiempo      | Frames  |
| -------------------- | ----- | ----------- | ------- |
| I — El caos          | 0–10  | 0,0–5,0 s   | 0–149   |
| Colapso              | 10–14 | 5,0–7,0 s   | 150–209 |
| II — La cadena       | 14–48 | 7,0–24,0 s  | 210–719 |
| · Una venta          | 14–21 | 7,0–10,5 s  | 210–314 |
| · El stock responde  | 21–28 | 10,5–14,0 s | 315–419 |
| · La plata se mueve  | 28–35 | 14,0–17,5 s | 420–524 |
| · Cuadra solo        | 35–42 | 17,5–21,0 s | 525–629 |
| · NovaIA             | 42–48 | 21,0–24,0 s | 630–719 |
| III — Escala         | 48–54 | 24,0–27,0 s | 720–809 |
| Cierre               | 54–60 | 27,0–30,0 s | 810–899 |

Hitos puntuales dentro de cada acto, útiles para marcar acentos:

- **Beat 0** (frame 0): golpe visual — entra el desorden desde los ocho
  ángulos del encuadre.
- **Beats 8–10** (frames 120–149): tremor de la pila y aparición de
  "NO CUADRA".
- **Beat 10** (frame 150): freeze total — un beat de quietud absoluta antes
  del colapso.
- **Beats 11–14** (frames 165–209): el desorden converge a grilla; el
  isotipo se dibuja trazo a trazo. Termina en el isotipo completo.
- **Beat 18,5** (frame ~277): chip SIFEN vira a `APROBADO` en el plano de
  Una venta.
- **Cada ~7 beats dentro del Acto II** (beats 21, 28, 35, 42): relevo de un
  plano al siguiente, enlazado por el pulso de luz — nunca un corte duro.
- **Beat 54** (frame 810): entra el lockup de cierre.
- **Beat 57** (frame 855): el lockup queda quieto — sostiene 1,5 s hasta el
  final, para no leerse como inacabado al terminar el video.

## QA visual (criterio §7.3 del spec)

Cinco frames se extraen y se revisan a ojo tras cada build — es juicio
humano a propósito, no un chequeo automático (ver `verify.mjs`, que cubre
las otras cuatro comprobaciones del spec):

```bash
mkdir -p dist/qa
for f in 149 209 290 719 899; do
  ffmpeg -y -hide_banner -loglevel error -i dist/novasis-showreel-30s.mp4 \
    -vf "select=eq(n\,$f)" -vframes 1 "dist/qa/frame-$f.png"
done
```

(El quinto frame era originalmente 314 — ver nota abajo sobre por qué se movió a 290.)

| Frame | Qué debería verse                                   | Qué se ve en este build |
| ----- | ----------------------------------------------------- | ----------------------- |
| 149   | Pico de caos: la pila completa, "NO CUADRA" en rojo  | Correcto. |
| 209   | El isotipo completo, recién dibujado                 | El trazo esta completo y correctamente al frente (confirmado con `elementsFromPoint`, no es un bug de z-index), pero dos piezas de la pila convergida (un post-it y un rollo de cinta) quedan justo detras del centro del icono — la grilla 7×2 de 02-colapso.js no deja un hueco ahi. Revisado y aceptado como cosmetico en la review de la Tarea 7; queda como esta. |
| 290   | Plano "Una venta": chip SIFEN en `APROBADO`          | Correcto: factura, cliente y el chip verde `APROBADO` limpios y legibles. |
| 719   | Fin de la cadena (plano NovaIA, a punto de cerrar)   | Correcto. |
| 899   | Lockup final: isotipo + wordmark + eslogan + URL     | Correcto. |

**Nota sobre el keyframe movido (314 → 290):** el plan original de esta tarea
pedía el frame 314 para "SIFEN aprobado", pero en este build ese frame ya
muestra Inventario (48 / 120), no la factura. El plano "Una venta" empieza su
transición de salida en el frame 303 (`enlazar()` en `03-cadena.js`: solape de
0,8 beat / 12 frames con "El stock responde"), y para el 314 — último frame
nominal de "Una venta" según la tabla de beats — la transición ya completó. El
chip `APROBADO` se ve limpio bastante antes, así que el keyframe de QA se movió
a 290 en vez de tocar el timing de la escena.

## Verificación automática (`verify.mjs`)

Cuatro comprobaciones. Tres de ellas (1, los dos gates de 2, y 3 y 4) salen
con código ≠ 0 si fallan; la cuarta parte de la comprobación 2 (la
envolvente de píxeles, 2b) es **informativa y nunca afecta el código de
salida** — ver más abajo por qué.

1. **Contenedor** (`comprobarContenedor`) — `ffprobe` confirma 30,00 s
   (±1 frame), 1920×1080, 30 fps, 900 frames, `yuv420p`.
2. **Determinismo** (`comprobarDeterminismo`) — reescrito en esta ronda.
   **La pieza es reproducible en contenido, no bit-exacta pixel a pixel.**
   El criterio original de esta tarea ("hash SHA-256 idéntico sobre los 900
   PNG entre dos corridas") **no se cumple y estaba mal escrito como
   criterio** — no es una propiedad alcanzable de este pipeline, y forzar
   una tolerancia hasta que "pase" habría escondido eso en vez de
   documentarlo. El reemplazo son tres chequeos independientes, de los
   cuales solo dos son gates duros:

   - **2a. Estructural (GATE)** — grep sobre el código fuente del proyecto
     (`src/`, `assets/`, `fonts/`, `scripts/`, `render.mjs`) buscando
     `Math.random(`, `Date.now(` y `new Date(` fuera de comentarios. Esto es
     lo que de verdad elimina la variación **lógica** de la pieza — a
     diferencia del jitter de rasterizado (2b), que es ruido del motor de
     render, no un bug. Estable: no depende de la sesión de rasterizado.
   - **2b. Envolvente de píxeles medida (INFORMATIVA, no gate)** — cinco
     rangos de frames CONTIGUOS que cubren las cinco escenas (`[55,70]`,
     `[150,215]`, `[300,315]`, `[720,790]`, `[880,899]`) se renderean dos
     veces cada uno, cada vez en una página nueva, y se comparan pixel a
     pixel. **Se mide y se reporta siempre** el peor frame visto, con un
     umbral de referencia (64/255 por canal, 0,15% de píxeles) que marca el
     resultado con `⚠ INFO` cuando lo supera — pero nunca hace fallar la
     verificación. Ver "por qué" más abajo.
   - **2c. Regresión de contenido (GATE)** — los frames 105 y 135 (dentro
     de la entrada de "NO CUADRA", Acto I) tienen que ser **distintos**
     entre sí. Esto es lo que atrapa la clase de defecto `page.screenshot({
     animations: 'disabled' })`: con esa opción Playwright adelanta las
     animaciones finitas a su estado final (incluso pausadas), los 900
     frames salen en pose final, y los chequeos 1, 2a, 2b y 3 siguen
     pasando igual — ninguno de ellos mira si el contenido cambia entre dos
     instantes que deberían ser distintos. Estable: compara el mismo build,
     no dos sesiones de rasterizado independientes.

   **Por qué 2b dejó de ser gate**: el jitter de rasterizado de
   Chromium/Skia depende del **historial de la sesión del navegador**, no
   del frame en sí — un frame renderizado aislado dos veces da exactamente
   el mismo resultado, pero el mismo frame dentro de un RANGO renderizado
   dos veces puede variar. Es antialiasing/dithering de Skia en bordes con
   transform continuo sobre trazos SVG (Colapso: `stroke-dashoffset` del
   isotipo) o gradientes (Escala: `scale(2.8→0.75)` de cámara sobre el
   `linear-gradient` del scrim — el muestreo sub-píxel de contenido
   escalado es donde se concentra el jitter, por eso Escala es el peor
   caso). Sobrevive a `--disable-gpu` y a forzar un solo hilo de
   rasterizado — no es `Math.random`, `Date.now` ni `new Date` escondido en
   el código (eso lo confirma el gate 2a por grep).

   Se intentó fijar un techo de tolerancia **dos veces**, y las dos veces
   la corrida siguiente lo superó:

   | Ronda | Techo fijado | Lo que midió la corrida siguiente |
   | --- | --- | --- |
   | 1ª | 8/255, 0,05% | 61/255 en Escala (720–789), muy por encima |
   | 2ª | 64/255, 0,15% | 93/255 en el frame 762, 75/255 en el 722 |

   Cada intento de techo quedó superado por la medición siguiente, en la
   misma máquina, sin cambios de código entre una corrida y otra. El techo
   no existe: se mueve con cada corrida porque depende del historial de
   rasterizado de esa sesión en particular, no es una propiedad fija de
   ningún frame. Perseguir un tercer número sería repetir lo mismo
   esperando un resultado distinto. Y el problema de fondo es peor que sólo
   "no converge": **un gate que falla al azar sobre un build correcto es
   peor que no tener gate** — entrena a re-correr hasta que dé verde, y el
   día que falle de verdad nadie le va a creer. Por eso 2b se mide y se
   reporta en cada corrida (la tendencia sí es información valiosa) pero ya
   no determina el código de salida. **Ese rango — hasta 93/255, hasta
   0,15%+ de píxeles en alguna corrida — no es un contrato de esta pieza,
   es lo que se observó.**

   **No se intentó eliminar el jitter en sí.** Tres implementadores ya
   gastaron esfuerzo en esto — probando `--disable-gpu`,
   `--disable-gpu-rasterization`, `--disable-partial-raster`,
   `--num-raster-threads=1`, `--run-all-compositor-stages-before-draw`,
   `--disable-threaded-animation` — sin eliminarlo. Es una propiedad del
   motor de render (Chromium/Skia), no un defecto de esta pieza.
3. **Contraste** (`comprobarContraste`) — recorre los 900 frames en vivo;
   cada nodo de texto, en el instante en que alcanza opacidad efectiva 1,
   se mide contra su fondo real compuesto por alpha-blending (ratio ≥4,5:1
   normal, ≥3:1 grande).
4. **Sin datos reales** (`comprobarSinDatosReales`) — grep binario-seguro
   sobre `src/`, `assets/`, `fonts/`, `scripts/` y `render.mjs` buscando el
   RUC y la razón social del tenant real visto al tomar las capturas de
   referencia del producto.

Dos comprobaciones del spec (§7) quedan fuera de este script porque ya las
cubre otra tarea: la legibilidad (ningún texto <28px) la cubre
`test/scene-contract.test.mjs`, y la fidelidad del isotipo reconstruido
(≤3% de píxeles discrepantes contra el PNG de referencia) la cubre
`scripts/check-isotipo.mjs`. El punto §7.3 (keyframes críticos) es la
sección "QA visual" de arriba — deliberadamente manual.

## Estructura

```
marketing/showreel-novasis-30s/
├── src/
│   ├── index.html        # raiz del compositor
│   ├── timeline.js       # grilla de beats — unica fuente de verdad del timing
│   ├── theme.css          # tokens de marca y de producto
│   ├── data/fixtures.js  # TODA la data ficticia de la pieza
│   └── scenes/            # 01-caos, 02-colapso, 03-cadena, 04-escala, 05-cierre
├── assets/                # isotipo.svg reconstruido, wordmark recoloreado
├── fonts/                 # Poppins self-hosteada
├── render.mjs             # captura determinista de 900 frames
├── build.sh               # render + ffmpeg -> dist/novasis-showreel-30s.mp4
└── verify.mjs             # las cuatro comprobaciones automaticas de arriba
```
