Arquitetura do portal

Propósito

Este portal oferece organização, roteiros de preenchimento e rastreabilidade para a documentação do NEAD Hub. O conteúdo do produto é definido pelos engenheiros e arquitetos responsáveis.

Organização

Cada domínio possui sete camadas: overview, entidades e relacionamentos, histórias do usuário, casos de uso, sitemap, API Reference e regras de negócio. Os nomes do catálogo são espaços reservados; suas fronteiras e responsabilidades aguardam definição humana.

Fluxo editorial

O responsável fornece as definições e indica o escopo. O conteúdo é organizado em rascunho, com autoria e referência. A revisão humana resolve pendências e registra a aprovação. Alterações de significado voltam a rascunho até nova aprovação.

A IA pode organizar material e auxiliar a edição. Não deve preencher lacunas por inferência de código nem criar regras, entidades, fluxos ou contratos por conta própria.

Implementação do portal

Next.js App Router, MDX, Tailwind CSS e busca local FlexSearch. O build produz arquivos estáticos hospedados no Appwrite Sites, projeto Lamarck Hub. A identidade visual usa a escala Gold customizada, com cor principal #7d661d.

Diagramas Mermaid podem ser adicionados quando fornecidos ou aprovados pelos responsáveis. O componente apresenta ampliação e código textual. Não há importação automática de conteúdo dos repositórios.

Manutenção

As decisões técnicas do portal estão em architecture.md. O guia de contribuição descreve preenchimento, estados editoriais e validação. Aprovar um build ou deploy não significa aprovar regras de negócio.