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/31c8dd67e47a516206b4122c4da00a634486a247/audit/DEPENDENCY_AUDIT.md
- Command line
-
hf download hf://spaces/Modulo-6/api@31c8dd67e47a516206b4122c4da00a634486a247/audit/DEPENDENCY_AUDIT.md
-
curl -L -o DEPENDENCY_AUDIT.md https://huggingface.co/spaces/Modulo-6/api/resolve/31c8dd67e47a516206b4122c4da00a634486a247/audit/DEPENDENCY_AUDIT.md
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.pylínea 9:jwt_secret: str = "supersecretkey_change_in_production"— fallback hardcodeado en código fuente..envlí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 conopenssl rand -hex 32.
ALTO
A-01: Sin lockfile — builds no reproducibles
- No existe
poetry.lock,requirements-lock.txtniPipfile.lock. - Las subdependencias no están fijadas; dos
pip installen 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-slimsin 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
psycopg2compilado (añadirlibpq-dev gccal Dockerfile) o migrar apsycopgv3.
MEDIO
M-01: python-multipart declarada pero no utilizada
- No hay
Form,FileniUploadFileen 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
--reloaddel Dockerfile. Usarlo solo endocker-compose.ymlpara 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,httpxprobablemente 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-dotenvNO es necesario:pydantic-settingsya gestiona la carga del.envnativamente (configurado correctamente enconfig.pyconenv_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)
- [CRÍTICO] Rotar el JWT secret — eliminar fallback hardcodeado y generar valor seguro
- [ALTO] Reemplazar
python-joseporauthlib - [ALTO] Reemplazar
psycopg2-binaryporpsycopg2compilado opsycopgv3 - [ALTO] Generar un lockfile (pip-tools o Poetry)
- [MEDIO] Remover
--reloaddel Dockerfile - [MEDIO] Incorporar
alembicpara migraciones - [MEDIO] Crear
requirements-dev.txtseparado - [BAJO] Agregar
.gitignorey.dockerignore