Gleam.br Wiki

ADR-0021: Reestruturação da Árvore de Conteúdo por Domínios, Blog, Wiki e Hub Central | Wiki

Documentação de engenharia e especificações técnicas da Gleam-BR.

ADR-0021: Reestruturação da Árvore de Conteúdo por Domínios, Blog, Wiki e Hub Central

Este documento especifica a decisão de arquitetura para a reestruturação da organização de arquivos em /content/ no motor gbr_ssg, segregando os conteúdos por domínios corporativos, portais e hub central.

1. Contexto e Motivação

Atualmente, os arquivos de conteúdo em apps/gbr_ssg/content/ misturam landing pages de diferentes marcas (/fvideen/, /comunidade/, raiz) com documentações e especificações. Para tornar a manutenção da base de conteúdo limpa, auditável e alinhada com o nosso Edge Router (_worker.js), organizaremos a árvore física do diretório /content/ refletindo diretamente a arquitetura multi-domínio da startup.


2. Decisão Arquitetural

  1. **Topologia Física de /content/:** - **/content/fvideen.com.br/:** Landing pages e conteúdos institucionais da holding FVideen (mapeado para /dist/fvideen/ ou domínio fvideen.com.br). - **/content/gleam-lang.com.br/:** Landing page e páginas da consultoria B2B (mapeado para a consultoria principal). - **/content/gleam.dev.br/:** Páginas, manifesto, valores e recursos da comunidade open-source (mapeado para /dist/comunidade/ ou gleam.dev.br). - **/content/blog/:** Artigos técnicos, changelogs e publicações de engenharia (/dist/blog/). - **/content/wiki/:** Documentação técnica do monorepo, ADRs e Startup Blueprint (/dist/wiki/). - **/content/index.djot:** Hub central da raiz com portal de atalhos.

  2. **Compatibilidade com o Edge Router (_worker.js):** O motor SSG compilará os diretórios preservando a estrutura de saída /dist/, garantindo que o _worker.js continue redirecionando requisições dos domínios para as pastas corretas em tempo de execução na Edge.


3. Requisitos EARS

*Requisitos Ubíquos (Ubiquitous Requirements)* - *UBQ-01 (Mapeamento de Árvore por Domínio):* O motor DEVE ler recursivamente todos os subdiretórios de /content/ e reproduzir a estrutura limpa de saída em /dist/. - *UBQ-02 (Integridade de Roteamento no Edge Router):* A compilação dos domínios DEVE manter a compatibilidade direta com as regras de reescrita do _worker.js.