Módulo 02 · Pacientes y dependientes

Última actualización: 14 de noviembre de 2026.

Documento funcional para validación con usuarios. Se presentan comportamientos esperados y reglas en lenguaje claro, sin códigos de trazabilidad técnica.

Contexto funcional vigente

El MVP se desarrolla en plataforma web. Salud 365 presenta la experiencia del usuario y coordina las operaciones; Elite Global Doctors (EGD) es el core clínico. Las capacidades concretas de sus servicios e interfaces aún requieren validación técnica.

El titular que contrata y paga puede ser distinto del paciente; los pacientes dependientes deben estar vinculados y autorizados. Los usuarios, pacientes y médicos requieren registro y correspondencia de identidad entre Salud 365 y EGD.

Descripción funcional y procesos

Especificación de Requerimientos Funcionales

Objetivo y alcance

Especificar el registro, asociación, consulta, actualización y control de acceso a los pacientes y dependientes gestionados por una cuenta TITULAR en Salud 365. Los pacientes deben disponer de registro válido en EGD antes de participar en procesos clínicos. Este documento complementa el Módulo 01 (Acceso y Gestión de Usuarios), sin sustituir sus reglas de autenticación y sincronización. Incluye la consulta consolidada de citas de pacientes asociados desde el inicio del TITULAR, sin reemplazar la gestión de citas del Módulo 04.

Bases funcionales y alcance de las decisiones

CONFIRMADO · Un TITULAR puede pagar y solicitar atención para sí mismo o para pacientes asociados; un TITULAR no necesariamente es paciente.

CONFIRMADO · Usuarios, pacientes y médicos deben estar registrados en Salud 365 y EGD; EGD es el core clínico.

CONFIRMADO · La cuenta TITULAR se autentica con correo y contraseña; el alta de usuarios requiere confirmación en línea de EGD antes de habilitar acceso.

PROPUESTA PARA VALIDACIÓN · Aplicar a pacientes el mismo bloqueo de procesos clínicos cuando su alta/actualización crítica en EGD esté pendiente.

Actores, conceptos y responsabilidades

Se incluyen siete requerimientos funcionales. contempla la visualización de citas por paciente; el ciclo de vida de la cita corresponde al Módulo 04.

RF-02-001 · Alta de paciente propio (TITULAR como paciente)

Objetivo: Permitir que un TITULAR cree o vincule su propia ficha de paciente sin asumir que el autorregistro ya la generó.

Precondiciones: TITULAR autenticado y ACTIVO en Salud 365 y EGD.

Flujo principal (propuesto):

1. Se visualiza la lista de pacientes dependientes incluido el mismo (siempre que sea ya paciente) (donde se tendrá la opción de citas, ver historia clínica, consulta de recetas y documentos,etc)(ver RF-02-003).

2. Se validará por tipo y numero de documento de identidad del usuario si existe el registro de paciente en EGD y Salud365. El paciente siempre tiene que estar registrado primero en Salud365.

3. Si existe en EGD y Salud365, solo mostrar la opción “Mis pacientes/dependientes”. Si elige “Mis pacientes/dependientes” (ver RF-02-002).

4. Si no Existe en EGD, se mostrara las opciones “Atenderme a mí” o “Mis pacientes/dependientes”. Si elige “Mis pacientes/dependientes” (ver RF-02-002).

5. Se selecciona “Atenderme a mi”.

6. Si no existe en EGD y Salud 365, se habilita un formulario( se recargaran los datos del usuario correspondiente al paciente, y se habilitara el ingreso de los datos faltantes) para el ingreso de datos, donde se harán las validaciones necesarias y se guarde los datos en Salud365(estado del paciente POR SINCRONIZAR) y se envie asincronamente a EGD,según contrato disponible, conservando correspondencia de IDs.

7. Nombres y Apellidos;Documento de identidad(Tipo y Número); fecha nacimiento; genero( Femenino, Masculino, Otros);dirección(opcional);Correo válido y normalizado; celular según formato y país(maximo dos números-teléfono principal(obligatorio) y teléfono secundario(opcional)).

