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`