Procurement Inventory Risk Agent

Visão Geral

O Inventory Risk Agent analisa o risco de ruptura de estoque. Calcula cobertura de dias, identifica SKUs críticos e gera alertas de ruptura iminente.

Endpoint

Base URL: https://csuite-dev.vallery.com.br/proc/risk
Porta interna: 8035

Endpoints Disponíveis

Health Check

GET /health

Avaliar Risco de Ruptura

POST /v1/risk/assess

Avalia risco de ruptura para SKUs.

Request Body:

{
  "org_id": 1,
  "sku": "SKU001"
}

Response:

{
  "outcome": "ALLOW",
  "risk": {
    "sku": "SKU001",
    "stock_qty": 100,
    "in_transit_qty": 50,
    "avg_daily_demand": 10.5,
    "coverage_days": 14,
    "rupture_risk": "MEDIUM",
    "days_to_stockout": 14,
    "lead_time_days": 30
  }
}

Níveis de Risco

Nível	Coverage Days	Ação
CRITICAL	< 7	Compra urgente
HIGH	7-14	Priorizar compra
MEDIUM	14-30	Planejar compra
LOW	> 30	Monitorar

Integração

Alimenta o Planning Agent com informações de risco para priorização de compras.

Dependências

View: csuite_procurement.vw_proc_rupture_risk
Tabelas: Estoque, Demanda, Lead times

Configuração

Variável	Descrição	Default
`MYSQL_HOST`	Host do banco	localhost
`MYSQL_DB`	Database	csuite_procurement
`PORT`	Porta do serviço	8035

Fórmulas

coverage_days = (stock_qty + in_transit_qty) / avg_daily_demand
days_to_stockout = coverage_days - lead_time_days
rupture_risk = classify(days_to_stockout)

Arquitetura

┌─────────────────┐     ┌──────────────────┐
│ Estoque         │────▶│  Risk Agent      │
│ Em Trânsito     │     │                  │
│ Demanda         │     │  - assess()      │
│ Lead Times      │     │  - classify()    │
└─────────────────┘     └────────┬─────────┘
                                 │
                                 ▼
                        ┌──────────────────┐
                        │ Planning Agent   │
                        └──────────────────┘

Procurement Risk Agent