Campo	Obligatoriedad propuesta	Validación o comportamiento
Nombres	Obligatorio	Registrar nombres conforme al documento de identidad.
Apellido paterno	Obligatorio*	Permitir validación según tipo de documento.
Apellido materno	Condicional	No todos los documentos o nacionalidades utilizan dos apellidos.
Tipo de documento	Obligatorio	Catálogo configurable: DNI, carné de extranjería, pasaporte u otros admitidos.
Número de documento	Obligatorio	Validar longitud y formato según el tipo seleccionado.
Fecha de nacimiento	Obligatorio	No permitir fechas futuras; calcular edad automáticamente.
Género	Por definir	Femenino, Masculino, Otro, Prefiere no indicar, según catálogo aprobado.
Dirección	Opcional	País, departamento, provincia, distrito y dirección, según necesidad.
Correo electrónico	Condicional	Formato válido, normalizado y posibilidad de utilizar el del TITULAR.
Celular principal	Obligatorio propuesto	Código de país y número válido; identificar si pertenece al paciente o titular.
Celular secundario	Opcional	Máximo dos números por paciente, sin duplicados.
Relación con el TITULAR	Obligatorio para dependientes	Hijo/a, padre/madre, cónyuge, hermano/a, abuelo/a, nieto/a u otro.

8. Si Salud365 confirma la creacion del paciente, se vincula paciente y TITULAR y se habilita su selección para citas desde el punto 1(Se visualiza la lista de pacientes dependientes y del titular).

9. Sincronización de paciente a EGD, ver RF-02-007.

Alternativas / excepciones: Ficha existente: vincular únicamente después de comprobar titularidad. Coincidencia ambigua: derivar a validación; no fusionar automáticamente.

Validaciones y reglas: No crear ficha clínica automáticamente por el solo hecho de tener cuenta. Documento, fecha de nacimiento y campos mínimos por definir. Impedir asociación a identidad equivocada.

Criterios de aceptación: Paciente propio vinculado a cuenta correcta y con ID EGD confirmado; si falla EGD no se permite agendar; pero si la configuración de EGD esta desactiva, se trabaja con los datos de salud 365.

Referencias de trazabilidad: FL por vincular | INT INT-01 | API/Checklist EGD 4.1, 4.2, 4.3, 4.6.

RF-02-002 · Alta y asociación de dependiente

Objetivo: Permitir al TITULAR incorporar un paciente dependiente bajo una relación autorizada.

Precondiciones: TITULAR autenticado y ACTIVO; capacidad de asociar dependientes habilitada.

Flujo principal (propuesto):

1. Se visualiza la lista de pacientes dependientes incluido el titular(siempre que sea ya paciente) (donde se tendrá la opción de citas, ver historia clínica, consulta de recetas y documentos,etc)(ver RF-02-003).

2. El TITULAR ingresa a “Mis pacientes/dependientes”.

3. Selecciona tipo de relación y completa datos del dependiente(mínimo tipo y numero de documento de identidad).

4. Se validará por tipo y numero de documento de identidad del dependiente si existe el registro de paciente en EGD y Salud365. El paciente siempre tiene que estar registrado primero en Salud365.

5. Si no existe en EGD y Salud 365, se habilita un formulario para el ingreso de datos, donde se harán las validaciones necesarias y se guarde los datos en Salud365(estado del paciente POR SINCRONIZAR) y se enviara asincronamente a EGD,según contrato disponible, conservando correspondencia de IDs.

6. Para el correo, teléfono principal(obligatorio) y teléfono secundario(opcional) se debe tener la opción de cargar los datos del TITULAR.

