api / documentation /CONSIGNA.md
juampisor's picture
Added documentation. Included definitive design document.
476c19b
|
Raw History Blame
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.