api / README.md
Mate11
Pirmer commit
5f12c93
|
Raw History Blame
8.15 kB

Health Grid – Módulo 6: Internación y Gestión de Camas

TPO UADE – Sistema de Gestión Hospitalaria
Módulo 6 del sistema multi-módulo Health Grid. Gestiona camas hospitalarias, solicitudes de internación/traslado y reservas de quirófano.


Levantar el proyecto

# 1. Copiar variables de entorno y editarlas
cp .env.example .env
# Editar .env: JWT_SECRET, POSTGRES_PASSWORD (OBLIGATORIO antes de producción)

# 2. Levantar con Docker Compose
docker compose up --build

El backend queda disponible en http://localhost:8006/api/v1.

Para desarrollo con hot-reload:

cd modulo6
pip install -r requirements.txt
uvicorn app.main:app --host 0.0.0.0 --port 8006 --reload

Documentación interactiva

URL Descripción
http://localhost:8006/api/v1/docs Swagger UI (interactivo)
http://localhost:8006/api/v1/redoc ReDoc (legible)
http://localhost:8006/health Health check

Autenticación

El módulo usa JWT (HS256). Para desarrollo, expone un generador de tokens cuando ENVIRONMENT=development:

curl "http://localhost:8006/api/v1/auth/token?usuario=ADMINISTRATIVO&password=any"

En producción (ENVIRONMENT=production), este endpoint devuelve 404. Los tokens de producción deben provenir de M10 (Core).

Roles válidos: ADMINISTRATIVO, MEDICO, LIMPIEZA.

Usar el token en requests:

Authorization: Bearer <token>

Variables de entorno requeridas

Copiar .env.example a .env y completar:

Variable Requerida Descripción
DATABASE_URL SÍ Cadena de conexión PostgreSQL
POSTGRES_DB SÍ Nombre de la base de datos
POSTGRES_USER SÍ Usuario de PostgreSQL
POSTGRES_PASSWORD SÍ Contraseña de PostgreSQL
JWT_SECRET SÍ Secret de 64+ chars para firmar JWT. Generar con python -c "import secrets; print(secrets.token_hex(32))"
ENVIRONMENT No development o production (default: production)
ALLOWED_ORIGINS No Lista JSON de orígenes CORS permitidos
MOCK_EXTERNAL_SERVICES No true = no llama a módulos externos (default: true)
HTTP_TIMEOUT_SECONDS No Timeout para llamadas externas en segundos (default: 5.0)
M1_HCE_URL No URL del Módulo 1 - HCE
M2_TURNOS_URL No URL del Módulo 2 - Turnos
M7_FACTURACION_URL No URL del Módulo 7 - Facturación
M9_MONITOREO_URL No URL del Módulo 9 - Monitoreo
M10_CORE_URL No URL del Módulo 10 - Core

Endpoints propios

Camas

Método Endpoint Roles Descripción
GET /api/v1/camas MEDICO, ADMIN, LIMPIEZA Mapa de camas con estadísticas
POST /api/v1/camas ADMIN Crear nueva cama
GET /api/v1/camas/disponibilidad MEDICO, ADMIN Disponibilidad de quirófanos en rango horario
GET /api/v1/camas/{id} MEDICO, ADMIN Detalle de una cama
PATCH /api/v1/camas/{id} ADMIN, LIMPIEZA Actualizar estado/contraindicaciones
DELETE /api/v1/camas/{id} ADMIN Baja permanente (soft delete)
POST /api/v1/camas/{id}/asignar ADMIN Asignación/traslado directo
GET /api/v1/camas/{id}/reservas MEDICO, ADMIN Reservas de un quirófano
POST /api/v1/camas/{id}/reservas MEDICO, ADMIN Crear reserva programada
GET /api/v1/camas/{id}/reservas/{rid} MEDICO, ADMIN Detalle de reserva
PATCH /api/v1/camas/{id}/reservas/{rid} ADMIN Actualizar estado de reserva

Solicitudes de Internación

