Decisões

ADR-0004 — Site da arquitetura

Status: aceita
Data: 2026-10-18
Cumpre: ORG-0005, ORG-0010, ORG-0018, ORG-0019, ORG-0023

Contexto

A documentação precisa ser lida por pessoas que não abrem o repositório, inclusive sem rede, e com a cara da Hibex. Renderizar Markdown no navegador depende de bibliotecas de fora e não funciona offline.

Decisão

Um site estático, gerado dos Markdown por site/gerar.mjs (com marked em versão fixa), em site/dist/: HTML pronto, que funciona sem rede.
Usa o design system da Hibex (cópia em vendor/hibex/, família cobalt), com o verificador sem erro antes de toda entrega.
Os rabiscos entram inline nas páginas e seguem a Aparência escolhida (Sistema, Claro, Escuro).
O site é aberto e indexado, como o do design system, em architecture.enterprise.hibex.net.
Publicação por imagem Docker (nginx-unprivileged, não-root) e Kamal, com segredos só por referência; quem publica é o mantenedor.

Alternativas consideradas

Alternativa	Por que não
Ler os Markdown no GitHub	Por que não: sem a identidade da Hibex; rabiscos sem o tema escolhido
Gerador de sites pronto (MkDocs, Docusaurus)	Por que não: traz o próprio visual, que concorre com o design system
Renderizar Markdown no navegador	Por que não: depende de rede e de bibliotecas de fora

Consequências

Mudou um documento ou um rabisco: regere o site.
O que falta no design system para o site vira pedido (docs/design-system/pedidos.md).