Modulo-6 / documentation /CONSIGNA.md
juampisor's picture
Added documentation. Included definitive design document.
476c19b
|
Raw History Blame Contribute Delete
9.05 kB

TRABAJO PR脕CTICO OBLIGATORIO: HEALTH GRID

Instituci贸n: UADE Materia: DESARROLLO DE APLICACIONES II Profesor: Ing. Joaqu铆n Timerman

La red de hospitales "Health Grid" busca unificar sus procesos m茅dicos y administrativos. Actualmente, la informaci贸n de los pacientes est谩 dispersa en silos, lo que dificulta la atenci贸n coordinada. Se solicita desarrollar una plataforma modular y distribuida que integre desde la Historia Cl铆nica Electr贸nica hasta el monitoreo de pacientes en tiempo real.


REQUERIMIENTOS GENERALES

  • Cada grupo estar谩 integrado por siete alumnos como m谩ximo.
  • Cada grupo dise帽ar谩 y desarrollar谩 un m贸dulo espec铆fico.
  • Cada m贸dulo deber谩 integrarse con otros de acuerdo con las reglas de negocio establecidas en este documento.
  • La integraci贸n ser谩 por medio de APIs RESTful y/o eventos asincr贸nicos, quedando la elecci贸n del m茅todo a criterio de cada grupo.
  • Los mismos deber谩n estar justificados y correctamente defendidos en las entregas parciales y final.
  • Las tecnolog铆as utilizadas para desarrollar cada m贸dulo quedar谩n a criterio de cada grupo.
  • Las mismas deber谩n estar justificadas y correctamente defendidas en las entregas parciales y final.
  • Se deber谩 documentar correctamente las APIs con herramientas como Swagger o Postman.

LISTADO DE M脫DULOS

1. Historia Cl铆nica Electr贸nica

Es el repositorio central de datos m茅dicos. Debe gestionar el registro de cada consulta, diagn贸stico y tratamiento.

  • Registro Cl铆nico: Creaci贸n y actualizaci贸n de la ficha m茅dica del paciente (antecedentes, alergias, cirug铆as, etc.).
  • Evoluci贸n M茅dica: Carga de notas de consulta por parte de profesionales de salud.
  • Consulta Externa: Exponer un servicio para que otros m贸dulos consulten si un paciente tiene contraindicaciones m茅dicas antes de un estudio o medicaci贸n.
  • Notificaci贸n Cr铆tica: Emitir un evento asincr贸nico cuando se detecte una patolog铆a de notificaci贸n obligatoria.

2. Gesti贸n de Turnos y Agendas

Administra la disponibilidad de profesionales y espacios f铆sicos.

  • Calendario Profesional: Gesti贸n de la disponibilidad horaria por m茅dico, especialidad y sede.
  • Reserva de Turnos: Flujo de reserva para pacientes, permitiendo filtrar por cercan铆a o primera disponibilidad.
  • Recordatorios: Env铆o de notificaciones autom谩ticas 24 horas antes del turno (v铆a evento asincr贸nico).
  • Presentismo: Registro de llegada del paciente para disparar el flujo de atenci贸n en sala de espera.

3. Farmacia e Insumos Hospitalarios

Controla el stock de medicamentos en farmacia y dep贸sitos.

  • Dispensaci贸n de Recetas: Validaci贸n y entrega de medicamentos basados en la receta electr贸nica emitida en HCE.
  • Gesti贸n de Inventario: Control de stock f铆sico en farmacia central y dep贸sitos de piso.
  • Alertas de Stock: Generaci贸n autom谩tica de pedidos de compra cuando un insumo cr铆tico llega al punto de reorden.
  • Trazabilidad: Registro de qu茅 lote de medicamento se entreg贸 a cada paciente.

4. Laboratorio de An谩lisis Cl铆nicos

Gesti贸n de pedidos de laboratorio y carga de resultados.

  • Gesti贸n de Ordenes: Recepci贸n de pedidos de an谩lisis desde el Portal del Paciente o M茅dicos.
  • Carga de Resultados: Interfaz para bioqu铆micos donde puedan cargar valores y observaciones t茅cnicas.
  • Publicaci贸n de Resultados: Al guardar un resultado finalizado, debe impactar autom谩ticamente en la HCE y notificar al paciente.
  • Validaci贸n de Rangos: Marcado autom谩tico de valores fuera de rango normal.

5. Diagn贸stico por Im谩genes

Gesti贸n de estudios como Rayos X, Tomograf铆as y Resonancias.

  • Cat谩logo de Estudios: Gesti贸n de turnos espec铆ficos para equipos de alta complejidad (Tom贸grafos, Resonadores, etc.).
  • Informe M茅dico: Herramienta para que el radi贸logo redacte el informe vinculado a la imagen.
  • Visualizador Lite: Interfaz para que el m茅dico solicitante pueda ver el informe y el link a la imagen almacenada.
  • Integraci贸n de Resultados: Env铆o del informe finalizado a la HCE de forma sincr贸nica.

6. Internaci贸n y Gesti贸n de Camas

