59 lines
2.6 KiB
Markdown
59 lines
2.6 KiB
Markdown
# Monitor de estado — Telegram + correo + Jira
|
|
|
|
Proceso en segundo plano que **cada 30 minutos** recoge lo del día en curso, lo archiva
|
|
por fuente, genera un **resumen IA** y emite un **aviso por voz local** cuando algo
|
|
requiere atención. Nunca envía mensajes a ningún medio (solo lee y avisa localmente).
|
|
|
|
Spec y plan: `biblioteca_negocio_prolongo/specs/005-monitor-estado-conversaciones/`.
|
|
|
|
## Qué recoge
|
|
- **Telegram** (sesión dedicada `~/.telegram-agent/sessions/monitor`): Oscar Rodríguez, Isa,
|
|
Daniel García Jiménez, Antonio Romero y el canal "Desarrollo software".
|
|
- **Correo** `jminguez@prolongo.es`: últimos 24 h (no marca leído).
|
|
- **Jira** proyecto **DS**: incidencias nuevas (desde el ciclo anterior) y tickets sin asignar
|
|
no cerrados. Solo lectura.
|
|
|
|
## Uso
|
|
```powershell
|
|
python scripts/monitor_estado.py ciclo # un ciclo y salir
|
|
python scripts/monitor_estado.py ciclo --solo correo
|
|
python scripts/monitor_estado.py daemon # bucle cada 30 min (segundo plano)
|
|
python scripts/monitor_estado.py estado # último resumen + rutas
|
|
python scripts/monitor_estado.py login-telegram --qr # autorizar sesión Telegram (una vez)
|
|
python scripts/monitor_estado.py simular --de DAX --texto "Confirmado el desarrollo"
|
|
```
|
|
|
|
- `simular` inyecta entradas ficticias en un directorio aislado (`estado/monitor/simulacion/`):
|
|
no crea correos reales, no toca datos reales y **nunca** envía a Telegram.
|
|
|
|
## Arranque y vigilancia
|
|
- **Tarea programada `Monitor Estado`** (al iniciar sesión) → `scripts/monitor_estado_watchdog.ps1 -Once`.
|
|
- **Plugin global de OpenCode** `~/.config/opencode/plugins/monitor-estado-bootstrap.ts` → relanza el
|
|
watchdog al arrancar OpenCode.
|
|
- El watchdog lanza `daemon` solo si no corre; el propio monitor tiene un lock (instancia única).
|
|
- Instalación: `scripts/instalar_global.ps1`.
|
|
```powershell
|
|
powershell -ExecutionPolicy Bypass -File scripts/monitor_estado_watchdog.ps1 -Once
|
|
powershell -ExecutionPolicy Bypass -File scripts/monitor_estado_watchdog.ps1 -Stop
|
|
```
|
|
|
|
## Configuración
|
|
`estado/monitor/config.json` (se autogenera desde `config.example.json`):
|
|
intervalo, retención (30 días), fuentes de Telegram, correo, Jira, IA (OmniRoute) y aviso de voz.
|
|
|
|
## Datos y logs
|
|
```
|
|
estado/monitor/
|
|
conversaciones/ correo/ jira/ # ficheros del día por fuente (<YYYY-MM-DD>.md)
|
|
visto/ # estado "ya visto" (dedup)
|
|
resumen_actual.md/.json # último resumen
|
|
ultimo_ciclo.json
|
|
monitor_estado.out.log / .err.log # salida del daemon
|
|
```
|
|
|
|
## Tests
|
|
```powershell
|
|
python -m pytest tests/ -q
|
|
```
|
|
Requiere: `pip install pytest qrcode` (Telethon/gspread ya usados por otros watchers).
|