@omnizap-system/omnizap 2.5.12

package/docs/seo/satellite-pages-phase1.json

@@ -0,0 +1,364 @@
+{
+  "generated_at": "2026-02-28",
+  "pages": [
+    {
+      "slug": "bot-whatsapp-para-grupo",
+      "title": "Bot para Grupo de WhatsApp | OmniZap pronto para usar",
+      "description": "Descubra como usar um bot para grupo de WhatsApp sem configuração técnica. Adicione o OmniZap, organize conversas e ative automações em minutos.",
+      "keywords": ["bot para grupo whatsapp", "bot whatsapp pronto", "automação para grupos", "moderação grupo whatsapp"],
+      "h1": "Bot para grupo de WhatsApp: adicione e use em minutos",
+      "intro": "Se você administra grupo no WhatsApp, o principal desafio é manter organização sem perder tempo com tarefas repetidas. Com OmniZap, você adiciona o bot e começa a automatizar de forma imediata.",
+      "intent_label": "Solução pronta",
+      "sections": [
+        {
+          "title": "O que você ganha com um bot pronto",
+          "paragraphs": ["Um bot pronto reduz o trabalho manual de quem cuida do grupo todos os dias.", "Em vez de repetir avisos, apagar spam e responder sempre as mesmas perguntas, o grupo passa a operar com regras e fluxos automáticos."],
+          "bullets": ["Respostas automáticas para perguntas frequentes", "Avisos recorrentes sem trabalho manual", "Grupo mais organizado e profissional"]
+        },
+        {
+          "title": "Como começar sem configuração técnica",
+          "paragraphs": ["O processo é simples: abrir o bot, adicionar no grupo e autorizar.", "Depois disso, recursos como moderação e automação já podem ser usados sem programar."]
+        },
+        {
+          "title": "Quando usar stickers dentro do bot",
+          "paragraphs": ["Stickers ajudam no engajamento e fazem parte do ecossistema OmniZap.", "Você pode combinar organização do grupo com recursos de interação para manter a comunidade ativa."]
+        }
+      ],
+      "faq": [
+        {
+          "q": "Preciso saber programação para usar o bot?",
+          "a": "Não. O uso padrão do OmniZap é pronto para usuário final e não exige código."
+        },
+        {
+          "q": "Em quanto tempo o bot fica ativo no grupo?",
+          "a": "Em geral, em menos de 1 minuto após adicionar e autorizar."
+        },
+        {
+          "q": "Onde vejo os stickers disponíveis?",
+          "a": "O catálogo fica em /stickers/ e pode ser usado como recurso extra no grupo."
+        }
+      ],
+      "related_links": [
+        { "href": "/como-moderar-grupo-whatsapp/", "label": "Como moderar grupo no WhatsApp" },
+        { "href": "/como-evitar-spam-no-whatsapp/", "label": "Como evitar spam no WhatsApp" },
+        {
+          "href": "/melhor-bot-whatsapp-para-grupos/",
+          "label": "Melhor bot para grupos: guia rápido"
+        }
+      ]
+    },
+    {
+      "slug": "como-moderar-grupo-whatsapp",
+      "title": "Como moderar grupo no WhatsApp com bot | Guia prático",
+      "description": "Aprenda como moderar grupo no WhatsApp com menos trabalho manual. Use bot pronto para bloquear spam, organizar regras e manter conversa produtiva.",
+      "keywords": ["como moderar grupo whatsapp", "bot para moderar grupo", "organização de grupo whatsapp"],
+      "h1": "Como moderar grupo no WhatsApp sem sobrecarga",
+      "intro": "Moderação manual funciona no inicio, mas quebra quando o grupo cresce. O caminho mais eficiente é automatizar regras básicas com um bot pronto.",
+      "intent_label": "Guia de dor",
+      "sections": [
+        {
+          "title": "Problemas comuns em grupos sem moderação",
+          "paragraphs": ["Quando não existe rotina de moderação, o grupo perde foco rápido.", "Mensagem fora de contexto, links em excesso e repetição de conflitos viram padrão."],
+          "bullets": ["Spam de links e divulgações", "Perguntas repetidas sem resposta padrão", "Administrador sobrecarregado"]
+        },
+        {
+          "title": "O que automatizar primeiro",
+          "paragraphs": ["Comece por regras simples: aviso de boas-vindas, lembrete de regras e bloqueio de comportamento abusivo.", "Esses três pontos já elevam a qualidade do grupo sem aumentar custo operacional."]
+        },
+        {
+          "title": "Moderação com previsibilidade",
+          "paragraphs": ["Com o bot ativo, você cria padrão de operação para o grupo.", "Isso reduz desgaste da equipe e melhora a experiência de quem participa."]
+        }
+      ],
+      "faq": [
+        {
+          "q": "Dá para moderar grupo sem ficar online o tempo todo?",
+          "a": "Sim. O bot executa regras automáticas e reduz a dependência de moderação manual constante."
+        },
+        {
+          "q": "Posso combinar moderação e avisos automáticos?",
+          "a": "Sim. Essa combinação costuma ser o melhor ponto de partida para grupos em crescimento."
+        },
+        {
+          "q": "Onde vejo recursos técnicos avançados?",
+          "a": "A documentação de integração está em /api-docs/."
+        }
+      ],
+      "related_links": [
+        { "href": "/como-evitar-spam-no-whatsapp/", "label": "Como evitar spam no WhatsApp" },
+        {
+          "href": "/como-organizar-comunidade-whatsapp/",
+          "label": "Como organizar comunidade no WhatsApp"
+        },
+        { "href": "/bot-whatsapp-para-grupo/", "label": "Bot para grupo de WhatsApp" }
+      ]
+    },
+    {
+      "slug": "como-evitar-spam-no-whatsapp",
+      "title": "Como evitar spam no WhatsApp com bot pronto",
+      "description": "Guia rápido para reduzir spam em grupos de WhatsApp com bot pronto. Veja regras essenciais e práticas para manter o grupo limpo e produtivo.",
+      "keywords": ["como evitar spam whatsapp", "bot anti spam whatsapp", "moderação whatsapp"],
+      "h1": "Como evitar spam no WhatsApp sem travar seu grupo",
+      "intro": "Spam derruba a qualidade das conversas e afasta membros importantes. Com um bot pronto, você cria barreiras simples para proteger o grupo sem burocracia.",
+      "intent_label": "Guia anti-spam",
+      "sections": [
+        {
+          "title": "Por que spam cresce tao rápido",
+          "paragraphs": ["Grupos ativos atraem divulgações, correntes e mensagens repetidas.", "Sem automação, o admin entra em modo reativo e sempre chega tarde."]
+        },
+        {
+          "title": "Regras que resolvem no curto prazo",
+          "paragraphs": ["Defina filtros para links suspeitos e mensagens de repetição em massa.", "Ative respostas automáticas para orientar novos membros sobre comportamento esperado."],
+          "bullets": ["Bloqueio de padrões de spam", "Aviso automático de regras", "Acompanhamento contínuo sem intervenção manual"]
+        },
+        {
+          "title": "Resultado esperado",
+          "paragraphs": ["Com menos spam, o grupo ganha ritmo e relevância.", "Isso aumenta retenção da comunidade e melhora a confiança no canal."]
+        }
+      ],
+      "faq": [
+        {
+          "q": "O bot bloqueia todo tipo de spam automaticamente?",
+          "a": "Ele cobre os casos mais comuns e pode ser ajustado conforme o perfil do grupo."
+        },
+        {
+          "q": "Spam reduz quando o bot entra?",
+          "a": "Na prática, a queda costuma ser imediata após ativar regras básicas."
+        },
+        {
+          "q": "Posso manter recursos de engajamento junto com anti-spam?",
+          "a": "Sim. Você pode usar moderação e stickers no mesmo fluxo de grupo."
+        }
+      ],
+      "related_links": [
+        { "href": "/como-moderar-grupo-whatsapp/", "label": "Como moderar grupo no WhatsApp" },
+        {
+          "href": "/como-automatizar-avisos-no-whatsapp/",
+          "label": "Como automatizar avisos no WhatsApp"
+        },
+        { "href": "/bot-whatsapp-sem-programar/", "label": "Bot sem programar" }
+      ]
+    },
+    {
+      "slug": "como-organizar-comunidade-whatsapp",
+      "title": "Como organizar comunidade no WhatsApp com automação",
+      "description": "Veja como organizar comunidade no WhatsApp com bot pronto: regras claras, avisos automáticos e menos ruído nas conversas.",
+      "keywords": ["organizar comunidade whatsapp", "bot para comunidade", "automação whatsapp grupo"],
+      "h1": "Como organizar comunidade no WhatsApp de forma prática",
+      "intro": "Comunidade forte precisa de rotina. Quando a operação depende só de humanos, a comunicação fica inconsistente. A automação ajuda a manter padrão e previsibilidade.",
+      "intent_label": "Guia de organização",
+      "sections": [
+        {
+          "title": "Estrutura mínima para comunidade",
+          "paragraphs": ["Toda comunidade precisa de boas-vindas, regras visíveis e canal de avisos.", "Com bot pronto, essa estrutura roda de forma contínua, mesmo com alto volume de mensagens."]
+        },
+        {
+          "title": "Automação que melhora experiência",
+          "paragraphs": ["Ajuste respostas para perguntas recorrentes e reduza fricção de suporte.", "Use lembretes automáticos para horários, eventos e combinados da comunidade."],
+          "bullets": ["Menos ruído", "Mais clareza", "Tempo da equipe preservado"]
+        },
+        {
+          "title": "Escala sem perder qualidade",
+          "paragraphs": ["Quando os processos básicos estao automatizados, a comunidade cresce com menos caos.", "Isso permite que admins foquem em conteúdo, relacionamento e crescimento."]
+        }
+      ],
+      "faq": [
+        {
+          "q": "Esse modelo serve para comunidades pequenas?",
+          "a": "Sim. Quanto antes automatizar, mais fácil manter padrão quando a comunidade crescer."
+        },
+        {
+          "q": "Posso usar o bot em comunidade e grupos ao mesmo tempo?",
+          "a": "Sim. O bot pode apoiar diferentes contextos de operação no WhatsApp."
+        },
+        {
+          "q": "Onde encontro os recursos extras do ecossistema?",
+          "a": "Você pode explorar stickers e recursos complementares em /stickers/."
+        }
+      ],
+      "related_links": [
+        {
+          "href": "/como-automatizar-avisos-no-whatsapp/",
+          "label": "Automatizar avisos no WhatsApp"
+        },
+        { "href": "/como-moderar-grupo-whatsapp/", "label": "Moderação de grupos" },
+        { "href": "/bot-whatsapp-para-grupo/", "label": "Bot para grupo" }
+      ]
+    },
+    {
+      "slug": "como-automatizar-avisos-no-whatsapp",
+      "title": "Como automatizar avisos no WhatsApp | Guia rápido",
+      "description": "Aprenda como automatizar avisos no WhatsApp para grupos e comunidades. Envie lembretes com consistência e reduza falhas de comunicação.",
+      "keywords": ["automatizar avisos whatsapp", "lembrete automático whatsapp", "bot para avisos"],
+      "h1": "Como automatizar avisos no WhatsApp sem esquecer recados",
+      "intro": "Avisos manuais dependem de memória e disponibilidade. Com automação, o grupo recebe recados importantes no horário certo, todos os dias.",
+      "intent_label": "Guia de automação",
+      "sections": [
+        {
+          "title": "Quando avisos automáticos fazem diferença",
+          "paragraphs": ["Reuniões, eventos, prazos e lembretes recorrentes são casos clássicos.", "A automação evita falha humana e melhora a confiança do grupo na comunicação."]
+        },
+        {
+          "title": "Modelo simples para começar",
+          "paragraphs": ["Defina os avisos que mais se repetem e padronize mensagem e frequência.", "Com bot pronto, esse fluxo roda sem precisar montar infraestrutura própria."],
+          "bullets": ["Recados diários", "Lembretes antes de eventos", "Avisos fixos para novos membros"]
+        },
+        {
+          "title": "Ganhos para admins e membros",
+          "paragraphs": ["Admin ganha tempo para tarefas estratégicas.", "Membros recebem informação no momento certo, com menos retrabalho."]
+        }
+      ],
+      "faq": [
+        {
+          "q": "Automatizar aviso deixa o grupo robotizado?",
+          "a": "Não. A ideia é automatizar o repetitivo e liberar tempo para interação humana de qualidade."
+        },
+        {
+          "q": "Posso combinar avisos com moderação?",
+          "a": "Sim. Essa combinação é recomendada para grupos ativos."
+        },
+        {
+          "q": "Existe modo avançado para integração técnica?",
+          "a": "Sim. A documentação para cenários avançados está em /api-docs/."
+        }
+      ],
+      "related_links": [
+        {
+          "href": "/como-organizar-comunidade-whatsapp/",
+          "label": "Organizar comunidade no WhatsApp"
+        },
+        { "href": "/como-evitar-spam-no-whatsapp/", "label": "Evitar spam no WhatsApp" },
+        { "href": "/bot-whatsapp-sem-programar/", "label": "Bot sem programar" }
+      ]
+    },
+    {
+      "slug": "como-criar-comandos-whatsapp",
+      "title": "Como criar comandos no WhatsApp com bot pronto",
+      "description": "Entenda como criar e usar comandos no WhatsApp para acelerar atendimento e organização de grupos com bot pronto para uso.",
+      "keywords": ["comandos whatsapp", "bot com comandos", "automação de respostas whatsapp"],
+      "h1": "Como criar comandos no WhatsApp sem complicar",
+      "intro": "Comandos ajudam a transformar tarefas repetidas em respostas rápidas. Em vez de digitar tudo manualmente, você ativa rotinas com poucas palavras.",
+      "intent_label": "Guia de operação",
+      "sections": [
+        {
+          "title": "Por que comandos economizam tempo",
+          "paragraphs": ["Em grupos ativos, as mesmas perguntas aparecem muitas vezes.", "Com comando pronto, o admin responde com consistência e reduz desgaste da equipe."]
+        },
+        {
+          "title": "Boas práticas de comandos",
+          "paragraphs": ["Use nomes curtos e intuitivos.", "Padronize respostas para regras, horários, links oficiais e orientações internas."],
+          "bullets": ["Comando de menu", "Comando de regras", "Comando de suporte"]
+        },
+        {
+          "title": "Comandos + moderação + avisos",
+          "paragraphs": ["Quando essas três camadas trabalham juntas, a operação fica muito mais previsível.", "Esse é o caminho mais rápido para profissionalizar grupos e comunidades."]
+        }
+      ],
+      "faq": [
+        {
+          "q": "Preciso programar para ter comandos no grupo?",
+          "a": "Não para uso comum. O bot pronto entrega comandos básicos sem necessidade de código."
+        },
+        {
+          "q": "Comando serve apenas para grupos grandes?",
+          "a": "Não. Mesmo grupos pequenos ganham produtividade com respostas padronizadas."
+        },
+        {
+          "q": "Posso integrar comandos com API depois?",
+          "a": "Sim. Se precisar evoluir para integração, use a Área de Desenvolvedor em /api-docs/."
+        }
+      ],
+      "related_links": [
+        { "href": "/como-moderar-grupo-whatsapp/", "label": "Moderação de grupo" },
+        { "href": "/como-automatizar-avisos-no-whatsapp/", "label": "Automatizar avisos" },
+        { "href": "/melhor-bot-whatsapp-para-grupos/", "label": "Como escolher o melhor bot" }
+      ]
+    },
+    {
+      "slug": "melhor-bot-whatsapp-para-grupos",
+      "title": "Melhor bot para WhatsApp em grupos | Como escolher",
+      "description": "Compare critérios para escolher o melhor bot para grupos de WhatsApp. Veja o que avaliar em moderação, automação e facilidade de uso.",
+      "keywords": ["melhor bot whatsapp", "bot para grupos", "comparativo bot whatsapp"],
+      "h1": "Melhor bot para grupos de WhatsApp: o que realmente importa",
+      "intro": "Escolher bot só por nome de marca costuma gerar retrabalho. O critério certo é avaliar resultado operacional: menos caos, menos spam e mais organização.",
+      "intent_label": "Comparativo prático",
+      "sections": [
+        {
+          "title": "Critérios que importam na prática",
+          "paragraphs": ["Facilidade de entrada, moderação automática e rotina de avisos são os pilares mais importantes.", "Se o bot exigir setup técnico complexo, a adoção no dia a dia tende a cair."],
+          "bullets": ["Tempo para entrar em operação", "Qualidade da moderação", "Capacidade de escalar com o grupo"]
+        },
+        {
+          "title": "Sinal de escolha certa",
+          "paragraphs": ["A equipe gasta menos tempo apagando incêndio e mais tempo gerando valor para membros.", "Quando o grupo fica previsível, a percepção de profissionalismo sobe."]
+        },
+        {
+          "title": "Como testar rápido",
+          "paragraphs": ["Defina um grupo piloto e acompanhe 7 dias de operação.", "Meça redução de spam, clareza de comunicação e tempo economizado por admin."]
+        }
+      ],
+      "faq": [
+        {
+          "q": "Existe melhor bot universal para todo cenário?",
+          "a": "Não. O melhor bot depende do problema principal do seu grupo e da facilidade de adoção."
+        },
+        {
+          "q": "Vale priorizar bot sem configuração técnica?",
+          "a": "Sim, especialmente para times que precisam de velocidade e previsibilidade."
+        },
+        {
+          "q": "Onde encontro módulo de stickers para engajamento?",
+          "a": "No catálogo em /stickers/."
+        }
+      ],
+      "related_links": [
+        { "href": "/bot-whatsapp-para-grupo/", "label": "Bot para grupo" },
+        { "href": "/bot-whatsapp-sem-programar/", "label": "Bot sem programar" },
+        { "href": "/como-moderar-grupo-whatsapp/", "label": "Guia de moderação" }
+      ]
+    },
+    {
+      "slug": "bot-whatsapp-sem-programar",
+      "title": "Bot para WhatsApp sem programar | OmniZap",
+      "description": "Use bot para WhatsApp sem programar. Adicione no grupo, ative recursos prontos e automatize moderação, avisos e organização em poucos passos.",
+      "keywords": ["bot whatsapp sem programar", "bot pronto whatsapp", "automação whatsapp sem código"],
+      "h1": "Bot para WhatsApp sem programar: resultado rápido",
+      "intro": "Nem toda equipe tem tempo para setup técnico. Por isso o modelo sem código é o caminho mais rápido para automatizar grupos e comunidades.",
+      "intent_label": "Sem código",
+      "sections": [
+        {
+          "title": "Por que sem código acelera",
+          "paragraphs": ["Quando o foco é operação, velocidade vale mais do que arquitetura complexa.", "Com bot pronto, você elimina barreiras técnicas e entra em produção no mesmo dia."]
+        },
+        {
+          "title": "Aplicacoes imediatas",
+          "paragraphs": ["Moderar spam, enviar avisos e padronizar respostas são as três aplicações mais comuns.", "Esses ganhos aparecem rápido, mesmo em grupos pequenos."],
+          "bullets": ["Operação em minutos", "Menos dependência técnica", "Escala com baixo atrito"]
+        },
+        {
+          "title": "Evolução futura",
+          "paragraphs": ["Se no futuro você precisar de integrações avançadas, pode usar a API.", "Assim você começa simples e evolui sem trocar de ecossistema."]
+        }
+      ],
+      "faq": [
+        {
+          "q": "Sem programar significa sem personalização?",
+          "a": "Não. Você pode ajustar fluxo e mensagens sem precisar escrever código."
+        },
+        {
+          "q": "Esse modelo atende lojas e comunidades?",
+          "a": "Sim. É um modelo versátil para operações diferentes dentro do WhatsApp."
+        },
+        {
+          "q": "Posso usar stickers nesse fluxo sem código?",
+          "a": "Sim. O módulo de stickers pode ser usado como recurso de engajamento complementar."
+        }
+      ],
+      "related_links": [
+        { "href": "/bot-whatsapp-para-grupo/", "label": "Bot para grupos" },
+        { "href": "/como-evitar-spam-no-whatsapp/", "label": "Evitar spam" },
+        { "href": "/como-criar-comandos-whatsapp/", "label": "Comandos no WhatsApp" }
+      ]
+    }
+  ]
+}

