Portal de administración¶

Acceso¶

CU-A-01¶

Iniciar sesión con segundo factor

• Actor: Cualquier rol interno
• Precondición: La cuenta está activa y tiene credencial de segundo factor confirmada
• Requerimientos:

  • RF-A-02
  • RF-A-03

Flujo principal

1. El administrador introduce correo y contraseña.
2. El sistema solicita el código temporal de la aplicación autenticadora.
3. Verificado el código, abre la sesión con expiración por inactividad de treinta minutos.

• Postcondición: Sesión administrativa activa.

CU-A-02¶

Dar de alta una cuenta interna

• Actor: Superadministrador
• Precondición: Sesión abierta
• Requerimientos:

  • RF-A-01
  • RF-A-05

Flujo principal

1. El Superadministrador introduce el correo y elige el rol interno.
2. El sistema emite una invitación con enlace de un solo uso.
3. El invitado crea su contraseña y da de alta su segundo factor.
4. El sistema registra el alta en bitácora y avisa a los demás Superadministradores.

• Postcondición: Existe una cuenta interna activa con su rol.

CU-A-03¶

Cambiar el rol de una cuenta interna

• Actor: Superadministrador
• Precondición: La cuenta existe
• Requerimientos:

  • RF-A-04
  • RF-A-05

Flujo principal

1. El Superadministrador selecciona el rol nuevo.
2. El sistema lo aplica, registra el cambio y notifica a los demás Superadministradores.

• Postcondición: La cuenta opera con el rol nuevo.

CU-A-04¶

Desactivar una cuenta interna

• Actor: Superadministrador
• Precondición: La cuenta está activa
• Requerimientos:

  • RF-A-05

Flujo principal

1. El Superadministrador desactiva la cuenta.
2. El sistema revoca de inmediato sus sesiones administrativas.

3. El historial de acciones de esa cuenta permanece intacto y sigue nombrándola.

4. Postcondición: La cuenta queda sin acceso, conservando su rastro.

Afiliación¶

CU-A-05¶

Revisar una solicitud de afiliación

• Actor: Operaciones
• Precondición: La solicitud está en la bandeja
• Requerimientos:

  • RF-A-06
  • RF-A-07

Flujo principal

1. El administrador abre la bandeja, ordenada por antigüedad.
2. Abre la ficha consolidada con los datos, la ubicación en mapa, la fachada y la licencia.
3. Verifica las señales automáticas: verificación de canales, posible duplicado y cobertura.

• Postcondición: Ninguna. La consulta queda registrada.

CU-A-06¶

Aprobar una afiliación

• Actor: Operaciones
• Precondición: Ambos canales del responsable están verificados
• Requerimientos:

  • RF-A-08

Flujo principal

1. El administrador aprueba la solicitud.
2. El sistema pasa el comercio a activo y materializa el horario declarado como horario de atención.
3. Envía al responsable el enlace de creación de contraseña con vigencia de setenta y dos horas.
4. Registra el aprobador con fecha y hora.

• Postcondición: El comercio está activo y pendiente de completar su configuración.

CU-A-07¶

Rechazar una afiliación

• Actor: Operaciones
• Precondición: La solicitud está en revisión
• Requerimientos:

  • RF-A-09

Flujo principal

1. El administrador selecciona el motivo de la lista cerrada.
2. Si el motivo lo exige, escribe la nota.
3. El sistema notifica al solicitante con el motivo y la fecha a partir de la cual puede reaplicar.

• Postcondición: La solicitud queda rechazada con su motivo archivado.

CU-A-08¶

Solicitar información adicional

• Actor: Operaciones
• Precondición: La solicitud está en revisión
• Requerimientos:

  • RF-A-10

Flujo principal

1. El administrador escribe qué falta, con hasta quinientos caracteres.
2. El sistema notifica al solicitante y le reabre la edición de su formulario sin perder lo ingresado.
3. Fija el vencimiento a quince días.

• Postcondición: La solicitud espera al solicitante.

Comercios¶

CU-A-09¶

Consultar el directorio de comercios

• Actor: Cualquier rol interno
• Precondición: Sesión abierta
• Requerimientos:

  • RF-A-11
  • RF-A-12

Flujo principal

1. El administrador filtra por estado, categoría, zona o rango de calificación, o busca por nombre o RUC.
2. Abre la ficha administrativa de un comercio y consulta su configuración, sus usuarios y su historial de estados.

• Postcondición: Ninguna.

