bi-nomenclatura

사용 방법

설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.

npx skills add https://github.com/officetuning/skill-library --skill bi-nomenclatura

시작 전 확인

설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.

원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Padrão Corporativo de Nomenclatura

Técnico para quem desenvolve, intuitivo para quem consome, previsível para quem mantém. O nome revela o papel do objeto antes de ele ser aberto.

Regra de ouro

SQL é estrutura. Power BI é comunicação. Prefixo técnico só existe na camada física. Todo objeto visível no modelo usa nome de negócio. Colunas técnicas que sobram (chaves, FKs) ficam ocultas.

Motivo além da leitura humana: Copilot e agentes de IA leem nomes ao pé da letra. TabFatVenda piora respostas em linguagem natural; Vendas ajuda.

SQL Físico → Views Semânticas → Power Query → Modelo Semântico → Relatórios

1. Prefixos da camada física

Prefixo	Objeto	Exemplo
`Tab`	Tabela	`TabDimCliente`, `TabFatVenda`
`Vw`	View	`VwFatVenda`
`Pr`	Procedure	`PrAtualizarEstoque`
`Fn`	Função (SQL ou M)	`FnCalcularMargem`
`Cns`	Consulta de ETL (Power Query)	`CnsClienteTratado`

2. Papel dimensional

Papel	Padrão	Exemplo
Dimensão	`TabDimObjeto`	`TabDimCliente`, `TabDimCalendario`
Fato	`TabFatEvento`	`TabFatVenda`, `TabFatPedido`
Ponte N:N	`TabPonAB`	`TabPonClienteProduto`
Monolítica	`TabFltObjeto`	`TabFltVendasCamisetas`

TabFlt é uma tabela achatada que junta fato e dimensões. Serve para escopo pequeno ou export de terceiros. Quando o volume ou o reuso crescer, migre para TabDim/TabFat.

❌ Proibido nome genérico: TabFatDados, TabFatBase.

3. Convenções gerais (camada física)

Singular: TabDimCliente ✔️ │ TabDimClientes ❌
PascalCase: TabFatVendaMensal ✔️ │ tab_fat_venda ❌
Sem caractere especial, espaço no início ou fim, ou emoji.

4. Campos

Camada	Padrão	Exemplo
Física (SQL)	PascalCase por extenso	`CodigoCliente`, `ValorVenda`
Semântica (Power BI)	Nome amigável com espaços	`Código do Cliente`, `Valor da Venda`

❌ Abreviação proibida: CodCli, DtFat, VlrTot.

Em SQL, use sempre AS [Nome Amigável] na view semântica: reduz renomeação no Power Query e antecipa a camada semântica.

sql

-- View semântica: estrutura física por dentro, nome de negócio por fora
CREATE VIEW VwFatVenda AS
SELECT
    v.CodigoCliente AS [Código do Cliente],
    v.DataVenda     AS [Data da Venda],
    v.ValorVenda    AS [Valor da Venda]
FROM TabFatVenda AS v;

5. Fronteira física × semântica

Objeto	Física (SQL/ETL/PQ)	Semântica (visível)
Dimensão	`TabDimCliente`	`Cliente` (singular)
Fato	`TabFatVenda`	`Vendas` (plural aceito em fato)
Coluna	`ValorVenda`	`Valor da Venda`
Medida	—	`Total de Vendas`, `% vs Meta`

6. Medidas e variáveis DAX

Medida: nome amigável com espaços — Total de Vendas, Ticket Médio.
Variação: [Base] [Período] ([Unidade]) — Total de Vendas (ytd), Margem Bruta (%).
Contagem: prefixo # — # Pedidos, # Clientes.
Variável DAX: camelCase com prefixo v — vTotalVendas, vMetaMes.

7. Comparativo temporal: AV/AA/Δ/Δ%/Δi

Padrão oficial para qualquer medida que compara o período corrente com o mesmo período do ano anterior. Use o símbolo literal, nunca por extenso.

Sigla	Significado	Medida
`AV`	Ano Vigente (período corrente)	`Total de Vendas AV`
`AA`	Ano Anterior (mesmo período)	`Total de Vendas AA`
`Δ`	Variação absoluta (AV − AA)	`Δ Total de Vendas`
`Δ%`	Variação percentual	`Δ% Total de Vendas`
`Δi`	Farol sobre a variação: ✔️ positivo │ ⚠️ estável │ ❗ negativo	`Δi Total de Vendas`

dax

Total de Vendas AV = SUM ( TabFatVenda[ValorVenda] )

Total de Vendas AA =
CALCULATE ( [Total de Vendas AV], SAMEPERIODLASTYEAR ( TabDimCalendario[Data] ) )

Δ Total de Vendas = [Total de Vendas AV] - [Total de Vendas AA]

Δ% Total de Vendas = DIVIDE ( [Δ Total de Vendas], [Total de Vendas AA] )

Δi Total de Vendas =
VAR vVariacao = [Δ% Total de Vendas]
RETURN
    SWITCH (
        TRUE (),
        ISBLANK ( vVariacao ), BLANK (),   -- sem ano anterior: sem farol
        vVariacao > 0, "✔️",
        vVariacao = 0, "⚠️",
        "❗"
    )

⚠️ SAMEPERIODLASTYEAR exige a tabela de calendário marcada como Tabela de Datas.

Os nomes físicos no exemplo (TabFatVenda, TabDimCalendario) aparecem porque a referência DAX usa o nome da tabela no modelo. Se as tabelas já foram renomeadas para a camada semântica, troque por Vendas[Valor da Venda] e Calendário[Data].

Checklist ao criar ou renomear

O prefixo revela o papel? (física)
Singular e PascalCase? (física)
Objeto visível usa nome de negócio, sem prefixo técnico?
Campos semânticos com nome amigável via alias ou renomeação?
Nenhuma abreviação críptica sobrou?
Comparativos temporais seguem AV/AA/Δ/Δ%/Δi?