package/docs/wiki/Home.md

@@ -0,0 +1,120 @@
+# OmniZap Wiki
+
+Bem-vindo à wiki oficial do **OmniZap System**.
+
+Esta página é o ponto de entrada para entender o projeto, subir o ambiente local e navegar pelos principais fluxos técnicos e operacionais.
+
+## Status Atual
+
+- Versão do projeto: `2.5.6`
+- Snapshot desta wiki: `2026-03-08`
+- Roadmap técnico recente: consolidação de configuração/tempo de execução do bot e redução de duplicação entre controlador/socket.
+
+## Links rápidos
+
+- Repositório: https://github.com/Omnizap-System/omnizap
+- Site: https://omnizap.shop/
+- Login web: https://omnizap.shop/login/
+- API Docs: https://omnizap.shop/api-docs/
+- Termos: https://omnizap.shop/termos-de-uso/
+- Segurança: https://github.com/Omnizap-System/omnizap/blob/main/SECURITY.md
+- Código de Conduta: https://github.com/Omnizap-System/omnizap/blob/main/CODE_OF_CONDUCT.md
+
+## O que é o OmniZap
+
+O OmniZap é uma plataforma open source com 3 camadas principais:
+
+1. Bot WhatsApp (Baileys): comandos, automações e eventos.
+2. Camada web: login, painel de usuário e catálogo de stickers.
+3. Camada de dados e operação: MySQL, workers, métricas e deploy.
+
+## Quick Start (local)
+
+```bash
+npm install
+cp .env.example .env
+npm run db:init
+npm run build:frontend
+npm run dev
+```
+
+Rotas úteis após subir:
+
+- `http://localhost:3000/healthz`
+- `http://localhost:3000/readyz`
+- `http://localhost:3000/metrics`
+
+## Mapa rápido de arquitetura
+
+```text
+WhatsApp (Baileys)
+  -> app/connection + app/controllers + app/modules
+  -> app/services (persistência, filas, login-link, integrações)
+  -> database/ (MySQL)
+
+HTTP Server
+  -> server/routes/*
+  -> public/ (páginas web)
+
+Operação
+  -> scripts/
+  -> observability/ (Prometheus, Grafana, Loki)
+```
+
+## Mudanças Recentes
+
+- Refatoração de configuração: entrada unificada em `app/config/index.js` com reexport de `app/configParts/*`.
+- Consolidação de estado/socket/LID no `baileysConfig` e sincronização de consumo em:
+  - `app/connection/socketController.js`
+  - `app/controllers/messageController.js`
+- Remoção de arquivo órfão de middleware HTTP:
+  - `server/middleware/requestLogger.js`
+- Atualização dos audits de `stickerCatalogController` para novo snapshot.
+- Atualização do runbook de banco para incluir migrações `d31` a `d34`.
+
+## Navegação da wiki
+
+Páginas recomendadas para criar/expandir em seguida:
+
+- `[[Arquitetura]]`
+- `[[Setup-Local]]`
+- `[[Configuração-.env]]`
+- `[[Bot-e-Comandos]]`
+- `[[Autenticação-Web-e-Login-com-Google]]`
+- `[[Deploy-e-Operação]]`
+- `[[Observabilidade]]`
+- `[[Troubleshooting]]`
+- `[[Contribuição-e-Padrões]]`
+- `[[Segurança-e-Resposta-a-Incidentes]]`
+
+## Governança de documentação
+
+- Prefira exemplos executáveis (comandos reais e verificáveis).
+- Sempre documente impacto de configurações em `.env`.
+- Ao mudar fluxo de módulo/serviço, atualize README + wiki + runbooks.
+- Evite duplicar regra de negócio: referencie arquivo-fonte quando possível.
+- Mantenha data de atualização ao final da página.
+
+## Referências internas
+
+- README principal: `README.md`
+- Runbook de evolução de banco: `docs/database/production-db-evolution-runbook-2026q1.md`
+- Runbook de hardening de rede: `docs/security/network-hardening-runbook-2026-03-07.md`
+- Runbook de incidentes LGPD/ANPD: `docs/security/incident-response-lgpd-anpd-runbook-2026-03-07.md`
+- Checklist mensal de compliance: `docs/compliance/monthly-compliance-checklist-2026-03-07.md`
+- Playbook SEO BR: `docs/seo/omnizap-seo-playbook-br-2026-02-28.md`
+- Template de páginas satélite: `docs/seo/satellite-page-template.md`
+- Mudanças recentes (detalhado): `docs/wiki/recent-changes-2026-03-08.md`
+- Audit (escopo): `docs/audits/stickerCatalogController-out-of-scope.md`
+- Audit (símbolos): `docs/audits/stickerCatalogController-symbols.md`
+
+## Referências externas úteis
+
+- Node.js Docs: https://nodejs.org/docs/latest/api/
+- MySQL 8.0 Reference Manual: https://dev.mysql.com/doc/refman/8.0/en/
+- Prometheus Docs: https://prometheus.io/docs/introduction/overview/
+- Grafana Docs: https://grafana.com/docs/
+
+---
+
+Última atualização: `2026-03-08`

