🌐 Bem-vindo à Wiki do Clube67 NewWhats

Esta Wiki centraliza toda a documentação arquitetural, resoluções de erros de infraestrutura, controle de versionamento, gerenciamento de plugins e integrações de microsserviços do ecossistema NewWhats.

📂 Categorias de Documentação

Selecione um tópico abaixo para acessar o guia detalhado:

🚀 1. Guia de Operações e Deploy (Urgente / Operacional)

Fluxo de Deploy Multi-VPS: Passo a passo detalhado do deploy em cada VPS (VPS 1, VPS 3 e VPS 4 - push, pull, etc.).
Como Funciona o Processo de Build: Detalhamento técnico de todas as fases de compilação da plataforma.
Rede VPN e Segurança Zero-Trust: Como as VPSs se comunicam por meio da VPN privada e o modelo de isolamento lateral de rede.

⚙️ 2. Infraestrutura e Rede

Backup do Banco para Wasabi (Cold Storage): Script e CRON job para fazer backup autônomo do banco da VPS 3 para a nuvem.
Resolução de Erros de SSL e Proxy: Como corrigimos o erro crítico de Mixed Content do SSL por proxy reverso.
Contador de Versões e Painel de Deploy: Detalhamento do controle de deploys automáticos em ambiente multi-VPS.

🔌 3. Arquitetura de Plugins e Core

Sincronização de Caminhos de Plugins: Como configurar caminhos relativos de importação em produção (Docker vs Host) de forma automática.
Troca do Engine Baileys: Comparação e controle entre a engine Baileys Oficial e o fork InfiniteAPI para mensagens ricas.
Correção de Wasabi Storage: Detalhes da resolução de acúmulo de arquivos de mídia locais no servidor Wasabi.

🏢 4. Integração Multi-Tenant SaaS

Integração de Empresa e Plugins Clientes: Visão geral da comunicação entre o Motor NewWhats e o plugin newwhats-client embarcado.
Gerenciador de Subdomínios e DNS (Hostinger): Painel central de DNS em tempo real e controle multitenancy de marcas visuais (Logos/Paletas HSL) para subdomínios da rede Clube67.

🤖 Protocolo Gitea Swarm (PGS) e Diretrizes IA

O ecossistema adota segurança Zero-Trust de movimentação lateral (impedindo que agentes em uma VPS acessem outras máquinas via SSH automático). O Gitea atua como o Orquestrador de Estado Assíncrono do enxame de agentes.

Diretrizes e Protocolos Estritos para Agentes de IA: Leitura OBRIGATÓRIA para todas as IAs. Define como acessar APIs sem tokens (SSH e Basic Auth) e orienta sobre o fluxo da Wiki.
Protocolo de Agentes (protocolo_agentes.md): Arquivo de regras de Hand-off e cooperação multi-VPS.