Módulo 03 · Médicos

Ú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.

EGD entrega la solución de videoconsulta para integrarla en Salud 365 y envía por WhatsApp el enlace al paciente y al médico. Terminar la llamada no significa cerrar el acto médico: el profesional puede retomar una atención pendiente. EGD proporciona la URL de la videoconsulta. Ante un fallo de conexión o error durante la llamada, se conserva esa misma URL, no se genera un enlace nuevo y el enlace deja de expirar para permitir retomar la atención; se mantienen los controles de acceso autorizados.

Descripción funcional y procesos

Objetivo y alcance

Definir las funciones para administrar el perfil profesional del médico, validar su habilitación, sincronizar su información con EGD, consultar agenda y citas asignadas, gestionar disponibilidad según reglas por confirmar y acceder al acto médico desde el frontend Salud 365.

Este módulo no especifica la ejecución clínica completa: anamnesis, diagnósticos, recetas y cierre se desarrollarán en Acto Médico y módulos clínicos. Tampoco sustituye las reglas transaccionales de Citas.

Bases funcionales y decisiones

Actores y responsabilidades

RF-03-001 · Alta administrativa y validación de médico

Objetivo: Permitir que un administrador registre un médico y valide sus datos profesionales antes de habilitar el acceso.

Actores: ADMINISTRADOR.

Precondiciones: Administrador autenticado y autorizado; catálogos necesarios disponibles.

Flujo principal:

1. Accede a Administración > Médicos y selecciona Nuevo médico.

2. Ingresa datos de identidad, contacto y atributos profesionales requeridos.

A. Datos personales y de identificación

Campo	Obligatoriedad propuesta	Validación o descripción
Nombres	Obligatorio	Nombres del profesional.
Apellido paterno	Obligatorio	Según documento de identidad.
Apellido materno	Condicional	Según documento y nacionalidad.
Tipo de documento	Obligatorio	DNI, carné de extranjería, pasaporte u otro admitido.
Número de documento	Obligatorio	Validación según tipo de documento.
Fecha de nacimiento	Opcional	Solo si existe necesidad administrativa justificada.
Género	Opcional	Según catálogo aprobado.
País	Obligatorio propuesto	País de registro o ejercicio profesional.
Fotografía de perfil	Opcional	Imagen que se mostrará al paciente.

B. Datos de contacto

Campo	Obligatoriedad propuesta	Validación o descripción
Correo electrónico	Obligatorio propuesto	Formato válido y normalizado.
Celular principal	Obligatorio propuesto	Código de país y número válido.
Celular secundario	Opcional	Máximo dos números en total.
Dirección	Opcional	Solo para fines administrativos si corresponde.
Canal de notificación	Por confirmar	WhatsApp u otro canal soportado por EGD.

C. Datos profesionales

Campo	Obligatoriedad propuesta	Validación o descripción
Número de colegiatura (CMP en Perú)	Obligatorio según país	Identificación profesional.
País de colegiatura	Obligatorio propuesto	País donde está registrado profesionalmente.
Estado de habilitación	Obligatorio	Habilitado, no habilitado o estado equivalente de EGD.
Especialidad principal	Obligatorio propuesto	Especialidad médica principal.
Especialidades adicionales	Opcional	Una o varias especialidades reconocidas.
Número de registro de especialidad (RNE en Perú)	Condicional	Cuando corresponda.
Título profesional	Opcional	Denominación del título acreditado.
Años de experiencia	Opcional	Para mostrar información profesional al paciente.
Descripción profesional	Opcional	Resumen de experiencia o perfil.
Idiomas de atención	Opcional	Español, inglés u otros

3. El sistema valida obligatoriedad, formatos y posibles duplicados.

4. El administrador verifica la documentación o fuente oficial que se defina, validación profesional, y registra resultado.

5. Se crea o vincula la cuenta MEDICO en Salud 365.

6. Se notifica creación de cuenta enviando las credenciales de acceso.

Validaciones y reglas:

Solo ADMINISTRADOR autorizado crea y habilita MEDICO.

No basta con declarar ser médico; exige validación interna.

Evitar duplicidad por identificadores y colegiatura cuando aplique.

No guardar contraseña en texto plano; entrega de credenciales mediante mecanismo seguro.

Criterios de aceptación:

No existe alta pública de médico.

La operación deja auditoría de actor, fecha y resultado.

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

RF-03-002 · Consulta y actualización de perfil profesional

Objetivo: Consultar datos profesionales y mantenerlos actualizados bajo reglas de aprobación.