Método Endpoint Roles Descripción
GET /api/v1/solicitudes MEDICO, ADMIN Listar solicitudes (default: PENDIENTE)
GET /api/v1/solicitudes/{id} MEDICO, ADMIN Detalle (ID formato SOL-XXXXX)
PATCH /api/v1/solicitudes/{id} ADMIN Aprobar / rechazar solicitud

Webhooks entrantes

Método Endpoint Emisor Descripción
POST /api/v1/webhooks/hce/solicitud M1 HCE Recibir solicitud de internación o traslado
POST /api/v1/webhooks/hce/alta-medica M1 HCE Recibir alta médica del paciente
POST /api/v1/webhooks/hce/cirugia-urgente M1 HCE Solicitud de cirugía urgente (desplaza reservas)
POST /api/v1/webhooks/turnos/{id}/cancelacion-quirofano M2 Turnos Cancelar reserva de quirófano
POST /api/v1/webhooks/monitoreo/alerta-emergencia M9 Monitoreo Poner cama en CODIGO_ROJO
POST /api/v1/webhooks/monitoreo/alerta-resuelta M9 Monitoreo Resolver CODIGO_ROJO → OCUPADA

Mapa de integraciones

Módulo 6 (Internación)
    │
    ├── [WEBHOOKS INBOUND]
    │   ├── ← M1 HCE         POST /webhooks/hce/*
    │   ├── ← M2 Turnos      POST /webhooks/turnos/*
    │   └── ← M9 Monitoreo   POST /webhooks/monitoreo/*
    │
    └── [HTTP OUTBOUND — app/integrations/]
        ├── → M10 Core       :8010  validar paciente
        ├── → M1 HCE         :8001  contraindicaciones + movimientos
        ├── → M9 Monitoreo   :8009  alta/baja monitoreo
        ├── → M7 Facturación :8007  cama lista (post limpieza)
        └── → M2 Turnos      :8002  resultado de quirófano

Para deshabilitar las llamadas salientes durante desarrollo: MOCK_EXTERNAL_SERVICES=true


Estructura del proyecto

modulo6/
├── app/                          # Código fuente principal
│   ├── main.py                   # App factory, routers, CORS, startup
│   ├── config.py                 # Settings con pydantic-settings (lee .env)
│   ├── dependencies.py           # BD, JWT y auth (get_db, require_roles)
│   ├── routers/                  # Endpoints HTTP (solo input/output)
│   │   ├── camas.py
│   │   ├── solicitudes.py
│   │   └── webhooks.py
│   ├── services/                 # Lógica de negocio
│   │   ├── cama_service.py
│   │   └── solicitud_service.py
│   ├── schemas/                  # Modelos Pydantic (request/response)
│   │   ├── enums.py
│   │   ├── cama.py
│   │   ├── solicitud.py
│   │   └── reserva.py
│   ├── models/                   # Modelos ORM SQLAlchemy
│   │   ├── cama.py
│   │   ├── solicitud.py
│   │   └── reserva.py
│   ├── crud/                     # Acceso a datos (sin lógica de negocio)
│   │   ├── cama.py
│   │   ├── solicitud.py
│   │   └── reserva.py
│   └── integrations/             # Clientes HTTP para módulos externos
│       ├── _base.py              # Helpers compartidos (timeout, headers)
│       ├── core.py               # M10 - validación de pacientes
│       ├── hce.py                # M1 - HCE (contraindicaciones, movimientos)
│       ├── turnos.py             # M2 - resultado de quirófano
│       ├── facturacion.py        # M7 - cama lista
│       └── monitoreo.py          # M9 - alta/baja monitoreo
├── tests/                        # Tests (espejo de app/)
│   ├── conftest.py               # Fixtures: DB en memoria, cliente de test
│   ├── test_camas.py
│   └── test_solicitudes.py
├── backend/                      # Código original (preservado)
├── audit/                        # Reportes de auditoría técnica
├── Dockerfile                    # Imagen de producción (sin --reload)
├── docker-compose.yml            # Orquestación: backend + PostgreSQL
├── requirements.txt              # Dependencias de producción
├── .env.example                  # Template de variables de entorno
└── README.md                     # Este archivo

Correr tests

pip install pytest pytest-asyncio
pytest tests/ -v