Data model

Main entities of the MarIA system and their relationships: centers, services, calls, transcripts, and webhooks

This document summarizes the main entities of MarIA and how they connect.

Entities

• Center: medical center with its associated services and coverage.
• Service: specialty or type of service offered at one or more centers.
• Benefit: specific coverage/benefit within a service (used to schedule appointments).
• Call: inbound call with status, timestamps, and reference to the patient.
• Answer: response captured during a call (for questionnaires in outbound calls).
• Transcript: text transcript and recording URL associated with a call.
• FAQDocument: indexed document that feeds the agent’s knowledge base.
• Webhook: destination endpoint registration for events.

ER Diagram (simplified)

Inbound call lifecycle

RINGING → IN_PROGRESS → SUCCEEDED
                      ↘ FAILED
                      ↘ ESCALATED (transferred to human)

Retention and privacy

• Minimize PII in logs (mask phone numbers and patient data).
• Index transcripts and FAQ documents according to client policies.
• Right to erasure: answer and transcript deletion endpoints available in the API.