Gleam.br Wiki

GBR: Requisitos do Ecossistema de Telemetria e Tradução (Parser XML) | Wiki

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

GBR: Requisitos do Ecossistema de Telemetria e Tradução (Parser XML)

*Requisitos Ubíquos (Ubiquitous Requirements)*

  • *UBQ-01:* O motor de parsing de ficheiros XML legados (falcon.xsd -> Regras BPE/Chronos) deve rejeitar manipulações imperativas de Strings (Regex/Splits), utilizando exclusivamente a interface SAX C/Erlang envelopada em gbr_xml (xmerl) para garantir a imunidade a anomalias de formatação e namespaces hierárquicos.
  • *UBQ-02:* A Máquina Virtual (BEAM) deve nomear obrigatoriamente pacotes de bibliotecas de domínio global (ex: gbr_mnesia, gbr_monitor) seguindo a estrutura de diretórios estrita (src/gbr/mnesia/...) para prevenir poluição e conflitos no namespace nativo do repositório Erlang (Governança Read-Before-Write documentada no AGENTS.md).

*Requisitos Orientados a Eventos (Event-Driven Requirements)*

  • *EVD-01:* Quando o Gateway autenticar uma nova sessão Yamux estabelecida por um agente remoto, a orquestração central deve gerar um Manifesto estático (JSON), fragmentá-lo em blocos de segurança de no máximo 64KB (Yamux Chunking), e empurrá-lo assincronamente para a Borda para impor o modelo de "Fonte Absoluta de Verdade" (Single Source of Truth).
  • *EVD-02:* Quando o Agente na Borda receber os fragmentos do Manifesto via Stream Yamux, o Ator responsável pelo fluxo deve acumular os BitArrays (Edge Buffering) até interceptar o delimitador de quebra de linha (\n), momento em que deverá descarregar o buffer e invocar a decodificação matemática da carga útil completada.

*Requisitos Orientados a Estado (State-Driven Requirements)*

  • *STD-01:* Enquanto o sistema operacional host reiniciar o serviço do Gateway na Nuvem (Boot), a função start do Ator Chronos deve consultar a porta hexagonal ChronosStorage implementada no Mnesia (gbr_mnesia) para carregar a matriz de trabalhos persistidos e reconstruir a topologia física de process.send_after antes de aceitar requisições da API pública.

*Requisitos de Comportamento Indesejado (Unwanted Behavior Requirements)*

  • *UNW-01:* Se a avaliação de uma métrica no motor de regras de negócio (gbr_bpm) resultar na diretiva genérica Unchanged, o Roteador Semântico ("Moedor de Carne") deve descartar silenciosamente a criação da transição no ciclo, abdicando de emitir qualquer SemanticFact ao Cérebro C++ (DuckDB) para otimizar o uso do disco.