File size: 8,753 Bytes
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 | # 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 |
|