ingleo44/comercialai-logistics repository overview

git clone <repository-url>
cd comercialai-saas
npm install

# Copiar archivo de configuración
cp .env.example .env

# Editar .env con tus API keys
nano .env

# ========================================
# SELECCIÓN DE PROVEEDOR (Escoge UNO)
# ========================================
AI_PROVIDER=QWEN                    # QWEN | OPENAI | DEEPSEEK

# ========================================
# QWEN AI (Alibaba Cloud) - Recomendado para Producción
# ========================================
DASHSCOPE_API_KEY=sk-your-qwen-key
MODEL_NAME=qwen-flash               # qwen-flash | qwen-plus | qwen-max

# ========================================  
# OPENAI - Máxima Calidad
# ========================================
OPENAI_API_KEY=sk-your-openai-key
OPENAI_MODEL=gpt-4o-mini            # gpt-4o-mini | gpt-4 | gpt-4-turbo

# ========================================
# DEEPSEEK - Ultra Económico
# ========================================
DEEPSEEK_API_KEY=sk-your-deepseek-key
DEEPSEEK_MODEL=deepseek-chat        # deepseek-chat | deepseek-coder

# Probar todos los proveedores configurados
npm run test:ai

# Probar un proveedor específico
npm run test:ai:openai
npm run test:ai:qwen  
npm run test:ai:deepseek

# Iniciar servidor
npm start

npm start              # Iniciar servidor
npm run dev           # Modo desarrollo con recarga automática
npm run test:ai       # Probar todos los proveedores AI

npm run test:ai:openai    # Probar solo OpenAI
npm run test:ai:qwen      # Probar solo Qwen
npm run test:ai:deepseek  # Probar solo DeepSeek

# Usar el script de switching automático
./scripts/switch-ai-provider.sh OPENAI   # Cambiar a OpenAI
./scripts/switch-ai-provider.sh QWEN     # Cambiar a Qwen  
./scripts/switch-ai-provider.sh DEEPSEEK # Cambiar a DeepSeek

npm run ai:validate         # Validar proveedor actual
npm run ai:validate:all     # Probar todos los proveedores

# Análisis paginado (recomendado para datasets grandes)
POST /api/inventory/analyze-paginated
GET  /api/inventory/results/:sessionId
GET  /api/inventory/status/:sessionId
DELETE /api/inventory/stop/:sessionId    # 🛑 NUEVO: Detener análisis en progreso

# Exportación de resultados
POST /api/inventory/export
GET  /api/inventory/exports
GET  /api/inventory/export/:filename

GET /api/inventory/status           # Estado del sistema
GET /api/inventory/ai/validate      # Validar proveedor actual
GET /api/inventory/ai/validate?testAll=true  # Probar todos

// Análisis de inventario con archivo CSV
const formData = new FormData();
formData.append('inventory', csvFile);

const response = await fetch('/api/inventory/analyze-paginated', {
  method: 'POST',
  body: formData
});

const { sessionId } = await response.json();

// Polling para obtener resultados
const pollResults = async () => {
  const results = await fetch(`/api/inventory/results/${sessionId}`);
  const data = await results.json();
  
  if (data.processing.completed) {
    console.log('Análisis completado:', data.results);
  } else {
    setTimeout(pollResults, 2000); // Continuar polling
  }
};

pollResults();

// 🛑 Detener análisis si es necesario
const stopAnalysis = async () => {
  const response = await fetch(`/api/inventory/stop/${sessionId}`, {
    method: 'DELETE'
  });
  
  const result = await response.json();
  console.log('Análisis detenido:', result.data.final_stats);
  
  if (result.data.results_available) {
    // Obtener resultados parciales
    const partialResults = await fetch(`/api/inventory/results/${sessionId}`);
    console.log('Resultados parciales:', await partialResults.json());
  }
};

# Construir imagen
docker build -t comercialai-saas .

# Ejecutar con docker-compose
docker-compose up -d

# Verificar estado
docker-compose logs -f

# En docker-compose.yml o al ejecutar
docker run -e AI_PROVIDER=QWEN \
           -e DASHSCOPE_API_KEY=sk-your-key \
           -e OPENAI_API_KEY=sk-your-openai-key \
           -e DEEPSEEK_API_KEY=sk-your-deepseek-key \
           -p 3000:3000 comercialai-saas

comercialai-saas/
├── src/
│   ├── algorithms/
│   │   ├── InventoryCalculationEngine.js      # Motor V1 (Pipeline + Días Objetivo)
│   │   └── InventoryCalculationEngineV2.js    # Motor V2 (Min-Max + Safety Stock) 🆕
│   ├── controllers/
│   │   └── InventoryController.js             # Controlador principal
│   ├── services/
│   │   ├── UnifiedInventoryAnalysisService.js # Servicio unificado (sin IA)
│   │   ├── ExcelProcessorService.js           # Procesamiento Excel
│   │   └── ExportService.js                   # Exportación de datos
│   ├── routes/
│   │   └── inventory.js                       # Rutas API
│   ├── utils/
│   │   └── middleware.js                      # Middleware personalizado
│   └── index.js                               # Servidor principal
├── scripts/
│   ├── test-ai-providers.js                   # Testing de proveedores
│   └── switch-ai-provider.sh                  # Cambio de proveedor
├── .env.example                               # Plantilla de configuración
├── docker-compose.yml                         # Configuración Docker
├── Dockerfile                                 # Imagen Docker
├── CLEANUP_SUMMARY.md                         # Resumen de limpieza de código
├── DEPLOYMENT.md                              # Guía de despliegue
├── INVENTORY_MODELS_COMPARISON.md             # Comparación V1 vs V2 🆕
└── README.md                                  # Esta documentación

# Usar modelo V1 (Default - Pipeline + Días Objetivo)
USE_INVENTORY_MODEL_V2=false

# Usar modelo V2 (Nuevo - Min-Max + Safety Stock)
USE_INVENTORY_MODEL_V2=true

# En .env - Ajustes de rendimiento
MAX_AI_CONCURRENCY=2              # Llamadas concurrentes (reducir si hay timeouts)
OPTIMIZED_THRESHOLD=100           # Usar modo optimizado para datasets >100 items
AI_TIMEOUT_BASE_MS=180000         # Timeout base: 3 minutos
AI_TIMEOUT_PER_ITEM_MS=8000       # Timeout adicional por item: 8 segundos
CIRCUIT_BREAKER_MAX_FAILURES=3    # Max fallos antes de backoff

# Configuraciones de negocio
LEAD_TIME_DAYS=90                 # Lead time de fabricantes
TARGET_COVERAGE_DAYS=40           # Cobertura objetivo de stock
MIN_STOCK_ALERT_DAYS=30           # Umbral de alerta de stock mínimo

# Reducir concurrencia en .env
MAX_AI_CONCURRENCY=1
AI_TIMEOUT_BASE_MS=300000

# Verificar configuración
npm run test:ai

# Validar un proveedor específico
npm run test:ai:qwen

# Usar procesamiento paginado
POST /api/inventory/analyze-paginated
# En lugar de /api/inventory/analyze

# Logs en tiempo real
docker-compose logs -f

# Estado del sistema
curl http://localhost:3000/api/inventory/status

# Validar todos los proveedores
curl "http://localhost:3000/api/inventory/ai/validate?testAll=true"