Code Library

Arquitetura e governança

O Code Library é um repositório de código reaproveitável — não um manual de linguagem. Ele é irmão do Function Library, que serve para consultar documentação de DAX e M. Os dois se referenciam, mas não se fundem: aqui você copia código pronto; lá você entende a linguagem.

Taxonomia de três níveis

Linguagem → Tipo de Objeto → Categoria/Biblioteca

Nem todo tipo de objeto existe em toda linguagem. A validade de cada combinação vive em tabelas de referência no banco (linguagens, tipos de objeto, ambientes de execução), nunca em regra fixa de código. Campos específicos de cada linguagem ficam num campo de metadados flexível — adicionar uma linguagem nova não exige coluna nova nem migração de estrutura.

Fluxo de publicação

  1. 1. Autoria no Git

    Todo item nasce como arquivo no repositório Git. O Git é a fonte canônica: nome, código, documentação embutida e metadados vivem lá.

  2. 2. Pull Request

    Alterações entram por PR. Nada é editado direto no banco nem no app — a rastreabilidade do histórico é parte da governança.

  3. 3. Revisão

    A revisão valida convenção de nomes, documentação embutida obrigatória da linguagem, categoria/biblioteca e dependências declaradas.

  4. 4. Merge e sincronização

    Após o merge, o processo de sync popula o banco de publicação com os itens aprovados e seus metadados.

  5. 5. Consulta no app

    O app nunca lê o Git em tempo real. Ele consulta apenas o banco de publicação, o que mantém a navegação rápida e previsível.

Status desta versão

  • · Banco, schema e taxonomia extensível: prontos.
  • · Leitura pública do catálogo: liberada; escrita restrita a administradores.
  • · Navegação por linguagem e busca: shell no ar, ainda sem itens.
  • · Importação do catálogo, área administrativa e login: próximas etapas.