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 emgbr_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 noAGENTS.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
startdo Ator Chronos deve consultar a porta hexagonalChronosStorageimplementada no Mnesia (gbr_mnesia) para carregar a matriz de trabalhos persistidos e reconstruir a topologia física deprocess.send_afterantes 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éricaUnchanged, 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.