Reporte de Auditoría Técnica — Módulo 6 (Health Grid)
Fecha: 2026-05-03 | Stack: FastAPI 0.115 · SQLAlchemy 2.0 · PostgreSQL 16 · Python 3.12
1. Resumen ejecutivo
El Módulo 6 (Internación y Gestión de Camas) implementa correctamente la arquitectura de 4 capas (Router → Service → ORM → BD), gestiona las 3 entidades del dominio (Cama, Solicitud, ReservaQuirofano) y mantiene integración con 5 módulos externos via webhooks entrantes y HTTP saliente. El código es funcional y cubre los flujos principales del dominio médico (internación, traslado, cirugía urgente, alta médica, alertas). Sin embargo, la auditoría identificó 5 vulnerabilidades críticas de seguridad que deben resolverse antes de cualquier despliegue, 36 problemas de calidad de código (incluyendo 1 bug funcional en un webhook), y ausencia total de tests automatizados. La reorganización a la nueva estructura app/ corrigió el bug de autorización en POST /reservas, eliminó la lógica duplicada, formalizó la capa de acceso a datos (crud/) y separó las integraciones externas en módulos independientes.
2. Issues críticos — acción inmediata requerida
2.1 Seguridad (CRÍTICO)
| ID |
Descripción |
Archivo original |
Acción |
| SEC-01 |
JWT secret hardcodeado como default en código fuente ("supersecretkey_change_in_production") |
backend/config.py:9 |
Resuelto en nueva estructura — campo obligatorio sin default en app/config.py. Rotar el secret activo del .env inmediatamente. |
| SEC-02 |
.env con credenciales activas potencialmente versionado en git |
.env |
Verificar: git log --all --full-history -- .env. Si fue comprometido, rotar todas las credenciales. |
| SEC-03 |
CORS con allow_origins=["*"] + allow_credentials=True — combinación inválida W3C, facilita CSRF |
backend/main.py:45-46 |
Resuelto en nueva estructura — app/main.py usa settings.allowed_origins. |
| SEC-04 |
Endpoint /auth/token genera JWT reales sin restricción de entorno — cualquier persona puede obtener tokens ADMIN |
backend/main.py:62-77 |
Resuelto en nueva estructura — guard if settings.environment != "development": return 404. |
| SEC-05 |
--reload en CMD del Dockerfile de producción |
backend/Dockerfile:12 |
Resuelto — nuevo Dockerfile sin --reload. |
2.2 Bug funcional (ALTO)
| ID |
Descripción |
Impacto |
| BUG-01 |
POST /camas/{id}/reservas usaba get_current_user sin rol → usuarios de LIMPIEZA podían crear reservas de quirófano |
Integridad operacional |
| Resuelto |
Cambiado a require_roles("MEDICO", "ADMINISTRATIVO") en app/routers/camas.py |
— |
3. Issues de alta prioridad
3.1 Calidad de código
| Categoría |
Cantidad |
Issues más importantes |
| Strings hardcodeados en lugar de enums |
9 |
Estados de cama/reserva como literals en services |
| Manejo de errores silenciado |
3 |
except Exception: return None en external_client sin logging |
| Lógica duplicada |
3 |
_get_cama_or_404 ×2, verificación contraindicaciones ×3, _now_iso() ×5 |
| Modelos Pydantic sin validadores |
5 |
Sin validación de fechas, sin Literal en tipo de asignación |
| Funciones > 50 líneas |
2 |
crear_reserva_urgente (75 líneas), _aprobar_traslado (49 líneas) |
Todos resueltos en la nueva estructura app/:
- Enums usados en lugar de strings
- Logging agregado en
_base.py de integraciones
_get_cama_or_404 en crud/cama.py (una sola vez)
_verificar_contraindicaciones extraída en ambos servicios
- Validadores de fechas en schemas de reserva
3.2 Seguridad media
| ID |
Descripción |
Severidad |
Estado |
| SEC-06 |
Webhooks sin firma HMAC — cualquier token JWT puede inyectar eventos médicos |
ALTO |
Pendiente |
| SEC-07 |
Sin rate limiting en ningún endpoint |
ALTO |
Pendiente |
| SEC-08 |
Puerto 5432 expuesto al host |
ALTO |
Resuelto en nuevo docker-compose.yml |
| SEC-09 |
Contraindicaciones médicas expuestas en mensajes HTTP |
MEDIO |
Resuelto — mensajes genéricos en nueva estructura |
| SEC-10 |
Mensajes de error JWT diferenciados (oracle de timing) |
MEDIO |
Resuelto — mensaje genérico en app/dependencies.py |
3.3 Arquitectura
| Issue |
Estado |
| Sin capa repositorio — ORM directo en services |
Resuelto — nueva capa app/crud/ |
external_client.py monolítico para 5 integraciones |
Resuelto — app/integrations/ separado por módulo |
cancelar_reserva_por_turno en módulo incorrecto (import lazy circular) |
Resuelto — usa crud.reserva.get_by_turno() |
| httpx síncrono bloqueando event loop de FastAPI |
Pendiente — requiere migrar a httpx.AsyncClient |
OpenAPI: solo 56% de endpoints con response_model |
Mejorado — todos los endpoints tienen responses={4xx:...} |
| Sin tests |
Mejorado — estructura base + conftest; tests reales pendientes |
4. Resumen de reorganización
Ver detalles completos en: audit/REFACTOR_LOG.md
Nueva estructura creada (app/)
app/
├── main.py # App factory mejorada
├── config.py # Settings pydantic v2 (sin defaults inseguros)
├── dependencies.py # DB + JWT + auth unificados
├── routers/ # 3 routers (camas, solicitudes, webhooks)
├── services/ # 2 servicios de dominio
├── schemas/ # 5 archivos (enums + 4 dominios)
├── models/ # 3 modelos ORM
├── crud/ # ← NUEVA CAPA (3 módulos de acceso a datos)
└── integrations/ # ← NUEVA CAPA (5 clientes HTTP por módulo externo)
Estadísticas de la refactorización
| Métrica |
Valor |
| Archivos creados |
31 |
| Archivos modificados |
2 (docker-compose.yml, README.md) |
| Archivos eliminados |
0 |
| Bugs corregidos |
7 |
| Código duplicado eliminado |
3 instancias |
| Imports lazy eliminados |
3 |
| Strings mágicos → enums |
9 ubicaciones |
5. Próximos pasos en orden de prioridad
Semana 1 — Seguridad crítica
- Rotar credenciales — generar nuevo JWT_SECRET y POSTGRES_PASSWORD; revocar los actuales
- Verificar historial git —
git log --all --full-history -- .env; si fue comprometido, tratar el repositorio como público
- Crear
.gitignore — incluir .env, __pycache__/, *.pyc, .pytest_cache/
- Implementar firma HMAC en webhooks — secret compartido entre módulos para validar llamadas de M1/M2/M9
- Agregar rate limiting —
slowapi en endpoints de auth y webhooks
Semana 2 — Calidad y tests
- Migrar httpx a AsyncClient — cambiar
_post/_get en integrations/_base.py a async para no bloquear event loop
- Escribir tests reales — completar
tests/test_camas.py y tests/test_solicitudes.py usando el conftest existente
- Adoptar pip-tools o Poetry — generar lockfile para builds reproducibles
- Reemplazar
python-jose — migrar a authlib (mantenimiento activo, sin CVEs conocidos)
- Reemplazar
psycopg2-binary — migrar a psycopg2 compilado o psycopg v3
Semana 3 — Madurez operacional
- Incorporar Alembic — reemplazar
create_all() en startup por migraciones versionadas
- Configurar logging estructurado — JSON logs para integración con sistemas de observabilidad
- Documentar errores en OpenAPI — agregar
responses={} completos en los endpoints de webhooks que aún faltan
- Crear
requirements-dev.txt — separar dependencias de test/lint de producción
- Agregar
.dockerignore — excluir __pycache__, *.pyc, audit/, backend/, tests/ del contexto de build
Archivos de auditoría generados