File size: 13,846 Bytes
c54762e 5f12c93 3bc4d13 70170fe 3bc4d13 5f12c93 3f2c35b 5f12c93 3f2c35b 5f12c93 3f2c35b 5f12c93 3f2c35b 5f12c93 3f2c35b 794cdd1 5f12c93 3f2c35b 5f12c93 3f2c35b f6c0922 3f2c35b f6c0922 5f12c93 794cdd1 3f2c35b 5f12c93 3f2c35b 5f12c93 794cdd1 5f12c93 3f2c35b 794cdd1 3f2c35b 5f12c93 794cdd1 5f12c93 794cdd1 5f12c93 794cdd1 5f12c93 3f2c35b 5f12c93 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 | ---
title: Modulo 6
emoji: 🚀
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
pinned: false
---
# 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.
---
## Deploy y links
URL APIs: https://modulo-6-api.hf.space/api/v1/
URL Documentación: https://modulo-6-api.hf.space/api/v1/docs
## Levantar el proyecto
**Prerequisitos:** tener Docker instalado y corriendo. Copiar `.env.example` a `.env` y completar `DATABASE_URL` y `JWT_SECRET` antes de arrancar.
### Mac (con Colima)
Colima puede tener problemas de DNS por defecto. Levantarlo así:
```bash
colima start --dns 8.8.8.8
```
Luego:
```bash
cp .env.example .env # completar DATABASE_URL y JWT_SECRET
docker compose up --build
```
### Windows (con Docker Desktop)
Docker Desktop ya maneja DNS automáticamente:
```bash
copy .env.example .env # completar DATABASE_URL y JWT_SECRET
docker compose up --build
```
El backend queda disponible en `http://localhost:7860`.
### Desarrollo local con hot-reload (sin Docker)
```bash
pip install -r requirements.txt
uvicorn app.main:app --host 0.0.0.0 --port 7860 --reload
```
> Requiere Python 3.12 y tener el `.env` configurado en la raíz del repo.
### Base de datos
La app usa **Supabase** (PostgreSQL). Al arrancar, `create_all` crea las tablas automáticamente si no existen. Si necesitás resetear las tablas:
```sql
-- Ejecutar en Supabase SQL Editor
DROP TABLE IF EXISTS auditoria CASCADE;
DROP TABLE IF EXISTS reservas_quirofano CASCADE;
DROP TABLE IF EXISTS solicitudes CASCADE;
DROP TABLE IF EXISTS camas CASCADE;
```
Luego reiniciar el contenedor para que las recree.
### Tabla de auditoría
El historial de eventos de camas (solicitudes, asignaciones, traslados, cambios
de estado, bajas y reservas) se guarda en la tabla `auditoria`. Como `supabase-py`
no ejecuta DDL, se crea con un script idempotente que se conecta por `psycopg2`:
```bash
# Requiere DATABASE_URL en el .env (postgresql://USER:PASS@HOST/DB?sslmode=require)
python scripts/create_auditoria_table.py
```
Alternativamente, pegar este SQL en el Supabase SQL Editor:
```sql
CREATE TABLE IF NOT EXISTS auditoria (
id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
entidad TEXT NOT NULL, -- CAMA | SOLICITUD | RESERVA_QUIROFANO
entidad_id TEXT NOT NULL,
cama_id BIGINT, -- denormalizado: historial por cama
evento TEXT NOT NULL,
estado_anterior TEXT,
estado_nuevo TEXT,
paciente_id BIGINT,
usuario_id TEXT,
rol TEXT, -- ADMINISTRATIVO | MEDICO | LIMPIEZA | SISTEMA
origen TEXT NOT NULL DEFAULT 'API', -- API | WEBHOOK | SISTEMA
descripcion TEXT,
detalle JSONB,
hospital_id TEXT,
creado_en TIMESTAMPTZ NOT NULL DEFAULT now()
);
CREATE INDEX IF NOT EXISTS idx_auditoria_cama_id ON auditoria (cama_id);
CREATE INDEX IF NOT EXISTS idx_auditoria_entidad ON auditoria (entidad, entidad_id);
CREATE INDEX IF NOT EXISTS idx_auditoria_paciente_id ON auditoria (paciente_id);
CREATE INDEX IF NOT EXISTS idx_auditoria_creado_en ON auditoria (creado_en DESC);
CREATE INDEX IF NOT EXISTS idx_auditoria_hospital_id ON auditoria (hospital_id);
```
Consulta del historial:
- `GET /api/v1/auditoria` — listado REST con filtros (`cama_id`, `entidad`,
`paciente_id`, `evento`, `fecha_desde`, `fecha_hasta`, `limit`, `offset`).
- `WS /api/v1/auditoria/ws?token=<JWT>` — envía un snapshot del historial
filtrado al conectar y luego empuja cada nuevo evento en tiempo real. Acepta
los mismos filtros como query params. El JWT va en `token` (el navegador no
puede setear el header `Authorization` en WebSocket).
---
## Documentación interactiva
| URL | Descripción |
| ---------------------------------- | ------------------------ |
| http://localhost:7860/api/v1/docs | Swagger UI (interactivo) |
| http://localhost:7860/api/v1/redoc | ReDoc (legible) |
| http://localhost:7860/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:7860/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 Neon (PostgreSQL). Formato: `postgresql://USER:PASS@HOST/DB?sslmode=require&...` |
| `JWT_SECRET` | **SÍ** | Secret de 64+ chars para firmar JWT. Generar con `python -c "import secrets; print(secrets.token_hex(32))"` |
| `JWT_ALGORITHM` | No | Algoritmo JWT (default: `HS256`) |
| `JWT_EXPIRE_MINUTES` | No | Duración del token en minutos (default: `60`) |
| `ENVIRONMENT` | No | `development` o `production` (default: `production`). En `development` habilita `/auth/token` |
| `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 -r requirements-dev.txt
pytest tests/ -v
```
|