Campo	Obligatoriedad propuesta	Validación o comportamiento
Nombres	Obligatorio	Registrar nombres conforme al documento de identidad.
Apellido paterno	Obligatorio*	Permitir validación según tipo de documento.
Apellido materno	Condicional	No todos los documentos o nacionalidades utilizan dos apellidos.
Tipo de documento	Obligatorio	Catálogo configurable: DNI, carné de extranjería, pasaporte u otros admitidos.
Número de documento	Obligatorio	Validar longitud y formato según el tipo seleccionado.
Fecha de nacimiento	Obligatorio	No permitir fechas futuras; calcular edad automáticamente.
Género	Por definir	Femenino, Masculino, Otro, Prefiere no indicar, según catálogo aprobado.
Dirección	Opcional	País, departamento, provincia, distrito y dirección, según necesidad.
Correo electrónico	Condicional	Formato válido, normalizado y posibilidad de utilizar el del TITULAR.
Celular principal	Obligatorio propuesto	Código de país y número válido; identificar si pertenece al paciente o titular.
Celular secundario	Opcional	Máximo dos números por paciente, sin duplicados.
Relación con el TITULAR	Obligatorio para dependientes	Hijo/a, padre/madre, cónyuge, hermano/a, abuelo/a, nieto/a u otro.

7. Si Salud365 confirma la creacion del paciente, se vincula paciente y TITULAR y se habilita su selección para citas desde el punto 1(Se visualiza la lista de pacientes dependientes y del titular).

8. Si existe en EGD y Salud365,se alerta que el paciente esta creado y se deriva al punto1 donde se visualiza la lista de pacientes dependientes y de titular.

9. Sincronización de paciente a EGD, ver RF-02-007.

Alternativas / excepciones: fallo EGD: guardar trazabilidad de operación pendiente para sincronizar posteriormente datos del paciente de SALUD365 a EGD.fallo Salud 365: rechazar operación.

Validaciones y reglas: Evitar duplicidad de pacientes y relaciones.

Criterios de aceptación: Solo asociaciones verificadas aparecen habilitadas para solicitar citas; las rechazadas no exponen información clínica.

Referencias de trazabilidad: FL por vincular | INT INT-01 | API/Checklist EGD 4.1, 4.2, 4.3, 4.6.

RF-02-003 · Consulta y selección de pacientes

Objetivo: Mostrar al TITULAR los pacientes propios y dependientes autorizados para contratar servicios.

Precondiciones: TITULAR autenticado; relaciones activas.

Flujo principal (propuesto):

1. El TITULAR accede a la lista de pacientes asociados.

2. El sistema muestra datos mínimos y estado de cada asociación. La lista del titular presenta los vínculos activos; la información se organiza en una tabla en escritorio y en tarjetas en móvil.

Campo	Descripción funcional
Nombres y apellidos	Nombre completo del paciente asociado al TITULAR.
Tipo de relación con el TITULAR	Indica si es el propio titular, hijo(a), cónyuge, padre/madre u otro dependiente.
Estado del vínculo	ACTIVO / INACTIVO. Indica si la relación TITULAR–PACIENTE está habilitada dentro de la cuenta. No equivale al estado general del paciente ni elimina su ficha.
Estado del servicio	Muestra la situación del servicio de telemedicina más reciente o vigente del paciente.
Fecha de última cita generada	Fecha de creación de la cita más reciente registrada para el paciente.
Ver detalle	Permite consultar los datos personales y de contacto del paciente. Ver RF-02-004, Ver RF-02-005.
Ver cita	Solicitar Cita, Ver RF-04-001, si existe una cita generada se activa la opcion haciendo referencia “RF-04-008 · Confirmación, detalle y consulta de cita.”
Acceso a videollamada	Desde el detalle de la cita, cuando corresponda su habilitación. Ver RF-04-008 y RF-05-001 · Habilitación de acceso a videoconsulta.
Ver historial	Ver RF-02-006
Ver documentos	Ver RF-02-006
Ver historial de citas	Ver RF-02-006.
Editar	Permite modificar los datos autorizados del paciente. Ver RF-02-004
Desvincular	Permite solicitar la desvinculación del paciente de la cuenta del TITULAR, según las reglas de autorización. Ver RF-02-005
Fotografía	Muestra la foto del paciente o su identificación visual cuando no tenga imagen.
Edad y documento	Muestra la edad y el tipo y número de documento del paciente.
Cambiar foto	Permite cargar, encuadrar, reemplazar o quitar la imagen de un paciente autorizado. Ver RF-02-004.

