Frameflow
Editor de vídeo con IA en el navegador
EL RETO
Las herramientas de edición profesionales son complejas y empiezan con una línea de tiempo en blanco. Quería un editor en el navegador donde primero describes el vídeo, obtienes un plan de escenas y editas a partir de ahí.
STACK TECNOLÓGICO
Enfoque de ingeniería
Flujo de generación con IA primero
Los usuarios describen un vídeo en lenguaje natural y un modelo de IA devuelve un plan de escenas. La búsqueda de vídeos de stock (Pexels) y las subidas rellenan cada escena.
Arquitectura guiada por el esquema
Diseñé el modelo de datos en torno a proyectos, escenas y capas de audio. Cuando la música y la locución necesitaron varias capas, sustituí los campos planos por una tabla de capas de audio y migré a ella los proyectos existentes. Prisma usa una conexión con pool para la aplicación y una directa para las migraciones.
Línea de tiempo multipista
Construí una línea de tiempo con pistas de vídeo, música y locución, una escala de tiempo fija y un cabezal de reproducción arrastrable que controla la posición de reproducción en la vista previa, la línea de tiempo y la página.
Refuerzo de la seguridad
Añadí esquemas de Zod para la entrada de la API, transacciones atómicas al guardar escenas, autenticación resistente a ataques de temporización, limitación de intentos de inicio de sesión por correo e IP y comprobaciones de propiedad del proyecto en las subidas.
Decisiones técnicas clave
Las decisiones que dieron forma a la arquitectura y a lo fácil que es mantenerla.
Una única fuente de verdad para la reproducción
La posición del cabezal controla la vista previa, la línea de tiempo y el play y la pausa. Al desplazarse, se pausa y nunca se reproduce automáticamente.
Varios componentes mantenían cada uno su propia idea del tiempo actual. Un único responsable de ese estado elimina el desfase entre ellos.
Estirar un clip cambia su velocidad
Estirar fija la velocidad de reproducción entre 0,25x y 2x. Recortar (elegir los puntos de entrada y salida) es una función aparte.
Son dos operaciones distintas. Mantenerlas separadas permite construir y probar cada una por su cuenta, y se guarda la duración original para que los clips estirados se reproduzcan a la velocidad correcta.
Una cuenta de demostración con protecciones
Una cuenta de demostración con datos de ejemplo tiene protecciones en todas las rutas de escritura y se reinicia cada día.
Los visitantes pueden explorar el producto sin poder cambiar datos que ven otros visitantes.
Estados pendientes honestos
Las funciones que aún no existen lo dicen. El botón de exportar informa de que la exportación no está disponible, en lugar de un falso éxito.
Un mensaje de éxito falso es una mentira en un producto. Los estados honestos mantienen la interfaz fiable mientras las funciones se construyen por orden.
Retos y soluciones
Cualquier usuario con sesión iniciada podía subir archivos a cualquier proyecto, porque la ruta de subida no comprobaba quién era el propietario del proyecto.
Añadí una comprobación de propiedad antes de cada subida, y la misma comprobación en las rutas de subida de audio.
Al duplicar un proyecto se obtenían los metadatos correctos pero ningún clip.
La ruta de creación copiaba solo 5 de los 7 campos de la escena, descartando en silencio la URL del vídeo y el ID de stock. Corregí la correspondencia y normalicé los valores nulos de estilo y relación de aspecto que fallaban en la validación.
El tema cambiaba en una pestaña pero volvía desactualizado en otra.
El hook del tema confiaba en la clase del DOM, que entraba en condición de carrera entre pestañas. Lo reescribí con useSyncExternalStore para que localStorage sea la única fuente de verdad.
Resultados
Frameflow ejecuta el bucle principal de principio a fin: iniciar sesión, describir un vídeo, obtener un plan de escenas, añadir clips de stock o subidos, organizarlos en una línea de tiempo multipista con capas de audio y gestionar proyectos. El CI ejecuta lint, comprobación de tipos y build en GitHub Actions, y un atraso de lint de 2316 problemas, causado por analizar código generado, es ahora cero.
CONCLUSIONES CLAVE
Construir en solitario significa que cada atajo aparece después como un error. El hábito que más rindió fue auditar: qué campos copia realmente una copia, quién puede llamar a cada ruta y qué estado es dueño de cada valor.