Actores: ADMINISTRADOR.

Precondiciones: Cuenta MEDICO activa.

Flujo principal:

1. El Administrador ingresa a la lista de Medicos( ver RF-03-008), se busca y selecciona Medico a editar datos.

2. Se visualiza los campos a EDITAR:

A. Datos personales y de identificación

Campo	Obligatoriedad propuesta	Validación o descripción
Nombres	Obligatorio	Nombres del profesional.
Apellido paterno	Obligatorio	Según documento de identidad.
Apellido materno	Condicional	Según documento y nacionalidad.
Tipo de documento	Obligatorio	DNI, carné de extranjería, pasaporte u otro admitido.
Número de documento	Obligatorio	Validación según tipo de documento.
Fecha de nacimiento	Opcional	Solo si existe necesidad administrativa justificada.
Género	Opcional	Según catálogo aprobado.
País	Obligatorio propuesto	País de registro o ejercicio profesional.
Fotografía de perfil	Opcional	Imagen que se mostrará al paciente.

B. Datos de contacto

Campo	Obligatoriedad propuesta	Validación o descripción
Correo electrónico	Obligatorio propuesto	Formato válido y normalizado.
Celular principal	Obligatorio propuesto	Código de país y número válido.
Celular secundario	Opcional	Máximo dos números en total.
Dirección	Opcional	Solo para fines administrativos si corresponde.
Canal de notificación	Por confirmar	WhatsApp u otro canal soportado por EGD.

C. Datos profesionales

Campo	Obligatoriedad propuesta	Validación o descripción
Número de colegiatura (CMP en Perú)	Obligatorio según país	Identificación profesional.
País de colegiatura	Obligatorio propuesto	País donde está registrado profesionalmente.
Estado de habilitación	Obligatorio	Habilitado, no habilitado o estado equivalente de EGD.
Especialidad principal	Obligatorio propuesto	Especialidad médica principal.
Especialidades adicionales	Opcional	Una o varias especialidades reconocidas.
Número de registro de especialidad (RNE en Perú)	Condicional	Cuando corresponda.
Título profesional	Opcional	Denominación del título acreditado.
Años de experiencia	Opcional	Para mostrar información profesional al paciente.
Descripción profesional	Opcional	Resumen de experiencia o perfil.
Idiomas de atención	Opcional	Español, inglés u otros

3. Incluye la opción administrativa de regenerar la contraseña y notificarla. Esta operación se diferencia de la recuperación solicitada por el propio médico mediante un código enviado al correo electrónico, conforme a RF-01-003.

4. Modifica únicamente los campos habilitados para autogestión.

5. El sistema valida cambios y, si corresponde, solicita aprobación administrativa.

6. Se muestra confirmación.

Validaciones y reglas:

Validar datos y conservar auditoría de cambios.

Criterios de aceptación:

El médico solo modifica información permitida.

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

RF-03-003 · Consulta de agenda y seguimiento de atenciones médicas

Objetivo: Permitir al médico consultar sus citas programadas, atenciones realizadas y atenciones pendientes de cierre, con búsqueda por paciente, número de cita, fecha y estado.

Actores: MEDICO.

Precondiciones: Cuenta habilitada y vínculo profesional confirmado en EGD.

Flujo principal:

1. Inicia sesión y accede a Mi agenda / Mis atenciones.

2. El sistema mostrará una lista de las citas asociadas al médico autenticado, incluyendo las atenciones inmediatas y programadas. Para cada cita se visualizará la siguiente información:

N.º	Campo	Descripción funcional
1	Nombres y apellidos	Nombre completo del paciente asociado a la cita.
2	Tipo de relación con el TITULAR	Indica si el paciente es el titular, hijo(a), cónyuge, padre/madre u otro dependiente.
3	Número de cita	Identificador único de la cita, vinculado a EGD.
4	Fecha de cita	Fecha programada o asignada para la atención.
5	Hora de cita	Hora de inicio de la atención, según zona horaria definida.
6	Modalidad de Atención	Inmediata / Programada
7	Estado de cita	Situación administrativa de la cita, según EGD.
8	Estado del acto médico	Situación del proceso clínico: pendiente, en curso o terminado, según EGD.
9	Ver detalle	Permite consultar la información de la cita y acceder a las acciones autorizadas. Ver RF-03-005
10	Video llamada	Según permisos y estado, puede iniciar la videoconsulta(Ver RF03-006)
11	Gestión de pendientes	Gestión de atenciones pendientes de cierre(ver RF03-009)

