El módulo Salud Ocupacional (y con el, el expediente médico, el Copiloto cardiovascular y el Copiloto de gran altura) se activa cuando tu tenant tiene habilitado el módulo Salud Ocupacional y tu usuario posee el permiso GESTIONAR PROGRAMAS DE SALUD OCUPACIONAL. Si no ves la sección Salud en el menú lateral, consulta con tu administrador sobre su habilitación. No es un módulo de auto-servicio del trabajador: está pensado para profesionales de la salud ocupacional.
El módulo Salud: Riesgo Cardiovascular y Copiloto Clínico es la parte del expediente médico ocupacional de IAegis que interpreta los parámetros clínicos de un trabajador y sugiere (nunca decide) el riesgo, las metas y la vigilancia que corresponden, citando la norma chilena que aplica en cada caso.
En concreto, el módulo entrega tres copilotos clínicos sobre el mismo expediente:
Antes, esta interpretación se hacía a mano, cruzando tablas del PSCV impresas con los resultados del laboratorio, y el control de vigencias vivía en planillas paralelas. El módulo reemplaza ese trabajo manual por un cálculo en vivo que ocurre a medida que el enfermero teclea los parámetros del examen, sin sacar el dato sensible del navegador.
Figura 16.1 — Hub de Salud Ocupacional (/health): punto de entrada a los expedientes, la analítica, la vigilancia y el asistente IA.
Este capítulo se concentra en el expediente del trabajador (/health/profile/:id) y sus copilotos clínicos. El hub general de Salud, la analítica, la carga inteligente de exámenes y la gestión de programas MINSAL se cubren en sus propios capítulos; aquí solo se referencian cuando conectan con los copilotos.
Todo el módulo se rige por un único patrón, repetido en cada tarjeta y cada botón:
La herramienta SUGIERE, el profesional CONFIRMA. El sistema calcula el riesgo, cita la norma y prellena el examen, pero la decisión de aptitud (el campo Resultado del examen) siempre la toma la persona profesional de salud. Ningún copiloto fija por sí solo la aptitud del trabajador.
Este principio tiene consecuencias prácticas que conviene tener claras desde el inicio:
| Concepto | Descripción |
|---|---|
| Expediente médico ocupacional | El perfil de salud de un trabajador (identidad, KPIs, alertas, exámenes y programas de vigilancia). Es el contenedor de todo el capítulo. |
| Examen médico ocupacional | Cada evaluación cargada al expediente: tipo, fecha, resultado, triage, parámetros clínicos, alertas y recomendaciones. Es la fuente de datos de los copilotos. |
| Copiloto cardiovascular | Tarjeta que corre el motor de Framingham (Chile) sobre el último examen y sugiere riesgo, metas de C-LDL e ingreso a PSCV, citando la norma. |
| Copiloto de gran altura | Tarjeta que revisa la vigencia del examen de altura y ofrece la calculadora Lake Louise Score para el Mal Agudo de Montaña. |
| Framingham (Chile) | Tablas de riesgo coronario a 10 años adaptadas a la población chilena, reproducidas en el Anexo 9 de la OT del PSCV. Motor determinístico, sin IA. |
| PSCV | Programa de Salud Cardiovascular del MINSAL. Aporta el algoritmo de riesgo y los criterios de "PASO 0" (riesgo ALTO directo, sin tabla). |
| Triage de prioridad | Semáforo clínico del examen: VERDE (sin urgencia), AMARILLO (seguimiento), ROJO (derivación inmediata). El copiloto lo puede prellenar. |
| Lake Louise Score (LLS) | Instrumento de 5 ítems para evaluar el Mal Agudo de Montaña (MAM). Es una calculadora en terreno; no persiste. |
| De-identificado | Dato clínico despojado de identidad directa (sin nombre ni RUT). Es la forma en que cualquier dato viaja a la IA. |
El módulo se apoya en un marco normativo que el propio código cita literalmente en las tarjetas y prompts. Conocerlo ayuda a interpretar bien las sugerencias:
| Norma | Rol en el módulo |
|---|---|
| Ley 16.744 | Accidentes del trabajo y enfermedades profesionales. Marco general del expediente ocupacional. |
| DS 109 | Calificación de enfermedades profesionales; base de los exámenes ocupacionales generales. |
| DS 594 | Condiciones sanitarias y ambientales básicas; contexto de la vigilancia. |
| DS 67 | Siniestralidad. Base del reporte de enfermedad profesional con días perdidos. |
| DS 44 / 2024 | Nuevo marco de gestión preventiva; citado en el copiloto de vigilancia (protocolos). |
| PSCV MINSAL | Programa de Salud Cardiovascular: algoritmo de riesgo y criterio de PASO 0 (ALTO directo). |
| OT Dislipidemias MINSAL 2018 | Metas terapéuticas de C-LDL / C-no HDL, fórmula de Friedewald y fenotipos lipídicos. |
| Guía Técnica Hipobaria (PREVAFOS) | Vigilancia de trabajo a gran altitud (sobre 3.000 m); marco del copiloto de altura. |
| Ley 21.719 | Protección de datos personales. Minimización del dato sensible de salud enviado a la IA. |
| Ley 20.584 | Derechos y deberes del paciente. Citada junto a la Ley 21.719 en el consentimiento IA. |
| Ley 19.799 | Firma electrónica; aplica al certificado que se genera en el Reposit al guardar un examen. |
El acceso al módulo se controla en dos niveles: el módulo debe estar habilitado para el tenant, y el usuario debe tener el permiso de salud. Quien cumple ambas cosas ve y opera todo el expediente.
| Aspecto | Detalle |
|---|---|
| Permiso | GESTIONAR PROGRAMAS DE SALUD OCUPACIONAL |
| Qué habilita | "Gestionar programas de salud ocupacional, exámenes médicos y perfiles de salud." |
| Módulo | Salud Ocupacional (requiere el permiso anterior). |
| Ruta del hub | /health |
| Ruta del expediente | /health/profile/:id (aquí viven los copilotos CV y de altura). |
| Rutas relacionadas | /health/analytics, /health/program/:id, /health/alcohol-drugs, /health/batch-review. |
Dentro de este módulo no hay diferenciación de interfaz por sub-rol: quien tiene el permiso puede crear, editar y eliminar exámenes y perfiles, correr los copilotos, chatear con la IA y reportar enfermedades profesionales. El gating es a nivel de módulo y de menú, no por cada botón.
/health./health/profile/:id, donde están los copilotos./health/profile/:id. Todas las rutas cuelgan del layout protegido (usuario autenticado).La interpretación clínica cardiovascular y de gran altura corre 100% local en IAegis: esos datos no salen del sistema. El único envío externo es a Google Gemini y solo desde los cuatro puntos de IA del módulo, siempre de-identificado (sexo, edad, cargo y parámetros, nunca nombre ni RUT). La identidad la conoce IAegis localmente. Es una minimización del dato sensible de salud conforme a la Ley 21.719 y la Ley 20.584.
Además, los PDF de exámenes que se guardan en el Reposit se almacenan en un path restringido de salud: solo el módulo Salud puede abrirlos, a través de una URL firmada temporal que válida el permiso de salud en el servidor. El nombre de archivo se guarda sin RUT y sin dato clínico visible. Volveremos sobre esto en la Sección 16.6.5.
El Detalle del expediente (/health/profile/:id) es el centro del capítulo. Reúne la identidad del trabajador, cuatro KPIs, las alertas activas, los dos copilotos clínicos, las tendencias, el historial de exámenes y el análisis IA del expediente.
Figura 16.2 — Expediente médico ocupacional: identidad del trabajador y fila de cuatro KPIs.
La franja superior del expediente muestra la identidad del trabajador:
/health.Bajo el encabezado aparece una fila de cuatro tarjetas que resumen el estado del expediente:
| KPI | Qué muestra | Estados |
|---|---|---|
| Exámenes | Conteo total de exámenes del expediente. | Siempre visible. |
| Último examen | Tipo y fecha del examen más reciente (formato chileno). | Si no hay examen: tarjeta ámbar "Sin examen registrado". |
| Vigencia | Días restantes = 365 menos los días transcurridos desde el último examen. | verde si ≥ 30 días · ámbar si < 30 días · naranja "vencido" si es negativo · "—" si no hay examen. |
| Alertas activas | Cantidad de alertas de salud activas del perfil. | rojo si hay al menos una. |
El KPI de Vigencia usa una referencia general de 365 días. La vigencia real de cada examen depende de su tipo (ver Sección 16.6.4): un pre-ocupacional dura más y un examen de altura, menos. El KPI es una señal rápida, no la regla de cada protocolo.
Justo debajo de los KPIs, si el perfil tiene alertas, aparece la sección "Alertas de salud activas": una fila de chips rojos, cada uno con el formato "⚠ {alerta}". Si no hay alertas, la sección no se muestra. Estas alertas alimentan también a los copilotos (por ejemplo, un antecedente de diabetes o hipertensión puede detonar el PASO 0 del riesgo cardiovascular).
| Botón / acción | Que hace | Precondición | Resultado / estados |
|---|---|---|---|
| Examen (header) | Abre el modal de nuevo examen. | Permiso de salud. | Siempre habilitado. |
| Eliminar perfil | Pide confirmación y borra todos los exámenes y luego el perfil. | — | Navega a /health; muestra "Eliminando..." mientras procesa; en error "Error eliminando perfil: ...". |
| Analizar riesgos / Re-analizar | Corre el análisis IA de-identificado del expediente. | Al menos un examen. | Deshabilitado si carga o si no hay exámenes; muestra "Analizando...". |
| Usar como base para aptitud | Prellena un examen con la sugerencia del Copiloto cardiovascular (ver 16.4.5). | Que haya un cálculo CV. | Abre el modal con recomendaciones y triage prellenados. |
| Ver programa (chip) | Navega al programa de vigilancia inscrito. | Trabajador inscrito. | Va a /health/program/:id. |
| Expandir examen | Despliega parámetros, alertas, recomendaciones y acciones del examen. | — | Acordeón. |
| Reposit (en examen) | Abre el certificado del examen en el Reposit. | Examen con certificado. | Va a /reposit?cert=.... |
| PDF (en examen) | Descarga el PDF original vía URL firmada temporal. | Examen con archivo asociado. | Deshabilitado sin archivo o mientras descarga ("..."); en error "No se pudo abrir el examen. Verifica que tengas permiso de salud para esta empresa.". |
| Reportar a Siniestralidad | Abre el modal de enfermedad profesional (DS 67). | Examen con EP detectada. | Aparece solo si el sistema sugiere EP. |
Eliminar perfil es una acción destructiva: borra el perfil y todos sus exámenes registrados. El trabajador en la nómina y los certificados ya subidos al Reposit NO se eliminan. Si el problema son perfiles duplicados del mismo trabajador, usa mejor "Fusionar duplicados" desde el hub de Salud, que no destruye datos.
La sección "Análisis IA de riesgos · copiloto" es un copiloto de IA que lee el conjunto de exámenes del trabajador (de-identificado) y devuelve insights priorizados: riesgos cardiovasculares, metabólicos, derivaciones sugeridas y vigilancia adicional según el cargo. Se dispara con el botón Analizar riesgos (o Re-analizar si ya se corrió).
Los estados de la sección son:
Cada insight se presenta como una tarjeta con su prioridad: CRÍTICO, ATENCIÓN o PREVENTIVO, con un título, una descripción y una acción sugerida (con el formato "→ {acción}").
La primera vez que pulses "Analizar riesgos" en una empresa, IAegis muestra el modal de consentimiento de privacidad. Solo tras pulsar Continuar se envía el cuadro clínico de-identificado a Gemini. La decisión se recuerda por empresa y no se vuelve a preguntar.
Su título es "Privacidad del análisis IA · Datos mínimos y de-identificados" y su contenido, literal, es:
Sus acciones son "Cancelar" (cierra sin analizar) y "Continuar" (persiste el consentimiento y corre el análisis).
El Copiloto cardiovascular es la tarjeta estrella del capítulo. Toma el último examen y el perfil, los mapea de forma tolerante y corre el motor puro de Framingham (Chile) en el navegador. Sugiere categoría de riesgo, porcentaje a 10 años, metas de C-LDL, banderas de dislipidemia e ingreso a PSCV, y cita la norma. No decide la aptitud, y si faltan datos, dice exactamente qué falta.
Figura 16.3 — Copiloto cardiovascular: riesgo de Framingham, porcentaje a 10 años y metas de C-LDL.
El encabezado de la tarjeta dice "Copiloto cardiovascular" con el badge Sugerencia IA · verificar. Debajo, la tarjeta se organiza en cuatro bloques que veremos uno por uno:
Esta misma tarjeta se embebe en vivo dentro del formulario de examen: a medida que el enfermero teclea colesterol, HDL, triglicéridos y presión, el cálculo se recalcula al instante. Es la forma más comoda de ver el riesgo sin salir de la carga del examen.
El bloque "Riesgo cardiovascular · Framingham (Chile)" muestra:
Debajo del número pueden aparecer notas condicionales que explican como se llego al resultado:
| Nota | Cuándo aparece |
|---|---|
| Override rojo: "Riesgo ALTO directo (PASO 0 · PSCV): {motivo}." | Cuando un criterio de PASO 0 fuerza el riesgo ALTO sin usar la tabla (diabetes, ECV, ERC, etc.). |
| Bump ámbar: "Sube +1 categoría: {motivo}." | Cuando un modificador (antecedente familiar de ECV prematura o síndrome metabólico) sube una categoría. |
| Borde ámbar: "Valor de borde ({%}%): confirmar con la herramienta oficial PIFRECV (Universidad de Talca)." | Cuando el porcentaje cae en 4–5% o 9–10%. Incluye enlace a https://pifrecv.utalca.cl. |
| Supuestos del mapeo | Ej.: "Sin C-HDL: no se aplica la corrección del riesgo por HDL."; "Tabaquismo no informado: se asumió NO fumador."; "Sin presión diastólica: se usó sólo la sistólica." |
Si no se puede calcular, en lugar del número aparece un bloque ámbar con el título "No se puede estimar el riesgo de Framingham", la línea "Falta: {faltantes}" y la aclaración "No se inventan valores: agrega estos parámetros al examen (o edad/sexo al perfil) y la sugerencia se recalcula."
Los faltantes duros para el riesgo de Framingham son cuatro: sexo, edad, colesterol total y presión sistólica. Con esos cuatro el copiloto ya entrega una categoría; el resto (HDL, tabaquismo, presión diastólica) solo afina el cálculo.
El bloque "Dislipidemia · metas de C-LDL" traduce el perfil lipídico en metas concretas según la OT Dislipidemias 2018:
<X.<X).| Clave | Etiqueta en la interfaz |
|---|---|
normal | Perfil lipídico normal |
hipercolesterolemia | Hipercolesterolemia |
hipertrigliceridemia | Hipertrigliceridemia |
hiperlipidemia_mixta | Hiperlipidemia mixta |
c_hdl_bajo_aislado | C-HDL bajo aislado |
Si aún no hay categoría de riesgo cardiovascular, el bloque avisa: "Sin categoría de RCV no se fijan metas de C-LDL / C-no HDL. Completa los datos de Framingham (falta: ...)." Y si no se puede evaluar la dislipidemia, aparece el bloque ámbar "No se puede evaluar la dislipidemia" con los faltantes (para dislipidemia son: colesterol total, C-HDL, triglicéridos y sexo).
La fórmula de Friedewald (C-LDL = CT − (HDL + TG/5)) solo es válida con triglicéridos ≤ 400 mg/dL. Si los triglicéridos superan ese valor, el copiloto marca "Friedewald no válido" y debes usar un C-LDL medido directo o guiarte por el C-no HDL.
El riesgo de Framingham depende del sexo. Cuando el documento no traía el sexo explícito y la IA lo dedujo del nombre de pila, el copiloto lo avisa con honestidad en un bloque ámbar "Sexo sugerido del nombre · verificar" (aparece solo en ese caso):
No ignores esta caja ámbar: es un anti-alucinación demográfica. Un sexo mal deducido cambia la tabla de Framingham y, con ella, la categoría de riesgo. Confirmar o corregir toma un clic y deja el dato "manual" para siempre.
La acción principal de la tarjeta es el botón "Usar como base para aptitud". Al pulsarlo, el copiloto:
Junto al botón, la nota lo deja claro: "La aptitud la decide el profesional. Esto solo prellena el examen." El botón se deshabilita si no hay ningún cálculo disponible.
Al pie de la tarjeta, el botón "Norma aplicada (N)" expande o colapsa la lista de citas (regla + fuente) que respaldan cada cálculo, deduplicadas. Es la trazabilidad del copiloto: puedes mostrarle a un fiscalizador exactamente que regla del PSCV o de la OT Dislipidemias se aplicó.
Cada sugerencia del copiloto viene con su cita normativa. Esto no es decoracion: es lo que permite auditar la interpretación clínica. Cuando "Uses como base para aptitud", el profesional queda respaldado por la norma citada, pero la firma de la aptitud sigue siendo suya.
El motor de riesgo es una función pura, determinística y sin IA: todo sale de tablas oficiales chilenas transcritas en el sistema. Conocer sus pasos ayuda a entender por qué a veces el resultado sale "ALTO directo" o "de borde".
[Último examen + perfil]
|
v
PASO 0: ¿hay criterio de ALTO directo? --- SI ---> RCV ALTO (sin tabla)
| (riskPercent = null)
NO
|
v
Lookup en Tabla de Framingham (Chile)
sexo x diabetes x fumador x edad x PA x colesterol
|
v
Corrección por C-HDL (<35 x1,5 ; ≥60 x0,5 ; si no x1)
|
v
% --> categoría (<5 bajo ; 5-9 moderado ; ≥10 alto)
|
v
Modificadores (+1 categoría): ECV prematura familiar / síndrome metabólico
|
v
Valor de borde (4-5% o 9-10%) --> "confirmar con PIFRECV"
Ocho celdas de la tabla (las dos filas inferiores de los cuatro paneles 35-44 de mujeres) están marcadas para verificación contra el PDF oficial, con un valor conservador. Todas caen en categoría "bajo" y no alteran la categorización final. Es una nota de calidad conocida, no un error de cálculo.
Antes de correr el motor, IAegis mapea los datos del examen y el perfil sin inventar:
El Copiloto de gran altura geográfica asiste la aptitud para faena minera de hipobaria intermitente crónica. Revisa la vigencia del examen de altura, ofrece la calculadora del Lake Louise Score y recuerda la vigilancia PREVAFOS. Todo el cálculo es local. Su encabezado dice "Copiloto gran altura geográfica / Faena minera · hipobaria intermitente crónica" con el badge Asiste y cita · no decide aptitud.
Figura 16.4 — Copiloto de gran altura: vigencia del examen de altura, Lake Louise Score y vigilancia PREVAFOS.
La primera sección localiza (de forma tolerante) el examen de altura más reciente: aquel cuyo tipo o batería contenga "altura", "altitud", "gran altura/altitud", "hipobaria/hipobárica", "prevafos" o el código "ELA" (token exacto), con un respaldo por alertas o parámetros.
Sobre ese examen calcula dos badges y algunas métricas:
| Elemento | Valores |
|---|---|
| Badge de vigencia | 🟢 VIGENTE · 🟡 POR VENCER · 🔴 VENCIDO · ⚪ SIN EXAMEN. Validez referencial por defecto: 12 meses; "por vencer" = 30 días o menos. |
| Badge de resultado | Apto / Apto con observaciones / No apto / Sin contraindicaciones / Contraindicaciones temporales. |
| Métricas | "Fecha de examen", "Vence", "Días para vencer" (o "vencido hace N d"). |
Según el estado, aparecen mensajes distintos:
Para transparencia, la tarjeta indica "Detectado por {motivo}" y "Vigencia referencial: 12 meses (ajustar según protocolo/contrato y edad — PREVAFOS)." Si no hay examen de altura, muestra el estado vacío: "Sin examen de altura registrado" con la explicacion "No se encontró un examen cuya batería/tipo contenga 'altura', 'ELA' o 'hipobaria'. No se inventa el estado: carga el examen de aptitud de altura y la vigencia se calcula sola."
Examen de altura vencido = no ingreso a faena. El trabajador no debe ascender a la faena de altura sin un examen de aptitud vigente. Gestiona la renovación antes de autorizar el ascenso. La vigencia por defecto (12 meses) es referencial: ajústala al protocolo, al contrato y a la edad del trabajador según PREVAFOS.
La segunda sección es una calculadora interactiva del Lake Louise Score (LLS), el instrumento estandar para evaluar el Mal Agudo de Montaña. Su subtítulo lo enmarca: "Puntuación para Mal Agudo de Montaña (MAM). El enfermero marca cada síntoma (0–3); la herramienta suma y cita la severidad. No es un diagnóstico ni una decisión de aptitud."
Figura 16.5 — Lake Louise Score: los cinco ítems sin marcar, con el total en 0/15.
Son cinco ítems, cada uno con cuatro opciones (0 a 3), transcritos literalmente del instrumento:
| Ítem | 0 | 1 | 2 | 3 |
|---|---|---|---|---|
| Dolor de cabeza | Ausente | Leve | Moderada | Severa, incapacitante |
| Gastrointestinales | Ausente | Poco apetito o náusea | Náuseas y/o vómitos moderados | Náuseas y/o vómitos severos o incapacitantes |
| Fatiga y/o debilidad | Ausente | Leve | Moderada | Severa, incapacitante |
| Vértigo y/o mareo | Ausente | Leve | Moderada | Severa, incapacitante |
| Alteraciones del sueño | Duerme como habitualmente | No duerme como habitualmente | Despertó muchas veces, escaso dormir nocturno | No pudo dormir en absoluto |
La herramienta suma los cinco ítems (total sobre 15 puntos) y muestra una barra de severidad con tres bandas:
| Puntaje | Banda |
|---|---|
| 0 a 2 | Sin MAM (bajo el umbral diagnóstico). |
| 3 a 5 | Banda "3 a 5 = MAM Moderado". |
| 6 o más | Banda "6 o más = MAM grave". |
El umbral diagnóstico de MAM es ≥ 3. El botón "Reiniciar" aparece al empezar a marcar; el estado vacío dice "Marca los síntomas para calcular el puntaje." Al pie, la fuente: "Fuente: Lake Louis Score (LLS) — Puntuación para Mal Agudo de Montaña (MAM)."
El Lake Louise Score no persiste: es una calculadora en terreno, pensada para usarse en el momento. No hay botón de guardado en esta tarjeta. Si necesitas dejar constancia del puntaje, anótalo en las Notas de triage o las Recomendaciones del examen. Y recuerda: el LLS es una evaluación, no un diagnóstico ni una decisión de aptitud.
La tercera sección recuerda la obligación de vigilancia: "Trabajo a gran altitud (> 3.000 m) exige vigilancia de hipobaria intermitente crónica. Coordinar la incorporación del trabajador al programa con el organismo administrador (Mutual) según la Guía Técnica MINSAL." Incluye el enlace "Guía Técnica de Hipobaria Intermitente Crónica (PREVAFOS · MINSAL)".
El pie del panel cierra con el patrón rector: "La aptitud para faena de altura la decide el profesional de salud. Esta tarjeta asiste y cita la norma."
El modal Nuevo/Editar examen es donde se cargan los datos que alimentan a los copilotos. Se abre desde el botón "Examen", desde "Cargar primer examen" o desde "Usar como base para aptitud". Su título dice "{Nuevo/Editar} examen médico ocupacional" con el nombre y la referencia "{RUT} · {cargo} · Ley 16.744 · DS 109 · DS 594".
Figura 16.6 — Nuevo examen médico ocupacional: tipo, fecha, resultado y triage.
| Campo | Tipo | Requerido | Valores / validación | Default |
|---|---|---|---|---|
| Tipo de examen | Select | Obligatorio | Pre-ocupacional · Periódico · Egreso (post-ocupacional) · Reintegro · Vigilancia médica · PREXOR (ruido) · PLANESI (sílice) · TMERT · PREVAFOS (hipobaria) · RUV · PLOMO · CITOSTÁTICOS · Test alcohol/drogas · Otro. Muestra "Vigencia auto: {X días / no expira}". | Pre-ocupacional |
| Fecha de evaluación | Fecha | Obligatorio | Formato de fecha nativo. | Hoy (o la fecha del examen editado). |
| Resultado | Select | Obligatorio | APTO · APTO CON OBSERVACIONES · NO APTO · SIN CONTRAINDICACIONES · CONTRAINDICACIONES TEMPORALES. Es la decisión de aptitud (la toma el profesional). | APTO |
| Triage de prioridad | Select | Opcional | — Sin triage — · 🟢 VERDE · sin urgencia · 🟡 AMARILLO · seguimiento · 🔴 ROJO · derivación inmediata. | Vacío (el copiloto CV lo puede prellenar). |
| Emisor | Texto | Opcional | Texto libre. Placeholder "Ej: Mutual de Seguridad CChC". | Vacío |
| Parámetros clínicos | Grupo repetible | Opcional | Por fila: Nombre · Valor · Unidad · Estado (Normal/Alterado). Botón "+ Agregar"; "×" para quitar. Alimenta el copiloto CV en vivo. | Lista vacía |
| Alertas de salud | Chips (texto + Enter) | Opcional | Texto libre; no agrega vacío. Placeholder "Ej: Hipertensión arterial · seguimiento mensual". | Las del examen editado, o vacío. |
| Notas de triage | Área de texto (2 filas) | Opcional | Texto libre. | Vacío |
| Recomendaciones | Área de texto (3 filas) | Opcional | Texto libre. Placeholder "Recomendaciones del médico ocupacional...". El copiloto CV le anexa su sugerencia. | Las del examen editado (+ prefill anexado). |
| Guardar también en Reposit | Checkbox | Opcional | On/Off. Solo aparece si el perfil tiene usuario asociado; genera el PDF y lo sube al Reposit. | Marcado (on) |
Dentro del modal se embebe la tarjeta del Copiloto cardiovascular alimentada por lo que estás tecleando: a cada parámetro que agregas, el riesgo se recalcula. Su botón "Usar como base para aptitud" anexa la sugerencia a Recomendaciones y fija el triage (si no había uno).
Figura 16.7 — Carga de parámetros clínicos con el Copiloto cardiovascular recalculando en vivo dentro del modal.
| Botón / acción | Que hace | Resultado / estados |
|---|---|---|
| Sugerir con IA (header) | Gemini sugiere tipo, parámetros, alertas y recomendaciones según el puesto y los peligros del MIPER. | Rellena los campos; "Analizando..." mientras carga; en error "IA no disponible. Intenta nuevamente o contacta al administrador." |
| + Agregar (parámetros) | Añade una fila vacía de parámetro. | Nueva fila. |
| × (parámetro) | Quita la fila. | — |
| Agregar / Enter (alerta) | Añade un chip de alerta. | Chip rojo; no agrega texto vacío. |
| Crear examen / Actualizar examen | Guarda el examen; si Reposit está activo, genera el PDF y lo sube; auto-vincula al programa. | Cierra el modal y recarga el expediente; "Guardando..." mientras procesa; error en caja roja. |
| Cancelar / × | Cierra sin guardar. | — |
El estado vacío de parámetros dice: "Sin parámetros. Click 'Sugerir con IA' para autocompletar según el tipo de examen." Al editar un examen existente, IAegis reusa el mismo identificador, de modo que no se crean duplicados.
El botón "Sugerir con IA" del encabezado le pide a Gemini que proponga tipo de examen, parámetros, alertas y recomendaciones adecuados al puesto del trabajador y a los peligros identificados en su MIPER. La IA responde con una estructura acotada que rellena los campos del formulario, listos para que el profesional los ajuste.
Figura 16.8 — "Sugerir con IA": los campos del examen autocompletados según el puesto y los peligros del MIPER.
"Sugerir con IA" tampoco envía nombre ni RUT a Gemini: trabaja sobre el puesto y los peligros. Y aunque la IA proponga parámetros, el resultado y el triage los confirma el profesional: la sugerencia es un punto de partida, no un examen cerrado.
Cada tipo de examen trae una vigencia por defecto que IAegis usa para calcular cuando expira (y que se muestra como "Vigencia auto" al elegir el tipo):
| Tipo de examen | Vigencia por defecto |
|---|---|
| Pre-ocupacional | 730 días |
| Periódico | 365 días |
| Egreso (post-ocupacional) | No expira |
| Reintegro | 365 días |
| PREXOR / PLANESI / TMERT / RUV | 365 días |
| PREVAFOS / PLOMO / CITOSTÁTICOS | 180 días |
| Test alcohol/drogas | 30 días |
| Otro | 365 días |
Si el perfil tiene un usuario asociado y el checkbox "Guardar también en Reposit" está marcado, al guardar el examen IAegis:
El PDF y el certificado del Reposit se guardan con un nombre de archivo sin RUT y sin dato clínico visible. El PDF va a un path restringido de salud que solo el módulo Salud puede abrir, a través de una URL firmada temporal que válida el permiso de salud en el servidor. Por eso, si no tienes permiso de salud en esa empresa, el botón "PDF" del examen responde "No se pudo abrir el examen. Verifica que tengas permiso de salud para esta empresa."
Cuando un examen sugiere una enfermedad profesional, el expediente muestra el botón "Reportar a Siniestralidad", que abre el modal de reporte bajo el DS 67. Su título dice "Reportar enfermedad profesional / DS 67 · Siniestralidad".
| Campo | Tipo | Requerido | Validación / notas | Default |
|---|---|---|---|---|
| Contrato afectado | Select | Obligatorio | "— Selecciona contrato —" + jerarquía de contratos. Si no eliges, avisa "Selecciona el contrato al que reportar". | Vacío |
| Días perdidos a sumar | Número | Opcional | Mínimo 0. "Se sumará al MonthlyStats del contrato + período actual (YYYY-MM)." | 0 |
Las acciones del modal son "Cancelar" (cierra) y "Reportar a DS 67" (deshabilitado sin contrato o mientras procesa, con el texto "Reportando..."). En caso de éxito, el sistema confirma con "EP reportada a Siniestralidad · +{N} días en lostDaysEP"; en error, "Error reportando: ...".
El botón "Reportar a Siniestralidad" aparece solo cuando IAegis detecta una posible enfermedad profesional en el examen. Los días perdidos que ingreses se acumulan en las estadísticas mensuales del contrato para el período actual, insumo del cálculo de siniestralidad del DS 67.
El "Asistente IA · Salud" es un copiloto conversacional sobre toda la dotación. Se abre con el botón flotante del hub /health ("Pregunta a la IA sobre tu dotación") y responde con nombres y cifras concretas del contexto cargado, siempre de-identificado.
Al abrirlo, el asistente saluda con el contexto que tiene cargado: "Pregúntame sobre el estado de salud de tu dotación. Tengo el contexto cargado: {N} perfiles, {M} exámenes y {K} programas activos." Y ofrece una sección "Sugerencias" con prompts rápidos:
El campo de entrada tiene el placeholder "Pregunta sobre tu dotación..." y un botón de enviar (avión de papel); ambos se deshabilitan mientras la IA responde. Mientras piensa, muestra un indicador de escritura (tres puntos animados).
El contexto que va a Gemini incluye nombre, cargo, alertas, tipo/fecha/resultado del último examen, triage, días desde el último examen y hasta ocho parámetros clínicos — pero nunca el RUT. La IA responde de forma concisa (máximo 250 palabras), citando nombres y cifras concretas, y con la regla explícita: "No inventes datos. Si no hay info, 'Sin datos disponibles para responder eso'."
| Situación | Mensaje |
|---|---|
| Cuota mensual agotada | "Tu organización agotó el cupo mensual de IA. Se renueva el 1° del próximo mes; contacta al administrador para ampliar el plan." |
| Error genérico | "IA no disponible. Intenta nuevamente o contacta al administrador." |
| Sin respuesta | "Sin respuesta de la IA." |
El panel "Vigilancia obligatoria · IA copiloto" del hub /health es el nexo entre el MIPER y la Salud: deriva de los MIPER vigentes qué protocolos MINSAL son obligatorios y con qué cobertura. Se documenta aquí por su relación con el módulo; su detalle exhaustivo corresponde al capítulo de Vigilancia.
Figura 16.9 — Analítica de Salud Ocupacional: cobertura, vencimientos y estado de la dotación, insumo de la vigilancia.
El panel deriva los protocolos MINSAL obligatorios (PREXOR, PLANESI, TMERT, PREVAFOS, RUV, PLOMO, CITOSTÁTICOS, PSICOSOCIAL) a partir de los peligros evaluados en el MIPER, con su cobertura, faltantes y acciones masivas. Sus estados clave son:
La vigilancia es el puente natural entre este capítulo y el MIPER: los peligros que evalúes en la matriz determinan qué exámenes de vigilancia (incluido el de altura PREVAFOS) son obligatorios para cada puesto. Mantén el MIPER al día para que la cobertura de salud se calcule bien.
/health, busca y abre el perfil del trabajador (/health/profile/:id)./health, abre el botón flotante del chat./health, abre el chat flotante.| Problema | Causa probable | Solución |
|---|---|---|
| No veo el módulo Salud en el menú | El tenant no tiene el módulo habilitado o tu usuario no tiene el permiso. | Solicita al administrador el permiso GESTIONAR PROGRAMAS DE SALUD OCUPACIONAL y la habilitación del módulo. |
| "No se puede estimar el riesgo de Framingham" | Faltan ejes de la tabla: sexo, edad, colesterol total y/o presión sistólica. | Agrega esos parámetros al examen o al perfil; la sugerencia se recalcula sola. |
| "No se puede evaluar la dislipidemia" | Faltan colesterol total, C-HDL, triglicéridos o sexo. | Completa esos cuatro datos en el examen. |
| El riesgo salió 🔴 ALTO directo (sin tabla) | Se aplicó PASO 0 del PSCV: diabetes, ECV documentada, ERC 3b-5, albuminuria RAC≥30, HTA refractaria o C-LDL>190. | Es un criterio correcto e independiente de la tabla. No requiere acción; es la interpretación esperada. |
| El copiloto dice "Sin examen de altura" | No hay un examen cuyo tipo contenga "altura/altitud/hipobaria/ELA". | Carga el examen con el tipo "Vigilancia médica · PREVAFOS (hipobaria)" u otro que mencione altura. |
| El botón "PDF" del examen está deshabilitado | Ese examen no tiene archivo asociado. | Vuelve a cargar el PDF por la "Carga inteligente" para vincularlo. |
| "No se pudo abrir el examen. Verifica que tengas permiso de salud..." | Falta el permiso de salud en esa empresa (el PDF está en path restringido). | Solicita el permiso de salud al administrador. |
| El análisis IA o el chat responden "IA no disponible" o "cupo mensual agotado" | Error transitorio o cuota mensual de IA del tenant agotada. | Reintenta; si persiste por cuota, se renueva el 1° del mes o contacta al administrador para ampliar el plan. |
| La categoría de riesgo cambió al confirmar el sexo | El sexo influye en la tabla de Framingham; la IA lo había deducido del nombre. | Es el comportamiento correcto: con el sexo confirmado, el cálculo es más preciso. |