Saltar al contenido principal

Modelo de Dominio

Versión: 1.0
Proyecto: Directorio de Clínicas Médicas Estado: Borrador

El éxito de este ecosistema radica en la separación de identidades: desacoplamos al profesional de la salud de la infraestructura física donde opera. El modelo es polimórfico y modular, permitiendo que servicios como Farmacias o Laboratorios coexistan bajo una misma estructura lógica, pudiendo activarse o desactivarse según las necesidades del negocio sin comprometer la integridad del sistema.

1. El Profesional de la Salud (Doctor)​

Representa al individuo prestador de servicios médicos. Su identidad es autónoma, única y lo sigue independientemente de las entidades donde colabore.

  • Identificador Único: Número de Colegiado (Llave primaria de identidad profesional).
  • Atributos Principales:
    • Nombre completo y especialidad(es).
    • Biografía profesional y perfil académico/maestrías.
    • Rating acumulado (basado en reseñas verificadas).
    • Status_Validacion: (Verificado / Pendiente / Suspendido).
  • Regla de Independencia: Un Doctor no "pertenece" a una clínica; se afilia a una o varias sedes para prestar servicios.

2. Entidades de Salud (Estructura Modular)​

Representan los puntos físicos de atención o servicio (Sedes). Utilizamos un modelo de Entidad Base con discriminadores de tipo para una arquitectura escalable.

A. Atributos Comunes (Base Entity)​

  • Tipo_Entidad: (CLINICA, LABORATORIO, FARMACIA).
  • Nombre_Comercial y Razón_Social.
  • Ubicación: Dirección física, Zona/Municipio y Coordenadas GPS (Lat/Lng).
  • Horarios_Sede: Definidos por día y franja horaria.
  • Métodos_Pago: (Efectivo, Tarjeta, Seguro, Transferencia).
  • Idiomas_Atencion: (Español, Inglés, Lenguas Mayas).
  • Multimedia: Galería de fotos del establecimiento y amenidades (Parqueo, Wi-Fi, Accesibilidad).

B. Atributos Específicos por Módulo (Extensibilidad)​

TipoAtributos Especializados (Dinámicos)
Clínica / SedeEmergencias 24h, Quirófanos, Disponibilidad de especialistas afiliados.
LaboratorioToma de muestras a domicilio, Resultados en línea, Certificaciones Sanitarias.
FarmaciaServicio a domicilio (Delivery), Drive-thru, Turnos 24h, WhatsApp directo para recetas.

3. Lógica de Propiedad y Afiliación​

El sistema resuelve la complejidad del ejercicio profesional mediante dos escenarios de negocio:

3.1 Escenario Independiente (Consultorio Propio)​

  • El Profesional actúa como Administrador de su propia Sede (Entidad tipo CLINICA).
  • Los convenios de seguros son gestionados directamente por el Profesional y se aplican a su sede única.
  • La reputación de la Sede y del Profesional están ligados por propiedad.

3.2 Escenario Corporativo (Clínica Multiespecialidad / Hospital)​

  • La Sede es una entidad independiente con administración y reputación corporativa propia.
  • Los Profesionales se afilian a la Sede mediante una relación de horarios y consultorios.
  • Lógica de Seguros: La sede puede tener convenios institucionales (cubren a todos los médicos) o permitir que cada médico use sus acreditaciones individuales.

4. El Paciente (Usuario Final / Cliente)​

Consumidor de los servicios. Su perfil optimiza la búsqueda basada en su contexto financiero y familiar.

  • Atributos de Identidad: Nombre, Correo, Teléfono verificado (OTP).
  • Atributos de Salud:
    • Seguro_Primario: Relación con la Aseguradora para pre-filtrar resultados de red.
    • Póliza_ID: Número de carné para agilizar validaciones en sedes.
    • Ubicaciones_Frecuentes: (Casa, Trabajo) para cálculos de cercanía relativa.
    • Favoritos: Marcadores persistentes de Doctores y Sedes.
  • Gestión Familiar:
    • Dependientes: Capacidad de gestionar perfiles de hijos o adultos mayores bajo una cuenta principal.

5. Aseguradora y Validación Activa​

Entidad que valida la cobertura financiera. El sistema funciona como un validador de red en tiempo real ("Living Directory").

  • Validación Triple: El sistema verifica la intersección: [Doctor] + [Entidad] + [Seguro].
    • Regla de Oro: Un doctor puede aceptar un seguro en la "Sede A" pero ser privado en la "Sede B".
  • Estado de Convenio: Flag de Convenio_Activo para garantizar que la relación comercial no es obsoleta.

6. Diccionario de Relaciones​

6.1 Relaciones Clínico-Legales​

  1. Afiliación (Doctor ↔ Entidad): Define dónde y cuándo atiende el profesional (Relación N:N).
  2. Acreditación (Doctor <-> Seguro): Define si el profesional pertenece a la red de la aseguradora.
  3. Convenio (Entidad <-> Seguro): Define si la infraestructura acepta pagos directos.

6.2 Relaciones de Usuario y Servicio​

  1. Reseña (Paciente → Doctor): Calificación validada. Regla: Si es negativa, requiere evidencia (comprobante) para evitar difamación.
  2. Parentesco (Paciente ↔ Paciente): Estructura jerárquica para cuentas familiares (Dependientes).

6.3 Relaciones Operativas (Flujo de Salud)​

  1. Referencia (Doctor → Paciente → Lab/Especialista): Origen de la orden médica para servicios de diagnóstico.
  2. Receta (Doctor → Paciente → Farmacia): Vínculo para el despacho y entrega de medicamentos.

6.4 Relaciones de Control (Administrativo)​

  1. Gestión (Usuario Admin ↔ Entidad): Define permisos de edición sobre la data de las sedes.
  2. Propiedad (Doctor <-> Consultorio): Relación de dueño único para el escenario independiente.

7. Diseño Técnico para la Escalabilidad​

  1. Registry de Módulos: Permite "apagar" o "encender" tipos de entidades (ej. Farmacias) desde la configuración del sistema.
  2. Atributos Dinámicos (JSONB): Los atributos específicos se manejan de forma dinámica para evitar migraciones constantes de base de datos.
  3. Jerarquía de Visualización: El sistema permite buscar tanto por Capacidad Técnica (Especialidad del Doctor) como por Infraestructura (Servicios de la Clínica/Lab).