api / audit /AUDIT_REPORT.md
Mate11
Pirmer commit
5f12c93
|
Raw History Blame Contribute Delete
8.75 kB

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

  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

  1. Migrar httpx a AsyncClient — cambiar _post/_get en integrations/_base.py a async para no bloquear event loop
  2. Escribir tests reales — completar tests/test_camas.py y tests/test_solicitudes.py usando el conftest existente
  3. Adoptar pip-tools o Poetry — generar lockfile para builds reproducibles
  4. Reemplazar python-jose — migrar a authlib (mantenimiento activo, sin CVEs conocidos)
  5. Reemplazar psycopg2-binary — migrar a psycopg2 compilado o psycopg v3

Semana 3 — Madurez operacional

  1. Incorporar Alembic — reemplazar create_all() en startup por migraciones versionadas
  2. Configurar logging estructurado — JSON logs para integración con sistemas de observabilidad
  3. Documentar errores en OpenAPI — agregar responses={} completos en los endpoints de webhooks que aún faltan
  4. Crear requirements-dev.txt — separar dependencias de test/lint de producción
  5. Agregar .dockerignore — excluir __pycache__, *.pyc, audit/, backend/, tests/ del contexto de build

Archivos de auditoría generados

Archivo Descripción
audit/STRUCTURE.md Mapa completo de la arquitectura original, endpoints, integraciones
audit/DEPENDENCY_AUDIT.md Análisis de dependencias, problemas de lockfile y Docker
audit/CODE_QUALITY.md 36 hallazgos de calidad con referencias file:line
audit/SECURITY_AUDIT.md 20 hallazgos de seguridad (5 críticos) con plan de remediación
audit/ARCHITECTURE_REVIEW.md Evaluación de capas, OpenAPI, acoplamiento y recomendaciones
audit/REFACTOR_LOG.md Log detallado de todos los cambios realizados en Phase 2