Configuración de Ambientes - Capitalta

1. Visión General

Este documento describe las variables de entorno y la configuración necesaria para los diferentes ambientes de la plataforma Capitalta: Development, Staging y Production.

2. Variables de Entorno

2.1. Variables Generales

VariableDescripciónEjemplo (Development)
NODE_ENVEntorno de ejecucióndevelopment
PORTPuerto del servidor3000
APP_URLURL base de la aplicaciónhttp://localhost:3000
API_URLURL de la APIhttp://localhost:3000/api

2.2. Base de Datos

VariableDescripciónEjemplo
DATABASE_URLURL de conexión a la base de datospostgresql://user:pass@localhost:5432/capitalta_dev
DATABASE_POOL_MINMínimo de conexiones en el pool2
DATABASE_POOL_MAXMáximo de conexiones en el pool10

2.3. Autenticación y Seguridad

VariableDescripciónEjemplo
JWT_SECRETSecreto para firmar tokens JWT[GENERAR_SECRETO_ALEATORIO]
JWT_EXPIRATIONTiempo de expiración del JWT7d
SESSION_SECRETSecreto para sesiones[GENERAR_SECRETO_ALEATORIO]
ENCRYPTION_KEYClave para encriptar datos sensibles[GENERAR_CLAVE_AES_256]

2.4. Servicio de Administración Tributaria (SAT)

VariableDescripción
SAT_API_URLURL de la API del SAT (o proveedor)
SAT_API_KEYAPI Key para acceso al SAT
SAT_CERTIFICATE_PATHRuta del certificado para e.firma

2.5. Sociedades de Información Crediticia

VariableDescripción
CIRCULO_CREDITO_API_URLURL de la API de Círculo de Crédito
CIRCULO_CREDITO_USERUsuario de Círculo de Crédito
CIRCULO_CREDITO_PASSWORDContraseña de Círculo de Crédito

2.6. Servicios de Comunicación

VariableDescripción
SENDGRID_API_KEYAPI Key de SendGrid (emails)
SENDGRID_FROM_EMAILEmail remitente
TWILIO_ACCOUNT_SIDAccount SID de Twilio (SMS)
TWILIO_AUTH_TOKENAuth Token de Twilio
TWILIO_PHONE_NUMBERNúmero de teléfono de Twilio

2.7. Almacenamiento (AWS S3)

VariableDescripción
AWS_ACCESS_KEY_IDAccess Key de AWS
AWS_SECRET_ACCESS_KEYSecret Access Key de AWS
AWS_REGIONRegión de AWS
AWS_S3_BUCKETNombre del bucket de S3

2.8. Pasarela de Pagos

VariableDescripción
STRIPE_PUBLIC_KEYPublic Key de Stripe
STRIPE_SECRET_KEYSecret Key de Stripe
STRIPE_WEBHOOK_SECRETWebhook Secret de Stripe

2.9. Modelo de IA

VariableDescripción
AI_MODEL_ENDPOINTEndpoint del modelo de IA
AI_MODEL_API_KEYAPI Key del modelo de IA

3. Archivos de Configuración por Ambiente

3.1. Development (.env.development)

NODE_ENV=development
PORT=3000
APP_URL=http://localhost:3000
DATABASE_URL=postgresql://capitalta:dev_password@localhost:5432/capitalta_dev
JWT_SECRET=dev_jwt_secret_change_in_production
# ... (resto de variables con valores de desarrollo)

3.2. Staging (.env.staging)

NODE_ENV=staging
PORT=3000
APP_URL=https://staging.capitalta.mx
DATABASE_URL=postgresql://capitalta:staging_password@staging-db.capitalta.mx:5432/capitalta_staging
JWT_SECRET=[SECRETO_SEGURO_STAGING]
# ... (resto de variables con valores de staging)

3.3. Production (.env.production)

NODE_ENV=production
PORT=3000
APP_URL=https://www.capitalta.mx
DATABASE_URL=postgresql://capitalta:[PASSWORD]@prod-db.capitalta.mx:5432/capitalta_prod
JWT_SECRET=[SECRETO_SEGURO_PRODUCTION]
# ... (resto de variables con valores de producción)

4. Reglas de Negocio Parametrizadas

Estas reglas deben ser configurables desde el panel de administración o mediante variables de entorno.

ParámetroDescripciónValor Sugerido
MIN_CREDIT_AMOUNTMonto mínimo de crédito250000 (MXN)
MAX_CREDIT_AMOUNTMonto máximo de crédito5000000 (MXN)
MIN_TERM_MONTHSPlazo mínimo en meses6
MAX_TERM_MONTHSPlazo máximo en meses36
COMMISSION_RATETasa de comisión por apertura (%)3.0
MIN_INTEREST_RATETasa de interés mínima anual (%)18.0
MAX_INTEREST_RATETasa de interés máxima anual (%)36.0
LATE_INTEREST_RATETasa de interés moratoria anual (%)48.0
SCORE_THRESHOLD_AUmbral para nivel de riesgo A750
SCORE_THRESHOLD_BUmbral para nivel de riesgo B680
SCORE_THRESHOLD_CUmbral para nivel de riesgo C620
SCORE_THRESHOLD_DUmbral para nivel de riesgo D550

Última actualización: 28 de diciembre de 2025