====== Monitor de recordatorios de pago ======
El monitor muestra, en una sola pantalla, el estado del envío automático de recordatorios de pago del colegio: cuántos están configurados, cuáles están a punto de enviarse, cuáles están en proceso ahora mismo y el resultado de los enviados en los últimos días. Es una pantalla de consulta: aquí no se configuran los recordatorios (eso se hace desde **Periodos** o desde el perfil de cada usuario), solo se revisa cómo va el envío.
**IMPORTANTE:** si tu colegio opera bajo la modalidad "Algebraix SaaS" (recordatorios de WhatsApp gestionados por Mattilda), esta pantalla no está disponible para el administrador de tu escuela ni para ningún operador: el seguimiento del envío lo hace el equipo de Mattilda.
===== Consultar el estado del envío =====
- En tu **Panel de control** selecciona la tarjeta **Cobranza** y, dentro de ella, **Monitor de recordatorios de pago**.
- En la parte superior se muestra un chip con el modo de envío activo: "Modo normal", "Modo mejorado" o "Algebraix SaaS".
- Da clic en **Refrescar** en cualquier momento para actualizar los cuatro paneles de la pantalla.
FALTA_CAPTURA — pantalla: Panel de control → Cobranza → Monitor de recordatorios de pago; mostrar: la parte superior de la pantalla con el chip del modo de envío y el botón "Refrescar"; archivo sugerido: :a:finance:charges:payment_reminders_monitor_encabezado.png
===== Consultar "Estado del servicio" =====
Este panel resume la configuración vigente:
* El modo de envío ("Modo normal", "Modo mejorado" o "Algebraix SaaS"), junto a la etiqueta "PAYMENT_LINK_ENHANCED_MODE:".
* **WhatsApp programados:** cuántos periodos tienen configurado el envío de recordatorio por WhatsApp.
* **Mensajes programados:** cuántos periodos tienen configurado el envío de recordatorio por mensaje.
* **Plantillas personalizadas:** cuántas plantillas propias del colegio existen para estos recordatorios.
Los mismos tres números se repiten como tarjetas al centro de la pantalla, junto con una cuarta tarjeta de **Errores** (con el porcentaje de error de los envíos de los últimos 7 días); da clic en esa tarjeta para filtrar de inmediato la tabla de envíos recientes por los que tuvieron error.
FALTA_CAPTURA — pantalla: Panel de control → Cobranza → Monitor de recordatorios de pago → panel Estado del servicio; mostrar: el panel completo con sus tres contadores y las cuatro tarjetas resumen; archivo sugerido: :a:finance:charges:payment_reminders_monitor_estado.png
===== Consultar "Recordatorios de pagos en proceso" =====
Este panel lista los recordatorios que ya se aceptaron para envío y todavía no terminan de procesarse, con su fecha, la vía (WhatsApp o Mensaje), el usuario destinatario y el tiempo que llevan en proceso.
- Si no hay ninguno, se muestra el aviso "No hay recordatorios pendientes de envío. El cron está al día."
- El tiempo de espera se marca en amarillo después de 4 horas y en rojo después de 24 horas.
- **IMPORTANTE:** si hay registros con más de 24 horas en proceso, aparece la alerta "Cron probablemente muerto:" seguida del aviso de cuántos registros llevan más de 24 horas pendientes; esto indica que el envío automático no se está ejecutando y conviene reportarlo a soporte.
- Mientras haya al menos un recordatorio en proceso, la pantalla se actualiza sola (se indica con el chip "PENDING" junto al modo de envío, arriba); cuando ya no queda ninguno, dice "Sin polling" en el panel de envíos recientes y hay que usar **Refrescar** para volver a consultar.
FALTA_CAPTURA — pantalla: Panel de control → Cobranza → Monitor de recordatorios de pago → panel Recordatorios de pagos en proceso; mostrar: la tabla con al menos un recordatorio en proceso y su tiempo de espera; archivo sugerido: :a:finance:charges:payment_reminders_monitor_proceso.png
===== Consultar "Próximos envíos programados" =====
Este panel lista, agrupados por fecha, los recordatorios que están programados para hoy o los próximos días: el periodo al que pertenecen (da clic en su nombre para ir a su configuración), la vía y el tipo de plantilla que se usará ("Mattilda", "Personalizada" o "Texto libre").
- Si no hay ninguno programado, se muestra el aviso "No hay recordatorios programados con fecha de hoy en adelante."
FALTA_CAPTURA — pantalla: Panel de control → Cobranza → Monitor de recordatorios de pago → panel Próximos envíos programados; mostrar: el panel con al menos una fecha y sus recordatorios agrupados; archivo sugerido: :a:finance:charges:payment_reminders_monitor_proximos.png
===== Consultar "Últimos envíos (7 días)" =====
Este panel lista hasta 500 registros de los últimos 7 días, con su fecha, la fecha en que terminó de procesarse, la vía, el usuario, el estado y, cuando aplica, la respuesta del proveedor:
* El **Estado** muestra un solo resultado por registro: "Enviado", "Entregado", "Leido" o "No entregado" cuando el proveedor de WhatsApp ya confirmó un desenlace; "Sin confirmación" si pasaron más de 20 minutos sin que llegara ninguna confirmación; "No hacía falta" cuando no era necesario enviarlo (por ejemplo, la familia ya no tiene adeudo o está bajo el mínimo configurado); o "Programado" (con la hora, cuando se conoce) para los que todavía no se procesan.
* La columna **Respuesta** muestra el motivo del error cuando se conoce, o la respuesta del proveedor.
- Puedes filtrar por **Vía** (Todas las vías, WhatsApp o Mensaje), por **Estatus** (Todos los estados, OK o ERROR) y por usuario con el buscador "Buscar por usuario..."; **Restablecer filtros** los quita todos.
- Si no hay registros, se muestra "No se encontraron resultados"; si los filtros no encuentran coincidencias, se muestra "No hay envíos que coincidan con los filtros."
FALTA_CAPTURA — pantalla: Panel de control → Cobranza → Monitor de recordatorios de pago → panel Últimos envíos (7 días); mostrar: la tabla con registros de distintos estados (Enviado, Entregado, No entregado) y los filtros de Vía, Estatus y usuario; archivo sugerido: :a:finance:charges:payment_reminders_monitor_recientes.png
Los botones "Disparar scheduler", "Refrescar estados" y "Vaciar bitácora" son acciones de prueba exclusivas de los ambientes de desarrollo del equipo de Algebraix (activadas por una bandera de ese ambiente): nunca aparecen en el producto real de un colegio, ni siquiera para el administrador principal de la plataforma.
===== Permisos para el operador =====
Para que el operador pueda consultar esta pantalla, es necesario asignarle el siguiente permiso al momento de agregarlo o modificar su perfil:
* Desde "Permisos globales" > **Colegiatura** > PAGOS POR INTERNET
* **Monitor de recordatorios de pago:** Permite consultar esta pantalla.
El administrador de la escuela consulta esta pantalla sin necesidad de que se le asigne ningún permiso, salvo que el colegio opere bajo la modalidad "Algebraix SaaS" (ver arriba).
REVISION_PENDIENTE — redactado por el canal automático y publicado sin revisión de un segundo lector. Para revisarlo: ARTICULOS="a:finance:charges:payment_reminders_monitor" make -C pipeline revisar