Configuración

facturAR se configura mediante variables de entorno. Esta página documenta las variables disponibles para cada servicio.

Variables generales (Docker Compose)

Variable	Default	Descripción
NODE_ENV	development	Entorno (development / production)
PORT	3000	Puerto de la API
CLIENT_PORT	8080	Puerto del frontend (nginx)
DOCS_PORT	8081	Puerto de la documentación (nginx)

API

Variable	Default	Descripción
DB_MAIN_HOST	localhost	Host de la base de datos principal
DB_MAIN_PORT	5432	Puerto de la BD principal
DB_MAIN_USER	facturas	Usuario de la BD principal
DB_MAIN_PASSWORD	—	Contraseña de la BD principal
DB_MAIN_NAME	facturas_central	Nombre de la BD principal
DB_AUDIT_HOST	localhost	Host de la BD de auditoría
DB_AUDIT_PORT	5433	Puerto de la BD de auditoría
DB_AUDIT_USER	facturas_audit	Usuario de la BD de auditoría
DB_AUDIT_PASSWORD	—	Contraseña de la BD de auditoría
DB_AUDIT_NAME	facturas_audit	Nombre de la BD de auditoría
REDIS_HOST	localhost	Host de Redis
REDIS_PORT	6379	Puerto de Redis
CREDENTIALS_MASTER_KEY	—	Clave maestra AES-256-GCM (64 hex)
JWT_SECRET	—	Secreto para firmar JWT (mín 32 chars)
JWT_EXPIRES_IN	7d	Expiración del token JWT
FRONTEND_URL	http://localhost:5173	URL del frontend (para CORS)
SMTP_HOST	—	Host SMTP (opcional)
SMTP_PORT	587	Puerto SMTP
SMTP_USER	—	Usuario SMTP
SMTP_PASS	—	Contraseña SMTP
SMTP_FROM	noreply@facturascentral.com	Remitente de emails
ADMIN_API_KEY	—	API Key de administración
ZEN_BASE_URL	https://opencode.ai/zen/v1	URL base del LLM
ZEN_MODEL	deepseek-v4-flash-free	Modelo del asistente IA
ZEN_TEMPERATURE	0.3	Temperatura del LLM

Documentación (Docusaurus)

Variable	Default	Descripción
DOCS_URL	https://docs.facturar.com.ar	URL canónica del sitio de docs
APP_URL	https://app.facturar.com.ar	URL de la aplicación principal
GITHUB_URL	https://github.com/facturar/facturacion_service	URL del repositorio GitHub

Frontend (Vite)

Variable	Default	Descripción
VITE_DOCS_URL	http://localhost:3002	URL de la documentación (sidebar)

Agente IA

Variable	Default	Descripción
DB_AGENT_URL	—	URL de conexión a la BD del agente
ZEN_API_KEY	—	API Key de OpenCode Zen
CONSUMER_FINAL_THRESHOLD	10000000	Umbral de consumo final del agente

Archivos .env

Cada servicio tiene su propio .env.example:

• api/.env.example — variables de la API.
• docs/.env.example — variables de la documentación.
• .env.example (raíz) — variables de Docker Compose.

Copiá el .env.example a .env y ajustá los valores según tu entorno:

cp .env.example .env
cp api/.env.example api/.env
cp docs/.env.example docs/.env