|
Download audit/DEPENDENCY_AUDIT.md from Modulo-6/api: direct link, hf CLI and curl.
- Browser
- Download file 7.72 kB
-
https://huggingface.co/spaces/Modulo-6/api/resolve/main/audit/DEPENDENCY_AUDIT.md
- Command line
-
hf download hf://spaces/Modulo-6/api/audit/DEPENDENCY_AUDIT.md
-
curl -L -o DEPENDENCY_AUDIT.md https://huggingface.co/spaces/Modulo-6/api/resolve/main/audit/DEPENDENCY_AUDIT.md
7.72 kB
| # Auditoría de Dependencias — Módulo 6 | |
| > Generado: 2026-05-03 | Auditor: Agent B (Dependency Auditor) | |
| --- | |
| ## Resumen de dependencias declaradas | |
| `backend/requirements.txt` declara **9 dependencias**, todas con versión fijada con `==`. No existe lockfile (ni `poetry.lock`, ni `requirements-lock.txt` de pip-tools, ni `Pipfile.lock`). | |
| | # | Paquete | Versión | Tipo | | |
| |---|---------|---------|------| | |
| | 1 | `fastapi` | `0.115.0` | Producción | | |
| | 2 | `uvicorn[standard]` | `0.31.0` | Producción | | |
| | 3 | `sqlalchemy` | `2.0.35` | Producción | | |
| | 4 | `psycopg2-binary` | `2.9.10` | Producción | | |
| | 5 | `pydantic` | `2.9.2` | Producción | | |
| | 6 | `pydantic-settings` | `2.5.2` | Producción | | |
| | 7 | `python-jose[cryptography]` | `3.3.0` | Producción | | |
| | 8 | `httpx` | `0.27.2` | Producción | | |
| | 9 | `python-multipart` | `0.0.12` | Producción | | |
| --- | |
| ## Dependencias utilizadas vs. declaradas | |
| | Paquete | Usado en fuente | Archivos | Notas | | |
| |---------|----------------|----------|-------| | |
| | `fastapi` | ✅ Sí | `main.py`, todos los routers, auth, services | Core framework | | |
| | `uvicorn[standard]` | ✅ Sí (runtime) | `Dockerfile CMD` | No se importa en Python; esencial como servidor ASGI | | |
| | `sqlalchemy` | ✅ Sí | `database.py`, `models/*.py`, `services/*.py` | ORM v2 | | |
| | `psycopg2-binary` | ✅ Sí (runtime) | Driver de la URL `postgresql://` en `database.py` | SQLAlchemy lo carga en runtime | | |
| | `pydantic` | ✅ Sí | `schemas/*.py` — `BaseModel`, `ConfigDict`, `field_validator` | Validación | | |
| | `pydantic-settings` | ✅ Sí | `config.py` — `from pydantic_settings import BaseSettings` | Uso correcto con v2 | | |
| | `python-jose[cryptography]` | ✅ Sí | `auth/jwt_handler.py` — `from jose import JWTError, jwt` | JWT | | |
| | `httpx` | ✅ Sí | `services/external_client.py` — `import httpx` | HTTP a módulos externos | | |
| | `python-multipart` | ⚠️ No explícito | Ningún router usa `Form`, `File` ni `UploadFile` | Potencialmente innecesario | | |
| --- | |
| ## Problemas encontrados | |
| ### CRÍTICO | |
| **C-01: Secret JWT hardcodeado como valor por defecto** | |
| - `config.py` línea 9: `jwt_secret: str = "supersecretkey_change_in_production"` — fallback hardcodeado en código fuente. | |
| - `.env` línea 6: el mismo valor sin cambiar en el entorno real. | |
| - Cualquier persona que lea el código puede firmar tokens JWT válidos. | |
| - **Acción:** Eliminar el default, usar `jwt_secret: str` (campo obligatorio sin fallback). Generar con `openssl rand -hex 32`. | |
| ### ALTO | |
| **A-01: Sin lockfile — builds no reproducibles** | |
| - No existe `poetry.lock`, `requirements-lock.txt` ni `Pipfile.lock`. | |
| - Las subdependencias no están fijadas; dos `pip install` en distintos momentos pueden instalar versiones diferentes. | |
| - **Acción:** Adoptar pip-tools (`pip-compile`) o Poetry. | |
| **A-02: Imagen Docker sin digest SHA256** | |
| - `FROM python:3.12-slim` sin hash fijado. | |
| - **Acción:** Usar `python:3.12-slim@sha256:<hash>` o versión patch completa. | |
| **A-03: `python-jose` sin mantenimiento activo (última versión: 2022)** | |
| - CVEs conocidos sin parche. El proyecto está virtualmente abandonado. | |
| - **Acción:** Migrar a `authlib` (mantenido activamente, sin CVEs activos conocidos). | |
| **A-04: `psycopg2-binary` desaconsejado en producción** | |
| - Los propios maintainers advierten contra su uso en producción (conflictos con libs del sistema). | |
| - **Acción:** Usar `psycopg2` compilado (añadir `libpq-dev gcc` al Dockerfile) o migrar a `psycopg` v3. | |
| ### MEDIO | |
| **M-01: `python-multipart` declarada pero no utilizada** | |
| - No hay `Form`, `File` ni `UploadFile` en ningún router. Dependencia prescindible actualmente. | |
| **M-02: `version: "3.9"` obsoleto en docker-compose.yml** | |
| - Campo deprecado en Docker Compose v2. Genera warnings. | |
| - **Acción:** Eliminar la línea `version:`. | |
| **M-03: `--reload` en CMD del Dockerfile de producción** | |
| - `CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8006", "--reload"]` | |
| - Flag de desarrollo en imagen de producción — file watchers, reinicios inesperados. | |
| - **Acción:** Remover `--reload` del Dockerfile. Usarlo solo en `docker-compose.yml` para dev. | |
| **M-04: Sin separación de dependencias dev/prod** | |
| - No existe `requirements-dev.txt`. Sin estructura para aislar herramientas de testing/linting. | |
| **M-05: Versiones potencialmente desactualizadas (a mayo 2026)** | |
| - Las versiones datan de mediados/finales 2024. `fastapi`, `uvicorn`, `sqlalchemy`, `pydantic`, `httpx` probablemente tienen versiones más recientes con correcciones de seguridad. | |
| ### BAJO | |
| **B-01: `.env` con credenciales sin `.gitignore` verificado** | |
| - No se encontró `.gitignore`. Riesgo de commit accidental de credenciales. | |
| **B-02: Sin `.dockerignore`** | |
| - El contexto de build incluye `__pycache__`, `.pyc`, etc. Aumenta tiempo de build. | |
| **B-03: Sin `pyproject.toml`** | |
| - Sin metadatos de proyecto estándar para integración con herramientas modernas. | |
| --- | |
| ## Dependencias faltantes recomendadas | |
| | Paquete | Justificación | Prioridad | | |
| |---------|--------------|-----------| | |
| | `alembic` | El proyecto usa `Base.metadata.create_all()` en startup — funciona en dev pero no en producción. Alembic permite migraciones versionadas y reversibles. | ALTA | | |
| | `authlib` | Reemplazo directo de `python-jose` (abandonado). RFC 7519 completo, mantenimiento activo. | ALTA | | |
| | `gunicorn` | Process manager para múltiples workers Uvicorn en producción (`-k uvicorn.workers.UvicornWorker`). | MEDIA | | |
| | `pytest` + `pytest-asyncio` | No hay tests visibles. `httpx` ya declarado puede usarse con `AsyncClient`. | MEDIA | | |
| | `ruff` | Linter/formatter moderno (dev). | BAJA | | |
| | `mypy` | Type checker — el código usa type hints extensivamente. | BAJA | | |
| > `python-dotenv` NO es necesario: `pydantic-settings` ya gestiona la carga del `.env` nativamente (configurado correctamente en `config.py` con `env_file = ".env"`). | |
| --- | |
| ## Análisis del entorno Docker | |
| ### Dockerfile | |
| | Aspecto | Estado | Nota | | |
| |---------|--------|------| | |
| | Imagen base `python:3.12-slim` | ✅ Correcto | Versión Python correcta, variante slim apropiada | | |
| | `--no-cache-dir` en pip install | ✅ Correcto | Reduce tamaño de imagen | | |
| | Orden de layers | ✅ Correcto | `COPY requirements.txt` → `pip install` → `COPY . .` | | |
| | Digest SHA256 fijado | ⚠️ Faltante | Sin hash fijado en imagen base | | |
| | `--reload` en CMD | ⚠️ Problema | Solo para desarrollo, no producción | | |
| | `.dockerignore` | ⚠️ Faltante | Contexto de build innecesariamente grande | | |
| | Usuario no-root | ⚠️ Faltante | Corre como root | | |
| ### docker-compose.yml | |
| | Aspecto | Estado | Nota | | |
| |---------|--------|------| | |
| | `postgres:16-alpine` | ✅ Correcto | Versión reciente y slim | | |
| | `healthcheck` con `pg_isready` | ✅ Correcto | Con `condition: service_healthy` | | |
| | Volumen nombrado | ✅ Correcto | Para persistencia de datos PostgreSQL | | |
| | `restart: unless-stopped` | ✅ Correcto | Para el backend | | |
| | Variables via `env_file: .env` | ✅ Correcto | | | |
| | `version: "3.9"` | ⚠️ Obsoleto | Campo deprecado en Docker Compose v2 | | |
| | Puerto `5432` expuesto al host | ⚠️ Riesgo | En producción no debería exponerse | | |
| | Bind mount `./backend:/app` | ⚠️ Solo dev | No apropiado para producción | | |
| --- | |
| ## Acciones urgentes (por prioridad) | |
| 1. **[CRÍTICO]** Rotar el JWT secret — eliminar fallback hardcodeado y generar valor seguro | |
| 2. **[ALTO]** Reemplazar `python-jose` por `authlib` | |
| 3. **[ALTO]** Reemplazar `psycopg2-binary` por `psycopg2` compilado o `psycopg` v3 | |
| 4. **[ALTO]** Generar un lockfile (pip-tools o Poetry) | |
| 5. **[MEDIO]** Remover `--reload` del Dockerfile | |
| 6. **[MEDIO]** Incorporar `alembic` para migraciones | |
| 7. **[MEDIO]** Crear `requirements-dev.txt` separado | |
| 8. **[BAJO]** Agregar `.gitignore` y `.dockerignore` | |