File size: 7,724 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 148 149 150 151 152 153 154 155 156 157 | # 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`
|