Guia de Uso - APIs `/api/executive/dashboard`

Base URL: https://csuite.internut.com.br/context/api/executive/dashboard

📋 Índice

Dashboard Executivo (KPIs e Métricas)
Vendedores e Performance
Estoque e Produtos
Metas e Targets
Policy e Governança
Agent Loop e Health
What-if Engine
Exemplos Práticos

1. Dashboard Executivo

1.1 KPIs Consolidados

Endpoint: GET /api/executive/dashboard/kpis

Descrição: Retorna KPIs consolidados do dashboard executivo (penetração, vendas, máquinas, payout, inbox).

Parâmetros:
- org_id (int, obrigatório) - ID da organização (0 = todas)
- target_month (string, opcional) - Mês alvo (YYYY-MM-DD), padrão: mais recente

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/kpis?org_id=0&target_month=2025-12-01"

Resposta:

{
  "org_id": 0,
  "target_month": "2025-12-01",
  "penetration_empresa_mes": 144,
  "penetration_meta_mes": 300,
  "penetration_sum_sellers": 144,
  "penetration_target_sum_sellers": 300,
  "sales_value": 29686182.0,
  "machines_sold": 9468,
  "low_turn_units": 0,
  "payout_amount": 23577.84,
  "sellers_with_bonus": 12,
  "radar_critical_items": 0,
  "inbox_rows_today": 908,
  "inbox_revendas_today": 435,
  "inbox_fit_total": 16362
}

1.2 Vendedores (Heatmap)

Endpoint: GET /api/executive/dashboard/sellers

Descrição: Retorna dados de vendedores para heatmap (penetração atual vs meta, vendas, máquinas, payout).

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- target_month (string, opcional) - Mês alvo
- vendedor_id (string, opcional) - Filtrar por vendedor específico

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/sellers?org_id=0&target_month=2025-12-01"

Resposta:

{
  "items": [
    {
      "org_id": 0,
      "target_month": "2025-12-01",
      "vendedor_id": "131",
      "target_penetration": 60,
      "actual_penetration": 42,
      "penetration_pct": 70.0,
      "sales_value": 392963.0,
      "machines_sold": 123,
      "low_turn_units": 0,
      "payout_amount": 1964.82
    }
  ]
}

1.3 Vendas Mensais

Endpoint: GET /api/executive/dashboard/sales-monthly

Descrição: Vendas mensais agregadas.

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- months_back (int, opcional, padrão: 12) - Quantos meses para trás

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/sales-monthly?org_id=0&months_back=12"

1.4 Ações Abertas

Endpoint: GET /api/executive/dashboard/open-actions

Descrição: Lista ações abertas/pendentes.

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- limit (int, opcional, padrão: 100) - Limite de resultados

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/open-actions?org_id=0&limit=50"

2. Estoque e Produtos

2.1 Ruptura Top 20

Endpoint: GET /api/executive/dashboard/rupture

Descrição: Top 20 produtos em ruptura (estoque zero ou muito baixo).

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- limit (int, opcional, padrão: 20) - Limite de resultados

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/rupture?org_id=0&limit=20"

Resposta:

{
  "items": [
    {
      "org_id": 0,
      "Produto_ID": 1980324,
      "Produto_Modelo": "ZT-781K",
      "Estoque_Atual": 0,
      "Vendidas_12m": 4,
      "Media_Mensal_12m": 0.33,
      "Cobertura_Meses": 0.0,
      "signal_code": "RUPTURA",
      "severity": 5
    }
  ]
}

2.2 Low-Turn Top 20

Endpoint: GET /api/executive/dashboard/lowturn

Descrição: Top 20 produtos com baixo giro (estoque parado).

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- limit (int, opcional, padrão: 20) - Limite de resultados

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/lowturn?org_id=0&limit=20"

Resposta:

{
  "items": [
    {
      "org_id": 0,
      "Produto_ID": 35226,
      "Produto_Modelo": "YL4834",
      "Estoque_Atual": 10,
      "Vendidas_12m": 0,
      "ultima_entrada_estoque": "2009-05-28",
      "Dias_Em_Estoque": 6061,
      "severity": 5
    }
  ]
}

2.3 Low-Turn Mensal

Endpoint: GET /api/executive/dashboard/low-turn-monthly

