Portal de administración¶
Plataforma¶
RF-A-01¶
Acceso restringido y separado
Panel alojado en un subdominio propio, sin registro público y sin enlace desde la aplicación móvil ni desde el portal de comercios. Las cuentas internas se crean únicamente por invitación emitida desde el propio panel, con enlace de un solo uso. Una invitación no puede llevar a la vez un rol interno y un comercio asociado.
RF-A-02¶
Restricción de acceso adicional
Segundo factor de autenticación obligatorio para todo usuario administrador, sin excepción, basado en códigos temporales de aplicación autenticadora. La sesión expira por inactividad a los treinta minutos. El secreto del segundo factor se almacena cifrado y no puede rotarse: cambiarlo exige dar de baja la credencial y crear otra.
Autenticación¶
RF-A-03¶
Inicio de sesión
Correo corporativo y contraseña de al menos doce caracteres con mayúscula, minúscula, número y símbolo. Bloqueo de treinta minutos tras tres intentos fallidos consecutivos, con alerta por correo al Superadministrador. Cada intento queda registrado con el identificador tecleado y la dirección de origen.
RF-A-04¶
Roles internos
Superadministrador: acceso total, incluidos los parámetros del sistema, la gestión de cuentas internas y la baja definitiva de comercios. Operaciones: aprueba comercios, aprueba cambios sensibles, modera contenido, resuelve incidencias y gestiona sanciones de usuarios. Soporte: lectura de reservas, usuarios y comercios más la capacidad de responder incidencias, sin poder cancelar, suspender, aprobar ni cambiar parámetros. Analista: lectura de reportes y métricas agregadas, sin acceso a datos personales, que se omiten de toda respuesta que reciba.
RF-A-05¶
Gestión de administradores
El Superadministrador crea cuentas internas, cambia su rol, las desactiva y fuerza el cierre de sus sesiones. No puede existir menos de un Superadministrador activo: el sistema rechaza la operación que dejaría el sistema sin ninguno, incluso cuando esa operación afecta a varias cuentas a la vez. Toda alta o cambio de rol queda en bitácora y se notifica por correo a los demás Superadministradores.
Afiliación¶
RF-A-06¶
Bandeja de solicitudes de comercios
Listado de las solicitudes que requieren acción, con su antigüedad, ordenable por fecha y filtrable por categoría y zona. Alerta visual para las que llevan más de cuarenta y ocho horas sin resolver. La bandeja destaca las marcadas como posible duplicado o fuera de la zona de cobertura.
RF-A-07¶
Ficha de revisión
Vista consolidada de todos los datos enviados en el formulario público, con la ubicación en mapa, la foto de fachada y el documento de licencia ampliables. Muestra si el teléfono y el correo del responsable ya fueron verificados y con qué fecha, y advierte si el RUC, el correo o la ubicación coinciden con un comercio existente, enlazando al candidato.
RF-A-08¶
Aprobación
Al aprobar, el sistema pasa el comercio a estado Activo, dispara el correo con el enlace de creación de contraseña del usuario administrador y registra el administrador aprobador con fecha y hora. La aprobación materializa el horario declarado en el formulario como horario de atención del comercio.
RF-A-09¶
Rechazo con motivo
Requiere seleccionar un motivo de lista cerrada: fuera de la zona de cobertura, documentación insuficiente, datos inconsistentes, giro de negocio no elegible, duplicado, u otro con nota obligatoria. El motivo se envía al solicitante junto con la fecha a partir de la cual puede volver a aplicar, y queda archivado en el expediente.
RF-A-10¶
Solicitud de información adicional
Estado intermedio en el que el administrador escribe qué falta, con hasta quinientos caracteres. El sistema notifica al solicitante y le habilita la edición de su formulario sin perder lo ya ingresado. La solicitud vence a los quince días sin respuesta y pasa a estado vencido, tras lo cual el solicitante debe iniciar una nueva.
Comercios¶
RF-A-11¶
Directorio de comercios
Listado con nombre, categoría, estado, fecha de afiliación, calificación promedio, reservas entregadas acumuladas, tasa de cancelación y fecha de última publicación. Filtros por estado, categoría, zona y rango de calificación. Buscador por nombre y por RUC, insensible a mayúsculas y tildes. Los comercios sin valoraciones se ordenan al final, no como si tuvieran la peor nota.
RF-A-12¶
Ficha administrativa del comercio
Vista de solo lectura de toda su configuración: plantillas activas, horario semanal, ventanas de recogida, excepciones de calendario vigentes, usuarios registrados con su rol y estado, historial de reservas e historial de cambios de estado con motivo y responsable.
RF-A-13¶
Aprobación de cambios sensibles
Cola de revisión de los cambios que quedaron pendientes: nombre comercial, categoría, dirección y movimiento del pin mayor a cien metros. Se muestra el valor anterior y el propuesto lado a lado, con la distancia calculada en el caso de la ubicación. Acciones de aprobar o rechazar con motivo. Aprobar aplica el valor y, si se trata de la ubicación, rederiva la zona y reevalúa la cobertura.
RF-A-14¶
Suspensión
Suspende al comercio con motivo obligatorio de lista cerrada: incumplimiento reiterado de entregas, reporte de inocuidad alimentaria, precios distintos a los publicados, solicitud del propio comercio, o investigación en curso. Efecto inmediato: oculta la ficha del mapa, bloquea publicaciones nuevas y bloquea reservas nuevas. El comercio conserva el acceso al portal para resolver sus reservas vivas.
RF-A-15¶
Tratamiento de reservas al suspender
Al suspender, el sistema muestra las reservas vivas del comercio y exige elegir entre mantenerlas vigentes para su entrega o cancelarlas masivamente notificando a cada usuario afectado. La suspensión no se ejecuta hasta que esa decisión se resuelva, y la decisión tomada queda registrada junto al cambio de estado.
RF-A-16¶
Reactivación y baja definitiva
Reactivar restituye el estado Activo conservando plantillas, horarios e historial. La baja definitiva conserva el historial transaccional, retira la ficha pública y desactiva a todos los usuarios del comercio; es irreversible y solo la ejecuta un Superadministrador. Ninguna de las dos borra dato alguno.
Usuarios¶
RF-A-17¶
Directorio de usuarios consumidores
Listado con nombre, canales verificados, fecha de registro, reservas totales, entregadas, canceladas y expiradas, y estado de la cuenta. Buscador por nombre, teléfono y correo. El rol Analista ve este directorio sin nombres ni datos de contacto.
RF-A-18¶
Ficha del usuario
Historial completo de reservas con su estado y comercio, incidencias abiertas, valoraciones emitidas y sanciones aplicadas con su motivo. Cada apertura de esta ficha queda registrada como acceso a dato personal, indicando qué administrador la consultó, con qué rol y cuándo.
RF-A-19¶
Gestión de sanciones por incumplimiento
Vista de las sanciones automáticas por expiraciones acumuladas, con la capacidad de levantarlas anticipadamente indicando motivo o de extenderlas. Muestra el detalle exacto de las reservas expiradas que la originaron, congelado al momento de aplicarse, no recalculado con los parámetros actuales.
RF-A-20¶
Suspensión manual de un usuario
Suspensión con motivo obligatorio: abuso del sistema, reportes reiterados de comercios, uso de datos falsos, o conducta inapropiada en el local. Duración definida en días o indefinida. El usuario conserva el acceso a la aplicación y ve el motivo y la fecha de reactivación al intentar reservar. No puede haber dos sanciones vigentes del mismo tipo sobre la misma cuenta.
RF-A-21¶
Reenvío de verificación y soporte de acceso
El administrador puede reenviar el código de verificación de correo o teléfono a solicitud del usuario, respetando los límites de envío por hora. No puede ver, cambiar ni establecer contraseñas: solo dispara el flujo de restablecimiento hacia el canal ya verificado.
RF-A-22¶
Vista de acompañamiento para soporte
Vista de solo lectura que reproduce lo que el usuario ve en su cuenta para resolver llamadas de soporte. Sin capacidad de ejecutar acciones en su nombre. Cada acceso queda registrado como acceso a dato personal.
Moderación¶
RF-A-23¶
Revisión de ofertas publicadas
Listado en vivo de las publicaciones activas y programadas, con comercio, tipo, precio, valor de referencia, descuento calculado, cantidad y ventana. Filtros por comercio, categoría y rango de descuento. Permite abrir la publicación y ver la foto en tamaño completo.
RF-A-24¶
Despublicación de una oferta
Retira una oferta del mapa de forma inmediata con motivo obligatorio: contenido inapropiado, foto que no corresponde, descripción engañosa, precio inconsistente, o sospecha de alimento no apto. Notifica al comercio con el motivo y aplica el mismo flujo de resolución de reservas vivas que la suspensión. Una publicación no puede despublicarse dos veces.
RF-A-25¶
Alertas automáticas de contenido
El sistema marca para revisión prioritaria las publicaciones con descuento superior al umbral configurado, precio por debajo del mínimo, oferta específica sin foto, cantidad mayor a treinta unidades, y la primera publicación de un comercio recién aprobado. No se acumulan alertas idénticas sin atender sobre la misma publicación.
RF-A-26¶
Moderación de valoraciones y comentarios
Bandeja con los comentarios de usuarios y las respuestas de comercios. Acciones: publicar, ocultar con motivo obligatorio, o eliminar por contenido ofensivo. La valoración del usuario se publica de inmediato y se modera después; la respuesta del comercio requiere aprobación previa antes de hacerse visible. Ninguna de las dos puede borrarse de la base.
Operación¶
RF-A-27¶
Monitor de reservas en tiempo real
Tablero global del día con reservas creadas, entregadas, pendientes de retiro, canceladas por usuario, canceladas por comercio, canceladas por administración y expiradas. Desglose por comercio y por ventana de recogida, con actualización automática. Consulta datos operativos en vivo, no reportes precalculados.
RF-A-28¶
Búsqueda de reserva individual
Buscador por identificador de reserva, código de retiro, teléfono del usuario o nombre del comercio. Devuelve la reserva con su línea de tiempo completa: creada, confirmada, notificada, recordada, validada, cancelada o expirada, con la hora exacta de cada evento, el actor que lo provocó y el operador que la validó.
RF-A-29¶
Cancelación administrativa de una reserva
Facultad de cancelar una reserva con motivo obligatorio, liberando las unidades y notificando a ambas partes. El estado resultante es diferenciado del de las otras cancelaciones para que los indicadores del comercio no se vean afectados por una decisión administrativa. Reservada para casos de disputa o error operativo.
RF-A-30¶
Validación manual excepcional
Permite registrar una entrega cuando ocurrió físicamente pero falló la validación digital. Requiere nota obligatoria, la confirmación del comercio registrada y queda marcada como validación excepcional, identificable en los reportes y auditable por separado. Es el único camino para validar fuera de la ventana con tolerancia.
RF-A-31¶
Zona de cobertura del piloto
Definición del área habilitada mediante un radio desde un punto central o un polígono, con vigencia propia. Las solicitudes de afiliación fuera del área se marcan automáticamente para revisión con esa señal, y la aplicación informa al usuario cuando su ubicación queda fuera. Ampliar la cobertura no reescribe el motivo por el que se rechazó una solicitud anterior.
Incidencias¶
RF-A-32¶
Bandeja de incidencias
Todos los reportes abiertos por usuarios y por comercios, con folio, categoría, identificador de reserva, fecha de apertura, antigüedad, prioridad y estado entre Abierta, En análisis, Esperando al comercio, Resuelta y Descartada. Alerta para las que llevan más de cuarenta y ocho horas sin movimiento, calculada sobre la fecha del último cambio y no sobre la de apertura.
RF-A-33¶
Resolución de incidencia
Vista con el reporte del usuario, los descargos del comercio y el historial completo de la reserva. El administrador registra la resolución de una lista cerrada, ya sea a favor del usuario, a favor del comercio, sin determinación o resuelta entre las partes; más una nota interna y un mensaje visible para el usuario. Una incidencia no puede cerrarse sin resolución escrita.
RF-A-34¶
Solicitud de descargo al comercio
El administrador solicita al comercio su versión de los hechos indicando un plazo. El proceso admite varias rondas: cada solicitud y cada respuesta quedan registradas por separado con su fecha. Si el plazo vence sin respuesta, la incidencia continúa y esa ausencia queda registrada.
RF-A-35¶
Escalamiento por inocuidad alimentaria
Las incidencias de categoría de contenido en mal estado se marcan con prioridad alta, notifican de inmediato al rol Operaciones y habilitan la suspensión preventiva del comercio en un solo paso desde la propia incidencia, aplicando el flujo de resolución de reservas vivas.
RF-A-36¶
Trazabilidad de patrones
Vista que agrupa incidencias por comercio y por usuario en los últimos treinta y noventa días, con su categoría y desenlace, para distinguir un caso aislado de un patrón antes de decidir una suspensión.
Parámetros¶
RF-A-37¶
Configuración centralizada del sistema
Todos los valores configurables se administran desde una sola pantalla, agrupados por ámbito y sin necesidad de desplegar código. Cada cambio guarda valor anterior, valor nuevo, administrador, fecha y hora, y admite reversión. Revertir registra un cambio nuevo enlazado al que deshace, no borra el anterior. El sistema valida cada valor contra el tipo y el rango declarados del parámetro.
RF-A-38¶
Reglas del usuario
Máximo de unidades por reserva, con tres por defecto; máximo de reservas activas simultáneas, con dos; máximo de reservas activas por comercio, con una; duración del bloqueo temporal de stock, con dos minutos; plazo límite para cancelar una reserva antes del cierre de ventana; plazo para calificar tras la entrega, con setenta y dos horas; y los radios disponibles en el filtro de distancia.
RF-A-39¶
Reglas de incumplimiento
Cantidad de reservas expiradas que dispara la sanción, con tres por defecto; periodo de conteo, con treinta días; y duración de la sanción, con siete días. El valor vigente al aplicarse queda congelado en la sanción.
RF-A-40¶
Reglas del comercio
Duración mínima y máxima de la ventana de recogida, con quince y doscientos cuarenta minutos; máximo de ventanas por día, con tres; horizonte de publicación, con cuarenta y ocho horas; corte de reservas antes del fin de la ventana, con quince minutos; tolerancia de validación posterior al cierre, con diez minutos; máximo de plantillas activas, con cinco; y máximo de operadores por comercio, con cinco.
RF-A-41¶
Reglas de precio
Precio mínimo permitido por oferta, descuento mínimo obligatorio con treinta por ciento por defecto, descuento a partir del cual la publicación se marca para revisión con ochenta por ciento, y cantidad máxima de unidades por publicación con cincuenta.
RF-A-42¶
Reglas de verificación y sesión
Vigencia del código de un solo uso, tiempo de espera para reenvío, máximo de envíos por hora al mismo destino, vigencia del enlace de verificación de correo, y duración de las sesiones de la aplicación móvil, del portal de comercios y del panel administrativo.
RF-A-43¶
Factores de cálculo de impacto
Kilogramos estimados por unidad rescatada y kilogramos de dióxido de carbono equivalente evitados por kilogramo, ambos configurables por categoría de comida y versionados por vigencia. Un cambio de factor no altera el impacto ya reportado: cada reserva se valora con el factor vigente en su fecha.
RF-A-44¶
Umbrales de alerta de cumplimiento
Tasa de cancelación, tasa de expiración e incidencias por cada cien reservas que disparan alerta sobre un comercio, con sus ventanas de cálculo de catorce y treinta días. Un comercio sin reservas en la ventana no dispara alerta.
Catálogos¶
RF-A-45¶
Categorías de comida
Alta, edición, reordenamiento y desactivación de las categorías usadas en los filtros de la aplicación y en la clasificación de ofertas. Una categoría con ofertas asociadas no puede eliminarse, solo desactivarse; las publicaciones históricas conservan su clasificación.
RF-A-46¶
Motivos de lista cerrada
Administración de los motivos seleccionables en cancelación por usuario, cancelación por comercio, cancelación administrativa, rechazo de afiliación, suspensión de comercio, suspensión de usuario, despublicación, entrega parcial, pausa, moderación y categorías de incidencia. Cada motivo declara si exige una nota adicional y para qué actor es visible. Los motivos en uso histórico no se eliminan, solo se desactivan.
RF-A-47¶
Zonas y barrios
Gestión de la lista de zonas que el usuario puede seleccionar como ubicación manual, con su coordenada representativa y, opcionalmente, su polígono. Cuando una zona tiene polígono, el sistema asigna automáticamente los comercios que caen dentro de ella.
Comunicación¶
RF-A-48¶
Envío de notificaciones masivas
Envío a un segmento definido por zona, categoría, comercio, actividad reciente o plataforma, con vista previa obligatoria que muestra el número estimado de destinatarios y confirmación en dos pasos por personas distintas. Respeta las preferencias de notificaciones promocionales. Límite configurable de envíos masivos por semana, contado sobre las campañas confirmadas.
RF-A-49¶
Comunicación a comercios
Envío de avisos por correo a todos los comercios o a un subconjunto filtrado, con plantillas reutilizables para el acompañamiento inicial y los cambios operativos del piloto. Registra el administrador emisor y el número real de destinatarios, que puede diferir del estimado.
RF-A-50¶
Plantillas de mensajería transaccional
Edición del texto de las notificaciones automáticas con las variables disponibles documentadas por plantilla. Los cambios se versionan y exigen vista previa antes de publicarse. Solo una versión puede estar vigente por código y canal a la vez. Cada mensaje enviado conserva la referencia a la versión con que se compuso.
Reportes¶
RF-A-51¶
Tablero general del piloto
Usuarios registrados y activos, comercios activos y publicando, ofertas publicadas, unidades rescatadas, monto total transado en efectivo, ticket promedio, tasa de venta del stock publicado y tasa de no presentación. Comparativo por periodo y evolución diaria.
RF-A-52¶
Embudo de conversión
Recorrido del usuario desde la exploración del mapa hasta el retiro: exploraciones, vistas de detalle, reservas iniciadas, reservas confirmadas y reservas retiradas, con la tasa de caída de cada paso. El embudo incluye a los visitantes sin cuenta mediante su identificador de sesión anónima.
RF-A-53¶
Ranking y desempeño de comercios
Tabla ordenable por unidades entregadas, tasa de venta, tasa de cancelación y calificación promedio, para identificar tanto a los comercios más efectivos como a los que requieren acompañamiento. Los comercios sin datos suficientes se marcan como tales en lugar de mostrarse con valores en cero.
RF-A-54¶
Análisis de demanda no atendida
Registro de búsquedas y combinaciones de filtros que no arrojaron resultados, agrupados por zona y franja horaria, con su ubicación de origen, para orientar el reclutamiento de nuevos comercios.
RF-A-55¶
Reporte de impacto ambiental y social
Kilogramos estimados de alimento rescatado, dióxido de carbono equivalente evitado y ahorro acumulado de los usuarios frente al valor de referencia, exportable como reporte del periodo del piloto. Solo cuentan las reservas entregadas.
RF-A-56¶
Exportación de datos
Exportación en CSV y XLSX de reservas, comercios, usuarios, incidencias y publicaciones, por rango de fechas y con los filtros aplicados. El rol Analista recibe las exportaciones sin datos personales. Cada exportación registra quién la generó, qué filtros usó, cuántas filas produjo y cuándo.
Auditoría¶
RF-A-57¶
Bitácora global
Registro inmutable y consultable de toda acción administrativa y de comercio: aprobaciones, rechazos, suspensiones, cancelaciones administrativas, cambios de parámetros, accesos a fichas de usuario, envíos masivos y exportaciones. Filtrable por administrador, tipo de acción, entidad afectada y rango de fechas. Registra también las acciones que no modifican ningún dato.
RF-A-58¶
Alertas de seguridad
Notificación automática al Superadministrador ante intentos fallidos de acceso reiterados, cambio de un parámetro marcado como crítico, exportación por encima del umbral configurado, volumen inusual de accesos a datos personales, y creación o cambio de rol de una cuenta interna.
RF-A-59¶
Retención de la bitácora
Las entradas de bitácora no son editables ni eliminables por ningún rol, incluido el Superadministrador, ni siquiera mediante acceso directo a la base de datos. Se conservan durante todo el piloto más doce meses, tras lo cual se purgan por proceso programado.
Sistema¶
RF-A-60¶
Modo mantenimiento
Activación de un modo que bloquea reservas y publicaciones nuevas mostrando un mensaje configurable, distinto para la aplicación y para el portal de comercios. No afecta la consulta de reservas activas, la validación de códigos en mostrador ni los procesos programados de expiración, que deben seguir corriendo para que ninguna reserva quede colgada.
RF-A-61¶
Monitor de salud operativa
Indicadores del estado de los servicios críticos: entrega de notificaciones push, envío de mensajes de texto, correo transaccional y servicio de mapas, con el conteo de fallos de las últimas veinticuatro horas y su nivel de severidad. Un mensaje no enviado por preferencia del usuario no cuenta como fallo del proveedor.
RF-A-62¶
Gestión de solicitudes de eliminación de cuenta
Bandeja con las solicitudes de eliminación enviadas por usuarios, su fecha y el estado del proceso de anonimización. El sistema verifica que no queden reservas vivas antes de permitir la ejecución y muestra cuáles lo impiden. La ejecución es irreversible.
RF-A-63¶
Gestión de tablas de estado y transiciones
Alta de estados nuevos en cualquier ciclo de vida del sistema, edición de sus etiquetas y descripciones visibles, y activación o retiro de transiciones entre ellos, sin desplegar código. El código interno de un estado es inmutable una vez creado, y un estado referenciado por algún registro no puede eliminarse.