Cómo se hacen los videos y las capturas

Esta página es para quien graba o actualiza los videos. Si solo querés verlos, andá a Todos los videos.

Los videos no se editan a mano. Se graban automatizando el sistema real con Playwright, y las anotaciones —foco, flechas, leyendas— se dibujan dentro de la página antes de grabar. Eso significa que el video se vuelve a generar con un comando, y que si la pantalla del sistema cambia, se regraba en vez de reeditarse.

El pipeline vive en incadex-docs/video-pipeline/.

Grabar no puede ensuciar el sistema

Desde que se borraron los datos de prueba, el sistema tiene solo datos reales. Las escenas nuevas (11 a 16) no guardan nada: llenan los formularios y los dejan sin confirmar, y donde el último paso escribiría, la leyenda lo cuenta y el video no lo hace.

Si una escena necesita sí o sí registrar algo para poder mostrarlo, hay que pedir autorización antes, registrarlo y borrarlo después — nunca dejarlo. Un dato de prueba olvidado en los libros desbalancea el Balance y nadie lo relaciona con un video.

🎬 Cómo se graban y se actualizan

---

1. Para quién es cada video

Para alguien que no conoce el sistema y no sabe contabilidad. Eso manda sobre todo lo demás:

• Nunca se da por sabido un término. Si aparece “ventilar”, el video dice qué es
• Cada paso explica por qué, no solo dónde hacer clic
• Si algo ya se explicó en otro video, se remite a ese video en vez de repetirlo

2. La estructura fija

Todos los videos tienen estas cuatro capas, siempre:

Capa	Qué es
Portada	Fondo morado, «INCADEX · MANUAL DEL SISTEMA», título grande y una bajada de una línea
Foco	El fondo se atenúa y se recuadra el elemento del que se está hablando
Flecha + etiqueta	Una flecha morada al elemento, con una etiqueta corta que lo nombra
Leyenda	Barra inferior: chip + titular en negrita + una frase que explica el porqué

Y un cursor amarillo que se mueve y hace clic, para que se vea de dónde sale cada cosa.

3. La regla del chip

El chip de la leyenda dice dónde está parado el espectador. La forma es siempre ETIQUETA n de N, donde la etiqueta nombra lo que se está contando:

Chip	Cuándo
PASO 2 de 5	Una secuencia que hay que seguir en orden
LÍNEA 1 de 3	Se repite lo mismo sobre varios elementos
EJEMPLO 1 de 3	Se muestran alternativas, no pasos
LO BUENO (sin número)	Un aparte que explica algo, no avanza el procedimiento

No numeres lo que no es una secuencia

Poner PASO 4 de 7 en un aparte le miente al espectador sobre cuánto le falta. Si el momento no avanza el procedimiento, va sin número.

4. Encuadre

• El elemento enfocado tiene que quedar en los dos tercios superiores de la pantalla, arriba de la barra de leyenda
• No enfoques en una pantalla con más espacio vacío que contenido. Si el formulario es corto, hacé scroll o ampliá antes de enfocar
• Nada importante debajo de la leyenda: la tapa

5. Duración

Tipo	Duración
Un solo procedimiento (entrar, imprimir)	40 – 60 s
Un circuito completo (asiento, caja chica, prorrateo)	90 – 120 s

Si pasa de dos minutos, se parte en dos videos y uno remite al otro.

6. Datos de prueba

Los videos se graban contra el sistema real, así que:

1. Los datos de prueba se crean con una marca reconocible: EJEMPLO-VIDEO, TEST-*
2. Se borran al terminar, siempre
3. Se verifica que el sistema volvió a su estado anterior:

SELECT COUNT(*) lineas, ROUND(SUM(debit),2) debe, ROUND(SUM(credit),2) haber
  FROM llx_accounting_bookkeeping;
-- tiene que dar el mismo número de líneas y debe = haber
SELECT COUNT(*) FROM llx_accounting_bookkeeping
 WHERE doc_ref LIKE 'EJEMPLO-%' OR doc_ref LIKE 'TEST-%';  -- tiene que dar 0

Los borradores casi no ensucian

Los asientos en borrador viven en llx_accounting_bookkeeping_tmp y solo pasan al libro definitivo al validar. Grabar el flujo de carga sin validar casi no toca la contabilidad real.

7. El contenido se pone viejo

Un video muestra el sistema como estaba el día que se grabó. Si después cambia la configuración, el video queda mintiendo y nadie se entera.

• Grabá solo pantallas cuyo estado hayas verificado ese mismo día
• Anotá en la escena qué configuración asume el video
• Cuando cambie esa configuración, regrabá

Ejemplo real: el video del Libro Mayor mostraba el aviso «No hay ningún grupo de cuentas contables disponible para el país BO». Dejó de ser cierto en cuanto se crearon los 21 grupos BO_*, y hubo que regrabarlo.

8. Reglas de operación

Peligro

• Un solo trabajo de grabación a la vez. Playwright nombra los archivos con un hash y los renombra al cerrar; dos grabaciones simultáneas se pisan y se pierde un video.
• Los videos quedan en WebM (el ffmpeg que trae Playwright solo codifica VP8). Andan en Chrome, Firefox y Edge; Safari de iPhone puede no reproducirlos.

9. Las capturas con flechas

Salen del mismo pipeline y del mismo overlay que los videos, pero son una sola imagen: foco, flecha y etiqueta, sin barra de leyenda.

node shots.js              # todas (es seguro repetirlo cuando cambia una pantalla)
node shots.js ventilacion  # una sola

Enfocá algo chico, nunca una tabla entera

La regla que más cuesta aprender

Si el recuadro es más alto que la pantalla, el atenuado se come todo y no se ve ni la flecha ni la etiqueta. Enfocá una fila, un campo, un botón. Nunca table.

Cada captura dice a qué página pertenece

En shots.js, cada entrada tiene un campo pagina. Sirve para saber qué regenerar cuando una pantalla del sistema cambia. Como son baratas de rehacer, ante la duda: rehacelas todas.

Si el selector no resuelve, la imagen sale linda y no enseña nada

Es peor que en un video. En un video una flecha que falta se nota como un hueco raro; en una captura queda una pantalla limpia que parece correcta. Por eso el pipeline avisa fuerte (⚠ SIN FLECHA) y hay que mirar ese aviso, no solo que el archivo exista.

Las etiquetas se acomodan solas

El overlay mide la etiqueta después de insertarla y la corre para adentro si se sale del cuadro. Sin eso, un campo pegado al borde derecho deja el texto cortado.

10. Los tropiezos técnicos

Están todos en incadex-docs/video-pipeline/README.md, con el motivo y la solución de cada uno. Vale la pena leerlo antes de tocar el pipeline: son errores que se ven bien en pantalla y salen mal en el video.