CU-A-10¶

Aprobar un cambio sensible de ficha

• Actor: Operaciones
• Precondición: Existe una solicitud de cambio pendiente
• Requerimientos:

  • RF-A-13

Flujo principal

1. El administrador abre la cola y compara el valor anterior con el propuesto.
2. Aprueba el cambio.
3. El sistema aplica el valor en la ficha pública.

• Postcondición: La solicitud queda resuelta.

CU-A-11¶

Suspender un comercio

• Actor: Operaciones
• Precondición: El comercio está activo
• Requerimientos:

  • RF-A-14
  • RF-A-15

Flujo principal

1. El administrador selecciona el motivo de la lista cerrada.
2. El sistema muestra las reservas vivas del comercio y exige decidir entre mantenerlas o cancelarlas masivamente.
3. Registrada la decisión, la suspensión se ejecuta: oculta la ficha, bloquea publicaciones y bloquea reservas nuevas.
4. El comercio conserva el acceso al portal para atender lo pendiente.

• Postcondición: El comercio queda suspendido y la decisión sobre sus reservas registrada.

CU-A-12¶

Reactivar un comercio

• Actor: Operaciones
• Precondición: El comercio está suspendido o pausado
• Requerimientos:

  • RF-A-16

Flujo principal

1. El administrador reactiva el comercio.
2. El sistema restituye el estado activo conservando plantillas, horarios e historial.

3. La ficha vuelve al mapa y la generación diaria se reanuda.

4. Postcondición: El comercio vuelve a publicar.

CU-A-13¶

Dar de baja definitiva a un comercio

• Actor: Superadministrador
• Precondición: El comercio no está dado de baja
• Requerimientos:

  • RF-A-16

Flujo principal

1. El Superadministrador confirma la baja con motivo obligatorio.
2. El sistema aplica el mismo flujo de resolución de reservas vivas que la suspensión.
3. Retira la ficha pública y desactiva a todos los usuarios del comercio.
4. El historial transaccional permanece íntegro.

• Postcondición: El comercio queda dado de baja de forma irreversible.

Usuarios¶

CU-A-14¶

Consultar la ficha de un usuario

• Actor: Operaciones o Soporte
• Precondición: Sesión abierta
• Requerimientos:

  • RF-A-17
  • RF-A-18

Flujo principal

1. El administrador busca por nombre, teléfono o correo.
2. Abre la ficha con historial de reservas, incidencias, valoraciones y sanciones.
3. El sistema registra el acceso indicando quién consultó, con qué rol y cuándo.

• Postcondición: El acceso queda registrado y es consultable por el titular.

CU-A-15¶

Levantar o extender una sanción automática

• Actor: Operaciones
• Precondición: Existe una sanción vigente
• Requerimientos:

  • RF-A-19

Flujo principal

1. El administrador abre la sanción y revisa las reservas expiradas que la originaron, congeladas al momento de aplicarse.
2. La levanta anticipadamente indicando motivo, o extiende su duración.

3. El sistema notifica al usuario el cambio.

4. Postcondición: La sanción queda levantada o extendida con su motivo.

CU-A-16¶

Suspender manualmente a un usuario

• Actor: Operaciones
• Precondición: La cuenta está activa
• Requerimientos:

  • RF-A-20

Flujo principal

1. El administrador selecciona el motivo y la duración, en días o indefinida.
2. El sistema aplica la suspensión; el usuario conserva el acceso pero no puede reservar.
3. Al intentar reservar, la aplicación le muestra el motivo y la fecha de reactivación.

• Postcondición: El usuario queda sin capacidad de reservar.

CU-A-17¶

Asistir el acceso de un usuario

• Actor: Soporte
• Precondición: El usuario solicitó ayuda
• Requerimientos:

  • RF-A-21

Flujo principal

1. El administrador reenvía el código de verificación al canal ya verificado.
2. El sistema respeta los límites de envío por hora.

• Postcondición: El usuario recibe un código nuevo.

CU-A-18¶

Acompañar a un usuario en soporte

• Actor: Soporte
• Precondición: Sesión abierta
• Requerimientos:

  • RF-A-22

Flujo principal

1. El administrador abre la vista de acompañamiento del usuario.
2. Ve sus reservas activas, códigos e historial en modo lectura.
3. El sistema registra el acceso como consulta a dato personal.

• Postcondición: El acceso queda registrado.

CU-A-19¶

Ejecutar una solicitud de eliminación de cuenta

