Portal de comercios¶

Afiliación¶

CU-C-01¶

Enviar solicitud de afiliación

• Actor: Solicitante
• Precondición: Ninguna
• Requerimientos:

  • RF-C-03
  • RF-C-04
  • RF-C-05
  • RF-C-08

Flujo principal

1. El responsable completa el formulario público con los datos del negocio, arrastra el pin al local y adjunta la foto de fachada.
2. Acepta los términos comerciales; el sistema registra versión, fecha, hora e IP.
3. El sistema solicita el código de seis dígitos enviado por SMS al teléfono declarado.
4. El sistema solicita la confirmación del enlace enviado al correo del responsable.
5. Con ambos canales verificados, la solicitud entra a la bandeja de revisión y el comercio queda en estado pendiente.

• Postcondición: Existe un comercio en estado pendiente de revisión con su expediente de afiliación completo.

CU-C-02¶

Completar información requerida

• Actor: Solicitante
• Precondición: La solicitud fue devuelta por administración pidiendo información
• Requerimientos:

  • RF-C-03
  • RF-A-10

Flujo principal

1. El responsable abre el enlace del correo que detalla lo solicitado.
2. Corrige los campos señalados o adjunta el documento faltante.
3. Reenvía la solicitud, que vuelve a la bandeja de revisión.

• Postcondición: La solicitud vuelve a requerir acción de administración.

CU-C-03¶

Activar la cuenta administradora

• Actor: Solicitante
• Precondición: La solicitud fue aprobada
• Requerimientos:

  • RF-C-07
  • RF-C-12

Flujo principal

1. El responsable abre el enlace de un solo uso recibido por correo.
2. Define su contraseña.
3. El sistema crea la membresía administradora del comercio y abre la sesión.
4. El portal muestra la lista de configuración pendiente antes de poder publicar: logo, horario de atención y al menos una ventana de recogida.

• Postcondición: El comercio tiene un administrador activo y queda en condiciones de completar su configuración.

CU-C-04¶

Volver a aplicar tras un rechazo

• Actor: Solicitante
• Precondición: La solicitud fue rechazada hace quince días o más
• Requerimientos:

  • RF-C-07

Flujo principal

1. El responsable abre el formulario público con el mismo RUC.
2. El sistema reconoce el expediente anterior y precarga los datos que no fueron motivo del rechazo.
3. El responsable corrige lo señalado y reenvía.

• Postcondición: El expediente se reabre con una revisión nueva.

Acceso¶

CU-C-05¶

Iniciar sesión en el portal

• Actor: Administrador u Operador del comercio
• Precondición: La membresía está activa
• Requerimientos:

  • RF-C-09
  • RF-C-11

Flujo principal

1. El usuario introduce correo y contraseña.
2. El sistema registra el intento y abre la sesión con el ámbito del comercio.
3. Si la persona pertenece a varios comercios, elige en cuál va a operar.

• Postcondición: Existe una sesión activa acotada a un comercio.

CU-C-06¶

Recuperar la contraseña

• Actor: Administrador u Operador del comercio
• Precondición: La cuenta existe
• Requerimientos:

  • RF-C-10

Flujo principal

1. El usuario solicita el restablecimiento desde la pantalla de acceso.
2. El sistema envía un enlace de un solo uso al correo registrado.
3. El usuario define la contraseña nueva.
4. El sistema revoca todas las sesiones abiertas de esa cuenta.

• Postcondición: La contraseña queda cambiada y no hay sesiones previas vigentes.

CU-C-07¶

Cerrar la sesión

• Actor: Administrador u Operador del comercio
• Precondición: Sesión abierta
• Requerimientos:

  • RF-C-11

Flujo principal

1. El usuario cierra la sesión desde el menú.
2. El sistema la revoca con motivo de salida voluntaria.

• Postcondición: La sesión queda revocada con su motivo registrado.

Equipo¶

CU-C-08¶

Invitar a un operador

• Actor: Administrador del comercio
• Precondición: El comercio no alcanzó el tope de operadores
• Requerimientos:

  • RF-C-12
  • RF-C-13

Flujo principal

1. El administrador introduce el correo del operador y selecciona su rol.
2. El sistema emite la invitación y envía el enlace de un solo uso.
3. El invitado define su contraseña y el sistema crea la membresía.