Descrição: Evolução mensal de produtos low-turn.

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- months_back (int, opcional, padrão: 12) - Quantos meses para trás

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/low-turn-monthly?org_id=0&months_back=12"

2.4 Radar de Estoque

Endpoint: GET /api/executive/dashboard/estoque-radar

Descrição: Radar de estoque com sinais de severidade (verde/amarelo/vermelho).

Parâmetros:
- org_id (int, obrigatório) - ID da organização

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/estoque-radar?org_id=0"

Resposta:

{
  "items": [
    {
      "produto_id": 12345,
      "produto_modelo": "ABC-123",
      "severity": "GREEN",
      "signal_code": "OK",
      "cobertura_meses": 3.5,
      "estoque_atual": 100,
      "media_mensal": 28.5
    }
  ]
}

3. Inbox e Campanhas

3.1 Inbox do Dia

Endpoint: GET /api/executive/dashboard/inbox

Descrição: Campanhas e bundles recomendados por vendedor para o dia.

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- vendedor_id (string, opcional) - Filtrar por vendedor
- limit (int, opcional, padrão: 100) - Limite de resultados

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/inbox?org_id=0&vendedor_id=131"

Resposta:

{
  "items": [
    {
      "vendedor_id": "131",
      "revenda_id": "12345",
      "campaign_code": "LOW_TURN_BUNDLE_001",
      "campaign_type": "BUNDLE",
      "fit_score": 85.5,
      "recommended_at": "2025-12-31T10:00:00"
    }
  ]
}

3.2 Inbox Top 20

Endpoint: GET /api/executive/dashboard/inbox-top20

Descrição: Top 20 recomendações do inbox.

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- limit (int, opcional, padrão: 20) - Limite de resultados

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/inbox-top20?org_id=0"

4. Metas e Targets

4.1 Targets Dinâmicos

Endpoint: GET /api/executive/dashboard/targets

Descrição: Metas dinâmicas calculadas por vendedor (contextualizadas).

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- target_month (string, opcional) - Mês alvo
- vendedor_id (string, opcional) - Filtrar por vendedor

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/targets?org_id=0&target_month=2025-12-01"

Resposta:

{
  "items": [
    {
      "org_id": 0,
      "target_month": "2025-12-01",
      "vendedor_id": "131",
      "target_penetration": 50,
      "target_sales": 500000,
      "context_score": 85.5,
      "portfolio_active_pct": 75.0
    }
  ]
}

4.2 Status de Targets

Endpoint: GET /api/executive/dashboard/targets-status

Descrição: Status de metas por vendedor e KPI (atingido/não atingido).

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- target_month (string, opcional) - Mês alvo
- vendedor_id (string, opcional) - Filtrar por vendedor

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/targets-status?org_id=0&target_month=2025-12-01"

4.3 Foco Diário

Endpoint: GET /api/executive/dashboard/daily-focus

Descrição: Foco diário recomendado por vendedor (o que priorizar hoje).

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- vendedor_id (string, opcional) - Filtrar por vendedor

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/daily-focus?org_id=0&vendedor_id=131"

5. Penetração e Evolução

5.1 Evolução de Penetração

Endpoint: GET /api/executive/dashboard/penetracao-evolucao

Descrição: Evolução mensal de penetração (empresa e por vendedor).

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- months_back (int, opcional, padrão: 12) - Quantos meses para trás

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/penetracao-evolucao?org_id=0&months_back=12"

5.2 Penetração Mensal por Seller

Endpoint: GET /api/executive/dashboard/penetracao-mensal-seller

Descrição: Penetração mensal agregada por vendedor.

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- target_month (string, opcional) - Mês alvo
- vendedor_id (string, opcional) - Filtrar por vendedor

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/penetracao-mensal-seller?org_id=0&target_month=2025-12-01"

5.3 Evolução de Penetração por Vendedor

Endpoint: GET /api/executive/dashboard/penetracao-vendedor-evolucao

Descrição: Evolução temporal de penetração de um vendedor específico.

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- vendedor_id (string, obrigatório) - ID do vendedor
- months_back (int, opcional, padrão: 12) - Quantos meses para trás

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/penetracao-vendedor-evolucao?org_id=0&vendedor_id=131&months_back=12"