• Actor: Operaciones
• Precondición: Existe una solicitud pendiente
• Requerimientos:

  • RF-A-62

Flujo principal

1. El administrador abre la bandeja y selecciona la solicitud.
2. El sistema verifica que no queden reservas vivas.
3. Ejecuta la anonimización: vacía nombre, correo, teléfono y foto, y conserva el historial transaccional sin datos personales.

• Postcondición: La cuenta queda anonimizada de forma irreversible.

Moderación¶

CU-A-20¶

Revisar una alerta de contenido

• Actor: Operaciones
• Precondición: Existe una alerta abierta
• Requerimientos:

  • RF-A-23
  • RF-A-25

Flujo principal

1. El administrador abre el tablero de alertas por familia y gravedad.
2. Revisa la publicación señalada y los valores que dispararon la alerta.
3. Marca la alerta como revisada o descartada, con nota.

• Postcondición: La alerta deja de requerir atención.

CU-A-21¶

Despublicar una oferta

• Actor: Operaciones
• Precondición: La publicación está visible
• Requerimientos:

  • RF-A-24

Flujo principal

1. El administrador selecciona el motivo de la lista cerrada.
2. El sistema muestra las reservas vivas de esa publicación y exige decidir entre mantenerlas o cancelarlas.
3. Retira la oferta del mapa de inmediato y notifica al comercio con el motivo.

• Postcondición: La oferta queda retirada con su motivo y la decisión sobre las reservas registrada.

CU-A-22¶

Moderar una valoración

• Actor: Operaciones
• Precondición: La valoración está publicada
• Requerimientos:

  • RF-A-26

Flujo principal

1. El administrador abre la bandeja de moderación.
2. Oculta la valoración indicando motivo obligatorio.
3. El sistema recalcula el promedio del comercio excluyéndola.

• Postcondición: La valoración deja de ser visible y el promedio refleja el cambio.

CU-A-23¶

Aprobar la respuesta de un comercio

• Actor: Operaciones
• Precondición: Existe una respuesta pendiente
• Requerimientos:

  • RF-A-26

Flujo principal

1. El administrador abre la cola de respuestas pendientes.
2. Aprueba la respuesta, que aparece bajo la valoración.

• Postcondición: La respuesta queda publicada o rechazada.

Operación¶

CU-A-24¶

Vigilar el monitor global del día

• Actor: Operaciones o Analista
• Precondición: Sesión abierta
• Requerimientos:

  • RF-A-27

Flujo principal

1. El administrador abre el monitor del día.
2. El sistema muestra reservas creadas, entregadas, pendientes, canceladas por cada actor y expiradas, con desglose por comercio y por ventana.

3. La vista se actualiza automáticamente sobre datos operativos en vivo.

4. Postcondición: Ninguna.

CU-A-25¶

Localizar una reserva

• Actor: Operaciones o Soporte
• Precondición: Sesión abierta
• Requerimientos:

  • RF-A-28

Flujo principal

1. El administrador busca por identificador, código de retiro, teléfono del usuario o nombre del comercio.

2. El sistema devuelve la reserva con su línea de tiempo completa, indicando cada evento con su hora, su actor y el operador que la validó.

3. Postcondición: Ninguna. La consulta queda registrada.

CU-A-26¶

Cancelar administrativamente una reserva

• Actor: Operaciones
• Precondición: La reserva está viva
• Requerimientos:

  • RF-A-29

Flujo principal

1. El administrador selecciona el motivo obligatorio.
2. El sistema cancela la reserva con un estado diferenciado del de las cancelaciones del comercio y del usuario.
3. Libera las unidades y notifica a ambas partes.

• Postcondición: La reserva queda cancelada sin afectar los indicadores del comercio.

CU-A-27¶

Registrar una validación excepcional

• Actor: Operaciones
• Precondición: La entrega ocurrió pero no se validó digitalmente
• Requerimientos:

  • RF-A-30

Flujo principal

1. El administrador localiza la reserva y confirma con el comercio que la entrega ocurrió.
2. Escribe la nota obligatoria y registra la validación.
3. El sistema la marca como excepcional y cierra la reserva como retirada.

• Postcondición: La entrega queda registrada, identificable como excepcional en los reportes.

CU-A-28¶

Definir la zona de cobertura

• Actor: Superadministrador
• Precondición: Sesión abierta
• Requerimientos:

  • RF-A-31

Flujo principal

