Flujo: Configuración de Marca

¿Quién lo usa?

¿Por qué importa?

Cada marca tiene configuraciones propias que controlan cómo se generan sus imágenes: qué poses están permitidas, qué validaciones deben cumplir las imágenes de entrada (prendas que sube el cliente), y qué modelos del catálogo puede usar. Una configuración incorrecta puede afectar la calidad de la generación o rechazar imágenes de prendas válidas.

Entrada en la plataforma

URL: /admin/companies/[companyId]/brands

El admin navega por Compañías → [nombre de empresa] → Ver Marcas → [marca] → Configuración.

La pantalla de compañías permite al admin navegar rápidamente a las marcas de cada empresa con los botones “Ver Marcas” y “Ver Modelos”. También puede editar la compañía o visualizarla como lo haría un cliente.

Qué incluye BrandSettings

Configuración de poses

Define qué poses están disponibles para esa marca en proyectos de tipo BATCH y FACESWAP. Cada pose tiene un identificador, nombre, preview y metadatos.

Endpoints:

GET /brands/{brandId}
  — Obtiene la configuración completa de la marca

PATCH /brands/settings/{brandSettingsId}/poses
  Body: { poses: [{ poseId, enabled, priority }] }
  — Actualiza las poses habilitadas para la marca

Configuración de validación de imágenes

Define las reglas que deben cumplir las imágenes de prendas que sube el cliente (en el Excel de creación de proyecto):

• Dimensiones mínimas y máximas
• Formatos aceptados
• Requisitos de fondo (transparente, blanco, etc.)
• Otras validaciones de calidad

Endpoint:

PATCH /brands/settings/{brandSettingsId}/image-validation
  Body: {
    minWidth: 800,
    minHeight: 800,
    allowedFormats: ["jpg", "png", "webp"],
    requireTransparentBackground: false
  }
  — Actualiza las reglas de validación de imágenes de entrada

Estructura de datos

// BrandSettings — configuración configurable por marca
model BrandSettings {
  id       Int    @id
  brandId  Int    @unique
  brand    Brand  @relation(fields: [brandId], references: [id])
 
  // Poses permitidas para esta marca
  poses    Json   // Array de PoseConfig
 
  // Validaciones de imágenes de entrada
  imageValidation Json  // ImageValidationConfig
}
 
// Brand — marca de una compañía cliente
model Brand {
  id           Int          @id
  name         String
  companyId    Int
  company      Company      @relation(...)
  settings     BrandSettings?
  projects     Project[]
}

Notas importantes

• La configuración de poses afecta directamente lo que aparece en el Excel que descarga el cliente. Si una pose no está habilitada, no aparece como opción válida.
• Los cambios en imageValidation son retroactivos solo para proyectos nuevos. Los proyectos ya creados conservan las validaciones del momento de su creación.