6. Policy e Governança

6.1 Policy Effectiveness

Endpoint: GET /api/executive/dashboard/policy-effectiveness

Descrição: Efetividade de políticas (success rate, delta score, etc).

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- policy_code (string, opcional) - Filtrar por política específica
- days_back (int, opcional, padrão: 30) - Quantos dias para trás

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/policy-effectiveness?org_id=0&days_back=30"

Resposta:

{
  "items": [
    {
      "policy_code": "INV_LOW_TURN",
      "total_outcomes": 150,
      "success_rate_pct": 85.3,
      "avg_delta_score": 6.2,
      "effectiveness_score": 91.5
    }
  ]
}

6.2 Attention Budget

Endpoint: GET /api/executive/dashboard/attention-budget

Descrição: Status do attention budget (limites e uso atual).

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- scope_type (string, opcional) - Tipo de escopo: SELLER, POLICY, GLOBAL
- scope_ref (string, opcional) - Referência do escopo

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/attention-budget?org_id=0"

6.3 Policy Versions

Endpoint: GET /api/executive/dashboard/policy-versions

Descrição: Histórico de versões de políticas.

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- policy_code (string, opcional) - Filtrar por política
- limit (int, opcional, padrão: 50) - Limite de resultados

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/policy-versions?org_id=0&policy_code=INV_LOW_TURN"

6.4 Policy Version Comparison

Endpoint: GET /api/executive/dashboard/policy-version-comparison

Descrição: Comparação entre duas versões de uma política.

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- policy_code (string, obrigatório) - Código da política
- version_from (int, obrigatório) - Versão inicial
- version_to (int, obrigatório) - Versão final

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/policy-version-comparison?org_id=0&policy_code=INV_LOW_TURN&version_from=1&version_to=2"

6.5 Seller Context

Endpoint: GET /api/executive/dashboard/seller-context

Descrição: Contexto completo da carteira de um vendedor (mix de marcas, overstock, risco médio).

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- vendedor_id (string, obrigatório) - ID do vendedor

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/seller-context?org_id=0&vendedor_id=131"

Resposta:

{
  "vendedor_id": "131",
  "portfolio_active_pct": 75.0,
  "brand_mix": {
    "BRAND_A": 40.0,
    "BRAND_B": 35.0,
    "BRAND_C": 25.0
  },
  "overstock_exposure_pct": 15.0,
  "avg_portfolio_risk": 2.5,
  "context_score": 85.5
}

6.6 Brand Radar

Endpoint: GET /api/executive/dashboard/brand-radar

Descrição: KPIs por marca (penetração, giro, % low-turn, % ruptura, contribuição no payout).

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- brand (string, opcional) - Filtrar por marca específica

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/brand-radar?org_id=0"

Resposta:

{
  "items": [
    {
      "brand": "BRAND_A",
      "penetration_pct": 45.0,
      "avg_turnover": 3.2,
      "low_turn_pct": 12.5,
      "rupture_pct": 5.0,
      "payout_contribution_pct": 40.0
    }
  ]
}

7. Agent Loop e Health

7.1 Decision Timeline

Endpoint: GET /api/executive/dashboard/decision-timeline

Descrição: Flight recorder do Agent Loop (Decision → Context → Action → Outcome).

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- decision_log_id (int, opcional) - Filtrar por decisão específica
- entity_type (string, opcional) - Filtrar por tipo de entidade
- entity_ref (string, opcional) - Filtrar por referência de entidade
- limit (int, opcional, padrão: 100) - Limite de resultados
- offset (int, opcional, padrão: 0) - Offset para paginação

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/decision-timeline?org_id=0&limit=50&offset=0"

Resposta:

{
  "items": [
    {
      "org_id": 0,
      "decision_log_id": 123,
      "decision_at": "2025-12-31T10:00:00",
      "decision_code": "INV_LOW_TURN:PRODUCT:12345",
      "decision_outcome": "ALLOW",
      "snapshot_id": 456,
      "snapshot_at": "2025-12-31T10:00:01",
      "agent_code": "CSuite.Sales.Agent",
      "entity_type": "PRODUCT",
      "entity_ref": "12345",
      "outcome_id": 789,
      "observed_outcome": "SUCCESS",
      "delta_score": 6.2
    }
  ],
  "total": 150,
  "limit": 50,
  "offset": 0
}