• Postcondición: Existe un miembro nuevo con el rol asignado.

CU-C-09¶

Desactivar a un miembro del equipo

• Actor: Administrador del comercio
• Precondición: El miembro está activo
• Requerimientos:

  • RF-C-13

Flujo principal

1. El administrador desactiva la membresía.
2. El sistema revoca de inmediato las sesiones de esa persona en ese comercio.
3. El historial de validaciones ejecutadas por esa persona permanece intacto y sigue nombrándola.

• Postcondición: La membresía queda desactivada sin perder su historial.

CU-C-10¶

Consultar la bitácora del comercio

• Actor: Administrador del comercio
• Precondición: Sesión abierta
• Requerimientos:

  • RF-C-14

Flujo principal

1. El administrador abre la bitácora y filtra por tipo de acción, usuario o rango de fechas.

2. El sistema muestra las acciones del comercio con su autor, fecha, hora, dirección de origen y valores anterior y nuevo cuando aplica.

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

Perfil público¶

CU-C-11¶

Editar la ficha pública

• Actor: Administrador del comercio
• Precondición: Sesión abierta
• Requerimientos:

  • RF-C-15

Flujo principal

1. El administrador edita descripción, referencias de llegada, teléfono público, logo o galería.
2. El sistema valida el tamaño y las dimensiones de cada imagen.
3. Los cambios quedan publicados de inmediato.

• Postcondición: La ficha pública refleja los cambios.

CU-C-12¶

Solicitar un cambio sensible

• Actor: Administrador del comercio
• Precondición: Sesión abierta
• Requerimientos:

  • RF-C-16

Flujo principal

1. El administrador modifica el nombre comercial, la categoría, la dirección o la ubicación.
2. El sistema detecta que el campo requiere aprobación y crea una solicitud de cambio.
3. La ficha pública conserva el valor anterior hasta que administración resuelva.
4. Al aprobarse, el valor nuevo entra en vigor.

• Postcondición: Existe una solicitud pendiente o el valor quedó aplicado.

Horarios¶

CU-C-13¶

Configurar el horario de atención

• Actor: Administrador del comercio
• Precondición: Sesión abierta
• Requerimientos:

  • RF-C-17

Flujo principal

1. El administrador define apertura y cierre para cada día, o marca el día como cerrado.
2. El sistema guarda los siete días.

• Postcondición: El comercio tiene un horario completo de siete días.

CU-C-14¶

Definir las ventanas de recogida

• Actor: Administrador del comercio
• Precondición: El horario de atención está configurado
• Requerimientos:

  • RF-C-18
  • RF-C-20

Flujo principal

1. El administrador elige un día y define inicio, fin y etiqueta de la ventana.
2. El sistema verifica que la ventana quede dentro del horario de atención de ese día.
3. El sistema verifica que no se solape con otra ventana activa del mismo día.
4. La ventana queda disponible para asignarse en la programación semanal.

• Postcondición: Existe una ventana activa asignable a plantillas.

CU-C-15¶

Registrar una excepción de calendario

• Actor: Administrador del comercio
• Precondición: Existe la ventana o plantilla que se va a excepcionar
• Requerimientos:

  • RF-C-21

Flujo principal

1. El administrador elige una fecha dentro de los próximos noventa días.
2. Elige si cierra el día completo, modifica el horario de una ventana o cambia la cantidad de una plantilla.
3. El sistema guarda la excepción, que se aplicará al generar las publicaciones de esa fecha.

• Postcondición: La generación de esa fecha usará la excepción.

CU-C-16¶

Pausar el comercio

• Actor: Administrador del comercio
• Precondición: No hay reservas vivas
• Requerimientos:

  • RF-C-22

Flujo principal

1. El administrador elige la duración de la pausa y su motivo.
2. El sistema oculta la ficha del mapa, detiene la generación de publicaciones y bloquea nuevas reservas.
3. Al terminar la pausa, el comercio vuelve a estado activo.

• Postcondición: El comercio queda pausado y fuera del mapa.

Catálogo de ofertas¶

CU-C-17¶

Crear una plantilla de pack sorpresa

