> ## Documentation Index
> Fetch the complete documentation index at: https://omniloy.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Modelo de datos

> Entidades principales del sistema MarIA y sus relaciones: centros, servicios, llamadas, transcripciones y webhooks

Este documento resume las entidades principales de MarIA y cómo se conectan.

## Entidades

* **Center**: centro médico con sus servicios y coberturas asociadas.
* **Service**: especialidad o tipo de servicio ofrecido en uno o varios centros.
* **Benefit**: cobertura/prestación concreta dentro de un servicio (usada para agendar citas).
* **Call**: llamada entrante con estado, tiempos y referencia al paciente.
* **Answer**: respuesta capturada durante una llamada (para cuestionarios en llamadas salientes).
* **Transcript**: transcripción textual y URL de grabación asociada a una llamada.
* **FAQDocument**: documento indexado que alimenta el conocimiento del agente.
* **Webhook**: registro de endpoint de destino para eventos.

## Diagrama ER (simplificado)

```mermaid theme={null}
erDiagram
  CENTER ||--o{ SERVICE : has
  SERVICE ||--o{ BENEFIT : contains
  CALL ||--o{ ANSWER : produces
  CALL ||--|| TRANSCRIPT : generates
  FAQCOLLECTION ||--o{ FAQdocument : stores
  WEBHOOK ||--o{ EVENT : delivers
```

## Ciclo de vida de una llamada entrante

```
RINGING → IN_PROGRESS → SUCCEEDED
                      ↘ FAILED
                      ↘ ESCALATED (transferida a humano)
```

## Retención y privacidad

* Minimizar PII en logs (enmascarar números de teléfono y datos de pacientes).
* Indexar transcripciones y documentos FAQ según políticas del cliente.
* Derecho al olvido: endpoints de borrado de respuestas y transcripciones disponibles en la API.