3. El TITULAR selecciona un paciente donde tendra la opcion de inciar una Cita, ver HIstorial Clinico, ver consulta de documentos, ver historial de citas, ver detalle del paciente y editar paciente(ver RF-02-004). La gestión incluye cargar, encuadrar, reemplazar y quitar la foto individual del paciente. El acceso a la videollamada se realiza desde el detalle de la cita.

Validaciones y reglas: No mostrar pacientes de otras cuentas; evitar filtración de datos clínicos en listados;

Criterios de aceptación: Únicamente pacientes autorizados y habilitados pueden seleccionarse para agendamiento.

Flujo A · Titular que solicita atención para sí: cuenta TITULAR ACTIVA → crear/vincular ficha PACIENTE propia Salud365 → confirmar ID EGD al crear/actualizar(asincrono) → seleccionar dependiente/paciente → validar consulta información clinica del paciente.

Flujo B · Titular que solicita atención para dependiente: cuenta TITULAR ACTIVA → registrar/verificar relación → crear/vincular PACIENTE en Salud 365→ confirmar asociación e ID EGD al crear/actualizar(asincrono)→ seleccionar dependiente/paciente → validar consulta información clinica del paciente.

Flujo C · Éxito Asincrono EGD: Envió datos paciente → solicitud alta → confirmación EGD → Cambio de estado en Salud365.

Flujo D · Error Asincrono EGD: Envió datos paciente → solicitud alta → EGD no confirma → paciente no creado → registro de incidencia(trazabilidad) → verificación/reintento seguro(si el número de reintentos es mayor a 5, registra el incidente para reenvio manual desde el modulo de administración) → confirmación EGD → Cambio de estado en Salud365.

Referencias de trazabilidad: FL por vincular | INT INT-02 | API/Checklist EGD 3.6, 3.7, 7.9, 13.2.

RF-02-004 · Consulta y actualización de datos de paciente

Objetivo: Permitir visualizar y actualizar datos administrativos permitidos, sincronizando los cambios necesarios con EGD.

Precondiciones: Paciente propio o dependiente con vínculo vigente; permiso de edición.

Flujo principal (propuesto):

1. Se abre la ficha del paciente autorizado.

2. Salud 365 presenta los datos permitidos para lectura y edición:

Campo	¿Editable?	Regla funcional propuesta
Nombres	No	Solo lectura. Correcciones mediante un procedimiento administrativo.
Apellido paterno	No	Solo lectura.
Apellido materno	No	Solo lectura.
Tipo de documento	No	No permitir modificación directa.
Número de documento	No	No permitir modificación directa para evitar inconsistencias con EGD.
Fecha de nacimiento	No	Solo lectura. Corrección mediante administración.
Género	Sí	Seleccionar entre las opciones del catálogo aprobado.
Dirección	Sí	Campo opcional.
Correo electrónico	Sí	Validar formato y normalizar el correo.
Celular principal	Sí	Validar código de país y número.
Celular secundario	Sí	Opcional, máximo dos números en total.
Tipo de relación con el TITULAR	Sí, condicionado	Permitir correcciones, siempre que no afecten las reglas de autorización.
Estado del paciente	No	No editable desde este formulario.
Estado del servicio	No	Se actualiza según los eventos de pago, cita y atención.
Fotografía de perfil	Sí, con autorización	Cargar, encuadrar, reemplazar o quitar. Mantener la correspondencia con la foto del titular cuando se trate de su propia ficha. Ver RF-01-005.

3. El TITULAR modifica los campos editables y confirma.

4. El sistema valida reglas y registra el cambio en Salud 365; la actualización necesaria se envía de forma asíncrona a EGD.

5. Si el registro es exitoso en Salud 365, se muestra el mensaje de actualización local y se regresa a RF-02-003. Ese resultado no equivale a la confirmación de actualización por EGD.

