Skip to content

Variables de entorno

BCN Extractor se configura mediante un archivo .env en la raíz del proyecto. Copia .env.example como punto de partida:

cp .env.example .env

Base de datos

Variable	Requerida	Default	Descripción
`DB_HOST`	✅	`localhost`	Host de PostgreSQL
`DB_PORT`	✅	`5432`	Puerto de PostgreSQL
`DB_NAME`	✅	`bcn_extractor`	Nombre de la base de datos
`DB_USER`	✅	`postgres`	Usuario de PostgreSQL
`DB_PASSWORD`	✅	—	Contraseña de PostgreSQL

# .env — configuración de base de datos
DB_HOST=localhost
DB_PORT=5432
DB_NAME=bcn_extractor
DB_USER=postgres
DB_PASSWORD=tu_password_segura

BCN Client

Variable	Requerida	Default	Descripción
`BCN_RATE_LIMIT`	—	`1.0`	Segundos de espera entre requests a la BCN
`BCN_MAX_RETRIES`	—	`3`	Número máximo de reintentos por request fallido
`BCN_TIMEOUT`	—	`30`	Timeout en segundos por request

# .env — configuración del cliente BCN
BCN_RATE_LIMIT=1.0
BCN_MAX_RETRIES=3
BCN_TIMEOUT=30

Rutas de almacenamiento

Variable	Default	Descripción
`XML_PATH`	`./data/xml`	Directorio donde se guardan los XMLs descargados
`MD_PATH`	`./data/md`	Directorio donde se guardan los Markdowns generados
`LOG_PATH`	`./data/logs`	Directorio de archivos de log
`CACHE_PATH`	`./data/cache`	Directorio de caché

API

Variable	Default	Descripción
`API_HOST`	`0.0.0.0`	Host donde escucha la API
`API_PORT`	`8000`	Puerto de la API
`API_RELOAD`	`false`	Habilitar recarga automática (solo desarrollo)

# .env — para desarrollo local
API_HOST=127.0.0.1
API_PORT=8000
API_RELOAD=true

Ejemplo completo de `.env`

# ─── Base de datos ─────────────────────────
DB_HOST=localhost
DB_PORT=5432
DB_NAME=bcn_extractor
DB_USER=postgres
DB_PASSWORD=cambia_esto_por_algo_seguro

# ─── BCN Client ────────────────────────────
BCN_RATE_LIMIT=1.0
BCN_MAX_RETRIES=3
BCN_TIMEOUT=30

# ─── Rutas ─────────────────────────────────
XML_PATH=./data/xml
MD_PATH=./data/md
LOG_PATH=./data/logs
CACHE_PATH=./data/cache

# ─── API ───────────────────────────────────
API_HOST=0.0.0.0
API_PORT=8000
API_RELOAD=false