7.2 Decision Timeline Stats

Endpoint: GET /api/executive/dashboard/decision-timeline/stats

Descrição: Estatísticas agregadas do Decision Timeline.

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- days_back (int, opcional, padrão: 30) - Quantos dias para trás

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/decision-timeline/stats?org_id=0&days_back=30"

Resposta:

{
  "total_decisions": 1500,
  "decisions_with_snapshot": 1485,
  "decisions_with_outcome": 1200,
  "snapshot_coverage_pct": 99.0,
  "outcome_closure_pct": 80.0,
  "avg_delta_score": 5.8
}

7.3 Health Summary

Endpoint: GET /api/executive/dashboard/health-summary

Descrição: Resumo de saúde do Agent Loop (missing snapshots, executions sem outcome, etc).

Parâmetros:
- org_id (int, obrigatório) - ID da organização

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/health-summary?org_id=0"

Resposta:

{
  "org_id": 0,
  "health_status": "HEALTHY",
  "missing_snapshots": 5,
  "snapshot_without_execution": 2,
  "execution_without_outcome": 10,
  "outcome_collisions": 0,
  "last_updated": "2025-12-31T10:00:00"
}

7.4 Health Details

Endpoint: GET /api/executive/dashboard/health-details

Descrição: Detalhes de saúde do Agent Loop (lista de problemas).

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- health_type (string, opcional) - Tipo: MISSING_SNAPSHOTS, SNAPSHOT_WITHOUT_EXECUTION, EXECUTION_WITHOUT_OUTCOME, OUTCOME_COLLISIONS

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/health-details?org_id=0&health_type=MISSING_SNAPSHOTS"

7.5 Backfill Outcomes

Endpoint: POST /api/executive/dashboard/backfill-outcomes

Descrição: Preenche decision_log_id em outcomes existentes (matching retrospectivo).

Parâmetros:
- org_id (int, obrigatório) - ID da organização (0 = todas)
- days_back (int, opcional, padrão: 30) - Quantos dias para trás processar
- limit (int, opcional, padrão: 1000) - Limite de outcomes a processar
- min_score (int, opcional, padrão: 80) - Score mínimo para aceitar match
- use_v2 (bool, opcional, padrão: true) - Usar versão v2 com scoring

Exemplo:

curl -X POST "https://csuite.internut.com.br/context/api/executive/dashboard/backfill-outcomes?org_id=0&days_back=30&limit=100&min_score=80&use_v2=true"

Resposta:

{
  "status": "success",
  "data": {
    "outcomes_updated": 25,
    "total_outcomes_without_decision_log_id": 30,
    "matched_via_action_id": 10,
    "matched_via_retrospective": 15,
    "avg_match_score": 87.5
  },
  "timestamp": "2025-12-31T10:00:00"
}

8. What-if Engine

8.1 What-if: Low-Turn Bundle

Endpoint: GET /api/executive/dashboard/whatif/low-turn-bundle

Descrição: Simula impacto de empurrar produtos low-turn via bundles.

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- bundle_pct (float, opcional, padrão: 30.0) - % de produtos low-turn a empurrar
- discount_pct (float, opcional, padrão: 15.0) - Desconto médio do bundle

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/whatif/low-turn-bundle?org_id=0&bundle_pct=30.0&discount_pct=15.0"

Resposta:

{
  "scenario": "LOW_TURN_BUNDLE",
  "bundle_pct": 30.0,
  "discount_pct": 15.0,
  "estimated_sales_increase": 150000.0,
  "estimated_machines_sold": 450,
  "estimated_revenue_growth_pct": 12.5,
  "low_turn_reduction_pct": 25.0
}

8.2 What-if: Ruptura Reduction

Endpoint: GET /api/executive/dashboard/whatif/ruptura-reduction

Descrição: Simula impacto de reduzir ruptura.

Parâmetros:
- org_id (int, obrigatório) - ID da organização
- reduction_pct (float, opcional, padrão: 50.0) - % de redução de ruptura desejada

Exemplo:

curl "https://csuite.internut.com.br/context/api/executive/dashboard/whatif/ruptura-reduction?org_id=0&reduction_pct=50.0"

