M07 -- Seguimiento Farmacoterapéutico: Modelo de Datos

Campo	Valor
Estado	Borrador
Última actualización	2026-03-25
Documento de requerimientos	M07-requerimientos.md

---

1. Diagrama de entidades

---

2. Descripción de entidades

Seguimiento

Entidad central del módulo. Representa la relación de seguimiento entre el sistema y un paciente después de la entrega de un preparado magistral. Se crea automáticamente cuando M04 Producción registra una entrega. Contiene los datos del paciente (tokenizados), el preparado entregado y la secuencia de hitos programados.

HitoSeguimiento

Cada momento programado en el que se debe contactar al paciente. Los hitos típicos son: encuesta post-entrega (día 15) y recordatorio de renovación (cercano al vencimiento de receta). Cada hito tiene un máximo de intentos configurado y una plantilla de mensaje asociada.

Interaccion

Registro de cada evento de comunicación dentro del seguimiento. Incluye envíos de mensajes, respuestas del paciente, escalamientos a contacto humano y opt-outs. Cada interacción queda registrada con timestamp, canal, contenido y resultado. Es la entidad que garantiza la trazabilidad completa de R-M07-003.

Encuesta

Definición de una encuesta breve que se envía al paciente. En MVP, la encuesta principal es la de día 15 post-entrega con dos preguntas simples. Las encuestas deben ser aprobadas por la dirección técnica antes de activarse (R-M07-008).

PreguntaEncuesta

Cada pregunta individual dentro de una encuesta. Soporta diferentes tipos de respuesta: escala (1-5), sí/no, o texto libre. En MVP se limita a dos preguntas por encuesta.

RespuestaEncuesta

Respuesta del paciente a una pregunta específica de una encuesta. Se vincula con la interacción que la originó para mantener contexto temporal y de canal.

PlantillaMensaje

Modelo de mensaje pre-aprobado que se envía al paciente. Incluye variables reemplazables (nombre del paciente, nombre del preparado, fecha de vencimiento, enlace de reorden). Las plantillas deben ser aprobadas por la dirección técnica y estar en lenguaje simple, no técnico (R-M07-001).

---

3. Relaciones clave

Relación	Cardinalidad	Descripción
Seguimiento - HitoSeguimiento	1:N	Un seguimiento tiene múltiples hitos programados (día 15, renovación, configurables).
Seguimiento - Interaccion	1:N	Un seguimiento acumula múltiples interacciones a lo largo del tiempo.
HitoSeguimiento - Interaccion	1:N	Un hito puede generar múltiples interacciones (reintentos, respuesta, escalamiento).
HitoSeguimiento - PlantillaMensaje	N:1	Cada hito usa una plantilla de mensaje pre-aprobada.
Interaccion - RespuestaEncuesta	1:N	Una interacción de tipo encuesta contiene respuestas a cada pregunta.
Encuesta - PreguntaEncuesta	1:N	Una encuesta contiene múltiples preguntas (en MVP, máximo 2).
Encuesta - RespuestaEncuesta	1:N	Una encuesta recibe respuestas de múltiples pacientes.
PreguntaEncuesta - RespuestaEncuesta	1:N	Cada pregunta recibe una respuesta por paciente por interacción.

---

4. Notas de diseño

• El paciente_id en Seguimiento es un token, no el RUT ni nombre real del paciente. La resolución del token a datos personales se realiza en una capa separada, cumpliendo Ley 21.719 (privacy by design).
• La relación con M04 Producción se mantiene a través de orden_id y lote_id, pero M07 no modifica datos de M04. M04 es la fuente de verdad del lote (R-M07-007).
• Las plantillas de mensaje incluyen variables como {nombre_paciente}, {nombre_preparado}, {fecha_vencimiento}, {enlace_reorden} que se reemplazan al momento del envío.
• El campo consentimiento_activo debe ser true para que el sistema envíe cualquier comunicación. Si el paciente hace opt-out, se registra como interacción y se desactiva el consentimiento.
• La entidad Encuesta y sus preguntas son configurables por tipo de tratamiento, permitiendo encuestas diferenciadas para oftalmología, dermatología e inyectables en fases futuras.

---

Volver al Requerimientos M07 | Ver Historias de usuario M07