botino/docs/env.md

Variables de entorno (Botino)

Variables usadas (runtime)

Core

• PORT: puerto del servidor (default 3000).
• TENANT_KEY: key por defecto para resolver tenant (default piaf).
• DATABASE_URL: conexión Postgres.
• PG_POOL_MAX: tamaño del pool (default 10).
• PG_IDLE_TIMEOUT_MS: idle timeout (default 30000).
• PG_CONN_TIMEOUT_MS: connection timeout (default 5000).
• APP_ENCRYPTION_KEY: clave para desencriptar credenciales Woo en Postgres (tenant_ecommerce_config).

OpenAI

• OPENAI_API_KEY (o OPENAI_APIKEY): API key.
• OPENAI_MODEL: modelo (default gpt-4o-mini).

Turn Engine

• TURN_ENGINE: motor de turnos. Valores:
  • v1 (default): pipeline actual (heurísticas + guardrails + LLM plan final).
  • v2: “LLM-first NLU, deterministic core” (nuevo motor detrás de feature flag).

WooCommerce (solo fallback si falta config por tenant)

• WOO_CONSUMER_KEY: consumer key (se usa solo si en tenant_ecommerce_config falta consumer_key).
• WOO_CONSUMER_SECRET: consumer secret (idem).

Debug por temas (nuevo)

Todos aceptan 1/true/yes/on para activar.

• DEBUG_PERF: perf/timings (pipeline + webhook evolution).
• DEBUG_WOO_HTTP: requests/responses a Woo (status/timing/len).
• DEBUG_WOO_PRODUCTS: cache/búsquedas de productos Woo.
• DEBUG_LLM: requests/responses a OpenAI.
• DEBUG_EVOLUTION: logs del hook evolution (además de perf).
• DEBUG_DB: reservado para instrumentar queries DB (no está verboso aún).
• DEBUG_RESOLVE: debug de resolución/ambiguity (pipeline).

Notas importantes

• En producción multi-tenant, Woo se toma de Postgres (tenant_ecommerce_config). Si restaurás WordPress y cambian keys/base_url, tenés que actualizar esa tabla para el tenant correspondiente; no alcanza con regenerar keys en WP si Botino sigue leyendo las viejas desde Postgres.