Gleam.br Wiki

ADR-0013: Montagem Multi-Site Institucional e Topologia de Conteúdo | Wiki

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

ADR-0013: Montagem Multi-Site Institucional e Topologia de Conteúdo

Este documento especifica a decisão de arquitetura sobre a organização multi-marca e orquestração declarativa das 3 landing pages do ecossistema no gerador estático gbr_ssg.

1. Contexto e Motivação

Com a biblioteca de 5 componentes modulares do layout "Site" concluída (Hero, FeatureGrid, CaseStudy, TeamGrid, ContentSection), a Fase 3 consiste na montagem das landing pages institucionais para as 3 marcas do grupo sem adicionar código de renderização extra, apenas compondo metadados TOML.


2. Decisão Arquitetural

  1. *Topologia de Diretórios e Mapeamento de Rotas:* A árvore de conteúdo em apps/gbr_ssg/content/ refletirá as 3 marcas do ecossistema: - *Gleam Lang BR (Consultoria Tech):* Mapeada na raiz / (content/index.djot). Focada em serviços B2B de migração de legados para Gleam/OTP. - *FVideen (Holding / Venture Builder):* Mapeada na subpasta /fvideen/ (content/fvideen/index.djot). Focada em governança, longevidade e liderança sênior. - *Comunidade (Ecossistema Open-Source):* Mapeada na subpasta /comunidade/ (content/comunidade/index.djot). Focada em simbiose, manifesto, aprendizagem e cultura da BEAM.

  2. *Orquestração 100% Declarativa (TOML Frontmatter):* Cada arquivo index.djot utilizará o parâmetro layout = "site" e declarará uma sequência customizada de tabelas [[sections]]. O motor layout_site.gleam irá iterar sobre os blocos e compor a página automaticamente.


3. Requisitos EARS

*Requisitos Ubíquos (Ubiquitous Requirements)* - *UBQ-01 (Mapeamento Estático da Topologia Multi-Marca):* O compilador DEVE gerar as 3 landing pages em suas respectivas sub-rotas no diretório estático de saída: ./dist/index.html (Consultoria), ./dist/fvideen/index.html (Holding) e ./dist/comunidade/index.html (Comunidade). - *UBQ-02 (Reaproveitamento de Componentes):* As 3 landing pages DEVEM reutilizar exclusivamente a biblioteca dos 5 componentes visuais padronizados (hero, feature_grid, case_study, team_grid, content), garantindo consistência estética (Dark Premium) e zero manutenção de código de renderização ad-hoc.