Cómo gestionar marcas virtuales
Consulta, crea y edita marcas virtuales de una ubicación para definir su nombre, archivos de identidad visual y paleta de colores. En Marea Gran Via, este flujo prepara las marcas que después pueden usarse en la configuración del TPV, pero no cambia por sí solo la marca activa.
En este artículo
Las marcas virtuales agrupan la identidad visual que el TPV puede mostrar o reutilizar: nombre, favicon, logos, portada y colores de marca. La gestión se hace desde la ubicación activa, por ejemplo Grupo Marea Demo > Marea Gran Via.
Este artículo se centra en consultar, crear y editar. El borrado queda fuera de esta guía y la selección de la marca activa pertenece al flujo de ajustes generales del TPV.
Antes de empezar
- Sesión iniciada en Antylogic.
- Organización Grupo Marea Demo y ubicación Marea Gran Via seleccionadas.
- Permiso `brand:view` o `brand:manage` para consultar marcas virtuales en el listado.
- Permiso `brand:manage` para crear o editar marcas virtuales.
- Una marca virtual existente si se va a editar.
- Servicio de ficheros disponible si se van a subir favicon, logos o portada.
Instrucciones
- 1.
Abrir marcas virtuales
Entra en `/location/brands` con la ubicación activa. La pantalla carga las marcas de esa ubicación, las ordena por nombre y muestra la identidad visual cuando hay colores guardados.
- 2.
Crear una marca
Con permiso de gestión, pulsa `Nueva marca`. El formulario parte de valores por defecto y permite completar el nombre, las imágenes de identidad y la paleta de colores.
- 3.
Completar la identidad visual
Carga o revisa favicon, logo cuadrado, logo en blanco y negro, logo en color y portada. Si una imagen no encaja en la proporción esperada, la interfaz puede abrir el recorte antes de subirla como archivo.
- 4.
Ajustar la paleta
Define `primary_color`, `secondary_color`, `text_color` y `background_color`. La interfaz valida que los colores informados sean hexadecimales de 6 dígitos antes de permitir el guardado.
- 5.
Editar una marca existente
Desde el listado, abre una marca o su acción de edición. El editor carga el detalle de la marca dentro del scope de la ubicación y reutiliza los mismos campos que el alta.
- 6.
Guardar y volver al listado
Al guardar, creación usa `POST /api/app/{orgId}/{locationId}/virtual-brands` y edición usa `PUT /api/app/{orgId}/{locationId}/virtual-brands/{id}`. Tras éxito, la app muestra confirmación, vuelve al listado e invalida los datos para refrescar la marca.
- 7.
Usar el alta guiada
Si se abre `/location/brands?setupGuide=brand`, la pantalla guía el alta y orienta al usuario por nombre, favicon, logos, portada y paleta, manteniendo las validaciones normales del formulario.
Validaciones y límites
- Sin organización o ubicación seleccionada, la pantalla muestra error y no carga marcas.
- `Nueva marca` y las acciones de gestión solo aparecen para usuarios con permiso de creación o edición.
- `name` es obligatorio en la UI y en creación backend.
- Los colores no vacíos deben ser hexadecimales válidos; no hay evidencia de validación backend específica para formato de color.
- Las proporciones esperadas son 1:1 para favicon y logo cuadrado, 16:5 para logo color y logo en blanco y negro, y 3:1 para portada.
- La marca debe pertenecer al scope activo; un identificador inexistente o de otro scope se trata como no encontrado.
- La base de datos exige exactamente uno de `org_id` o `location_id`.
- Crear o editar una marca virtual no selecciona automáticamente la marca activa del TPV.
- El formulario actual no expone `code`; cualquier documentación que lo mencione debe actualizarse antes de publicar.
Resultado esperado
La marca virtual queda guardada en la ubicación activa con su identidad visual y colores. El listado se actualiza y la marca queda disponible para otros flujos del TPV, sin cambiar automáticamente `tpv_settings.brand_id`.