← Voltar ao Índice 🇺🇸 English

⚡ Resiliência e Circuit Breaker

Como o Domain-System se protege sozinho de plugins fatais e erros críticos.

O Problema Clássico (Tela Branca da Morte)

Nos sistemas monolíticos ou baseados em plugins tradicionais (como o WordPress antigo), um simples erro de digitação de um desenvolvedor — como esquecer um ponto-e-vírgula em um plugin recém-instalado — pode causar a famosa "Tela Branca da Morte". O PHP interrompe abruptamente toda a execução, e o site inteiro fica inacessível para todos (inclusive para os administradores).

A Solução: Circuit Breaker (Disjuntor)

O Domain-System foi desenhado com um conceito avançado de arquitetura focado na alta resiliência: o Circuit Breaker (Disjuntor).

Funciona de maneira muito semelhante a um disjuntor de energia em uma casa. Quando ocorre uma "sobrecarga" (um erro fatal) em um dos cômodos (plugins), o disjuntor "desarma" apenas aquela linha, protegendo o núcleo geral de queimar.

Como Funciona nos Bastidores

  1. Interceptação Global (ErrorHandler): Uma camada de defesa, conectada diretamente ao register_shutdown_function do PHP, vigia todos os eventos fatais em nível de hardware e compilação (Erros de Sintaxe, Parse Errors, etc).
  2. Rastreamento Isolado: Quando uma exceção fatal explode, o Vigia captura o Stack Trace para descobrir a origem exata do erro.
  3. Desarme Automático: Se o sistema identifica que a falha veio de um arquivo pertencente à pasta de um Plugin específico, ele intercepta o arquivo config/plugins.json e desconecta / desativa o plugin em milissegundos.
  4. Proteção do Painel: O sistema limpa os buffers pela metade e renderiza uma tela limpa de "Sobrecarga de Núcleo" apenas para o autor da requisição afetada. Na mesma tela, exibe um botão para Recarregar o Sistema Seguro.
  5. Log e Alerta Visuais: O sistema adiciona um registro da queda ao arquivo temporário de disarmed.json. Assim que o administrador acessa a tela nativa de Plugins (via SystemAdmin), ele vê um alerta brilhante apontando o plugin desarmado, com o atalho para a tela de relatórios detalhados (SystemMonitor).