Administra la ocupaci贸n de camas, ingresos a guardia y quir贸fanos.

  • Mapa de Camas: Visualizaci贸n en tiempo real de la ocupaci贸n por piso, sector y tipo de cama (UTI, Sala Com煤n, etc.).
  • Gesti贸n de Ingresos: Registro de admisi贸n desde Guardia o Cirug铆a programada.
  • Pases de Piso: Gesti贸n de traslados internos del paciente y liberaci贸n de recursos.
  • Cierre de Episodio: Proceso de alta m茅dica que dispara el evento para la limpieza de la unidad y la facturaci贸n final.

7. Facturaci贸n y Obras Sociales

Liquida las prestaciones m茅dicas a las aseguradoras y gestiona cobros particulares.

  • Nomenclador M茅dico: Gesti贸n de precios y convenios por cada obra social o prepaga.
  • Liquidaci贸n de prestaciones: Recopilaci贸n de todos los actos m茅dicos (consultas, estudios, descartables) realizados a un paciente.
  • Auditor铆a de Cuentas: Proceso de validaci贸n de facturas antes del env铆o a la entidad pagadora.
  • Gesti贸n de Coseguros: C谩lculo y cobro de excedentes o copagos al paciente.

8. Portal del Paciente y Telemedicina

Interfaz para que el ciudadano interact煤e con el sistema.

  • Mi Salud: Visualizaci贸n de turnos pr贸ximos, historial de recetas y resultados de laboratorio.
  • Sala Virtual: Integraci贸n de videollamada para consultas de baja complejidad.
  • Pagos Online: Secci贸n para pagar coseguros o turnos particulares utilizando saldo de tarjetas o billeteras virtuales (Pueden simular la integraci贸n).
  • Perfil y Notificaciones: Centro de notificaciones en tiempo real para alertas de salud y turnos.

9. Monitoreo de Pacientes

Simula el procesamiento de datos provenientes de dispositivos m茅dicos.

  • Ingesta de Telemetr铆a: Simulaci贸n de recepci贸n de datos de sensores (frecuencia card铆aca, SpO2, etc.) mediante colas de mensajes.
  • Motor de Reglas: Evaluaci贸n en tiempo real de los datos recibidos (ej: si HR>120 por 2 minutos, generar alerta).
  • Panel de Monitoreo: Dashboard para enfermer铆a con el estado de los pacientes.
  • Alertas de Emergencia: Env铆o de evento de alta prioridad al M贸dulo de Internaci贸n ante un c贸digo rojo detectado por sensores.

10. Core

Gesti贸n centralizada de usuarios (m茅dicos, administrativos, pacientes), permisos y configuraci贸n global.

  • Maestro de Usuarios: Gesti贸n de identidades para m茅dicos, enfermeros, administrativos, bioqu铆micos y pacientes.
  • Control de Acceso: Definici贸n de qu茅 m贸dulos y acciones puede realizar cada rol. Autenticaci贸n por JWT para todos los m贸dulos.
  • Maestro de Sedes y Especialidades: Configuraci贸n global que consumen los m贸dulos de Turnos e Integraci贸n.
  • Bus de Eventos: Configuraci贸n y auditor铆a de los canales de integraci贸n entre todos los m贸dulos del sistema.

ENTREGAS

Primera entrega:

  • Mocks de cada vista (Frontend).
  • Contratos de APIs (Backend).

Segunda entrega:

  • M贸dulo completamente funcional con las integraciones mockeadas.

Entrega final:

  • M贸dulo completamente funcional e integrado al resto del sistema.
  • README con instrucciones para instalar y ejecutar el m贸dulo.

Anexo - Glosario de T茅rminos de Dominio

Conceptos Asistenciales (Atenci贸n al paciente)

  • HCE (Historia Cl铆nica Electr贸nica): Registro longitudinal de la informaci贸n de salud de un individuo, generada en uno o m谩s encuentros en cualquier entorno de prestaci贸n de cuidados.
  • Episodio / Encuentro M茅dico: Una interacci贸n espec铆fica entre un paciente y un profesional de la salud (una consulta, una internaci贸n, una guardia). Cada episodio debe generar un registro en la HCE.
  • Triage: Proceso de selecci贸n y clasificaci贸n de pacientes en los servicios de urgencias basado en sus necesidades terap茅uticas y recursos disponibles, no necesariamente por orden de llegada.
  • Evoluci贸n: Nota cl铆nica redactada por el profesional de salud durante un encuentro donde se describe el estado actual, el plan de tratamiento y las observaciones del paciente.
  • Receta Electr贸nica: Orden digital emitida por un m茅dico para la dispensaci贸n de medicamentos.

Conceptos Administrativos y Financieros

  • Nomenclador M茅dico: Cat谩logo de todas las prestaciones m茅dicas (consultas, cirug铆as, estudios) identificadas por un c贸digo 煤nico y una descripci贸n. Es la base para la facturaci贸n.
  • Prestaci贸n M茅dica: Cualquier acci贸n, servicio o estudio realizado a un paciente que tiene un costo asociado y debe ser registrado para su cobro.
  • Coseguro / Copago: Monto de dinero que el paciente debe abonar por una prestaci贸n m茅dica, el cual no est谩 cubierto por su obra social o prepaga.
  • Auditor铆a M茅dica: Proceso de revisi贸n de las prestaciones realizadas para asegurar que cumplen con las normas m茅dicas y administrativas antes de ser facturadas a la obra social.