Documentacao

Gestão Estratégica: OKRs, KPIs, benchmarks e dashboard

OKRs, KPIs com histórico, benchmarks (até 3 por produto) e dashboard estratégico por produto e workspace, com paridade na UI e no MCP.

Atualizado em

A Gestão Estratégica da XBASE junta num lugar só o planejamento (objetivos anuais, trimestrais ou mensais com resultados-chave mensuráveis), os indicadores que você acompanha (biblioteca de KPIs com histórico), os benchmarks do seu produto (até três empresas de referência por produto) e um dashboard consolidado por produto e por workspace. Tudo tem paridade completa na interface e pelo MCP — os agentes de IA conseguem cadastrar, consultar e atualizar sem passar pela tela.

Esta tela não substitui o que já existe em Marketing → Projetos (a declaração de KPIs de cada campanha) ou em Marketing → Canais de Aquisição → Estratégias (as metas comerciais do plano). Ela complementa: o OKR é o objetivo mensurável anual/trimestral/mensal da marca, ligável a um produto, a uma estratégia de aquisição e a um projeto de marketing.

O que você cadastra

RecursoO que é
Objetivo estratégico (OKR)Um objetivo da marca, com horizonte ano, trimestre ou mês, dono, status (rascunho → ativo → done/off-track) e vínculos opcionais a produto, estratégia e projeto.
Resultado-chave (KR)Um resultado mensurável do OKR, com valor inicial, meta, valor atual, direção (sobe/desce) e prazo. Cada KR tem histórico de medições.
KPIUm indicador canônico do workspace, com key única (ex.: mrr_brl, cac), categoria (aquisição, comercial, SaaS, produto, financeiro, marketplace, consumo), unidade, fórmula em texto, fonte, periodicidade, meta e histórico de medições (idempotente por dia).
BenchmarkEmpresa de referência, com posicionamento, modelo, preços, estratégias de marketing/aquisição/funil/distribuição/parcerias/retenção e aprendizados adaptáveis. Até três por produto. Cada campo pode ser marcado como fato, hipótese ou estimativa.

O dashboard estratégico

A tela Dashboard agrega, por workspace e opcionalmente por produto:

  • os OKRs ativos com a média de progresso dos KRs (respeitando a direção de cada um);
  • os KPIs por categoria com o último valor medido e o percentual em relação à meta;
  • os itens em risco (KRs com prazo vencido e meta não atingida);
  • os benchmarks do produto.

Converter aprendizado em iniciativa

No benchmark, o botão Converter aprendizado em iniciativa transforma o campo Ideias adaptáveis em uma MarketingAction apontando para o projeto ou a estratégia do produto (se existirem). O id da ação criada fica em spawnedActionIds do benchmark — você vê o histórico de aprendizados virados em iniciativa.

Agentes de IA e MCP

Todas as operações da tela estão disponíveis como ferramentas MCP (prefixo strategic_):

  • strategic_list_objectives, strategic_upsert_objective
  • strategic_list_key_results, strategic_upsert_key_result
  • strategic_record_key_result_measurement, strategic_list_key_result_measurements
  • strategic_list_kpis, strategic_upsert_kpi
  • strategic_record_kpi_measurement, strategic_list_kpi_measurements
  • strategic_list_benchmarks, strategic_upsert_benchmark, strategic_compare_benchmarks
  • strategic_convert_benchmark_learning_to_action
  • strategic_link_strategy_project
  • strategic_get_strategic_dashboard

Leitura funciona com qualquer credencial MCP; escrita exige o token MCP pessoal (xmcp_). Conexões de agente só leem. Toda ferramenta respeita o isolamento do workspace do token.

O que já existe hoje e não duplica

  • A declaração de KPIs de projeto (kpis do MarketingProject) continua como alvo por campanha; as medições moram em strategic_kpi_measurement.
  • As metas comerciais da AcquisitionStrategy (goals) continuam como a declaração do plano; o OKR é o objetivo da marca, ligável à estratégia.
  • Os nove Planos 2027 rascunhados em Canais de Aquisição → Estratégias são importados pelo script strategic-2027-import.ts sem duplicar: cada um vira um StrategicObjective com importedFrom.source="acquisition_strategy" e fromRequest guardando a origem.

Permissões

  • Ler: membro ACTIVE do workspace (qualquer cargo).
  • Gravar: cargo com MANAGE_INTEGRATIONS (ou ADMINISTRATOR). Token de agente e chave de API só leem.

Nesta página