Referencia Técnica

Arquitectura de la plataforma

Un mapa visual de la biblioteca compartida, los módulos de aplicación y las dependencias entre sistemas que sustentan la plataforma de inteligencia fiscal de infraestructura de Austral Intelligence.

Grafo de Dependencias

Arquitectura hub-and-spoke de motor compartido

Toda la lógica analítica está centralizada en ppp-core, una biblioteca compartida de Python con más de 90 módulos repartidos en una docena de dominios. Cada aplicación reexporta los motores que necesita, manteniendo una única fuente de verdad a la vez que permite el desarrollo independiente de la interfaz.

Biblioteca Compartida
Apps Financieras
Riesgo Fiscal
Garantías
Riesgo
Independiente

Haga clic en un nodo para ver los detalles

ppp-core

Biblioteca compartida
92 archivos · 12 dominios
engine · guarantees · pfram · cba · risk · common · pefa · dsa · srs1 · pima · tax · subnational

VFM

Value for Money
25 reexportaciones del motor
17 módulos de interfaz

FM

Modelo Financiero
20 reexportaciones del motor
28 módulos de interfaz

Guarantees

Plataforma CLV
10 reexportaciones del motor
8 módulos de gráficos

Risk

Registro de Riesgos
2 reexportaciones de datos
datos GIH + PFRAM

Equity

Calculadora CAPM
independiente

Austral AI

Chatbot RAG
independiente

GFS

