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](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 |