Baluarte Family Core
Foundations, componentes, padrões, shell, acessibilidade e comportamento compartilhados.
balu.css · components.css · patterns.cssMigração · convergência governada
Um percurso para substituir desvios legados sem perder função, conteúdo ou regras de negócio.
As três camadas protegem a unidade do portfólio sem confundir identidade visual com contexto de negócio.
Foundations, componentes, padrões, shell, acessibilidade e comportamento compartilhados.
balu.css · components.css · patterns.cssInventário, mapa de legado, piloto, métricas e exceções temporárias. Não contém tema visual.
products/<produto>/Conteúdo, dados e fluxos do domínio construídos com a mesma linguagem da família.
sem overrides de identidadeA convergência não termina na troca de tema. Cada produto mantém um ledger único para cinco trilhas e avança por evidência. ClickAgents pode iniciar o piloto, mas os demais produtos consomem o Baluarte — nunca uma cópia do CSS do ClickAgents.
| Trilha | Inclui | Prova de conclusão |
|---|---|---|
| Foundations | Cor, tipo, spacing, shape, elevação, motion e ícones | Displays 28–64/500, títulos 18–24/550, fonte/fallback e zero override |
| Shell e navegação | Header, sidebar/drawer, spacing, scroll, breakpoints, foco e motion | Título–item 10px, ícones persistentes no rail, preferências restauradas e reversões aprovadas |
| Componentes e estados | Anatomia, densidade, hover, foco, loading, empty e error | API pública sem dependência do portal |
| Padrões e domínio | Composição, conteúdo, permissões, dados e extensões | Variação de domínio sem identidade paralela |
| Qualidade e retirada | Regressão, performance, métricas, legado e exceções | Legado removido ou exceção com prazo |
Tipografia, papéis de cor, forma, elevação, densidade e motion vêm do mesmo núcleo.
Estados, espaçamento, foco, acessibilidade e API pertencem ao catálogo compartilhado.
Shell, navegação, painéis e hierarquia escolhem padrões governados, não composições privadas.
Rótulos, feedback, erros e orientação seguem princípios editoriais comuns.
| Obrigatório em todos | Pode variar por domínio | Não pode variar |
|---|---|---|
| Tokens semânticos, tipografia, shape, motion e iconografia | Dados, conteúdo, permissões, vocabulário especializado | Paleta principal, foco, status e hierarquia tipográfica |
| Componentes e estados do catálogo | Composição entre padrões aprovados | Anatomia privada do mesmo componente |
| Shell e receitas responsivas governadas | Presença de módulos conforme a tarefa | Um shell visual paralelo por produto |
| Regras de conteúdo e acessibilidade | Sequência de fluxo e regras de negócio | Tom contraditório, atalhos inacessíveis ou feedback inconsistente |
O perfil descreve como um produto converge. Ele não funciona como tema, pacote visual ou permissão para redefinir o core.
products/
└── <produto>/
├── README.md
├── adoption-checklist.md
├── legacy-map.md
└── exceptions.md
/* Produto consome a identidade comum. */
@import "balu.css";
@import "components.css";
@import "patterns.css";
/* Proibido: criar tema visual por produto. */
[data-product="..."] {
--action: ...;
--accent: ...;
}