🌐 Endpoints do Upgrade Estratégico - Policy Radar Executivo
Base URL
Direto (csuite-context): https://csuite.internut.com.br/context/api/executive/dashboard
Via Gateway (Recomendado): https://csuite.internut.com.br/api/executive/radar
1. Policy Effectiveness (Fechamento de Loop)
Endpoint
GET /api/executive/dashboard/policy-effectiveness?org_id=0&policy_code=INV_LOW_TURN
Descrição
Retorna a efetividade de políticas baseado em outcomes observados.
Parâmetros
org_id(int, obrigatório): ID da organização (padrão: 0)policy_code(string, opcional): Código da política específica
Resposta
{
"items": [
{
"org_id": 0,
"policy_code": "INV_LOW_TURN",
"policy_name": "INV · Baixo Giro / Sem Giro",
"total_actions": 150,
"success_count": 120,
"failure_count": 20,
"pending_count": 10,
"success_rate_pct": 85.71,
"avg_delta_score": 15.5,
"avg_success_delta": 20.3,
"avg_failure_delta": -5.2
}
]
}
2. Attention Budget (Governança Cognitiva)
Endpoint
GET /api/executive/dashboard/attention-budget?org_id=0&budget_type=BUNDLE_PER_SELLER_DAY
Descrição
Retorna o status do Attention Budget para evitar overload humano.
Parâmetros
org_id(int, obrigatório): ID da organização (padrão: 0)budget_type(string, opcional): Tipo de budget (BUNDLE_PER_SELLER_DAY, POLICIES_ACTIVE, ALERTS_PER_DAY, CAMPAIGNS_ACTIVE, COOLDOWN_PRODUCT)
Resposta
{
"items": [
{
"budget_id": 1,
"org_id": 0,
"budget_type": "BUNDLE_PER_SELLER_DAY",
"max_count": 5,
"cooldown_hours": null,
"is_active": 1,
"current_usage": 3,
"remaining_budget": 2,
"status": "OK"
}
]
}
Status
OK: Dentro do budgetWARNING: 80% ou mais do budget usadoEXCEEDED: Budget excedido
3. Policy Versions (Histórico)
Endpoint
GET /api/executive/dashboard/policy-versions?org_id=0&policy_code=INV_LOW_TURN
Descrição
Retorna o histórico de versões de uma política.
Parâmetros
org_id(int, obrigatório): ID da organização (padrão: 0)policy_code(string, opcional): Código da política específica
Resposta
{
"items": [
{
"version_id": 1,
"org_id": 0,
"policy_code": "INV_LOW_TURN",
"version_number": 1,
"effective_from": "2025-01-01T00:00:00",
"effective_until": "2025-12-31T23:59:59",
"policy_name": "INV · Baixo Giro / Sem Giro",
"severity_default": 3,
"score_default": 70,
"sla_default": "14d",
"rules_json": "[{\"rule_key\":\"GRACE_DAYS\",\"rule_value\":\"30\"}]"
}
]
}
4. Policy Version Comparison
Endpoint
GET /api/executive/dashboard/policy-version-comparison?org_id=0&policy_code=INV_LOW_TURN
Descrição
Compara versões consecutivas de políticas para identificar mudanças.
Resposta
{
"items": [
{
"org_id": 0,
"policy_code": "INV_LOW_TURN",
"version_from": 1,
"version_to": 2,
"from_date": "2025-01-01T00:00:00",
"to_date": "2025-12-31T23:59:59",
"severity_changed": 1,
"score_changed": 0,
"sla_changed": 0,
"auto_escalate_changed": 0,
"rules_changed": 1
}
]
}
5. Seller Context (Contexto de Carteira)
Endpoint
GET /api/executive/dashboard/seller-context?org_id=0&seller_id=131
Descrição
Retorna o contexto completo da carteira do vendedor para metas dinâmicas.
Parâmetros
org_id(int, obrigatório): ID da organização (padrão: 0)seller_id(int, opcional): ID do vendedor específico
Resposta
{
"items": [
{
"seller_id": 131,
"seller_name": "João Silva",
"total_revendas": 45,
"revendas_ativas_90d": 32,
"revendas_ativas_30d": 18,
"penetracao_90d_pct": 71.11,
"total_pedidos_12m": 156,
"total_maquinas_12m": 1234,
"total_receita_12m": 392963.0,
"ultima_compra": "2025-12-30",
"dias_sem_compra": 1,
"context_score": 85.5
}
]
}
6. Brand Radar (KPIs por Marca)
Endpoint
GET /api/executive/dashboard/brand-radar?org_id=0
Descrição
Retorna KPIs consolidados por marca para decisões executivas.
Resposta
{
"items": [
{
"org_id": 0,
"marca": "GERAL",
"penetracao_pct": 65.5,
"revendas_ativas": 285,
"total_pedidos": 1234,
"total_maquinas": 9468,
"total_receita": 29686182.0,
"ticket_medio": 3134.5,
"total_produtos": 450,
"total_estoque": 12345,
"produtos_ruptura": 12,
"produtos_low_turn": 45,
"pct_ruptura": 2.67,
"pct_low_turn": 10.0,
"giro_12m": 0.77,
"brand_score": 72.5
}
]
}
7. What-if: Low Turn Bundle
Endpoint
GET /api/executive/dashboard/whatif/low-turn-bundle?org_id=0
Descrição
Simula o impacto de empurrar 30% do estoque low-turn via bundle.
Resposta
{
"data": {
"org_id": 0,
"estoque_low_turn_atual": 5000,
"unidades_alvo_30pct": 1500,
"vendas_12m_atual": 25000,
"vendas_projetadas_30pct": 26500,
"media_mensal_projetada": 2208,
"chega_30k": "NÃO",
"conclusao": "Faltam 3500 máquinas para chegar em 30k"
}
}
8. What-if: Ruptura Reduction
Endpoint
GET /api/executive/dashboard/whatif/ruptura-reduction?org_id=0
Descrição
Simula o impacto de reduzir ruptura em 50%.
Resposta
{
"data": {
"org_id": 0,
"produtos_ruptura": 12,
"unidades_ruptura": 450,
"vendas_atual_ruptura": 1200,
"vendas_perdidas_estimadas": 600,
"receita_perdida_estimada": 3000000.0,
"vendas_projetadas_com_estoque": 1800,
"receita_projetada": 9000000.0,
"crescimento_receita": 3000000.0,
"crescimento_pct": 50.0
}
}
9. What-if: Run Scenario
Endpoint
POST /api/executive/dashboard/whatif/run-scenario?scenario_id=1&org_id=0
Descrição
Executa um cenário what-if específico.
Parâmetros
scenario_id(int, obrigatório): ID do cenárioorg_id(int, obrigatório): ID da organização (padrão: 0)
Resposta
{
"data": {
"scenario_id": 1,
"org_id": 0,
"scenario_name": "Bundle 30% Low-Turn",
"scenario_type": "LOW_TURN_BUNDLE",
"status": "COMPLETED",
"projected_revenue": 132500000.0,
"projected_machines": 26500,
"projected_payout": 132500.0,
"completed_at": "2025-12-31T12:00:00"
}
}
Integração no Gateway
Os endpoints também estão disponíveis via gateway:
GET https://csuite.internut.com.br/api/executive/radar/policy-effectiveness
GET https://csuite.internut.com.br/api/executive/radar/attention-budget
GET https://csuite.internut.com.br/api/executive/radar/policy-versions
GET https://csuite.internut.com.br/api/executive/radar/seller-context
GET https://csuite.internut.com.br/api/executive/radar/brand-radar
GET https://csuite.internut.com.br/api/executive/radar/whatif/low-turn-bundle
GET https://csuite.internut.com.br/api/executive/radar/whatif/ruptura-reduction
POST https://csuite.internut.com.br/api/executive/radar/whatif/run-scenario
Última atualização: 31/12/2025