3. El médico podrá realizar búsquedas por paciente o número de cita, así como aplicar filtros por fecha, rango de fechas, estado de cita y estado del acto médico. La consulta dispone de las vistas Hoy, Pendientes de cierre, Próximas, Realizadas y Todas, manteniendo independientes los filtros de cita y acto médico.

4. Salud 365 obtiene únicamente las citas y atenciones asignadas o autorizadas para el médico autenticado.

5. Al seleccionar «Ver detalle», el sistema presentará la información correspondiente a la atención seleccionada y las opciones disponibles según su estado(ver RF-03-005 );

6. Según permisos y estado, puede iniciar la videoconsulta(Ver RF-03-006), acceder a para completar un cierre pendiente o consultar el registro finalizado.

Validaciones y reglas:

El médico visualizará únicamente las citas asignadas a su identificador en EGD.

Se mostrarán las citas de atención inmediata y programada.

Los estados de cita y acto médico se consultarán de manera independiente.

La información deberá actualizarse cuando EGD confirme un cambio de estado, caso contrario trabajara con los datos configurados en Salud 365.

Las citas canceladas o reprogramadas deberán identificarse según los estados disponibles.

La relación del paciente con el TITULAR solo se mostrará si el médico está autorizado para conocer ese dato y EGD lo proporciona.

Si no existen citas para los filtros seleccionados, el sistema mostrará un mensaje informativo.

El acceso a la videoconsulta y a la información clínica estará sujeto a los permisos y mecanismos de autenticación definidos con EGD y Salud 365.

Alternativas y excepciones:

Si no existen resultados para los filtros, mostrar un mensaje claro y permitir limpiar filtros.

Criterios de aceptación:

Médico visualiza solo citas asignadas y autorizadas.

Se admite búsqueda por paciente, identificador de cita, fecha y estado; se distinguen citas futuras, atenciones pendientes de cierre y atenciones cerradas.

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

RF-03-004 · Disponibilidad y horarios médicos

Objetivo: Administrar o consultar franjas de disponibilidad para telemedicina inmediata y programada.

Actores: ADMINISTRADOR para la configuración de horarios; MÉDICO para declarar su disponibilidad de recepción inmediata, sin que ello le conceda edición de horarios.

Precondiciones: Médico validado, especialidades y modalidad de atención configuradas.

Flujo principal:

1. Se busca al Medico, y se muestra sus datos

2. Se muestra la vista de configurar horarios, descansos y restricciones, o autoriza autogestión médica si se aprueba.

3. Sistema valida solapamientos y consistencia horaria.

4. Se publican las franjas disponibles para agendamiento. Para la recepción de pacientes de atención inmediata se distinguen Disponible, Ocupado, Pausa y Desconectado. El médico declara Disponible, Pausa o Desconectado; Ocupado lo establece el sistema al asignarle un paciente o iniciar la atención. Pausa y Desconectado impiden nuevas asignaciones inmediatas y no cancelan las citas programadas.

Validaciones y reglas:

Evitar solapamiento de turnos y citas confirmadas.

Definir zona horaria y reglas de bloqueo/reserva.

No permitir eliminar disponibilidad que afecte citas sin política de reprogramación.

Alternativas y excepciones:

Si sincronización falla, no publicar disponibilidad inconsistente.

Si hay citas afectadas, generar alerta para gestión.

Integraciones y datos: Catálogo de médicos.

Criterios de aceptación:

Las franjas visibles corresponden a horarios válidos.

Los cambios quedan auditados.

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

RF-03-005 · Detalle de cita y preparación clínica

Objetivo: Permitir al médico revisar la información necesaria antes de iniciar una atención autorizada.

Actores: MEDICO.

Precondiciones: Cita asignada y autorizaciones clínicas vigentes.

Flujo principal:

1. Selecciona cita de su agenda.

2. Consulta paciente, motivo de consulta y triaje disponibles. El motivo y el triaje se registran después del consentimiento y antes del pago en el flujo de solicitud de cita virtual.

3. Consulta antecedentes e historia clínica (ver referencia modulo 07).

4. Identifica si el paciente está listo para la atención.

5. Según permisos y estado, puede iniciar la videoconsulta(Ver RF-03-006), acceder a para completar un cierre pendiente o consultar el registro finalizado.

6. Permitir al médico responsable recuperar una atención cuya videollamada terminó pero cuyo acto médico sigue abierto, completar datos faltantes y solicitar el cierre clínico definitivo(Ver RF-03-009)

