|
Download README.md from Modulo-6/api: direct link, hf CLI and curl.
- Browser
- Download file 8.15 kB
-
https://huggingface.co/spaces/Modulo-6/api/resolve/31c8dd67e47a516206b4122c4da00a634486a247/README.md
- Command line
-
hf download hf://spaces/Modulo-6/api@31c8dd67e47a516206b4122c4da00a634486a247/README.md
-
curl -L -o README.md https://huggingface.co/spaces/Modulo-6/api/resolve/31c8dd67e47a516206b4122c4da00a634486a247/README.md
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