• Actor: Administrador del comercio
• Precondición: El comercio no alcanzó el tope de plantillas activas
• Requerimientos:

  • RF-C-27
  • RF-C-28
  • RF-C-30

Flujo principal

1. El administrador nombra la plantilla y elige su categoría de comida.
2. Enumera entre tres y ocho elementos que el pack puede contener.
3. Fija el precio y el valor de referencia; el sistema calcula el descuento.
4. Activa la plantilla.

• Postcondición: Existe una plantilla activa programable.

CU-C-18¶

Crear una plantilla de oferta específica

• Actor: Administrador del comercio
• Precondición: El comercio no alcanzó el tope de plantillas activas
• Requerimientos:

  • RF-C-27
  • RF-C-29
  • RF-C-30

Flujo principal

1. El administrador nombra la oferta, escribe su descripción y elige la categoría.
2. Declara en la descripción los ingredientes y advertencias relevantes, incluidos los alérgenos.
3. Adjunta la foto del producto.
4. Fija el precio y el valor de referencia y activa la plantilla.

• Postcondición: Existe una plantilla activa programable.

CU-C-19¶

Programar una plantilla en la semana

• Actor: Administrador del comercio
• Precondición: Existen la plantilla activa y al menos una ventana
• Requerimientos:

  • RF-C-19
  • RF-C-23

Flujo principal

1. El administrador marca los días en que la plantilla se ofrece.
2. Para cada día activo elige la ventana de recogida y la cantidad predeterminada.
3. El sistema guarda la programación y la usará en la generación diaria.

• Postcondición: La plantilla se publicará automáticamente los días marcados.

CU-C-20¶

Desactivar una plantilla

• Actor: Administrador del comercio
• Precondición: La plantilla está activa
• Requerimientos:

  • RF-C-27

Flujo principal

1. El administrador desactiva la plantilla.
2. El sistema deja de generar publicaciones a partir de ella.

3. Las publicaciones ya generadas y sus reservas siguen su curso normal.

4. Postcondición: La plantilla queda inactiva sin afectar lo ya publicado.

Publicación diaria¶

CU-C-21¶

Revisar la generación automática del día

• Actor: Administrador u Operador del comercio
• Precondición: Existe programación semanal activa
• Requerimientos:

  • RF-C-23
  • RF-C-25
  • RF-C-35

Flujo principal

1. A la hora configurada, el sistema genera las publicaciones del día aplicando las excepciones de calendario.
2. El comercio abre el tablero y revisa lo generado.
3. Confirma la aptitud de cada publicación, requisito para que se abra a reservas.
4. Las publicaciones se abren a reservas al llegar su instante configurado.

• Postcondición: El día tiene su inventario publicado o programado.

CU-C-22¶

Publicar una oferta manual

• Actor: Administrador u Operador del comercio
• Precondición: El comercio está activo y tiene una ventana disponible
• Requerimientos:

  • RF-C-24
  • RF-C-35

Flujo principal

1. El comercio crea una publicación puntual eligiendo fecha, ventana, contenido, precio y cantidad.
2. Confirma la declaración de aptitud del producto.
3. El sistema publica dentro del horizonte permitido.

• Postcondición: Existe una publicación fuera de la programación semanal.

CU-C-23¶

Duplicar la publicación de otro día

• Actor: Administrador u Operador del comercio
• Precondición: Existe la publicación de origen
• Requerimientos:

  • RF-C-34

Flujo principal

1. El comercio elige una publicación anterior y la fecha destino.
2. El sistema copia contenido, precio y cantidad, y resuelve los instantes con la ventana de la fecha destino.

3. El comercio confirma la aptitud y ajusta lo que necesite.

4. Postcondición: Existe una publicación nueva enlazada a la que la originó.

CU-C-24¶

Ajustar el stock publicado

• Actor: Administrador u Operador del comercio
• Precondición: La publicación admite ajuste de stock
• Requerimientos:

  • RF-C-31
  • RF-C-32

Flujo principal

1. El comercio cambia la cantidad total de la publicación.
2. El sistema recalcula la disponibilidad y actualiza el mapa.

• Postcondición: La disponibilidad refleja la cantidad nueva.

CU-C-25¶

Marcar una publicación como agotada