1. El administrador define el área como un radio desde un punto o como un polígono, con su vigencia.
2. El sistema la aplica a las solicitudes nuevas y al aviso de cobertura de la aplicación.

• Postcondición: El área habilitada queda actualizada sin reescribir el pasado.

Incidencias¶

CU-A-29¶

Atender la bandeja de incidencias

• Actor: Operaciones o Soporte
• Precondición: Sesión abierta
• Requerimientos:

  • RF-A-32

Flujo principal

1. El administrador abre la bandeja ordenada por prioridad y antigüedad del último movimiento.
2. Abre una incidencia y ve el reporte del usuario y el historial completo de la reserva.

• Postcondición: Ninguna.

CU-A-30¶

Solicitar descargo al comercio

• Actor: Operaciones
• Precondición: La incidencia está abierta
• Requerimientos:

  • RF-A-34

Flujo principal

1. El administrador solicita la versión del comercio indicando un plazo.
2. El sistema notifica al comercio y pasa la incidencia a esperando al comercio.
3. El comercio responde y la incidencia vuelve a análisis.

• Postcondición: El expediente incluye lo solicitado y lo respondido.

CU-A-31¶

Resolver una incidencia

• Actor: Operaciones
• Precondición: La incidencia está abierta o en análisis
• Requerimientos:

  • RF-A-33

Flujo principal

1. El administrador elige la resolución de la lista cerrada.
2. Escribe la nota interna y el mensaje visible para el usuario.
3. El sistema cierra la incidencia y notifica al usuario.

• Postcondición: La incidencia queda resuelta o descartada con su constancia.

CU-A-32¶

Escalar por inocuidad alimentaria

• Actor: Operaciones
• Precondición: La incidencia es de categoría de contenido en mal estado
• Requerimientos:

  • RF-A-35

Flujo principal

1. El sistema marca la incidencia con prioridad alta y notifica a Operaciones al abrirse.
2. El administrador suspende preventivamente al comercio desde la propia incidencia.

3. El sistema aplica el flujo de resolución de reservas vivas.

4. Postcondición: El comercio queda suspendido y la incidencia enlazada a la suspensión.

CU-A-33¶

Revisar patrones de incidencias

• Actor: Operaciones
• Precondición: Sesión abierta
• Requerimientos:

  • RF-A-36

Flujo principal

1. El administrador abre la vista agrupada por comercio y por usuario.

2. El sistema muestra las incidencias de los últimos treinta y noventa días con su categoría y desenlace.

3. Postcondición: Ninguna.

Configuración¶

CU-A-34¶

Cambiar un parámetro del sistema

• Actor: Superadministrador
• Precondición: Sesión abierta
• Requerimientos:

  • RF-A-37

Flujo principal

1. El administrador abre la pantalla de parámetros agrupada por ámbito.
2. Cambia el valor.
3. El sistema lo valida contra el tipo y el rango declarados, lo aplica y registra el cambio con su autor.

• Postcondición: El parámetro rige desde ese instante para las operaciones nuevas.

CU-A-35¶

Revertir un cambio de parámetro

• Actor: Superadministrador
• Precondición: Existe un cambio previo
• Requerimientos:

  • RF-A-37

Flujo principal

1. El administrador abre el historial del parámetro y elige el cambio a deshacer.

2. El sistema registra un cambio nuevo enlazado al anterior, con el valor previo como valor nuevo.

3. Postcondición: El parámetro vuelve al valor anterior y el historial muestra que alguien decidió deshacer.

CU-A-36¶

Administrar un catálogo

• Actor: Operaciones o Superadministrador
• Precondición: Sesión abierta
• Requerimientos:

  • RF-A-45
  • RF-A-46
  • RF-A-47

Flujo principal

1. El administrador da de alta, edita o reordena un valor del catálogo.
2. El sistema lo aplica de inmediato en la aplicación y en el portal.

• Postcondición: El catálogo queda actualizado sin romper el histórico.

CU-A-37¶

Agregar un estado o una transición

• Actor: Superadministrador
• Precondición: Sesión abierta
• Requerimientos:

  • RF-A-63

Flujo principal

1. El administrador da de alta el estado con su código, etiqueta, descripción y atributos semánticos.
2. Declara las transiciones que lo alcanzan y las que salen de él, con su actor y su exigencia de motivo.
3. El sistema lo admite de inmediato en el motor.

• Postcondición: El ciclo de vida admite el estado nuevo sin desplegar código.

Comunicación¶

CU-A-38¶