6. Se conserva auditoría de cambios en Salud 365. Se permite cargar, encuadrar, reemplazar y quitar la foto de cada paciente autorizado. Si el paciente es el propio titular, su fotografía mantiene la correspondencia definida en RF-01-005.

7. Sincronización de actualización de paciente a EGD, ver RF-02-007.

Alternativas / excepciones: Campo inmutable: no permitir edición.

Validaciones y reglas: controlar autorizaciones por campo; preservar trazabilidad de cambios.

Criterios de aceptación: Cambios autorizados quedan consistentes o se señalan claramente como pendientes; no se pierden registros previos. La persona autorizada puede cargar, encuadrar, reemplazar y quitar la fotografía del paciente.

Referencias de trazabilidad: FL por vincular | INT INT-02 | API/Checklist EGD 3.6, 3.7, 7.9, 13.2.

RF-02-005 · Gestión de vínculo y desvinculación

Objetivo: Administrar el estado de la relación TITULAR–PACIENTE sin eliminar indebidamente la ficha clínica.

Precondiciones: Existe relación activa y el actor cuenta con autorización.

Flujo principal (propuesto):

1. Se solicita retirar a un dependiente (DESVINCULAR). Se valida primero que no exista ningún servicio activo: cita solicitada, consentida, pagada, en cola, confirmada o en atención. Si no existe, se presenta la confirmación con las opciones “SÍ” o “NO”.

2. Se confirma la operación y se desactiva el vínculo TITULAR–PACIENTE, mostrándolo como inactivo para esa cuenta. Se deshabilitan las opciones de solicitar citas y consultar información clínica mediante ese vínculo desde RF-02-003; no se cambia por ello el estado general de la ficha del paciente.

3. Se conserva evidencia de auditoría y se mantiene la historia clínica en EGD.

Alternativas / excepciones: Atención/cita en curso: impedir o posponer la desvinculación según regla.

Validaciones y reglas: Desvincular no equivale a borrar al paciente ni su historia clínica. Reglas de conservación y privacidad.

Criterios de aceptación: El TITULAR desvinculado no puede ver ni agendar para el paciente; se preserva trazabilidad.

Referencias de trazabilidad: FL por vincular | INT por vincular | API/Checklist EGD por verificar.

RF-02-006 · Autorización de acceso y consulta a información clínica

Objetivo: Aplicar permisos por paciente, relación, rol y contexto de atención para consultar historia, recetas y conclusiones.

Precondiciones: Identidad autenticada, paciente vinculado y permiso vigente.

Flujo principal (propuesto):

1. Se solicita un documento o dato clínico de un paciente desde las opciones Ver Historial, Ver documentos , ver Historial de Citas.

2. Salud 365 verifica rol, vínculo vigente y alcance de autorización, según los RF-07-001,RF-07-002,RF-07-003,RF-07-004,RF-07-005,RF-07-006.

Alternativas / excepciones: Sin autorización: denegar.

Validaciones y reglas: El pago de una cita no otorga por sí solo acceso a toda la historia clínica,si EGD esta activo y se tienen los permisos se puede visualizar el historial clínico del paciente, caso contrario se visualizara solo el historial clínico de Salud 365

Criterios de aceptación: Acceso limitado al Titular y a los documentos autorizados.

Referencias de trazabilidad (vinculación preliminar): FL-02-002 | INT-02 | Checklist EGD: 3.6, 3.7, 7.9, 13.2.

RF-02-007 · Sincronización y correspondencia de pacientes con EGD

Objetivo: Garantizar que el paciente asociado tenga identidad clínica válida en EGD y que los errores sean recuperables.

Precondiciones: Operación de alta, consulta o actualización de paciente iniciada.

Flujo principal (propuesto):

1. Salud 365 valida identidad y verifica coincidencias previas.

2. Invoca la operación EGD correspondiente mediante integración segura.

3. Se envia datos del paciente a EGD.