package/docs/wiki/pair-extraordinaire-2026-03-08.md

@@ -0,0 +1,3 @@
+# Pair Extraordinaire - Registro (2026-03-08)
+
+Commit de manutencao para validar fluxo de coautoria via `Co-authored-by`.

package/docs/wiki/recent-changes-2026-03-08.md

@@ -0,0 +1,47 @@
+# Mudancas Recentes do Projeto (2026-03-08)
+
+Referencia de versao: `v2.5.6`
+
+## Commits de referencia
+
+- `bce359e` chore: remove unused request logger middleware
+- `3f181ea` refactor: centralize config and sync baileys/socket/message helpers
+- `059c84d` feat(ai-help): support v2 command schema and regenerate module agents
+- `49af593` refactor: migrate command configs to v2 and harden validation
+- `de0ec01` feat: add script to generate commands catalog in JSON format
+
+## Principais mudancas tecnicas
+
+1. Configuracao e runtime do bot consolidados
+
+- Entrada unica em `app/config/index.js`.
+- Partes de configuracao organizadas em:
+  - `app/configParts/baileysConfig.js`
+  - `app/configParts/groupUtils.js`
+  - `app/configParts/adminIdentity.js`
+- Estado de socket e resolucao LID/JID agora concentrados no `baileysConfig` (sem os antigos services dedicados).
+
+2. Reducao de duplicacao entre conexao e processamento de mensagem
+
+- `app/connection/socketController.js` e `app/controllers/messageController.js` passaram a consumir helpers comuns de `app/config/index.js`.
+- Beneficio principal: mesma regra para disponibilidade de socket, normalizacao de IDs e resolucao de remetente.
+
+3. Limpeza de codigo orfao
+
+- Removido `server/middleware/requestLogger.js` (sem referencias de runtime).
+- Logging de request sensivel permanece coberto no `server/http/httpServer.js`.
+
+4. Evolucao de schema e pipeline de IA
+
+- Novas migracoes adicionadas para:
+  - hardening de sessao web (`d31`)
+  - cache de respostas de IA (`d32`)
+  - tabelas de aprendizado (`d33`)
+  - enriquecimento de config de comandos (`d34`)
+- Runbook atualizado em `docs/database/production-db-evolution-runbook-2026q1.md`.
+
+## Impacto para desenvolvimento
+
+- Importar utilitarios compartilhados via `app/config/index.js`.
+- Evitar recriar parser/normalizador local em controller/socket quando ja existir helper exportado.
+- Para mudancas em DB, seguir fases e validacoes do runbook atualizado.

