Editar alérgeno
Actualiza un alérgeno de Grupo Marea Demo o de Marea Gran Via cambiando nombre, descripción, color o imagen sin perder el ámbito propietario.
En este artículo
La edición de alérgenos mantiene coherente la información de carta que el equipo consulta al trabajar con productos y catálogos.
El detalle puede abrirse en lectura o edición. La aplicación guarda contra el ámbito propietario del alérgeno, sea organización o ubicación, y no solo contra la ruta desde la que se abrió.
Antes de empezar
- Sesión iniciada con organización seleccionada.
- Para editar en ámbito ubicación, debe estar seleccionada Marea Gran Via o la ubicación correspondiente.
- Debe existir un `allergenId` accesible desde la pestaña Alérgenos o desde la ruta `allergen-item/{id}`.
- El usuario necesita `catalog:manage` en el ámbito propietario del alérgeno; con solo `catalog:view`, el detalle queda en modo consulta.
- Para reemplazar la imagen, debe estar disponible `/api/app/files` y debe seleccionarse un archivo de imagen.
Instrucciones
- 1.
Abrir Alérgenos
En la gestión de catálogos de Marea Gran Via, abre la pestaña Alérgenos. La lista ayuda a identificar el alérgeno por nombre, color o imagen, descripción y propietario antes de entrar al detalle.
- 2.
Entrar al detalle
Selecciona una fila editable para abrir `allergen-item/{id}`. El formulario muestra Nombre, Descripción, Color e Imagen, y permite confirmar si el alérgeno se gestiona desde organización o desde ubicación.
- 3.
Modificar los campos
Actualiza el nombre, la descripción o el color. El nombre es obligatorio y el color se normaliza antes de enviarse, con un valor de reserva si queda vacío o inválido.
- 4.
Reemplazar imagen
Si hace falta cambiar la imagen, usa el campo Imagen para subir un nuevo archivo. La aplicación guarda primero el archivo y después asocia su identificador al alérgeno.
- 5.
Guardar cambios
Pulsa Guardar. La aplicación envía la actualización al ámbito propietario del alérgeno; si termina correctamente, actualiza lista y detalle, muestra confirmación y vuelve a la pestaña de origen.
Validaciones y límites
- La pantalla carga con `catalog:view` o `catalog:manage`; sin acceso suficiente se muestra `noAccess`.
- Los alérgenos `system` pueden consultarse, pero no editarse.
- Guardar queda deshabilitado si no hay cambios, si el formulario no es válido o si ya se está guardando.
- `Nombre` no puede quedar vacío después de quitar espacios; el backend repite esta validación antes de actualizar.
- `Color` se normaliza antes de guardar; si el valor no sirve, la UI prepara `#98A2B3`.
- La imagen se sube primero con `POST /api/app/files`; si falla, no se reemplaza el `imageFileId` local.
- La pantalla permite subir o reemplazar imagen, pero no muestra un control explícito para quitar una imagen existente.
- La pantalla actual no permite editar `name_translations` ni `description_translations`, aunque la API los acepte.
- Editar un alérgeno no cambia `product_allergens`; los productos que ya lo referencian verán sus datos actualizados.
Resultado esperado
El alérgeno queda actualizado en su ámbito propietario. Si hay servicios u ocurrencias afectados, el backend puede crear snapshots históricos de catálogo antes de aplicar el cambio.