# 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 ```bash # 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: ```bash 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`: ```bash 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 ``` --- ## 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 ```bash pip install pytest pytest-asyncio pytest tests/ -v ```