Cómo Diaphanum lee los datos del Estado sin reinterpretarlos.

Diaphanum se construye sobre el estándar OCDS publicado por el Estado de Guatemala. Documentamos aquí cómo el dato bruto se transforma en KPIs, rankings y series — y qué se materializa para que el rendimiento no comprometa la precisión.

Fuentes · 01

Una sola fuente primaria, seis esquemas operativos.

La fuente es el OCDS publicado por el Estado. Sobre él, Diaphanum opera seis esquemas con responsabilidades claras: ingesta, analítica, alertas, portal B2B, identidad y reportería.

Esquema	Responsabilidad
ocds	Lago transaccional — espejo del estándar
analytics	Vistas materializadas y agregados
alertas	Suscripciones por segmento, entidad y horario
aurelius_b2b	Empresas, suscripciones, monitores, eventos
iam	Identidades, roles, sesiones, recuperación
bi	Inteligencia editorial y reportería

Cada esquema vive con un contrato explícito. El esquema ocds es solo lectura para todo lo que no sea ingesta; el esquema analytics es de solo lectura para los productos finales. Esto evita que un panel sobre adjudicaciones dependa de un join improvisado contra el lago bruto.

El portal B2B vive sobre aurelius_b2b, que modela empresa, usuario, plan, monitor, alert_target y alert_event. Esto separa la lectura analítica del derecho de acceso comercial.

La identidad vive en iam, con dos planos: sesión web por cookies y sesión móvil / API por JWT. Roles vigentes: SUPERADMIN, ADMIN_EMPRESA y DELEGADO.

Modelo analítico · 02

Seis vistas materializadas, una para cada pregunta gerencial.

El modelo separa adjudicación base, adjudicación por proveedor, agregados mensuales por comprador y proveedor, desempeño en ofertas y prorrateo por producto. Ningún KPI improvisa joins contra el lago bruto.

VISTA 01

mv_award_base

1,185,019 filas

Núcleo analítico de adjudicaciones. Una fila por adjudicación con sus atributos esenciales: comprador, fecha, valor, mezcla legal, sector y territorio inferido. Sobre esta vista se construye el ranking de adjudicaciones y la lectura por entidad.

VISTA 02

mv_award_supplier_fact

1,185,020 filas

Hechos de adjudicación por proveedor. Resuelve la pregunta «¿qué se le adjudicó a este proveedor?» sin reabrir el OCDS. Es la base de los rankings de proveedores y de la rotación.

VISTA 03

mv_buyer_monthly

29,469 filas

Agregado mensual por comprador. Una fila por comprador × mes con totales, conteos y participación. Habilita las series temporales del dashboard ejecutivo sin agregaciones en caliente.

VISTA 04

mv_supplier_monthly

186,974 filas

Agregado mensual por proveedor. Mismo principio que la vista del comprador, pero leída desde el lado de quien recibe el contrato. Permite analizar concentración y dependencia.

VISTA 05

mv_supplier_bid_monthly

239,705 filas

Desempeño competitivo. Para cada proveedor × mes registra ofertas presentadas, ganadas y perdidas. Es el insumo para tasas de éxito, competencia efectiva y análisis de plazas dominadas.

VISTA 06

mv_product_allocation

2,681,423 filas

Prorrateo por producto / UNSPSC. Un mismo contrato suele cubrir varios ítems con valores y categorías distintas; esta vista distribuye el monto entre ítems para permitir lectura por sector real, no por rótulo administrativo.

Cobertura · 03

Del 2 de enero de 2020 al 14 de mayo de 2026.

La cobertura temporal es continua y compatible. Las vistas se reconstruyen contra el mismo modelo, lo que permite comparar dos años sin reinterpretar el OCDS cada vez.

PROCESOS POR AÑO · 2026 PARCIAL HASTA EL 14 DE MAYO

La distribución anual de procesos no es plana: refleja ciclos presupuestarios y reformas administrativas. Por eso comparamos períodos con criterios explícitos — mismo número de meses, misma mezcla legal — y dejamos visible cuándo un año está parcial.

2026 es un año en curso. Hasta el 14 de mayo, la base contiene cinco meses y medio de actividad, suficiente para anticipar tendencias pero no para clausurar conclusiones anuales.

"Comparamos años, no meses sueltos. Y dejamos visible cuándo un período está parcial."

Asistente IA · 04

Una IA con contexto OCDS y base documental — no un chat genérico.

La integración con OpenAI Responses construye prompts con contexto estructurado OCDS y se apoya en una base de conocimiento documental. El asistente es analítico y guiado, no abierto.

El asistente distingue intención del usuario antes de buscar. Si la pregunta es definicional, consulta el glosario interno; si es metodológica, consulta las reglas; si es operacional, consulta los alias de entidades; si es factual, consulta el modelo analítico.

La base de conocimiento contiene glosario, metodología, reglas de riesgo, alias de entidades y FAQ. Esto significa que el asistente puede explicar por qué un número es lo que es — no solo decir el número.

Componente	Uso
Glosario	Definiciones del estándar OCDS
Metodología	Cómo se calcula cada KPI
Reglas de riesgo	Señales y umbrales documentados
Alias de entidades	Nombres alternos de compradores y proveedores
FAQ	Preguntas frecuentes con respuesta canónica

Cómo Diaphanum lee los datos del Estado sin reinterpretarlos.

Una sola fuente primaria, seis esquemas operativos.

Seis vistas materializadas, una para cada pregunta gerencial.

Del 2 de enero de 2020 al 14 de mayo de 2026.

Una IA con contexto OCDS y base documental — no un chat genérico.

La metodología es auditable.Su acceso, también.

La metodología es auditable.
Su acceso, también.