Plataforma · Arquitectura
Arquitectura del probador virtual
Cómo se reparte el trabajo entre el navegador, nuestro servidor y el motor visual, y qué se guarda en cada sitio.
Componentes
- Tienda y catálogo
- Shopify: productos, variantes, disponibilidad, carrito y checkout.
- Acceso desde el menú
- Enlace de navegación de Shopify a la página del probador.
- Integración
- Aplicación de Shopify y extensión del tema para el botón en productos y la página dedicada.
- Interfaz
- React y TypeScript, responsive y adaptada al estilo de la marca.
- Backend
- Node.js con autenticación, control de uso, generación asíncrona y registro técnico.
- Motor visual
- FASHN AI u otro proveedor validado con prendas reales.
- Datos
- Base de datos para configuración, eventos y consumo; fotos temporales en almacenamiento privado.
Arquitectura del plan de MOOSBY en Shopify. En WooCommerce o en un ecommerce propio cambia la capa de integración.
Una prueba, paso a paso
Prepara la foto
En el navegador
Orientación, 1600 px, JPEG y sin EXIF.
POST /api/tryon
Del navegador al servidor
Foto, prenda elegida y consentimiento.
Valida
En el servidor
Bytes reales, tamaño, consentimiento y límites.
Lanza la generación
Del servidor al motor visual
Foto y prenda como datos, sin publicar nada.
Devuelve un identificador
Del motor visual al servidor
La prueba queda en marcha.
202 · identificador
Del servidor al navegador
Y las pruebas que te quedan.
Consulta cada 2 s
Del navegador al servidor
GET /api/tryon/{id}.
Pregunta el estado
Del servidor al motor visual
Preparando, en cola, vistiendo la camisa…
Imagen lista
Del motor visual al navegador
Llega al comparador antes/después.
Estados de la generación
| Estado | Qué significa |
|---|---|
| Preparando la prueba | El motor ha recibido la petición. |
| En cola | Espera su turno en el motor. |
| Vistiendo la camisa | Se está generando la imagen. |
| Lista | La imagen vuelve a nuestro servidor y de ahí a tu pantalla. |
| No se ha podido generar | Se explica el motivo y se puede reintentar. |
Límites y control de costes
| Límite | Valor |
|---|---|
| Por conexión | 3 pruebas cada 60 minutos |
| Total diario | 40 pruebas |
| Simultáneas | Una por conexión |
| Espera máxima | 150 s |
| Devolución del cupo | Si el proveedor rechaza la petición antes de procesarla: clave no válida, sin créditos, límite del proveedor o fallo de red |
Errores contemplados
- Foto vacía.
- Archivo que no es una imagen, aunque tenga extensión .jpg.
- Foto de más de 10 MB.
- Foto de menos de 512 px.
- Sin consentimiento.
- Clave del proveedor ausente o no válida.
- Créditos del proveedor agotados.
- Límite de peticiones del proveedor.
- Límite de la demo alcanzado.
- Postura no detectada.
- Contenido bloqueado por moderación.
- Fallo de red.
- Prueba caducada.
- Espera demasiado larga.
Cada caso muestra un mensaje claro en castellano y permite reintentar o cambiar de foto.
Qué se guarda y dónde
| Dónde | Qué | Cuánto tiempo |
|---|---|---|
| En tu navegador | Giramos la foto según su orientación, la reducimos a 1600 px y la recodificamos en JPEG. Así se eliminan los metadatos EXIF, como la ubicación GPS o el modelo del móvil. | Mientras tengas la página abierta. |
| En nuestro servidor | Comprobamos el formato y el tamaño reales, el consentimiento y los límites de uso, y la enviamos al motor visual. No se escribe en disco ni en ninguna base de datos. | Solo en memoria, durante la petición. Tu IP y la hora se mantienen en memoria hasta un máximo de 60 minutos (la ventana de límites), nunca en disco; el identificador de la prueba, 5 minutos. La imagen nunca se guarda. |
| En FASHN AI | Genera la imagen con la camisa. Según su documentación, no usa el contenido de sus clientes para entrenar modelos. | Borra su copia temporal al terminar, con una limpieza automática de respaldo en un día. El resultado está disponible 60 minutos y no se publica en su CDN. |
| En tu pantalla | El resultado llega a tu navegador. Puedes descargarlo; si no, desaparece al cerrar la página. | Hasta que cierres la página o cambies de foto. |
Preguntas frecuentes
Preguntas frecuentes sobre la arquitectura
¿Por qué la generación es asíncrona?
Porque una prueba tarda entre 15 y 30 segundos. El servidor lanza la generación, devuelve un identificador y el navegador consulta el estado cada dos segundos, sin mantener una conexión abierta todo ese tiempo.
¿Qué pasa si se reinicia el servidor?
En la demo, los límites y las pruebas en curso viven en memoria y se reinician. En un despliegue con varios servidores se pasan a un almacén compartido, como Redis.
¿Alguien puede consultar mi resultado?
No. Cada prueba queda ligada a la conexión que la lanzó y caduca a los 5 minutos.
¿La foto aparece en los registros?
No. Solo se registran códigos de error técnicos, sin imágenes ni datos de la persona.
Hablemos del probador virtual de tu marca.
Estudiamos cada proyecto de forma individual y preparamos una propuesta adaptada a las necesidades de tu marca.