Resposta:

{
  "scenario": "RUPTURA_REDUCTION",
  "reduction_pct": 50.0,
  "estimated_sales_increase": 200000.0,
  "estimated_machines_sold": 600,
  "estimated_revenue_growth_pct": 18.5,
  "rupture_reduction_achievable": true
}

8.3 Executar Cenário What-if

Endpoint: POST /api/executive/dashboard/whatif/run-scenario

Descrição: Executa um cenário what-if completo e salva os resultados.

Parâmetros (body JSON):
- org_id (int, obrigatório) - ID da organização
- scenario_type (string, obrigatório) - Tipo: LOW_TURN_BUNDLE, RUPTURA_REDUCTION
- parameters (object, obrigatório) - Parâmetros do cenário
- actor (string, obrigatório) - Quem executou

Exemplo:

curl -X POST "https://csuite.internut.com.br/context/api/executive/dashboard/whatif/run-scenario" \
  -H "Content-Type: application/json" \
  -d '{
    "org_id": 0,
    "scenario_type": "LOW_TURN_BUNDLE",
    "parameters": {
      "bundle_pct": 30.0,
      "discount_pct": 15.0
    },
    "actor": "robsonrr"
  }'

Resposta:

{
  "status": "success",
  "scenario_id": 123,
  "scenario_type": "LOW_TURN_BUNDLE",
  "results": {
    "estimated_sales_increase": 150000.0,
    "estimated_machines_sold": 450,
    "estimated_revenue_growth_pct": 12.5
  },
  "created_at": "2025-12-31T10:00:00"
}

9. Exemplos Práticos

9.1 Dashboard Executivo Completo

# 1. KPIs principais
curl "https://csuite.internut.com.br/context/api/executive/dashboard/kpis?org_id=0"

# 2. Heatmap de vendedores
curl "https://csuite.internut.com.br/context/api/executive/dashboard/sellers?org_id=0"

# 3. Top rupturas
curl "https://csuite.internut.com.br/context/api/executive/dashboard/rupture?org_id=0"

# 4. Top low-turn
curl "https://csuite.internut.com.br/context/api/executive/dashboard/lowturn?org_id=0"

# 5. Inbox do dia
curl "https://csuite.internut.com.br/context/api/executive/dashboard/inbox?org_id=0"

9.2 Análise de Performance de Vendedor

# 1. Contexto do vendedor
curl "https://csuite.internut.com.br/context/api/executive/dashboard/seller-context?org_id=0&vendedor_id=131"

# 2. Evolução de penetração
curl "https://csuite.internut.com.br/context/api/executive/dashboard/penetracao-vendedor-evolucao?org_id=0&vendedor_id=131&months_back=12"

# 3. Status de metas
curl "https://csuite.internut.com.br/context/api/executive/dashboard/targets-status?org_id=0&vendedor_id=131"

# 4. Foco diário
curl "https://csuite.internut.com.br/context/api/executive/dashboard/daily-focus?org_id=0&vendedor_id=131"

9.3 Monitoramento de Políticas

# 1. Efetividade de políticas
curl "https://csuite.internut.com.br/context/api/executive/dashboard/policy-effectiveness?org_id=0&days_back=30"

# 2. Histórico de versões
curl "https://csuite.internut.com.br/context/api/executive/dashboard/policy-versions?org_id=0&policy_code=INV_LOW_TURN"

# 3. Comparar versões
curl "https://csuite.internut.com.br/context/api/executive/dashboard/policy-version-comparison?org_id=0&policy_code=INV_LOW_TURN&version_from=1&version_to=2"

# 4. Attention budget
curl "https://csuite.internut.com.br/context/api/executive/dashboard/attention-budget?org_id=0"

9.4 Agent Loop Health Check

# 1. Resumo de saúde
curl "https://csuite.internut.com.br/context/api/executive/dashboard/health-summary?org_id=0"

# 2. Detalhes de problemas
curl "https://csuite.internut.com.br/context/api/executive/dashboard/health-details?org_id=0&health_type=MISSING_SNAPSHOTS"

# 3. Estatísticas do timeline
curl "https://csuite.internut.com.br/context/api/executive/dashboard/decision-timeline/stats?org_id=0&days_back=30"

