[ SaaS Product ]

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í.

ROL:Full-Stack Developer
AÑO:2025
TIPO:SaaS Product
ESTADO:In Development

STACK TECNOLÓGICO

Next.jsTypeScriptPrismaPostgreSQLSupabaseNextAuth.jsGroqTailwind CSS
I

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.

II

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.

POR QUÉ

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.

POR QUÉ

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.

POR QUÉ

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.

POR QUÉ

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.

III

Retos y soluciones

[ RETO ]

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.

[ SOLUCIÓN ]

Añadí una comprobación de propiedad antes de cada subida, y la misma comprobación en las rutas de subida de audio.

[ RETO ]

Al duplicar un proyecto se obtenían los metadatos correctos pero ningún clip.

[ SOLUCIÓN ]

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.

[ RETO ]

El tema cambiaba en una pestaña pero volvía desactualizado en otra.

[ SOLUCIÓN ]

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.

IV

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.

2,316 → 0
Lint problems
3
Timeline tracks: video, music, voiceover
0.25–2x
Clip speed range

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.