Estados Financieros Púb.
5 reexportaciones del motor
i18n · pfram/*

Stress

Prueba de Estrés de Cartera
20+ reexportaciones del motor
stress/* · guarantees/*

Monitor

Panel de APP
i18n · SQLite
independiente

CBA

Análisis Costo-Beneficio
14 reexportaciones del motor
cba/*

AI Copilot

Extracción de contratos · Clasificación IPSAS · Narrativa FRS
ai_extract · platform

PEFA

Tarjeta de Puntuación PI-10
M2 · Climate-PEFA
pefa/*

Subnational

Riesgo Fiscal Subnacional
chequeo de salud
subnational/*

ppp-core — Biblioteca Compartida

ppp-core/ppp_core/

engine/ (29 archivos)

  • model.py — Ejecutor principal del modelo financiero
  • model_inputs.py — Estructuras de datos base
  • construction, debt, debt_sizing — Financiación de proyectos
  • revenue, opex — Flujos de caja
  • balance_sheet, income_statement — Estados financieros
  • ratios, waterfall — Resultados de análisis
  • monte_carlo, sensitivity — Simulación de riesgo
  • psc, risk_allocation — Específico de VFM
  • fx, funding, depreciation, reserves — Apoyo
  • breakeven, refinancing, equity_engine — Avanzado

Otros módulos

  • guarantees/ (11) — Motores CLV: MRG, FX, deuda, terminación, cartera, correlación, sensibilidad, diagnósticos
  • pfram/ (19) — Riesgo fiscal: cálculos GFS, sostenibilidad fiscal, matriz de riesgo, API WEO, puente de garantías
  • cba/ (14) — Análisis Costo-Beneficio: motor, costos, beneficios, VAN, Monte Carlo, sensibilidad, clase de referencia, precios sombra, biblioteca de proxies
  • risk/ (3) — Datos sectoriales GIH, categorías y preguntas PFRAM
  • common/ (1) — Metadatos del proyecto
  • pefa/ (2) — Evaluador PEFA PI-10 de reporte de riesgo fiscal + suplemento Climate-PEFA (agregación M2)
  • dsa/ (2) — Análisis de Sostenibilidad de Deuda: proyección de dinámica de deuda, balance primario que estabiliza la deuda, GFN, tarjeta de puntuación de transparencia de deuda
  • srs1/ (2) — Preparación para la divulgación climática IPSASB SRS 1 (marco de cuatro pilares + evaluador)
  • pima/ (2) — Diagnóstico PIMA del FMI de inversión pública en 15 instituciones (fortaleza vs. eficacia)
  • tax_expenditure/ (2) — Registro de costos ocultos de gastos tributarios y operaciones cuasifiscales
  • subnational/ (2) — Chequeo de salud de riesgo fiscal subnacional (municipal/estatal)
  • ipsas/ (+2) — Infraestructura IPSAS 45 (modelo de valor actual) + divulgación de sensibilidad de la DBO según IPSAS 39

AI Copilot — IA Documental

austral-platform/modules/copilot/ · services/ai_extract.py

Capacidades

  • Extracción de contratos — PDF/DOCX de APP/concesión → garantías, pasivos contingentes, asignación de riesgos, condiciones de pago (hacia FARO / Guarantees)
  • Clasificador IPSAS — transacción → norma IPSAS sugerida + justificación + confianza
  • Narrativa FRS — cifras del Informe de Riesgo Fiscal → narrativa lista para el ministro (Pilar III del FTC)

Diseño

  • JSON validado por esquema en la ruta medida de Claude (services/ai_extract.py)
  • Respaldo elegante de entrada manual — nunca una caja negra
  • Análisis de documentos con pypdf / python-docx

PEFA — Tarjeta de Puntuación PI-10

austral-platform/modules/pefa/ · ppp_core/pefa/

Dimensiones (método M2)

  • 10.1 — Seguimiento de empresas públicas
  • 10.2 — Seguimiento de gobiernos subnacionales
  • 10.3 — Pasivos contingentes y otros riesgos fiscales

Resultado

  • Calificación agregada por M2 (A / B+ / B / C+ / C / D+ / D)
  • Suplemento Climate-PEFA (informativo)
  • Remediación priorizada. Base: PEFA 2016 + Climate-Responsive PEFA

Subnational — Riesgo Fiscal Subnacional

austral-platform/modules/subnational_risk/ · ppp_core/subnational/

Indicadores

  • Autonomía de ingresos (propios / total)
  • Carga de deuda y capacidad de servicio de deuda
  • Balance operativo, liquidez, pasivos contingentes

Resultado

  • Calificación Baja / Media / Alta por indicador
  • Calificación general de riesgo fiscal + alertas
  • Para mercados que el FISLAC del BID no alcanza. Base: DSF y PFM subnacional del BM/FMI

VFM — Evaluación de Value for Money

vfm/app.py · 11 pestañas

Importaciones de ppp-core (25 reexportaciones)

  • Todos los módulos engine/ (model, debt, revenue, opex, construction, etc.)
  • psc.py — Comparación PSC/APP
  • risk_allocation.py — Entradas de riesgo
  • vfm_monte_carlo.py — Monte Carlo específico de VFM
  • vfm_sensitivity.py — Sensibilidad de VFM
  • equity_engine.py — Costo del capital propio

Específico de la app (17 módulos de interfaz)

  • Cribado cualitativo, incentivos, cuestionario, NFB
  • Pestaña de costo del capital propio
  • Generación de informes VFM
  • Pestaña de sensibilidad
  • Exportación a Excel
  • Sistema de claves de widgets (wk() en formatting.py)

FM — Modelo Financiero

austral-platform/backend/app/modules/fm/ · Multiinquilino, en tiempo real

Motor ppp-core (biblioteca compartida)

  • El mismo motor que la app independiente Streamlit heredada fm/app.py
  • model, debt, revenue, opex, refinancing, reserves
  • breakeven, sensitivity, monte_carlo
  • health_check — Diagnóstico del modelo
  • Paridad de cálculo bit a bit con la app heredada (verificada en 5 proyectos de demostración, 14 hojas, 0 diferencias de celda)

Entrega en la plataforma

  • Servido en fm-platform.austral-intelligence.com mediante middleware de detección de host
  • Interfaz esbelta de herramienta única (sin barra lateral de la plataforma)
  • Colaboración multiusuario en tiempo real vía WebSocket
  • Proyectos respaldados por base de datos (autoguardado) + ida y vuelta de sesión JSON con la app heredada
  • Exportaciones XLSX de 18 hojas + PDF i18n de 5 páginas (EN/ES/FR/PT)
  • Perspectivas de IA (Claude) + API pública por lotes (X-API-Key)
  • La app independiente Streamlit heredada fm.austral-intelligence.com fue retirada en la migración de aplicaciones independientes de 2026; ese host ahora redirige a la aplicación independiente de la plataforma

Guarantees — Plataforma CLV

guarantees/app.py

Importaciones de ppp-core (10 reexportaciones)

  • data_models.py — SimulationConfig, CorrelationConfig
  • macro_shocks.py — Escenarios de shocks macroeconómicos
  • Motores: debt, FX, MRG, termination
  • portfolio, correlation, sensitivity
  • diagnostics — Diagnóstico de motores

Específico de la app

  • 8 módulos de gráficos (uno por motor)
  • Gestión del estado de sesión
  • E/S de archivos (importación/exportación de Excel)
  • Formato y estilo personalizados

Risk — Registro de Riesgos

risk/app.py

Importaciones de ppp-core (2 reexportaciones)

  • gih_risk_data — Definiciones sectoriales GIH
  • pfram_data — Categorías y preguntas PFRAM
  • calc_pfram_rating(), calc_pfram_priority()

Específico de la app

  • Integra datos de riesgo GIH + PFRAM
  • Asignación de riesgos (a partir de conceptos del motor VFM)
  • Generación de sesiones de prueba
  • Utilidades de extracción de datos GIH

Equity — Calculadora del Costo del Capital Propio

equity/app.py

Sin dependencia de ppp-core

  • Beta/CAPM independiente basado en Damodaran
  • Archivos de datos propios (betaemerg.xls, ctryprem.xlsx)

Funcionalidades

  • Soporte i18n
  • Cálculos de prima de riesgo país

Austral AI — Chatbot Experto

austral-ai/ai.py + ingest.py

Sin dependencia de ppp-core

  • Sistema RAG basado en LangChain
  • Almacén de vectores FAISS

Funcionalidades

  • LLM dual (OpenAI + Anthropic)
  • REPL de Python para cálculo
  • Ingesta de biblioteca de documentos

GFS — Estados Financieros del Gobierno

gfs/app.py · 7 páginas

Importaciones de ppp-core (5 reexportaciones)

  • pfram/ — Cálculos GFS, sostenibilidad fiscal
  • calculate_project(), validate_project()
  • sensitivity_mc — Simulación de Monte Carlo
  • excel_io — Importación de Excel PFRAM

Específico de la app

  • i18n completo (en/fr/es/pt)
  • Backend de base de datos SQLite
  • Sensibilidad de tornado y mapa de calor
  • Prueba de techo fiscal
  • Informes FCCL y de sostenibilidad

Stress — Pruebas de Estrés de Cartera

stress/app.py · 11 pestañas

Importaciones de ppp-core (20+ reexportaciones)

  • stress/ — Ejecutor de estrés, motor DSF, métricas de crédito
  • stress/fiscal_space — Holgura fiscal
  • guarantees/macro_shocks — Escenarios predefinidos
  • pfram/risk_matrix — Integración de la matriz de riesgo
  • stress/fan_charts, climate_risk, esg_scoring

Específico de la app (14 módulos de interfaz)

  • Panel, configuración de cartera, escenarios macroeconómicos
  • Sostenibilidad de deuda y espacio fiscal
  • Métricas de crédito y sensibilidad
  • Pasivos contingentes y matriz de riesgo
  • Informes de declaración de riesgo fiscal

Monitor — Panel de Seguimiento de APP

mon/app.py · Multipágina

Sin dependencia de ppp-core

  • Plataforma de seguimiento independiente
  • Backend de base de datos SQLite

Funcionalidades

  • i18n completo (en/fr/es/pt)
  • Seguimiento del ciclo de vida del proyecto
  • Seguimiento de compromisos fiscales
  • Paneles por sector y estado

CBA — Análisis Costo-Beneficio

cba/app.py · CBA multisectorial de escritorio

Importaciones de ppp-core (14 reexportaciones)

  • cba/engine.py — Ejecutor principal de CBA
  • cba/costs.py — Construcción, O&M, valor residual
  • cba/benefits.py — Beneficios al usuario, externalidades, salario sombra
  • cba/npv.py — Descuento y TIR
  • cba/monte_carlo.py — Simulación probabilística
  • cba/sensitivity.py — Uno a la vez y tornado
  • cba/reference_class.py — Referencias Flyvbjerg / ROCKS
  • cba/social.py — Precios sombra, ponderaciones distributivas
  • cba/validation.py — Verificaciones de coherencia de entradas
  • cba/library/* — Referencias de costos, parámetros nacionales, tasas de descuento, carbono sombra, citas

Sectores cubiertos

  • Transporte (carreteras, ferrocarril, puertos, aeropuertos)
  • Energía (convencional, renovable, red)
  • Agua y saneamiento
  • Infraestructura de salud y educación
  • Vivienda social
  • Otra inversión pública

Directrices

  • EC 2014 · World Bank · ADB · Green Book
  • OMB A-94/A-4 · ATAP · HEATCO · WHO HEAT
  • IRENA · ROCKS · clase de referencia Flyvbjerg
Resumen

Panorama de aplicaciones

Catorce aplicaciones, un único núcleo analítico compartido. Cada herramienta se puede desplegar de forma independiente a la vez que comparte una única fuente de verdad para la modelización financiera, la evaluación de riesgo fiscal, la valoración de garantías y la lógica de costo-beneficio.

App Punto de Entrada Motor Interfaz ppp-core Dominio Propósito
VFM vfm/app.py 25 17 engine/* vfm-platform.austral-intelligence.com Evaluación de Value for Money
FM austral-platform/modules/fm/ 20 18 páginas de plataforma engine/* fm-platform.austral-intelligence.com Modelo de financiación de proyectos
Primer módulo migrado de Streamlit a la plataforma
Guarantees guarantees/app.py 10 8 gráficos guarantees/* guarantees-platform.austral-intelligence.com Valoración de pasivos contingentes
Risk risk/app.py 0 Monolítico risk/* risk-platform.austral-intelligence.com Registro y asignación de riesgos
Equity equity/app.py 0 Personalizado — equity-platform.austral-intelligence.com CAPM / costo del capital propio
Austral AI austral-ai/ai.py 0 Personalizado — ai.austral-intelligence.com Chatbot experto RAG
GFS gfs/app.py 5 7 páginas pfram/* gfs-platform.austral-intelligence.com Estados financieros del gobierno
Stress stress/app.py 20+ 14 stress/* · guarantees/* stress-platform.austral-intelligence.com Pruebas de estrés fiscal de cartera
CBA cba/app.py 14 Multipágina cba/* cba-platform.austral-intelligence.com Análisis Costo-Beneficio (multisectorial)
Monitor mon/app.py 0 Multipágina — monitor-platform.austral-intelligence.com Panel de seguimiento de APP
AI Copilot austral-platform/modules/copilot/ — páginas de plataforma ai_extract platform.austral-intelligence.com IA documental — extracción de contratos, clasificador IPSAS, narrativa FRS
PEFA austral-platform/modules/pefa/ 2 páginas de plataforma pefa/* platform.austral-intelligence.com Tarjeta de puntuación PEFA PI-10 de reporte de riesgo fiscal
Subnational austral-platform/modules/subnational_risk/ 1 páginas de plataforma subnational/* platform.austral-intelligence.com Chequeo de salud de riesgo fiscal subnacional (municipal/estatal)

Matriz de Módulos del Motor Compartido

Módulo del MotorVFMFMNotas
model, model_inputs✓✓Modelo financiero central
construction, debt, debt_sizing✓✓Financiación de proyectos
revenue, opex✓✓Flujos de caja
balance_sheet, income_statement✓✓Estados financieros
ratios, waterfall✓✓Resultados de análisis
monte_carlo, sensitivity✓✓Simulación de riesgo
breakeven, refinancing, reserves✓✓Funcionalidades avanzadas
funding, fx, depreciation✓✓Motores de apoyo
health_check✓✓Diagnóstico del modelo
psc, risk_allocation✓—Solo VFM
vfm_monte_carlo, vfm_sensitivity✓—Solo VFM
equity_engine✓—Solo VFM
Módulos Centrales

Dentro de ppp-core

ppp_core.engine/ 29 archivos

model.py · model_inputs.py · construction.py · debt.py · debt_sizing.py · revenue.py · opex.py · funding.py · fx.py · balance_sheet.py · income_statement.py · depreciation.py · ratios.py · waterfall.py · monte_carlo.py · sensitivity.py · breakeven.py · refinancing.py · reserves.py · equity_engine.py · health_check.py · psc.py · risk_allocation.py · vfm_monte_carlo.py · vfm_sensitivity.py

ppp_core.guarantees/ 11 archivos

data_models.py · macro_shocks.py · correlation.py · debt_engine.py · fx_engine.py · mrg_engine.py · termination_engine.py · portfolio_engine.py · sensitivity_engine.py · diagnostics.py

ppp_core.pfram/ 19 archivos

calculate_project.py · calculate_contingent.py · calculate_gfs.py · fiscal_affordability.py · risk_matrix.py · risk_questions.py · bridge.py · guarantee_bridge.py · constants.py · session_defaults.py · financial_functions.py · private_partner.py · portfolio.py · sensitivity_mc.py · fccl_report.py · excel_io.py · weo_api.py

ppp_core.cba/ 14 archivos

engine.py · inputs.py · costs.py · benefits.py · npv.py · monte_carlo.py · sensitivity.py · reference_class.py · social.py · distribution.py · validation.py · demo.py · library/citations.py · library/cost_benchmarks.py · library/discount_rates.py · library/national_parameters.py · library/shadow_carbon.py

ppp_core.risk/ 3 archivos

gih_risk_data.py · pfram_data.py · pfram_risk_data.py

VFM ui/ 17 archivos

formatting.py · inputs_general.py · inputs_revenue.py · inputs_opex.py · inputs_funding.py · inputs_risk.py · cost_of_equity_tab.py · qualitative_screening.py · qualitative_incentives.py · qualitative_questionnaire.py · qualitative_nfb.py · outputs_quantitative.py · outputs_vfm_report.py · sensitivity_tab.py · manual_tab.py · export_excel.py

FM ui/ 28 archivos

formatting.py · inputs_general.py · inputs_opex.py · inputs_revenue.py · inputs_funding.py · outputs_dashboard.py · outputs_construction.py · outputs_debt.py · outputs_statements.py · outputs_waterfall.py · outputs_ratios.py · outputs_charts.py · outputs_sensitivity.py · outputs_scenarios.py · outputs_breakeven.py · outputs_monte_carlo.py · outputs_govt_affordability.py · outputs_health_check.py · outputs_risk_covenant.py · outputs_termination.py · session_manager.py · portfolio_helpers.py · export_excel.py · export_pdf.py · documentation.py · home.py

Servicios de Plataforma Sprint 8

475+ rutas de API · 133 páginas de frontend · 26 módulos analíticos · 23 tablas de base de datos · Aprovisionamiento SCIM 2.0 · Sincronización nocturna con Celery · Facturas Stripe + gestión de cobros · OData con doble autenticación (JWT + clave de API) · Consolidación de disputas FARO · Enriquecimiento de datos externos (BM/FMI/BIS) · Taxonomía de la UE (33 actividades) · Clasificador ESA (ampliado) · Listas de sanciones AML personalizadas · SSO (OIDC + SAML 2.0 + SCIM 2.0) · Diagnóstico de Preparación País (BM 2016 v2) · Correspondencia con los Principios de la OCDE · Motor de adecuación de capital del Fondo de Infraestructura (PIF) · Hub de Presupuesto y Programa Fiscal de APP