Validaciones y reglas:

Acceso clínico limitado a pacientes/citas autorizados.

No modificar triaje del paciente sin trazabilidad y reglas definidas.

Registrar accesos sensibles.

Alternativas y excepciones:

Si triaje no aplica o está pendiente, indicar estado.

Si historia clínica no está disponible, informar y aplicar protocolo por definir.

Integraciones y datos: Consulta de motivo/triaje, historia clínica y cita; APIs EGD por confirmar.

Criterios de aceptación:

Médico accede solo a información autorizada.

Se diferencia información pendiente de información inexistente.

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

RF-03-006 · Acceso a videoconsulta y acto médico

Objetivo: Habilitar el acceso del médico a la sesión y al registro del acto médico desde Salud 365.

Actores: MEDICO.

Precondiciones: Médico habilitado, cita asignada y condiciones de atención satisfechas.

Flujo principal:

1. Médico selecciona la cita habilitada.

2. Salud 365 valida rol, asignación y estado de cita.

3. Solicita o utiliza la URL de videoconsulta proporcionada por EGD e integra su acceso en Salud 365.

4. Permite iniciar atención y navega al módulo Acto Médico.

5. La información clínica se registra y se gestiona su cierre en módulo clínico.

Validaciones y reglas:

No permitir iniciar acto médico de cita ajena.

Evitar sesiones clínicas duplicadas para una misma atención según regla definida.

No equiparar fin de llamada con cierre del acto médico.

Alternativas y excepciones:

Si falla la conexión o se produce un error en la videoconsulta, se conserva la misma URL proporcionada por EGD, no se genera un enlace nuevo y el enlace deja de expirar para permitir retomar la atención. El acceso continúa sujeto a la asignación y los permisos autorizados.

Si falla escritura clínica, mantener registro pendiente sin declarar cierre exitoso.

Integraciones y datos: Videoconsulta y APIs de apertura/escritura/cierre clínico EGD por confirmar.

Criterios de aceptación:

Acceso exclusivo del médico asignado/autorizado.

El acto médico tiene trazabilidad independiente de la llamada. Ante un fallo se mantiene la URL original de EGD sin generar otra y sin que expire por esa incidencia.

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

RF-03-007 · Inactivación y suspensión de acceso médico

Objetivo: Permitir retirar temporal o permanentemente acceso a funcionalidades médicas sin eliminar el historial clínico.

Actores: ADMINISTRADOR.

Precondiciones: Cuenta médica existente.

Flujo principal:

1. Administrador busca médico y selecciona Suspender/Inactivar.

2. Sistema solicita motivo y valida permisos.

3. Revisa si hay citas futuras y aplica política de reasignación por definir.

4. Deshabilita acceso.

5. Registra auditoría y notifica a responsables definidos.

Validaciones y reglas:

No borrar historia clínica ni atenciones previas.

Impedir nuevas atenciones cuando el médico está suspendido.

Alternativas y excepciones:

Si EGD no confirma el cambio, bloquear acceso local y generar alerta de discrepancia.

Integraciones y datos: Estado de cuenta Salud 365 y actualización en EGD según capacidad disponible.

Criterios de aceptación:

Cuenta suspendida no puede realizar acto médico.

Citas afectadas se identifican para gestión.

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

RF-03-008 · Consulta administrativa y auditoría médica

Objetivo: Consultar estado de médicos y trazabilidad de altas, validaciones, sincronización y cambios.

Actores: ADMINISTRADOR.

Precondiciones: Administrador autorizado.

Flujo principal:

1. Accede a Administración > Médicos.

2. La consulta administrativa presenta los siguientes datos y acciones, distribuidos entre la lista de médicos y el detalle de cada profesional:

Campo	¿Mostrar?	Descripción
Código de médico	Sí	Identificador interno en Salud 365.
Nombres y apellidos	Sí	Nombre completo del profesional.
Tipo y número de documento	Sí	Identificación del médico para uso administrativo autorizado.
Correo electrónico	Sí	Correo asociado a su cuenta.
Celular principal	Sí	Número de contacto con código de país.
Especialidad principal	Sí	Especialidad registrada en EGD.
Número de colegiatura	Sí	CMP u otro registro profesional según país.
Estado del médico	Sí	Activo / Inactivo, según información de EGD.
Estado de cuenta	Sí	Habilitada / Bloqueada / Pendiente, según autenticación de Salud 365.
Estado de sincronización EGD	Sí	Sincronizado / Pendiente / Error.
Fecha de registro	Sí	Fecha de creación en Salud 365.
Última actualización	Opcional	Fecha del último cambio registrado.
Detalle Medico	Sí	Consulta detalle de médico, eventos de auditoría,y lista de atenciones,Ver RF-03-002, RF-03-004 y RF-03-007
Asignar disponibilidad	Sí	Ver RF-03-004
Detalle de Atenciones	Sí	lista de atenciones.
Editar	Sí	Ver RF-03-002
Desactivar	Sí	Ver RF-03-007

