Procurement Demand Translator Agent

Visão Geral

O Demand Translator Agent é responsável por traduzir sinais de demanda em requisitos de compra. Ele analisa dados de vendas, previsões e estoque para gerar snapshots de demanda que alimentam o planejamento de compras.

Endpoint

• Base URL: https://csuite-dev.vallery.com.br/proc/demand
• Porta interna: 8031

Endpoints Disponíveis

Health Check

GET /health

Retorna status do serviço.

Processar Demanda

POST /v1/demand/translate

Traduz sinais de demanda em requisitos de compra.

Request Body:

{
  "org_id": 1,
  "skus": ["SKU001", "SKU002"],
  "horizon_days": 90
}

Response:

{
  "outcome": "ALLOW",
  "snapshots": [
    {
      "sku": "SKU001",
      "demand_30d": 1500.00,
      "demand_60d": 3200.00,
      "demand_90d": 5000.00,
      "avg_daily_demand": 55.5,
      "trend": "INCREASING"
    }
  ]
}

Integração

Este agent é consumido pelo Planning Agent para calcular planos de compra baseados na demanda projetada.

Dependências

• Database: csuite_procurement.proc_demand_snapshot
• Tabelas de origem: Vendas, previsões, sazonalidade

Configuração

Arquitetura

┌─────────────────┐     ┌──────────────────┐
│  Vendas_Historia│────▶│  Demand Agent    │
│  Previsões      │     │                  │
│  Sazonalidade   │     │  - translate()   │
└─────────────────┘     │  - snapshot()    │
                        └────────┬─────────┘
                                 │
                                 ▼
                        ┌──────────────────┐
                        │ Planning Agent   │
                        └──────────────────┘

Métricas

• procurement_demand_requests_total - Total de requisições
• procurement_demand_latency_seconds - Latência de processamento