Flujos Principales de la Plataforma

Esta sección documenta los 6 flujos operativos clave de Rial AI. Cada flujo describe quién lo ejecuta, qué endpoints consume y cómo fluye el estado a través del sistema.

Mapa de flujos

Los 6 flujos

Flujo	Usuario principal	Entrada en la plataforma
Creación de proyecto	Company Admin	`/projects/create`
Subida de imágenes	Admin Rial	`/admin/library`
Revisión de imágenes	Company Admin	`/library`
Descarga de imágenes	Company Admin / Admin	`/library`
Métricas	Admin y Company Admin	`/admin/dashboard`, `/metrics`
Configuración de marca	Admin Rial	`/admin/companies/[id]/brands`

Estados del sistema

Tanto las carpetas (ProjectFolder) como los proyectos (Project) y SKUs (ProjectImage) tienen dos estados paralelos: uno visible para el cliente y otro para el admin.

Estado del cliente (`clientStatus`)

Estado	Descripción
`CREATING`	El caso está siendo creado
`IN_PROGRESS`	Imágenes en generación por parte de Rial
`PENDING_APPROVAL`	Hay imágenes listas para revisar
`IN_REVIEW`	El cliente rechazó imágenes y están en corrección
`PENDING_DOWNLOAD`	Todo aprobado, listo para descargar
`COMPLETED`	El cliente descargó todas las imágenes
`CANCELLED`	Caso cancelado

Estado del admin (`adminStatus`)

Estado	Descripción
`CREATING`	El caso está siendo creado
`IN_PROGRESS`	Imágenes por generar o en proceso
`WAITING_APPROVAL`	Esperando revisión del cliente
`REJECTED`	El cliente rechazó imágenes — hay correcciones pendientes
`UNPUBLISHED`	Imágenes listas pero aún no publicadas al cliente
`COMPLETED`	Todo completado
`CANCELLED`	Caso cancelado