Enviar una campaña masiva

• Actor: Operaciones
• Precondición: No se alcanzó el límite semanal
• Requerimientos:

  • RF-A-48
  • RF-A-50

Flujo principal

1. El administrador define el segmento y elige la plantilla.
2. Solicita la vista previa, que muestra el mensaje resuelto y el número estimado de destinatarios.
3. Un segundo administrador confirma el envío.
4. El sistema materializa un aviso por destinatario, respetando las preferencias de cada uno, y registra el número real de envíos.

• Postcondición: La campaña queda enviada con su número estimado y su número real.

CU-A-39¶

Editar una plantilla de mensaje

• Actor: Operaciones
• Precondición: Sesión abierta
• Requerimientos:

  • RF-A-50

Flujo principal

1. El administrador crea una versión nueva a partir de la vigente.
2. Edita el texto usando las variables documentadas de esa plantilla.
3. Solicita la vista previa y publica la versión.

4. El sistema archiva la versión anterior; solo una queda vigente por código y canal.

5. Postcondición: Los mensajes futuros usan la versión nueva; los ya enviados conservan la suya.

Reportes¶

CU-A-40¶

Consultar el tablero del piloto

• Actor: Analista o superior
• Precondición: Sesión abierta
• Requerimientos:

  • RF-A-51
  • RF-A-53
  • RF-A-55

Flujo principal

1. El administrador elige el periodo.

2. El sistema muestra usuarios, comercios, ofertas, unidades rescatadas, monto transado, ticket promedio, tasa de venta y tasa de no presentación, con comparativo y evolución diaria.

3. Postcondición: Ninguna.

CU-A-41¶

Analizar el embudo de conversión

• Actor: Analista o superior
• Precondición: Sesión abierta
• Requerimientos:

  • RF-A-52
  • RF-A-54

Flujo principal

1. El administrador abre el embudo por día y plataforma.
2. El sistema muestra exploraciones, vistas de detalle, reservas iniciadas, confirmadas y retiradas, con la tasa de caída de cada paso, incluyendo a los visitantes sin cuenta.

3. Complementa con las búsquedas sin resultados agrupadas por zona y franja horaria.

4. Postcondición: Ninguna.

CU-A-42¶

Exportar datos

• Actor: Analista o superior
• Precondición: Sesión abierta
• Requerimientos:

  • RF-A-56

Flujo principal

1. El administrador elige tipo, formato, rango de fechas y filtros.
2. El sistema genera el archivo y registra la exportación con su autor, filtros y número de filas.

• Postcondición: Existe un archivo descargable y su registro en bitácora.

Auditoría y sistema¶

CU-A-43¶

Consultar la bitácora global

• Actor: Operaciones o superior
• Precondición: Sesión abierta
• Requerimientos:

  • RF-A-57
  • RF-A-59

Flujo principal

1. El administrador filtra por administrador, tipo de acción, entidad afectada o rango de fechas.
2. El sistema muestra cada acción con su autor, el rol que tenía en ese momento, la fecha, la hora y el origen.

• Postcondición: Ninguna.

CU-A-44¶

Atender una alerta de seguridad

• Actor: Superadministrador
• Precondición: Existe una alerta abierta
• Requerimientos:

  • RF-A-58

Flujo principal

1. El Superadministrador recibe la notificación y abre la alerta.
2. Revisa los valores que la dispararon y la entidad afectada.

3. La marca como revisada o descartada con nota.

4. Postcondición: La alerta deja de requerir atención.

CU-A-45¶

Activar el modo mantenimiento

• Actor: Superadministrador
• Precondición: No hay otro modo mantenimiento vigente
• Requerimientos:

  • RF-A-60

Flujo principal

1. El Superadministrador escribe el mensaje para la aplicación y el mensaje para el portal.
2. Activa el modo, que bloquea reservas y publicaciones nuevas.

3. La consulta de reservas activas, la validación en mostrador y los procesos programados siguen funcionando.

4. Postcondición: El sistema queda en mantenimiento sin dejar reservas colgadas.

CU-A-46¶

Revisar la salud operativa

• Actor: Operaciones o superior
• Precondición: Sesión abierta
• Requerimientos:

  • RF-A-61

Flujo principal

1. El administrador abre el monitor de servicios.
2. El sistema muestra el estado de notificaciones push, mensajes de texto, correo y mapas, con el conteo de fallos de las últimas veinticuatro horas ordenado por severidad.

• Postcondición: Ninguna.