venkatv-hub/powerbi-dashboard-builder

Construtor de Painéis Power BI

Transforma uma especificação de painel (veja bi-dashboard-design/references/dashboard-spec.md) em um artefato funcional do Power BI. O conhecimento de domínio vem da habilidade de domínio; as regras de layout e estilo vêm de bi-dashboard-design. Esta habilidade cobre os aspectos específicos do Power BI.

Escolha primeiro o modo de construção

Verifique o que está disponível e informe ao usuário qual modo você está usando:

Modo	Quando	O que você produz
A. Modelo ao vivo via MCP/CLI	O servidor MCP de Modelagem do Power BI (@microsoft/powerbi-modeling-mcp) ou pbi-cli está conectado e o Power BI Desktop tem o modelo aberto	Tabelas, relacionamentos, medidas criados diretamente no modelo aberto; relatório construído como arquivos PBIR
B. Arquivos de projeto PBIP	Você pode escrever arquivos mas não tem conexão ao vivo	Uma pasta de projeto .pbip: <Nome>.SemanticModel/definition/*.tmdl e <Nome>.Report/definition/ (PBIR) que o usuário abre no Power BI Desktop
C. Kit de construção	Nem arquivos nem ferramentas são práticos (ex.: apenas chat)	Script de medidas DAX, trechos TMDL, JSON de tema e uma folha de construção página por página que um desenvolvedor segue

Prefira A, depois B. No modo B, lembre o usuário de ativar a opção de salvar PBIP e "Armazenar modelo semântico usando formato TMDL" nas funcionalidades de visualização do Power BI Desktop se a versão ainda as tiver como pré-visualização.

Fluxo de trabalho

1. Leia a especificação e o arquivo de métricas do domínio. Cada medida que você criar deve corresponder a uma definição no arquivo <domínio-skill>/references/metrics.md da habilidade de domínio.
2. Modele o esquema estrela (references/tmdl-patterns.md):
   • Uma tabela fato por granularidade na especificação; dimensões conformadas entre fatos.
   • Uma tabela Date dedicada marcada como tabela de data, contínua, cobrindo todas as datas dos fatos, com colunas fiscais quando o domínio usar calendário fiscal.
   • Relacionamentos um-para-muitos unidirecionais da dimensão para o fato. Use bidirecional apenas com uma justificativa por escrito. Datas de papéis (fatura vs vencimento vs pagamento): um relacionamento ativo, os outros inativos e ativados com USERELATIONSHIP nas medidas.
   • Oculte chaves estrangeiras e colunas numéricas brutas que são substituídas por medidas; defina summarizeBy: none em chaves, IDs e números de ano/mês.
   • Colunas de ordenação para nomes de meses e para rótulos de faixas (aging, bands).
3. Escreva medidas (references/dax-patterns.md): uma tabela _Measures, pastas de exibição por tema (ex.: 01 Receita, 02 Margem), uma string de formato e uma descrição em cada medida. Construa primeiro as medidas base, depois as razões, depois a inteligência de tempo, depois os auxiliares de exibição (delta %, seta, cor de status).
4. Construa as páginas do relatório (references/report-pbir.md): mapeie cada componente da especificação para um visual, posicione-o na tela de 1280×720 usando o mapeamento de grade, aplique o tema de bi-dashboard-design/references/theme-tokens.md, adicione páginas de detalhamento e um marcador de reset.
5. Segurança: se a especificação tiver row_level, crie a função RLS com um filtro DAX na dimensão relevante e documente como atribuir membros no Serviço.
6. Verifique: execute as verificações DAX em references/dax-patterns.md#verification (totais correspondem à fonte, inteligência de tempo retorna valores para o período mais recente, nenhum KPI em branco), depois execute a lista de verificação de aceitação de bi-dashboard-design. Relate o que você não pôde verificar.

Mapeamento de grade (tela 1280 × 720)

• Margens 16 px; largura útil 1248 px; 12 colunas de 88 px com espaçamentos de 16 px.
• Extensão de coluna c → largura c*88 + (c-1)*16 px; x = 16 + col_index*104.
• Uma unidade de altura = 56 px com espaçamentos de 16 px (linha de cabeçalho ≈ 64 px).
• Páginas longas: prefira uma segunda página em vez de rolagem vertical para L1/L2; páginas de detalhe L3 podem usar uma tela mais alta (1280 × 1440) para tabelas.

Mapeamento visual

Componente da especificação	Visual do Power BI	Notas
kpi_card	Cartão (novo) / KPI	Rótulo de referência para comparação; cor condicional via medida
trend_line	Gráfico de linhas	Alvo como segunda medida ou linha constante; 13 meses via filtro de data relativo ou janela de medida
ranked_bar	Barras agrupadas	Filtro Top N + "Outros" via uma medida de segmentação dinâmica se necessário
variance_bar	Barras agrupadas na medida de variância	Cor por regra no sinal de Var × direção
waterfall	Cascata	Campo de detalhamento = dimensão do driver
stacked_bar	Barras 100% empilhadas
matrix	Matriz	Hierarquia de linhas, valores Real/Orçamento/Var/Var%, elementos de célula em Var%
exception_table	Tabela	Filtro Top N ou severidade, ícones condicionais, detalhamento habilitado
aging_buckets	Colunas agrupadas	Coluna de faixa ordenada pela coluna de ordem da faixa
funnel	Funil ou barras	Barras ordenadas pela ordem do estágio é mais legível
map	Mapa do Azure / mapa preenchido	Apenas se o locatário permitir mapas
slicer	Segmentação (lista suspensa ou bloco)	Sincronizar segmentações entre páginas para Período e Org

Diretrizes

• Nunca codifique datas como "2026-10-31" em medidas; derive "último período completo" dos dados ou de um parâmetro.
• Use DIVIDE() para toda razão. Nunca calcule a média de uma razão entre linhas.
• Prefira medidas a colunas calculadas; prefira transformações do Power Query / warehouse a tabelas calculadas em DAX.
• Não importe colunas sensíveis (SSN, nome de paciente, detalhe de salário) a menos que a especificação solicite e RLS/OLS esteja em vigor.
• Mantenha Auto data/hora desligado; ele incha o modelo e entra em conflito com a tabela Date.

Arquivos de referência

• references/tmdl-patterns.md – sintaxe TMDL para tabelas, colunas, relacionamentos, tabela Date, funções. Leia no modo A/B.
• references/dax-patterns.md – DAX reutilizável: razões, inteligência de tempo, instantâneos semiaditivos, faixas de aging, Top N + Outros, auxiliares de exibição, consultas de verificação.
• references/report-pbir.md – layout da pasta PBIR, essenciais do JSON do visual, detalhamento, marcadores e o formato da folha de construção para o modo C.