package/ecosystem.prod.config.cjs

@@ -0,0 +1,135 @@
+require('dotenv').config();
+
+const appName = process.env.PM2_APP_NAME || 'omnizap-system';
+
+const baseEnv = {
+  NODE_ENV: 'production',
+  COMMAND_PREFIX: '/',
+  LOG_LEVEL: 'info',
+  DB_LOG_EVERY_QUERY: 'false',
+  DB_MONITOR_ENABLED: 'false',
+  LID_BACKFILL_ON_START: 'false',
+  STICKER_CLASSIFICATION_BACKGROUND_ENABLED: 'true',
+  STICKER_CLASSIFICATION_BACKGROUND_CONCURRENCY: '1',
+  STICKER_CLASSIFICATION_BACKGROUND_BATCH_SIZE: '3',
+  STICKER_REPROCESS_QUEUE_ENABLED: 'false',
+  STICKER_REPROCESS_MAX_PER_CYCLE: '2',
+  STICKER_REPROCESS_MODEL_UPGRADE_SCAN_LIMIT: '20',
+  STICKER_REPROCESS_LOW_CONFIDENCE_SCAN_LIMIT: '15',
+  STICKER_REPROCESS_PRIORITY_BACKFILL_SCAN_LIMIT: '20',
+  STICKER_SEMANTIC_RECLASSIFICATION_ENABLED: 'false',
+  STICKER_AUTO_PACK_BY_TAGS_ENABLED: 'false',
+  STICKER_AUTO_PACK_BY_TAGS_MAX_ADDITIONS_PER_CYCLE: '30',
+  STICKER_AUTO_PACK_BY_TAGS_RETRO_CONSOLIDATION_MUTATION_LIMIT: '120',
+  STICKER_WORKER_PIPELINE_ENABLED: 'true',
+  STICKER_WORKER_PIPELINE_INLINE_POLLER_ENABLED: 'false',
+  STICKER_WORKER_PIPELINE_SCHEDULER_INTERVAL_MS: '90000',
+  STICKER_WORKER_PIPELINE_POLLER_INTERVAL_MS: '30000',
+  STICKER_WORKER_CLASSIFICATION_CADENCE_MS: '600000',
+  STICKER_WORKER_CURATION_CADENCE_MS: '21600000',
+  STICKER_WORKER_REBUILD_CADENCE_MS: '43200000',
+  STICKER_DEDICATED_WORKERS_ENABLED: 'false',
+  STICKER_DEDICATED_WORKER_POLL_INTERVAL_MS: '30000',
+  STICKER_DEDICATED_WORKER_IDLE_BACKOFF_MULTIPLIER: '2.5',
+  STICKER_DEDICATED_WORKER_IDLE_MAX_POLL_INTERVAL_MS: '180000',
+  STICKER_DEDICATED_WORKER_IDLE_JITTER_PERCENT: '15',
+  STICKER_DOMAIN_EVENT_CONSUMER_ENABLED: 'false',
+  STICKER_DOMAIN_EVENT_CONSUMER_POLLER_INTERVAL_MS: '15000',
+  STICKER_SCORE_SNAPSHOT_ENABLED: 'false',
+  STICKER_SCORE_SNAPSHOT_REFRESH_INTERVAL_MS: '1500000',
+  STICKER_SCORE_SNAPSHOT_BATCH_SIZE: '20',
+  METRICS_HOST: process.env.METRICS_HOST || '127.0.0.1',
+};
+
+module.exports = {
+  apps: [
+    {
+      name: `${appName}-production`,
+      script: './index.js',
+      cwd: __dirname,
+      exec_mode: 'fork',
+      instances: 1,
+      autorestart: true,
+      watch: false,
+      max_memory_restart: '3G',
+      log_date_format: 'YYYY-MM-DD HH:mm:ss',
+      out_file: `logs/${appName}-out.log`,
+      error_file: `logs/${appName}-error.log`,
+      env: {
+        ...baseEnv,
+      },
+      wait_ready: true,
+      listen_timeout: 10000,
+      kill_timeout: 5000,
+    },
+    {
+      name: `${appName}-worker-classification`,
+      script: './scripts/sticker-worker-task.mjs',
+      args: '--task-type classification_cycle',
+      cwd: __dirname,
+      exec_mode: 'fork',
+      instances: 1,
+      autorestart: true,
+      watch: false,
+      max_memory_restart: '2G',
+      log_date_format: 'YYYY-MM-DD HH:mm:ss',
+      out_file: `logs/${appName}-worker-classification-out.log`,
+      error_file: `logs/${appName}-worker-classification-error.log`,
+      env: {
+        ...baseEnv,
+        STICKER_DEDICATED_WORKERS_ENABLED: 'true',
+        STICKER_DEDICATED_WORKER_POLL_INTERVAL_MS: '25000',
+        STICKER_DEDICATED_WORKER_IDLE_BACKOFF_MULTIPLIER: '2.4',
+        STICKER_DEDICATED_WORKER_IDLE_MAX_POLL_INTERVAL_MS: '180000',
+        STICKER_CLASSIFICATION_BACKGROUND_BATCH_SIZE: '3',
+        STICKER_CLASSIFICATION_BACKGROUND_CONCURRENCY: '1',
+        STICKER_REPROCESS_QUEUE_ENABLED: 'false',
+        STICKER_SEMANTIC_RECLASSIFICATION_ENABLED: 'false',
+        STICKER_AUTO_PACK_BY_TAGS_ENABLED: 'false',
+      },
+      kill_timeout: 5000,
+    },
+    {
+      name: `${appName}-worker-curation`,
+      script: './scripts/sticker-worker-task.mjs',
+      args: '--task-type curation_cycle',
+      cwd: __dirname,
+      exec_mode: 'fork',
+      instances: 1,
+      autorestart: true,
+      watch: false,
+      max_memory_restart: '2G',
+      log_date_format: 'YYYY-MM-DD HH:mm:ss',
+      out_file: `logs/${appName}-worker-curation-out.log`,
+      error_file: `logs/${appName}-worker-curation-error.log`,
+      env: {
+        ...baseEnv,
+        STICKER_DEDICATED_WORKERS_ENABLED: 'false',
+        STICKER_DEDICATED_WORKER_POLL_INTERVAL_MS: '60000',
+        STICKER_AUTO_PACK_BY_TAGS_ENABLED: 'false',
+      },
+      kill_timeout: 5000,
+    },
+    {
+      name: `${appName}-worker-rebuild`,
+      script: './scripts/sticker-worker-task.mjs',
+      args: '--task-type rebuild_cycle',
+      cwd: __dirname,
+      exec_mode: 'fork',
+      instances: 1,
+      autorestart: true,
+      watch: false,
+      max_memory_restart: '2G',
+      log_date_format: 'YYYY-MM-DD HH:mm:ss',
+      out_file: `logs/${appName}-worker-rebuild-out.log`,
+      error_file: `logs/${appName}-worker-rebuild-error.log`,
+      env: {
+        ...baseEnv,
+        STICKER_DEDICATED_WORKERS_ENABLED: 'false',
+        STICKER_DEDICATED_WORKER_POLL_INTERVAL_MS: '60000',
+        STICKER_AUTO_PACK_BY_TAGS_ENABLED: 'false',
+      },
+      kill_timeout: 5000,
+    },
+  ],
+};