• Actor: Administrador u Operador del comercio
• Precondición: La publicación está abierta a reservas
• Requerimientos:

  • RF-C-33

Flujo principal

1. El comercio marca la publicación como agotada.
2. El sistema iguala la cantidad total a las unidades ya reservadas, con lo que la disponibilidad queda en cero.

3. Las reservas existentes conservan su obligación de entrega.

4. Postcondición: La publicación deja de admitir reservas sin cancelar ninguna.

CU-C-26¶

Corregir el precio de una publicación

• Actor: Administrador del comercio
• Precondición: La publicación no tiene reservas
• Requerimientos:

  • RF-C-30

Flujo principal

1. El comercio corrige el precio o el valor de referencia.
2. El sistema revalida el descuento mínimo y actualiza la publicación.

• Postcondición: El precio publicado queda corregido.

Operación del día¶

CU-C-27¶

Vigilar el tablero del día

• Actor: Administrador u Operador del comercio
• Precondición: Sesión abierta
• Requerimientos:

  • RF-C-36
  • RF-C-37

Flujo principal

1. El comercio abre el tablero, que agrupa las reservas del día por ventana.
2. El sistema muestra por publicación las unidades publicadas, reservadas, entregadas y pendientes.

3. La vista se refresca periódicamente sin recargar la página.

4. Postcondición: Ninguna.

CU-C-28¶

Consultar el contacto de un cliente

• Actor: Administrador u Operador del comercio
• Precondición: Existe la reserva
• Requerimientos:

  • RF-C-38

Flujo principal

1. El comercio ve en la ficha de la reserva el nombre del cliente y los últimos cuatro dígitos de su teléfono.
2. Si necesita el número completo, lo solicita explícitamente.

3. El sistema lo muestra y registra el acceso con actor, rol, fecha y motivo.

4. Postcondición: El acceso queda registrado y es consultable por el titular del dato.

CU-C-29¶

Cancelar una reserva

• Actor: Administrador u Operador del comercio
• Precondición: La reserva está viva
• Requerimientos:

  • RF-C-40

Flujo principal

1. El comercio elige la reserva y selecciona el motivo de cancelación.
2. El sistema cancela la reserva, devuelve las unidades al inventario y avisa al usuario por dos canales.

• Postcondición: La reserva queda cancelada con su motivo y el stock liberado.

CU-C-30¶

Atender el aviso de una reserva nueva

• Actor: Administrador u Operador del comercio
• Precondición: El comercio tiene avisos habilitados
• Requerimientos:

  • RF-C-39
  • RF-C-57

Flujo principal

1. El sistema notifica al comercio cada reserva confirmada y cada cancelación de usuario.

2. El aviso lleva al tablero del día en la ventana correspondiente.

3. Postcondición: Ninguna.

Validación en mostrador¶

CU-C-31¶

Validar una entrega

• Actor: Operador del comercio
• Precondición: La reserva está confirmada y dentro de su ventana
• Requerimientos:

  • RF-C-42
  • RF-C-43
  • RF-C-44
  • RF-C-45

Flujo principal

1. El operador abre la pantalla de validación e introduce el código de seis caracteres o escanea el código del cliente.
2. El sistema muestra el contenido de la reserva y el monto exacto a cobrar en efectivo.
3. El operador cobra y confirma la entrega.
4. El sistema registra la validación con la hora del servidor y cierra la reserva como retirada.

• Postcondición: La reserva queda retirada y su entrega registrada de forma inmutable.

CU-C-32¶

Registrar una entrega parcial

• Actor: Operador del comercio
• Precondición: La reserva es de más de una unidad
• Requerimientos:

  • RF-C-46

Flujo principal

1. El operador reduce la cantidad entregada respecto de la reservada.
2. Selecciona el motivo de la entrega parcial.
3. El sistema recalcula el monto y cierra la reserva.

• Postcondición: La reserva queda retirada con la cantidad realmente entregada. Las unidades no entregadas no vuelven al inventario.

CU-C-33¶

Confirmar una no presentación

• Actor: Operador del comercio
• Precondición: La reserva expiró sin validarse
• Requerimientos:

  • RF-C-47

Flujo principal