4. Se valida permisos( de EGD), obligatoriedad, formato y posibles coincidencias de identidad.

5. Procesa respuesta y guarda identificador EGD, fecha, resultado y referencia de operación.

6. Si EGD confirma la identidad clínica, se guarda trazabilidad del registro correcto del paciente, y marcar el estado del paciente “SINCRONIZADO”.

7. Habilita uso clínico solo si la operación obligatoria fue confirmada.

8. Si EGD NO confirma la identidad clínica, guardar trazabilidad del registro; mantener estado del paciente POR SINCRONIZAR;posteriormente se vuelve a ejecutar el proceso de sincronizacion de datos del paciente de SALUD365 a EGD.

9. Ante error, conserva estado, muestra mensaje y permite reintento controlado por backend/administrador.

Alternativas / excepciones: Timeout: no asumir fallo definitivo ni reenviar a ciegas; respuesta duplicada: reconciliar; EGD inconsistente: escalar a soporte.

Validaciones y reglas: Evitar duplicados e implementar idempotencia o verificación equivalente; nunca guardar credenciales en logs; proteger datos personales. Sincronizar solo paciente con estado “POR SINCRONIZAR”.En el caso si un paciente tiene mas de 5 eventos asincronos NO EXITOSOS, se debe alertar y notificar.

Criterios de aceptación: Se pueden recuperar fallos sin duplicar fichas. Paciente con estado “SINCRONIZADO” en Salud365 y creado exitosamente en EGD.

RF-02-009 · Consulta de citas de pacientes asociados

Objetivo: Permitir al TITULAR visualizar, al ingresar a Salud 365 y desde la ficha de cada paciente, las citas de sí mismo y de sus dependientes autorizados, con su estado y datos esenciales.

Actores: TITULAR. Sistemas relacionados: Salud 365 y EGD. Referencia cruzada: Módulo 04 · Citas (fuente de estados y acciones de agendamiento).

Precondiciones: TITULAR autenticado y ACTIVO en Salud 365 y EGD; vínculos de pacientes vigentes; permisos de consulta válidos.

Flujo principal (propuesto):

1. El TITULAR inicia sesión y accede a la pantalla principal o a “Mis pacientes/dependientes”.

2. Salud 365 identifica su ficha de paciente, si existe, y los dependientes con vínculos autorizados vigentes.

3. El sistema obtiene las citas asociadas a cada paciente permitido mediante la integración y fuente de información definidas con EGD.

4. Muestra un resumen de citas por paciente con fecha, hora, especialidad o servicio, profesional cuando corresponda y estado visible.

5. El TITULAR puede filtrar por paciente y estado (inicialmente Pendiente y Realizada) y abrir el detalle de una cita autorizada.

6. Para acciones como reprogramar o cancelar, Salud 365 deriva al flujo del Módulo 04 · Citas, según permisos y reglas aplicables.

Alternativas / excepciones: Sin citas: mostrar estado vacío. Error de EGD: informar que no se pudo actualizar la consulta, sin presentar datos obsoletos como confirmados. Vínculo revocado: excluir citas del paciente sin autorización. Estado no reconocido: mostrar estado controlado y registrar incidencia de mapeo.

Validaciones y reglas: Filtrar siempre por IDs de paciente autorizados; verificar permisos en backend y no solo en pantalla; no exponer citas de otros titulares. Diferenciar estado de cita, estado de pago y cierre del acto médico. El resumen no debe revelar datos clínicos sensibles por defecto.

Estados visibles: Pendiente y Realizada como vista inicial solicitada. Cancelada, Reprogramada, En atención y No atendida son propuestas para validar contra el catálogo real de EGD; no se asume que existan con esos nombres.

Criterios de aceptación: El TITULAR ve únicamente citas de pacientes autorizados; puede filtrar por paciente y estado; se muestra un mensaje claro si no hay citas o falla la integración; al perder el vínculo deja de ver las citas correspondientes; las acciones de gestión remiten al Módulo 04.

---

Descargar Markdown original