taskbot/docs/how-to/adding-env.md

Añadir una nueva variable de entorno

Pasos

1. Definir uso y por defecto

   • Elige un nombre claro (prefijos existentes si aplica, p.ej. GROUP_, RATE_LIMIT_, METRICS_).
   • Define valor por defecto sensato si procede.

2. Leer y validar

   • Lee la variable en el módulo correspondiente.
   • Si es global u obligatoria, extiende src/server.ts::validateEnv() para loggear o fallar si falta.

3. Documentar

   • Añade la variable a docs/operations.md con:
     • significado, rango válido, default y efectos.

4. Tests

   • Cubre ramas con valores válidos/ inválidos y ausencia de la variable.
   • Evita efectos secundarios en test (p.ej., schedulers no deben arrancar).

Consejos

• Normaliza formatos (booleans como 'true'/'1'/'yes').
• Mantén consistencia en nombres y semánticas con variables similares.