3. Filtra por estado de habilitación, especialidad , nombre y apellido, y fecha.

4. Consulta detalle de médico y eventos de auditoría.

Validaciones y reglas:

No exponer datos clínicos innecesarios en monitoreo técnico.

Restringir reintentos a personal autorizado.

No registrar contraseñas ni tokens en logs.

Alternativas y excepciones:

Ante fallos de consulta, indicar fecha de última actualización.

Criterios de aceptación:

Administración identifica cuentas pendientes o con error.

Toda operación sensible queda registrada.

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

RF-03-009 · Gestión de atenciones pendientes de cierre

Objetivo: Permitir al médico responsable recuperar una atención cuya videollamada terminó pero cuyo acto médico sigue abierto, completar datos faltantes y solicitar el cierre clínico definitivo.

Actores: MEDICO; ADMINISTRADOR únicamente para monitoreo, sin acceso ordinario a completar registros clínicos.

Precondiciones: Médico autenticado y autorizado; atención vinculada a una cita y a un paciente; acto médico pendiente de cierre en el sistema clínico.

Flujo principal:

1. Desde, el médico filtra y selecciona una atención pendiente de cierre.

2. Salud 365 recupera desde EGD la información clínica previamente guardada y su estado vigente.

3. El médico revisa los datos y completa anamnesis, diagnósticos, conclusiones, indicaciones o recetas faltantes según corresponda.

4. Selecciona Guardar borrador para conservar avances sin cerrar el acto médico.

5. Cuando termina, selecciona Finalizar acto médico; Salud 365 verifica campos obligatorios y solicita el cierre en EGD.

6. Solo después de confirmación exitosa de EGD, el sistema muestra el acto médico como Cerrado y actualiza su consulta de seguimiento.

Validaciones y reglas:

Diferenciar finalización de videollamada, atención efectuada y cierre clínico; no cambiar automáticamente a Cerrado por guardar conclusiones.

Solo el médico responsable o un profesional autorizado podrá completar la atención; registrar usuario, fecha y cambios.

Impedir cierre si faltan datos obligatorios según reglas clínicas aprobadas; no perder avances previamente guardados.

Una atención cerrada no podrá editarse por el flujo ordinario; correcciones posteriores requieren mecanismo clínico autorizado y auditable.

Alternativas y excepciones:

Si EGD no responde al guardar o cerrar, conservar estado no confirmado, consultar el resultado antes de reintentar y evitar cierres duplicados.

Si la atención ya fue cerrada o reasignada, impedir edición y mostrar estado actualizado.

Integraciones y datos: APIs EGD de consulta por cita, lectura de borrador, escritura parcial, validación y cierre clínico por confirmar; correlación de IDs y auditoría.

Criterios de aceptación:

Una atención pendiente puede recuperarse sin pérdida de datos; Guardar borrador no cierra el acto médico.

Finalizar acto médico solo cambia a Cerrado tras respuesta confirmada de EGD y validaciones completas.

5.1 Alta y habilitación de médico

ADMINISTRADOR registra → valida identidad y habilitación → asigna MEDICO → Salud 365 crea/vincula cuenta → sincroniza con EGD → EGD confirma → cuenta ACTIVA. Si EGD falla, queda PENDIENTE_EGD/ERROR_EGD y el acceso permanece bloqueado.

5.2 Consulta de agenda, seguimiento y cierre pendiente

MEDICO autenticado → Mi agenda / Mis atenciones → filtra por cita, paciente o estado → consulta atención autorizada → inicia atención programada o recupera pendiente de cierre → guarda borrador o solicita cierre clínico → EGD confirma estado Cerrado. La videollamada puede terminar antes del cierre clínico.

Salud 365 aprueba campos, roles, flujo de validación y habilitación médica.

EGD confirma operaciones de registro y consulta de médicos, agenda y citas.

Se validan escenarios exitosos y fallidos de sincronización en línea.

Se define la frontera funcional con Citas, Videoconsulta y Acto Médico.

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

---

Descargar Markdown original