1. Al cerrar la ventana, el sistema muestra las reservas que expiraron.
2. El operador confirma que el cliente no se presentó.

3. El sistema deja constancia de la confirmación con su autor.

4. Postcondición: La expiración queda confirmada y cuenta para el historial de incumplimiento del usuario.

CU-C-34¶

Operar sin conexión y sincronizar

• Actor: Operador del comercio
• Precondición: El dispositivo perdió conexión durante la ventana
• Requerimientos:

  • RF-C-48

Flujo principal

1. El operador valida entregas contra la copia local de las reservas del día.
2. El navegador encola cada validación con la hora declarada del dispositivo.
3. Al recuperar la conexión, el sistema sincroniza la cola y registra la hora de llegada.
4. El sistema resuelve cada validación con la hora del servidor y cierra las reservas correspondientes.

• Postcondición: Las entregas quedan registradas, con los conflictos identificados para su resolución.

Reputación¶

CU-C-35¶

Responder una valoración

• Actor: Administrador del comercio
• Precondición: La valoración está publicada
• Requerimientos:

  • RF-C-50

Flujo principal

1. El administrador escribe la respuesta pública.
2. El sistema la deja pendiente de moderación.
3. Aprobada por administración, aparece bajo la valoración.

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

CU-C-36¶

Consultar los indicadores de cumplimiento

• Actor: Administrador del comercio
• Precondición: Sesión abierta
• Requerimientos:

  • RF-C-51

Flujo principal

1. El administrador abre el panel de cumplimiento.
2. El sistema muestra las tasas de entrega, cancelación, expiración e incidencias en las ventanas de catorce y treinta días.

• Postcondición: Ninguna.

CU-C-37¶

Presentar descargo ante una incidencia

• Actor: Administrador del comercio
• Precondición: Administración solicitó el descargo
• Requerimientos:

  • RF-C-49
  • RF-A-34

Flujo principal

1. El administrador recibe el aviso con el plazo de respuesta.
2. Abre la incidencia y escribe su versión de los hechos.
3. El sistema registra el descargo y devuelve la incidencia a análisis.

• Postcondición: El expediente incluye la versión del comercio.

Reportes¶

CU-C-38¶

Consultar el desempeño diario

• Actor: Administrador del comercio
• Precondición: Sesión abierta
• Requerimientos:

  • RF-C-52

Flujo principal

1. El administrador elige un rango de fechas.

2. El sistema muestra unidades publicadas, reservadas, entregadas, canceladas y expiradas, el ingreso en efectivo, el ticket promedio y la tasa de venta.

3. Postcondición: Ninguna.

CU-C-39¶

Analizar el rendimiento por ventana

• Actor: Administrador del comercio
• Precondición: Sesión abierta
• Requerimientos:

  • RF-C-53

Flujo principal

1. El administrador abre el análisis por día de la semana y ventana.

2. El sistema contrasta lo publicado con lo vendido en cada combinación.

3. Postcondición: Ninguna.

CU-C-40¶

Consultar el impacto ambiental

• Actor: Administrador del comercio
• Precondición: Sesión abierta
• Requerimientos:

  • RF-C-54

Flujo principal

1. El administrador abre el panel de impacto.

2. El sistema muestra los kilogramos de comida rescatada y el CO₂e evitado, por mes y acumulado, calculados con el factor vigente en la fecha de cada reserva.

3. Postcondición: Ninguna.

CU-C-41¶

Exportar datos del comercio

• Actor: Administrador del comercio
• Precondición: Sesión abierta
• Requerimientos:

  • RF-C-55

Flujo principal

1. El administrador elige el tipo de exportación, el formato y los filtros.
2. El sistema genera el archivo sin incluir datos personales de consumidores.

3. El sistema registra la exportación con su autor y sus filtros.

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

Notificaciones¶

CU-C-42¶

Configurar las preferencias de aviso

• Actor: Administrador u Operador del comercio
• Precondición: Sesión abierta
• Requerimientos:

  • RF-C-56
  • RF-C-58

Flujo principal

1. El usuario activa o desactiva cada categoría de aviso por canal.
2. El sistema guarda la preferencia y la aplica a los avisos siguientes.

• Postcondición: Los avisos futuros respetan la preferencia.