Começar
Decisões
Toda escolha com alternativas é uma ADR: o que se decidiu, o que se descartou e por quê.
Registro de decisões
| ADR | Decisão | Estado |
|---|---|---|
| 0001 | Registrar decisões como ADR | aceita |
| 0002 | Português brasileiro, com nomes de código em inglês | aceita |
| 0003 | Desenvolvimento assistido por IA com Git e publicação nas mãos do mantenedor | aceita |
| 0004 | Estudo guiado por capítulos revisados, sem OpenSpec | aceita |
| 0005 | Referências congeladas no repositório, com binários em Git LFS | aceita |
| 0006 | Cores semânticas próprias, em pares texto/fundo por tema | aceita |
| 0007 | Tipografia: escala de seis passos, corpo em 16 px, sem negrito sintético, fontes auto-hospedadas | aceita |
| 0008 | Superfícies, forma e fundo: vidro só no cromo, raios e elevação em escala, colinas nos dois temas | aceita |
| 0009 | Campos, validação e erros: o servidor é a única voz, o erro fica abaixo do campo sem desalinhar nada | aceita |
| 0010 | Ações e disposição: botão mais pesado que o campo, hierarquia em vez de cor, edição em lista na largura toda | aceita |
| 0011 | Mensagens como componente próprio: canto quase reto, barra lateral, cinco tipos e regra de ícone | aceita |
| 0012 | Bootstrap 5.3 como referência e escola, não como base; o destino é um design system próprio com site de documentação | aceita |
| 0013 | O design system está acima dos produtos; o stack-projetos é exemplo, não fonte | aceita |
| 0014 | Playwright próprio em eng/, para renderizar pranchas e capturas | aceita |
| 0015 | Plataforma web primeiro, JavaScript como melhoria, nenhuma tecnologia de servidor pressuposta | aceita |
| 0016 | Diálogo de confirmação no lugar do window.confirm(); formulário nunca em diálogo | aceita |
| 0017 | Navegação: três menus, três cantos, iguais em todo sistema Hibex | aceita |
| 0018 | Três faixas de largura, três larguras de conteúdo, camada superior do navegador para o que sobrepõe | aceita |
| 0019 | Selos: quatro marcas pequenas com formas próprias e um vocabulário de estados em cinco papéis | aceita |
| 0020 | Vazios em três tipos, no lugar do conteúdo; uma página de exceção para todo sistema | aceita |
| 0021 | Carregamento por região com aria-busy e aviso atrasado; falha como mensagem; sem esqueleto | aceita |
| 0022 | Tema por elemento, tamanho de título separado do nível, sem contorno sutil por papel | aceita |
| 0023 | Tabelas, listas e números: alinhamento pelo tipo, sinal sempre, nome em vez de identificador, lista no celular | aceita |
| 0024 | Gráficos: forma pela pergunta, escala redonda, três séries validadas, rampa de um tom, estado com as cores de estado | aceita |
| 0025 | Landings: o mesmo design system em escala de vitrine, faixas da marca escuras e o resto no tema do visitante | aceita |
| 0026 | Um conjunto de ícones: Lucide, em SVG embutido, com três tamanhos e regras de uso | aceita |
| 0027 | Símbolo da marca em três versões, tamanho mínimo e grafismo só em superfície de marca | aceita |
| 0028 | Logotipo do arquivo, símbolo em três versões por tamanho e ativos de uso gerados a partir do vetor do designer | aceita |
| 0029 | Logos de sistema: o símbolo sobre ladrilho em degradê, uma família de cor por sistema, variantes clara e escura | aceita |
| 0030 | Moeda Hibex: o nome por extenso, "H$" onde iria "R$", e uma submarca a desenvolver | aceita |
| 0031 | Arquitetura de marca: marca-mãe, submarcas de sistema e subprodutos; este repositório como fonte da verdade | aceita |
| 0032 | Biblioteca (fase 2): CSS nativo em camadas, prefixo hx-, um passo de build mínimo e entrega por pasta versionada | aceita |
| 0033 | Biblioteca, primeira entrega: um menu só para as duas faixas, tabela que vira lista sem outra marcação, fontes dos pacotes oficiais | aceita |
| 0034 | Site de documentação: HTML estático gerado aqui, feito com a própria biblioteca, revisado como artifact privado | proposta |
| 0035 | "Carregar mais" em vez de paginação: o próximo bloco se junta ao que está na tela, sempre com filtro, e o botão nunca some | proposta |
| 0036 | Tipografia em quatro papéis: títulos, texto, código e rabisco, cada fonte no seu lugar | proposta |
| 0037 | Estilo de rabisco: a ideia antes da tela, desenhada com os tokens da marca | proposta |
| 0038 | Componentes complementares: cartão com variantes, grupo de botões de ação, barra de progresso e giro em tamanhos | proposta |
| 0039 | Publicação do site de documentação: design.enterprise.hibex.net, imagem nginx estática, Kamal no VPS de aplicações web | aceita |
Origem: docs/decisoes/README.md · ADR-0001 · desde a versão 0.1.0