Gleam.br Wiki

GBR: Requisitos Cognitivos e de Ingestão (gbr_bpm & Ingress) | Wiki

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

GBR: Requisitos Cognitivos e de Ingestão (gbr_bpm & Ingress)

*Requisitos Ubíquos (Ubiquitous Requirements)* - *UBQ-01:* O motor BPE (gbr_bpm) deve manter pureza funcional irrestrita, sendo proibido de executar efeitos colaterais de rede, disco ou console (I/O) diretamente de dentro do morfismo de transição (machine.step). - *UBQ-02:* A camada de Ingress (Web) deve aplicar decodificação estrita de esquemas a todo tráfego JSON (Norte-Sul), convertendo-o para Tipos de Dados Algébricos (ADTs) na fronteira de entrada.

*Requisitos Orientados a Eventos (Event-Driven Requirements)* - *EVD-01:* Quando a Máquina de Estados (BPE) processar a transição do ExecutionToken sobre um nó do tipo Tarefa de Regra (RuleTask), o sistema deve retornar um Efeito de Alerta (TriggerAlert) encapsulado com as variáveis de contexto atuais da telemetria. - *EVD-02:* Quando o Roteador de Telemetria interceptar uma falha de ets.lookup (Cold Start), a API de Fachada deve emitir o comando de Spawn para o Manager, aguardar 10ms, e reexecutar a tentativa de ingestão antes de considerar a requisição finalizada.

*Requisitos Orientados a Estado (State-Driven Requirements)* - *STD-01:* Enquanto o ExecutionToken estiver posicionado antes de um Gateway Exclusivo (Losango de Decisão), o roteador BPE deve avaliar obrigatoriamente a Árvore Sintática Abstrata (AST) matemática configurada nas arestas (SequenceFlow) contra o Dict de payload atual para decidir o caminho lógico subsequente.

*Requisitos de Comportamento Indesejado (Unwanted Behavior Requirements)* - *UNW-01:* Se uma fórmula matemática na AST invocar uma variável (ex: cpu_usage) que não esteja presente no payload atual do Token, o interpretador AST deve suspender o cálculo e retornar um Error propagável que bloqueie o avanço do processo em fluxos condicionais. - *UNW-02:* Se a avaliação da AST contiver operações de divisão e o divisor for avaliado como zero (0.0), a máquina deve blindar o processamento matematicamente, retornando um erro previsível (Prevenção de interrupção abrupta da BEAM).

*Requisitos de Funcionalidades Opcionais / Futuras (Optional Feature Requirements)* - *OPT-01:* Onde o agente local no cliente tiver autorização explícita corporativa (Opt-In de Segurança), o sistema poderá transitar do "Modo Stealth" (HTTP POST Ingress) para o "Modo Operações Especiais", estabelecendo um túnel reverso multiplexado persistente via gbr_p2p (WebSockets/TCP Mesh) para permitir comandos bidirecionais isolados (Zero-Trust Network Access). - *OPT-02:* Onde houver diagramas de processos corporativos no padrão de mercado, o sistema deve fornecer uma ferramenta utilitária (Parser) capaz de converter nativamente XMLs exportados pelo Camunda diretamente em core.ProcessDef para a nossa arquitetura BPE.