# 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](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 1. **Rotar credenciales** — generar nuevo JWT_SECRET y POSTGRES_PASSWORD; revocar los actuales 2. **Verificar historial git** — `git log --all --full-history -- .env`; si fue comprometido, tratar el repositorio como público 3. **Crear `.gitignore`** — incluir `.env`, `__pycache__/`, `*.pyc`, `.pytest_cache/` 4. **Implementar firma HMAC en webhooks** — secret compartido entre módulos para validar llamadas de M1/M2/M9 5. **Agregar rate limiting** — `slowapi` en endpoints de auth y webhooks ### Semana 2 — Calidad y tests 6. **Migrar httpx a AsyncClient** — cambiar `_post`/`_get` en `integrations/_base.py` a async para no bloquear event loop 7. **Escribir tests reales** — completar `tests/test_camas.py` y `tests/test_solicitudes.py` usando el conftest existente 8. **Adoptar pip-tools o Poetry** — generar lockfile para builds reproducibles 9. **Reemplazar `python-jose`** — migrar a `authlib` (mantenimiento activo, sin CVEs conocidos) 10. **Reemplazar `psycopg2-binary`** — migrar a `psycopg2` compilado o `psycopg` v3 ### Semana 3 — Madurez operacional 11. **Incorporar Alembic** — reemplazar `create_all()` en startup por migraciones versionadas 12. **Configurar logging estructurado** — JSON logs para integración con sistemas de observabilidad 13. **Documentar errores en OpenAPI** — agregar `responses={}` completos en los endpoints de webhooks que aún faltan 14. **Crear `requirements-dev.txt`** — separar dependencias de test/lint de producción 15. **Agregar `.dockerignore`** — excluir `__pycache__`, `*.pyc`, `audit/`, `backend/`, `tests/` del contexto de build --- ## Archivos de auditoría generados | Archivo | Descripción | |---------|-------------| | [audit/STRUCTURE.md](STRUCTURE.md) | Mapa completo de la arquitectura original, endpoints, integraciones | | [audit/DEPENDENCY_AUDIT.md](DEPENDENCY_AUDIT.md) | Análisis de dependencias, problemas de lockfile y Docker | | [audit/CODE_QUALITY.md](CODE_QUALITY.md) | 36 hallazgos de calidad con referencias file:line | | [audit/SECURITY_AUDIT.md](SECURITY_AUDIT.md) | 20 hallazgos de seguridad (5 críticos) con plan de remediación | | [audit/ARCHITECTURE_REVIEW.md](ARCHITECTURE_REVIEW.md) | Evaluación de capas, OpenAPI, acoplamiento y recomendaciones | | [audit/REFACTOR_LOG.md](REFACTOR_LOG.md) | Log detallado de todos los cambios realizados en Phase 2 |