Procurement Planning Agent

Visão Geral

O Planning Agent é o orquestrador central dos Procurement Agents. Ele consolida informações de demanda, risco, custo e fornecedores para gerar planos de compra otimizados.

Endpoint

Base URL: https://csuite-dev.vallery.com.br/proc/plan
Porta interna: 8037

Endpoints Disponíveis

Health Check

GET /health

Computar Planos

POST /v1/plan/compute

Gera planos de compra baseados no contexto atual.

Request Body:

{
  "org_id": 1,
  "horizon_days": 90
}

Response:

{
  "outcome": "ALLOW",
  "candidates_count": 5,
  "plans_created": 3,
  "plans_updated": 1,
  "plans_skipped": 1,
  "candidates": [
    {
      "sku": "SKU001",
      "supplier_id": 1,
      "suggested_qty": 500,
      "target_date": "2026-02-15",
      "priority_score": 95.5,
      "rationale": {
        "rupture_risk": "HIGH",
        "coverage_days": 12,
        "cost_savings": 5.2
      }
    }
  ]
}

Lógica de Planejamento

Coleta Contexto: Busca estratégia, guidelines, riscos, custos
Identifica Candidatos: SKUs com risco de ruptura
Prioriza: Ordena por urgência e impacto
Gera Planos: Cria registros com status DRAFT
Dedup: Usa plan_hash para evitar duplicatas

Integração

┌──────────────┐
│ Demand Agent │──┐
└──────────────┘  │
┌──────────────┐  │   ┌──────────────────┐
│ Risk Agent   │──┼──▶│  Planning Agent  │
└──────────────┘  │   │                  │
┌──────────────┐  │   │  - compute()     │
│ Cost Agent   │──┤   │  - prioritize()  │
└──────────────┘  │   │  - deduplicate() │
┌──────────────┐  │   └────────┬─────────┘
│ Trust Agent  │──┘            │
└──────────────┘               ▼
                      ┌──────────────────┐
                      │ Cashflow Agent   │
                      │ Execution Agent  │
                      └──────────────────┘

Dependências

Tabelas:
procurement_strategy
procurement_guideline
procurement_plan
procurement_cost_snapshot
procurement_supplier_profile
Views:
vw_proc_rupture_risk

Status do Plano

Status	Descrição
DRAFT	Plano gerado, aguardando aprovação
APPROVED	Aprovado para execução
REJECTED	Rejeitado
EXECUTED	Ordem de compra emitida
CANCELLED	Cancelado
STALE	Expirado (dados desatualizados)

Configuração

Variável	Descrição	Default
`MYSQL_HOST`	Host do banco	localhost
`MYSQL_DB`	Database	csuite_procurement
`PORT`	Porta do serviço	8037
`DEMAND_AGENT_URL`	URL do Demand Agent	http://proc-demand-dev:8031
`RISK_AGENT_URL`	URL do Risk Agent	http://proc-inventory-risk-dev:8035
`COST_AGENT_URL`	URL do Cost Agent	http://proc-cost-dev:8033
`TRUST_AGENT_URL`	URL do Trust Agent	http://proc-supplier-trust-dev:8032