# 4. Backfill de outcomes (se necessário)
curl -X POST "https://csuite.internut.com.br/context/api/executive/dashboard/backfill-outcomes?org_id=0&days_back=30&limit=100"

9.5 Simulação What-if

# 1. Simular impacto de low-turn bundle
curl "https://csuite.internut.com.br/context/api/executive/dashboard/whatif/low-turn-bundle?org_id=0&bundle_pct=30.0&discount_pct=15.0"

# 2. Simular redução de ruptura
curl "https://csuite.internut.com.br/context/api/executive/dashboard/whatif/ruptura-reduction?org_id=0&reduction_pct=50.0"

# 3. Executar e salvar cenário
curl -X POST "https://csuite.internut.com.br/context/api/executive/dashboard/whatif/run-scenario" \
  -H "Content-Type: application/json" \
  -d '{
    "org_id": 0,
    "scenario_type": "LOW_TURN_BUNDLE",
    "parameters": {"bundle_pct": 30.0, "discount_pct": 15.0},
    "actor": "robsonrr"
  }'

10. Autenticação

Nota: Se a autenticação estiver habilitada, você precisará incluir o token JWT:

# Com autenticação
curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  "https://csuite.internut.com.br/context/api/executive/dashboard/kpis?org_id=0"

11. Documentação OpenAPI

Swagger UI: https://csuite.internut.com.br/context/docs

OpenAPI JSON: https://csuite.internut.com.br/context/openapi.json

12. Troubleshooting

Erro: "Not Found"

Verifique se o serviço csuite-context está rodando
Verifique se a imagem Docker foi atualizada
Verifique se o router executive_dashboard está registrado

Erro: "Method Not Allowed"

Verifique se está usando o método HTTP correto (GET vs POST)
Alguns endpoints são POST, não GET (ex: /backfill-outcomes, /whatif/run-scenario)

Erro: "Access Denied"

Verifique se a autenticação está configurada corretamente
Verifique se o token JWT é válido

Dados vazios ou null

Verifique se há dados no banco para o org_id fornecido
Alguns endpoints têm fallback para org_id=0 se não houver dados

13. Integração com Gateway

Nota: Alguns endpoints também estão disponíveis via gateway:

https://csuite.internut.com.br/api/executive/radar/*

O gateway faz proxy para csuite-context, então ambos funcionam.

Última atualização: 2024-01-15
Versão: v1.1 (STABLE)

Guia de Uso - APIs /api/executive/dashboard

📋 Índice

1. Dashboard Executivo

1.1 KPIs Consolidados

1.2 Vendedores (Heatmap)

1.3 Vendas Mensais

1.4 Ações Abertas

2. Estoque e Produtos

2.1 Ruptura Top 20

2.2 Low-Turn Top 20

2.3 Low-Turn Mensal

2.4 Radar de Estoque

3. Inbox e Campanhas

3.1 Inbox do Dia

3.2 Inbox Top 20

4. Metas e Targets

4.1 Targets Dinâmicos

4.2 Status de Targets

4.3 Foco Diário

5. Penetração e Evolução

5.1 Evolução de Penetração

5.2 Penetração Mensal por Seller

5.3 Evolução de Penetração por Vendedor

6. Policy e Governança

6.1 Policy Effectiveness

6.2 Attention Budget

6.3 Policy Versions

6.4 Policy Version Comparison

6.5 Seller Context

6.6 Brand Radar

7. Agent Loop e Health

7.1 Decision Timeline

7.2 Decision Timeline Stats

7.3 Health Summary

7.4 Health Details

7.5 Backfill Outcomes

8. What-if Engine

8.1 What-if: Low-Turn Bundle

8.2 What-if: Ruptura Reduction

8.3 Executar Cenário What-if

9. Exemplos Práticos

9.1 Dashboard Executivo Completo

9.2 Análise de Performance de Vendedor

9.3 Monitoramento de Políticas

9.4 Agent Loop Health Check

9.5 Simulação What-if

10. Autenticação

11. Documentação OpenAPI

12. Troubleshooting

Erro: "Not Found"

Erro: "Method Not Allowed"

Erro: "Access Denied"

Dados vazios ou null

13. Integração com Gateway

🔊 Text-to-Speech

Guia de Uso - APIs `/api/executive/dashboard`