NEAD Hub · Documentação
O Lamarck Hub é a aplicação de Legal Ops da Lamarck Sociedade de Advogados. Este portal organiza a documentação do produto por domínio, para que engenheiros e arquitetos registrem contexto, dados, necessidades, fluxos, navegação, contratos e regras de negócio com origem e revisão identificáveis.
Projetos do Hub
| Repositório | Responsabilidade | Organização principal |
|---|---|---|
nead-hub | Cliente web: experiência de navegação, composição de telas e integração com a API. | Next.js App Router em app/; componentes, formulários e domínios locais em lib/; snapshot OpenAPI em contracts/. |
nead-hub-api | Backend: fronteira HTTP, regras de negócio, persistência e autorização. | Módulos NestJS em src/; recursos compartilhados em src/common, configuração em src/config, banco em src/database e adaptadores em src/integrations. |
nead-hub-docs | Portal de documentação e processo editorial. | Páginas MDX em src/app, domínios ainda ocultos em content/modulos, catálogo em src/data e validações em scripts/. |
Arquitetura em resumo
Navegador → nead-hub (Next.js) → HTTP validado → nead-hub-api (NestJS) → PostgreSQL e integrações
O front organiza a experiência web e valida as fronteiras que consome. A API concentra as decisões de negócio, a persistência e a autorização efetiva. O Appwrite participa da identidade e da sessão; o front utiliza essa integração no servidor. A API expõe seu contrato OpenAPI, e o front mantém um snapshot versionado para orientar a integração.
Como a documentação está organizada
Cada domínio tem seis camadas: Overview → Entidades e relacionamentos → Histórias do usuário → Sitemap → Regras de negócio → API Reference. Fluxos críticos complementam as histórias a que pertencem. A estrutura da documentação explica o propósito e o conteúdo esperado de cada uma. O guia de contribuição orienta autoria, revisão e publicação.
O estado exibido em cada página informa se o conteúdo aguarda definição, está em rascunho ou recebeu aprovação humana registrada. Os domínios catalogados aparecem na navegação conforme o refinamento começa.