ℹ️ ¿Qué es el Monitor IRI?
El Monitor de Riesgo Institucional (IRI) es una herramienta académica de código abierto que cuantifica niveles de riesgo de corrupción e ineficiencia en organismos del Estado argentino.
🧮 Fórmula IRI
IRI = R_Financiero × 35% + R_Contratación × 30% + R_Operativo × 20% + R_Datos × 15%
| Componente | Peso | Descripción |
|---|
| R_Financiero | 35% | Irregularidades presupuestarias, desvios en ejecucion del gasto. |
| R_Contratación | 30% | Proporción de contrataciones directas vs. licitaciones. |
| R_Operativo | 20% | Inasistencia legislativa, tasa de vacancia judicial, participation_pct senado. |
| R_Datos | 15% | Calidad y disponibilidad de información pública. |
| Score IRI | Nivel de riesgo |
|---|
| 0 – 29 | 🟢 BAJO — dentro de parámetros normales |
| 30 – 59 | 🟡 MEDIO — requiere seguimiento |
| 60 – 100 | 🔴 ALTO — alerta de riesgo institucional |
🏗 Repositorios integrados
| Repositorio | Datos que aporta |
|---|
| monitor (central) | FastAPI principal. Dashboard HTML con Plotly.js. |
| justicia | IRA por juzgado, vacantes judiciales, magistrados. |
| monitor_legistativo | NAPE, IQP, asistencia — Cámara de Diputados. |
| monitor_legistativo_senadores | Participación, reporte por partido — Senado. |
| monitor_contratos_v2 | BORA + COMPR.AR + TGN. Detección de irregularidades. |
| gob_bo_comprar_tgn | Tesorería General de la Nación Argentina. |
🔑 Variables de entorno
| Variable | Descripción |
|---|
| JUSTICIA_API_URL | URL del servicio justicia en Railway |
| LEGISTATIVO_API_URL | URL del servicio monitor_legistativo en Railway |
| SENADORES_API_URL | URL del servicio senadores en Railway |
| CONTRATOS_AR_API_URL | URL de monitor_contratos_v2 en Railway |
| TGN_AR_API_URL | URL de gob_bo_comprar_tgn en Railway |
| REFRESH_TOKEN | Token para POST /refresh (default: dev) |
📋 Endpoints de la API
| Endpoint | Descripción |
|---|
| GET / | Redirige a /dashboard |
| GET /dashboard | Este dashboard |
| GET /datos | Dataset completo en JSON |
| GET /por-area/{area} | Organismos filtrados por área |
| GET /top-riesgo?n=10 | Top N organismos de mayor IRI |
| GET /resumen | Estadísticas globales por área |
| POST /refresh | Regenera el CSV (requiere X-Refresh-Token) |
| GET /docs | Swagger UI |
