Antes de nada, lo que hay que contar
Un manual siempre empieza siendo un recorrido que alguien se sabe de memoria y tiene que explicar una y otra vez. Este va de la portada de esta web a la demo de un proyecto, y es el que va a seguir el grabador.
Demo interactiva · Aplicación web
El manual se escribe mientras trabajas
AutoDoc es una plataforma de documentación que alojas tú. Una extensión del navegador graba el flujo mientras usas tu aplicación, y lo que vuelve es un manual paso a paso, ya maquetado en hojas A4, listo para salir en PDF, PowerPoint, Word o Markdown.
Todo lo que hay debajo es de verdad. Las capturas son las que tomó el grabador recorriendo esta misma web, y las hojas son el PDF que AutoDoc exportó con ellas.
Un manual siempre empieza siendo un recorrido que alguien se sabe de memoria y tiene que explicar una y otra vez. Este va de la portada de esta web a la demo de un proyecto, y es el que va a seguir el grabador.
Le das a grabar y recorres el flujo como siempre. El grabador guarda un paso por cada clic y por cada campo que rellenas, fotografía la pantalla justo antes de pulsar y señala lo que has pulsado. Dentro de la página no pinta nada, así que en las capturas no queda ni rastro de él.
Lo que vuelve son solo las capturas, en orden, con lo que pulsaste en cada una. Se tiran los pasos que sobraban y se le pone título al manual. Al publicar viajan todas de una vez a AutoDoc, y allí el borrador se compone solo.
El texto de cada paso viene redactado por un modelo de visión que ha leído las capturas en orden, y la hoja se compone a mano. Arrastras un paso al lado de otro y los dos se reparten la anchura, así que acaban exactamente igual de altos.
Lo que sale es la composición que estás viendo: un PDF con los píxeles originales, un PowerPoint con una diapositiva por hoja, un Word para seguir editando o un Markdown con sus capturas al lado para un repositorio o una wiki.
Un interruptor sirve el manual en una dirección secreta, sin cuenta detrás y lista para embeberla en otra web con un iframe. Al revocarla se cae el enlace y se lleva sus capturas con él.
Documentar una aplicación es fotografiarla con datos reales en pantalla: nombres, facturas, expedientes. Por eso AutoDoc está pensada para instalarse en un servidor privado y en ningún otro sitio. Son Docker, Postgres y un almacén de objetos, y funciona en una máquina sin salida a internet si es lo que piden los datos. No hay cuenta en la nube, ni un tercero guardando las capturas, ni telemetría.
De aquí no sale nada
Los textos de los pasos los redacta un modelo de visión a través de OpenRouter, y es lo único que habla con el exterior. Quita su clave del entorno y los pasos entran vacíos, para escribirlos a mano. Y cuando está encendido, el modelo lo eliges tú: OpenRouter deja ceñirse a proveedores que no guardan nada ni entrenan con nada, así que ni las capturas que mandas para un borrador se quedan en ningún sitio.
Django y PostgreSQL detrás de Gunicorn, con las capturas en un almacén de objetos compatible con S3 y servidas solo a través de la aplicación. El manual se compone una vez y lo imprimen cinco exportadores que comparten la misma maqueta: WeasyPrint para el PDF, python-pptx para las diapositivas, python-docx para el Word y un zip para el Markdown. El grabador es una extensión de Chrome MV3 que dibuja el resalte sobre el PNG capturado dentro de un worker en vez de tocar la página, así que un diálogo modal por encima de todo no da problema y la aplicación documentada no se entera de que la están mirando.
