|
Download audit/AUDIT_REPORT.md from Modulo-6/api: direct link, hf CLI and curl.
- Browser
- Download file 8.75 kB
-
https://huggingface.co/spaces/Modulo-6/api/resolve/main/audit/AUDIT_REPORT.md
- Command line
-
hf download hf://spaces/Modulo-6/api/audit/AUDIT_REPORT.md
-
curl -L -o AUDIT_REPORT.md https://huggingface.co/spaces/Modulo-6/api/resolve/main/audit/AUDIT_REPORT.md
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 | | |