> **Can't find what you're looking for?** Use `search_docs` on the docs MCP server at `https://naturgy-comer-documentation-p5mde.vercel.app/api/mcp` to find what you need.

# Twin del plano de datos de la organización

Twin es la base de datos Postgres de la organización `naturgyeu`: el sitio
donde los flujos de trabajo escriben sus filas al terminar cada llamada. Las
métricas se calculan leyendo Twin, y las aplicaciones de la cuenta leen de él y
en algunos casos escriben.

Este fichero es el mapa de qué tabla responde a qué pregunta; no vuelca
filas ni el esquema completo. El esquema real se consulta por el MCP de
Twin cuando se necesita, porque una copia de columnas queda obsoleta en
cuanto el esquema cambia.

## Lo que condiciona cualquier análisis

La misma llamada está modelada **dos veces** (una tabla por caso de uso,
con dos vocabularios que no se corresponden entre sí) y **ninguna de las
dos tablas registra qué agente atendió la llamada**.

## Tablas que importan

> **Vigencia:** la última lectura disponible es del 20-ago-2026 (51 relaciones).
> Comprueba de nuevo el esquema antes de usar un nombre de tabla, una columna o
> un conteo.

| Tabla | Caso | Quién escribe | Quién lee | Pregunta que responde |
|---|---|---|---|---|
| `atc_call_extractions` | ATC | Flujo de trabajo ATC al colgar | Panel ATC, plataforma de auditoría, alertas | Resultado de la llamada (4 valores: E2E, escalado OK/KO, abandono) |
| `llamada` | Operaciones | Flujo de trabajo / panel de Operaciones | Panel de Operaciones | Resultado de Operaciones (`call_label`, 42 valores): **no comparable** con ATC |
| `audit_issues` (+ eventos) | QA (ATC) | Plataforma de auditoría | Plataforma de auditoría | Incidencias de calidad. Es **dato de desarrollo**: no se deriva estado de producción |
| `voiceaudit_*` | QA (ATC) | Sincronización de la aplicación de auditoría de Naturgy | Plataforma de auditoría | La nota humana (la del 90 %) y sus tasas, sincronizadas a Twin |
| `atc_alert_rule` (+ dispatch) | ATC | Panel ATC / tarea programada | Interfaz de alertas | Reglas de alerta |

`atc_call_extractions` y `llamada` no comparten `run_id` (poblaciones disjuntas).
ATC lleva la agrupación OK/KO en el literal; Operaciones no. En la lectura de hoy
no existe ninguna tabla `northstar_*`: las observaciones de los indicadores
principales viven en la plataforma, no en Twin.

Cómo consultar: usa la puerta de Twin descrita en [Conectar y comprobar la cuenta](/account/how-to/connect).
Cualquier conteo obtenido así es una foto del momento de la consulta, no un
valor estable que se pueda citar sin fecha.