## Introducción iMedik es el módulo de gestión clínica integrado a la plataforma V12. Permite registrar pacientes, llevar un historial de consultas, emitir recetas y, en consultorios con más de un médico, compartir información clínica de forma controlada y con trazabilidad completa. El sistema tiene tres perfiles de usuario con funciones distintas: **médico/especialista**, **asistente** y **administrador**. Cada usuario solo ve y puede hacer lo que su perfil permite. --- ## Acceso al sistema El administrador del consultorio o clínica crea tu cuenta en el sistema y te asigna el perfil correspondiente. Recibirás tus credenciales de acceso por el canal que defina tu organización. El médico puede cambiar su contraseña desde su perfil; el administrador **no** gestiona contraseñas. --- ## Pantalla principal — Dashboard Al iniciar sesión verás el tablero principal con tres secciones: - **⏳ En espera de atención:** pacientes cuyo triaje fue completado por la asistente y están listos para consulta. La tabla muestra nombre del paciente, motivo de consulta y hora del triaje. Una alerta de alergia aparece junto al nombre cuando el paciente tiene alergias registradas. El botón **Atender** abre directamente la consulta; también puedes hacer clic en la fila. - **📂 Consultas abiertas:** consultas que el médico inició directamente (sin triaje de asistente) y que aún no han sido cerradas. - **🕐 Pacientes recientes:** los últimos pacientes registrados en el sistema, con nombre, edad y teléfono. El botón **Expediente** abre su ficha completa. --- ## Módulo de Pacientes ### Buscar un paciente Usa la barra de búsqueda en la pantalla de pacientes para localizar por nombre, apellido, teléfono, CURP o cualquier número de documento registrado. La búsqueda se actualiza automáticamente mientras escribes. ### Registrar un nuevo paciente Haz clic en **+ Nuevo paciente**. El formulario tiene seis secciones: - **Datos personales:** nombre(s), primer apellido, segundo apellido, fecha de nacimiento (la edad se calcula automáticamente) y sexo. - **Documentos de identidad:** tipo de documento (INE, CURP, RFC, pasaporte, acta de nacimiento, cédula profesional, etc.) y número. Puedes registrar más de un documento con el botón **+ Agregar**. - **Domicilio:** calle y número, colonia, ciudad, C.P. y referencias. También permite múltiples domicilios. - **Contacto:** teléfono y correo electrónico. - **Antecedentes clínicos:** alergias conocidas (se muestran como alerta en el expediente) y notas generales sobre condiciones previas relevantes. - **Consentimiento informado:** casilla para indicar que el paciente firmó el consentimiento para manejo de sus datos clínicos, con campo de fecha de firma. Al guardar, el sistema abre automáticamente el expediente del paciente recién registrado. ### Expediente del paciente Al abrir un paciente verás un encabezado con nombre completo, edad, sexo, teléfono, documento principal y un badge de alerta si tiene alergias. La ficha tiene tres pestañas: - **Mis consultas:** historial de consultas en orden cronológico inverso. Las consultas cerradas muestran diagnóstico y código CIE-10. Las consultas en triaje o abiertas muestran su estado con un badge de color. El botón **+ Nueva consulta** inicia una consulta directa sin triaje. - **Historial compartido:** visible solo cuando existen accesos activos de colegas que comparten su expediente hacia este paciente. Muestra el especialista que comparte, el nivel de acceso autorizado y las fechas de vigencia. - **Datos del paciente:** información completa registrada (datos personales, documentos de identidad, domicilio, antecedentes y estado del consentimiento). El botón **Editar datos** lleva al formulario de edición. --- ## Módulo de Consultas ### Flujo general ``` Asistente abre triaje → captura signos vitales y adjuntos → entrega al médico Médico toma la consulta → edita la parte clínica → cierra la consulta ``` El médico también puede abrir una consulta directamente sin pasar por triaje. ### Triaje (asistente) Al entrar a **Triaje** desde el menú lateral, el formulario tiene tres pasos encadenados que deben completarse en orden: 1. **Seleccionar médico:** la asistente ve solo los especialistas a los que está vinculada. Al hacer clic en uno, el paso queda marcado y se habilita el siguiente. 2. **Buscar o registrar paciente:** el buscador permite localizar por nombre, apellido o número de documento. Si el paciente no existe, el enlace **+ Registrar nuevo paciente** abre el formulario de alta en una nueva pantalla. Al seleccionar al paciente, se habilita el paso 3. 3. **Signos vitales y motivo:** motivo de consulta (obligatorio), peso, talla, temperatura, presión arterial sistólica y diastólica, frecuencia cardíaca y SpO₂. También puedes adjuntar archivos (laboratorios, estudios de imagen) arrastrándolos o seleccionándolos desde el dispositivo. Al hacer clic en **📤 Entregar al médico**, la consulta aparecerá en el tablero del médico en la sección "En espera de atención". > **Importante para asistentes:** una vez entregada la consulta al médico, ya no podrás editarla ni agregar adjuntos. Esta restricción la valida el servidor. ### Consulta clínica (solo médico) Desde el tablero (botón **Atender**) o desde el expediente del paciente, se abre la pantalla de consulta. Tiene dos columnas: - **Izquierda (columna principal):** datos de la consulta, motivo, signos vitales, archivos adjuntos y el formulario clínico completo: exploración física / síntomas, diagnóstico (con buscador CIE-10 por código o descripción), plan de tratamiento y notas internas. Al final de la columna están los botones **💾 Guardar borrador**, **✓ Cerrar consulta** y **🗑 Eliminar**. - **Derecha (columna lateral fija):** sección de **Receta** con la lista de prescripciones de esa consulta, el botón **+ Agregar medicamento** y el botón **🖨 Imprimir** para la receta imprimible. > **Notas internas:** este campo nunca se comparte con ningún otro médico, ni siquiera en modalidad de acceso completo. El servidor aplica esta restricción de forma independiente al navegador. Al hacer clic en **✓ Cerrar consulta**, el sistema verifica que el diagnóstico no esté vacío. Una consulta cerrada es inmutable. --- ## Prescripciones y Receta Dentro de la consulta abierta, en la sección **Prescripciones**, haz clic en **+ Agregar** para añadir un medicamento. Los campos son: nombre del medicamento, dosis, vía de administración, frecuencia, duración e indicaciones. Puedes agregar, editar o eliminar prescripciones mientras la consulta esté abierta. Para imprimir o descargar la receta, haz clic en el botón **Imprimir receta** (ícono de impresora). Se abre una vista imprimible con el encabezado que configuraste en tu perfil, los datos del paciente, los signos vitales clave y todas las prescripciones de esa consulta. También puede imprimirla la asistente. --- ## Archivos adjuntos Dentro de la consulta puedes adjuntar archivos (PDF, imágenes). Los tipos habituales son resultados de laboratorio, estudios de imagen y documentos previos. - El botón **Analizar con IA** (fase 3) permite que el sistema extraiga automáticamente valores relevantes del documento y los sugiera para incorporar al expediente. El médico revisa la sugerencia y decide si aplicarla. --- ## Perfil del especialista Accede desde el menú lateral con el ícono **⚙ Mi perfil**. Encontrarás cuatro pestañas: ### Datos profesionales Título (Dr., Dra., Lic., etc.), nombre completo, especialidad, subespecialidad, cédula profesional, cédula de especialidad, años de experiencia, institución formadora, idiomas en que atiendes y semblanza profesional. ### Receta Configura el encabezado imprimible de tu receta: título principal (generalmente tu nombre con título), dos subtítulos opcionales (especialidad, cédulas, institución) y hasta tres líneas de pie de página (dirección, teléfono, horarios). También puedes subir el **logo** del consultorio y ajustar su posición (izquierda, centro, derecha). La columna derecha muestra una **vista previa en tiempo real** de la receta con los datos actuales. ### Contacto Nombre del consultorio, dirección, teléfono, correo profesional, sitio web y redes sociales (Facebook, Instagram, LinkedIn, X). ### Directorio (fase 2) Vinculación con el directorio médico público de iMedik. Permite publicar tu perfil profesional en línea y controlar si se actualiza automáticamente al guardar cambios en el perfil. --- ## Acceso compartido entre especialistas Cuando un paciente tuyo necesita ser visto por otro especialista de la clínica, puedes compartir su información clínica de forma controlada. Hay tres niveles: | Nivel | Qué incluye | |---|---| | **Generales** | Nombre, edad, sexo, teléfono, correo | | **Resumen clínico** | Generales + antecedentes + diagnósticos previos | | **Completo** | Todo lo anterior + historial completo de consultas y adjuntos | El paciente debe otorgar su consentimiento, que queda registrado en el sistema. En situaciones de urgencia, el sistema permite acceso temporal a datos generales sin consentimiento previo, pero deja registro automático del acceso en el log de auditoría. ### Para compartir información de tu paciente 1. Abre el expediente del paciente. 2. Ve a la pestaña **Datos del paciente**. 3. En la sección **Consentimiento informado** verás el estado actual. El registro y gestión de consentimientos se hace desde el formulario de edición del paciente (botón **Editar datos**). 4. Una vez registrado el consentimiento, el colega podrá acceder desde su sesión. En el expediente del paciente aparecerá la pestaña **Historial compartido** con la información según el nivel autorizado. Para revocar el acceso, edita los datos del paciente y usa la opción de revocar el consentimiento correspondiente. > La asistente puede registrar consentimientos únicamente de nivel **Generales**. Los niveles Resumen clínico y Completo requieren que los registre el propio médico. --- ## Administración de la clínica (perfil Administrador) El administrador gestiona la configuración operativa del consultorio o clínica desde la pantalla **Clínica** del menú lateral. No tiene acceso a expedientes clínicos. La pantalla tiene tres pestañas: ### Especialistas Lista de todos los médicos con nombre, especialidad, cédula profesional y estado (activo / suspendido / baja). Puedes: - **Registrar** un nuevo especialista: completa sus datos profesionales en el formulario `especialista-form.html` y vincula un usuario existente del sistema. - **Editar** los datos de un especialista existente con el ícono ✏. - **Dar de baja** con registro del motivo (ícono ✕ rojo). Un especialista dado de baja ya no puede iniciar sesión; sus pacientes y expedientes quedan preservados y los colegas de la clínica acceden automáticamente a datos generales y resumen para garantizar la continuidad de la atención. - **Reactivar** un especialista dado de baja (ícono ↩ verde). ### Asistentes Lista de asistentes con sus especialistas vinculados. Puedes: - Ver los médicos asignados a cada asistente en la columna **Especialistas vinculados**. - **Editar vínculos** (ícono ✏): abre la pantalla de vinculación donde puedes asignar o quitar especialistas. Guardar reemplaza el conjunto completo de vínculos. - **Quitar todos los vínculos** de un asistente con el ícono ✕. El usuario permanece en el sistema y puede reasignarse. ### Auditoría Tabla de accesos a expedientes clínicos con filtros de fecha (desde / hasta), tipo de acceso y especialista. Columnas: **Fecha / Hora**, **Médico**, **Paciente**, **Tipo** (propio, compartido, urgencia, internamiento), **Nivel** (generales, resumen, completo) y **Vista** (pantalla desde la que se realizó el acceso). Los registros son de solo lectura. --- ## Preguntas frecuentes **¿Puedo editar una consulta cerrada?** No. Las consultas cerradas son inmutables. Si necesitas agregar información, abre una nueva consulta para ese paciente. **¿El administrador puede ver los expedientes?** No. El administrador tiene acceso operativo (médicos, asistentes, auditoría) pero no puede ver datos clínicos de pacientes. **¿Mis notas internas de consulta las puede ver otro médico si comparto el expediente?** Nunca. Las notas internas están excluidas de todos los niveles de acceso compartido, incluyendo el acceso completo. **¿Puedo tener más de un asistente?** Sí. Puedes vincular tantos asistentes como necesites a tu perfil. **¿Puedo ser médico y administrador al mismo tiempo?** Sí, el administrador puede asignarte ambos grupos. Tendrás acceso a todas las funciones de ambos perfiles.