@kaikybrofc/omnizap-system 2.3.1 → 2.3.3

package/README.md

@@ -1,520 +1,119 @@
 <img width="1318" height="352" alt="OmniZap banner" src="https://github.com/user-attachments/assets/d44835e7-021a-4c67-a0e7-5b858d51eb91" />
 
-![Node.js](https://img.shields.io/badge/Node.js-18%2B-3C873A?logo=node.js&logoColor=white)
-![JavaScript](https://img.shields.io/badge/JavaScript-ES2022-F7DF1E?logo=javascript&logoColor=000)
-![MySQL](https://img.shields.io/badge/MySQL-8%2B-4479A1?logo=mysql&logoColor=white)
-![Baileys](https://img.shields.io/badge/Baileys-WhatsApp%20SDK-25D366?logo=whatsapp&logoColor=white)
-![PM2](https://img.shields.io/badge/PM2-Process%20Manager-2B037A?logo=pm2&logoColor=white)
-![OpenAI](https://img.shields.io/badge/OpenAI-SDK-111111?logo=openai&logoColor=white)
-![License](https://img.shields.io/badge/License-MIT-0B6E4F?logo=opensourceinitiative&logoColor=white)
+# OmniZap System
 
-O **OmniZap System** é uma plataforma de automação para WhatsApp usando **Node.js + Baileys**, com foco em:
+Plataforma de automacao para WhatsApp com foco em figurinhas, packs, catalogo web e comandos inteligentes.
 
-- comando por chat (grupos e privado)
-- persistência em MySQL
-- automações administrativas
-- mídia/figurinhas com packs persistentes
-- observabilidade (Prometheus/Grafana/Loki)
+## Links oficiais
 
-**Versão atual:** `2.1.3`
-
-## Links oficiais do projeto
-
-- Site principal: https://omnizap.shop/
-- Catálogo web de stickers: https://omnizap.shop/stickers/
+- Site: https://omnizap.shop/
+- Login web: https://omnizap.shop/login/
+- Painel do usuario: https://omnizap.shop/user/
+- Catalogo de figurinhas: https://omnizap.shop/stickers/
 - API Docs: https://omnizap.shop/api-docs/
 - Termos de uso: https://omnizap.shop/termos-de-uso/
-- Licença: https://omnizap.shop/licenca/
-
-## Snapshot dinâmico para README/NPM
-
-Use as rotas abaixo para consumir o bloco já renderizado com dados do sistema:
-
-- JSON: `GET /api/sticker-packs/readme-summary`
-- Markdown: `GET /api/sticker-packs/readme-markdown`
-
-Para atualizar este `README.md` automaticamente com o conteúdo renderizado:
-
-```bash
-npm run readme:sync-snapshot
-```
-
-Conteúdo incluído no snapshot:
-
-- total de usuários (`lid_map`)
-- total de grupos
-- total de packs e stickers
-- total de mensagens registradas
-- tipos de mensagem mais usados
-- lista de comandos disponíveis no menu
-
-Atualização em cache: **30 minutos** por padrão (`README_SUMMARY_CACHE_SECONDS=1800`).
-
-<!-- README_SNAPSHOT:START -->
-### Snapshot do Sistema
-
-> Atualizado em `2026-02-28T21:56:21.021Z` | cache `1800s`
-
-| Métrica | Valor |
-| --- | ---: |
-| Usuários (lid_map) | 5.515 |
-| Grupos | 116 |
-| Packs | 301 |
-| Stickers | 7.170 |
-| Mensagens registradas | 444.453 |
-
-#### Tipos de mensagem mais usados (amostra: 25.000)
-| Tipo | Total |
-| --- | ---: |
-| `texto` | 16.074 |
-| `figurinha` | 4.780 |
-| `reacao` | 1.546 |
-| `imagem` | 1.339 |
-| `outros` | 850 |
-| `video` | 215 |
-| `audio` | 190 |
-| `documento` | 6 |
-
-<details><summary>Comandos disponíveis (62)</summary>
-
-`/add` · `/addmode` · `/autorequests` · `/autosticker` · `/ban` · `/captcha` · `/cat` · `/catimg` · `/catprompt` · `/catprompt reset` · `/dado` · `/down` · `/farewell` · `/groups` · `/info` · `/invite` · `/join` · `/leave` · `/menu anime` · `/menu figurinhas` · `/menu ia` · `/menu midia` · `/menu quote` · `/menu stats` · `/menuadm` · `/metadata` · `/newgroup` · `/noticias` · `/nsfw` · `/pack add` · `/pack create` · `/pack list` · `/pack send` · `/ping` · `/play` · `/playvid` · `/prefix` · `/premium` · `/quote` · `/ranking` · `/rankingglobal` · `/requests` · `/revoke` · `/s` · `/semmsg` · `/setdesc` · `/setgroup` · `/setsubject` · `/st` · `/stb` · `/sticker` · `/stickertext` · `/stickertextblink` · `/stickertextwhite` · `/stw` · `/temp` · `/tiktok` · `/toimg` · `/up` · `/updaterequests` · `/user perfil` · `/welcome`
-
-</details>
-<!-- README_SNAPSHOT:END -->
-
-## Recursos principais
-
-- Gerenciamento de grupos (admin, boas-vindas, despedida, anti-link, captcha).
-- Prefixo de comando por grupo.
-- Comandos de mídia (`play`, `playvid`, stickers e conversões).
-- Sticker packs persistentes com CRUD e envio com fallback.
-- Recursos de IA (`cat`, `catimg`, `catprompt`) com OpenAI.
-- Estatísticas (`ranking`, `rankingglobal`, `semmsg`, `user perfil`).
-- Suporte a LID/JID com reconciliação automática (`lid_map`).
-- Métricas e logs estruturados para operação em produção.
-
-## Pré-requisitos
-
-- Node.js 18+ recomendado.
-- MySQL 8+.
-- FFmpeg instalado e acessível no `PATH`.
-- PM2 (opcional): `npm i -g pm2`.
-- Docker Compose (opcional, para stack de observabilidade).
-
-## Instalação rápida
-
-1. Clone o repositório:
-
-```bash
-git clone https://github.com/Kaikygr/omnizap-system.git
-cd omnizap-system
-```
-
-2. Instale dependências:
+- Licenca: https://omnizap.shop/licenca/
 
-```bash
-npm install
-```
+## Como comecar (usuario final)
 
-3. Crie o `.env` a partir do exemplo:
+1. Abra o WhatsApp e envie `iniciar` para o bot.
+2. Use o link seguro recebido para abrir o login web.
+3. Faça login com Google para vincular sua conta.
+4. Volte para o WhatsApp e use os comandos de figurinha e pack.
+5. Acesse o painel em `https://omnizap.shop/user/` para gerenciar seus packs.
 
-```bash
-cp .env.example .env
-```
-
-4. Ajuste as variáveis mínimas obrigatórias no `.env` (o restante já vem com defaults no `.env.example`):
-
-```env
-DB_HOST=localhost
-DB_USER=seu_usuario
-DB_PASSWORD=sua_senha
-DB_NAME=omnizap
-USER_ADMIN=seu_jid@s.whatsapp.net
-IMAGE_MENU=https://example.com/menu.png
-```
-
-Para recursos de IA (`cat`, `catimg`, `catprompt`), configure também:
-
-```env
-OPENAI_API_KEY=sua_chave
-```
-
-5. Inicialize banco e tabelas:
-
-```bash
-npm run db:init
-```
-
-6. Inicie o bot:
-
-```bash
-npm run start
-```
-
-7. Escaneie o QR Code no terminal.
-
-## Observações importantes de ambiente
-
-- `DB_NAME` recebe sufixo automaticamente:
-  - `NODE_ENV=development` => `_dev`
-  - `NODE_ENV=production` => `_prod`
-  - Se já terminar com `_dev` ou `_prod`, o nome é preservado.
-- `COMMAND_PREFIX` pode ser global e também por grupo (via comandos admin).
-- `LID_BACKFILL_ON_START=true` habilita backfill de `lid_map` no boot.
-- `LID_BACKFILL_BATCH` padrão do serviço: `50000`.
-
-## Referência de variáveis (`.env.example`)
-
-O `.env.example` foi atualizado para cobrir todas as variáveis atualmente referenciadas no código e no `docker-compose.yml`.
-
-Principais blocos do arquivo:
-
-- Core do bot (prefixo, admin, imagem de menu, logs e Baileys).
-- Banco MySQL (conexão, fila de escrita, monitor de query lenta).
-- Métricas/observabilidade do app (`METRICS_*`, `DB_QUERY_ALERT_THRESHOLDS`, social metrics).
-- OpenAI (chat, imagem, TTS, timeout e retry).
-- Mídia (`play`, TikTok, FFmpeg/FFprobe).
-- Sticker packs (storage, limites, auto-coleta, catálogo web).
-- XP e RPG Pokémon (economia, PvP, raids, social XP, canvas).
-- Stack de observabilidade no Docker (Prometheus, Grafana, Loki, Promtail e exporters).
-
-Variáveis legadas foram mantidas por compatibilidade (`QUOTE_API_URL`, `WAIFU_API_*`, `STORE_PATH`), mas não participam do fluxo principal atual.
-
-## Scripts npm
-
-- `npm run start`: inicia o app (`node index.js`).
-- `npm run dev`: alias de start.
-- `npm run db:init`: cria/valida schema e executa migrations.
-- `npm run pm2:prod`: sobe com PM2 usando `ecosystem.prod.config.cjs`.
-- `npm run deploy`: deploy automático de `public/` com cache-bust, backup, validação e reload do Nginx.
-- `npm run deploy:dry-run`: simula o deploy sem publicar/recarregar serviços.
-- `npm run readme:sync-snapshot`: sincroniza o bloco dinâmico do README consumindo `/api/sticker-packs/readme-markdown`.
-- `npm run release`: release completo com versão unificada (npmjs + GitHub Packages + GitHub Release) e verificação final.
-- `npm run release:minor`: bump `minor` + deploy + publish do package.
-- `npm run release:major`: bump `major` + deploy + publish do package.
-- `npm run test`: executa testes Node (`node --test`).
-- `npm run lint`: lint com ESLint.
-- `npm run lint:fix`: lint com correções automáticas.
-
-## Deploy automático (Nginx + cache-bust)
-
-Comando padrão:
-
-```bash
-npm run deploy
-```
-
-Variáveis úteis:
-
-- `DEPLOY_TARGET_DIR` (default: `/var/www/omnizap`)
-- `DEPLOY_NGINX_SERVICE` (default: `nginx`)
-- `DEPLOY_PM2_APP_NAME` (default: `omnizap-system-production`)
-- `DEPLOY_RESTART_PM2` (default: `1`)
-- `DEPLOY_CREATE_BACKUP` (default: `1`)
-- `DEPLOY_VERIFY_URL` (default: `https://omnizap.shop/`)
-- `DEPLOY_GITHUB_NOTIFY` (default: `1`) - cria/atualiza deployment no GitHub
-- `DEPLOY_GITHUB_ENVIRONMENT` (default: `production`)
-- `DEPLOY_GITHUB_REPO` (opcional, ex.: `kaikybrofc/omnizap-system`)
-- `DEPLOY_GITHUB_TOKEN` (opcional; se vazio usa `GITHUB_TOKEN`/`GH_TOKEN`)
-- `DEPLOY_PACKAGE_STEP` (default: `0`) - executa etapa de package durante o deploy
-- `DEPLOY_PACKAGE_INSTALL` (default: `1`) - instala dependências (`npm ci --omit=dev`)
-- `DEPLOY_PACKAGE_TEST` (default: `0`) - executa `npm test`
-- `DEPLOY_PACKAGE_PACK` (default: `0`) - gera artefato `npm pack`
-- `DEPLOY_PACKAGE_ARTIFACTS_DIR` (default: `.artifacts`) - pasta dos artefatos do pack
-- `DEPLOY_PACKAGE_PUBLISH` (default: `0`) - publica em registry npm
-- `DEPLOY_PACKAGE_REGISTRY` (default: `https://npm.pkg.github.com`)
-- `DEPLOY_PACKAGE_TOKEN` (opcional; fallback automático por tipo de registry)
-- `DEPLOY_PACKAGE_OTP` (opcional) - OTP para publish quando 2FA interativo for exigido
-- `DEPLOY_PACKAGE_SCOPE_OWNER` (opcional) - owner esperado do scope para publish (ex.: `kaikybrofc` ou sua org)
-- `DEPLOY_PACKAGE_TAG` (default: `latest`)
-- `DEPLOY_PACKAGE_PUBLISH_SKIP_IF_EXISTS` (default: `1`) - evita erro se versão já existir
-- `DEPLOY_PACKAGE_PUBLISH_SECONDARY` (default: `0`) - habilita publish secundário (dual publish)
-- `DEPLOY_PACKAGE_SECONDARY_REGISTRY` (default: `https://registry.npmjs.org`)
-- `DEPLOY_PACKAGE_SECONDARY_TOKEN` (opcional; fallback: `NPM_TOKEN`/`NODE_AUTH_TOKEN`/demais tokens)
-- `DEPLOY_PACKAGE_SECONDARY_OTP` (opcional) - OTP do npmjs para publish com 2FA
-- `DEPLOY_PACKAGE_SECONDARY_TAG` (default: `latest`)
-- `DEPLOY_PACKAGE_SECONDARY_ACCESS` (default: `public`) - usado para pacote escopado no npmjs
-- `DEPLOY_PACKAGE_SECONDARY_PUBLISH_SKIP_IF_EXISTS` (default: mesmo valor de `DEPLOY_PACKAGE_PUBLISH_SKIP_IF_EXISTS`)
-- `DEPLOY_PACKAGE_SECONDARY_TOKEN_KEYS` (opcional) - ordem customizada de fallback de tokens
-
-Para `npm.pkg.github.com`, prefira token do GitHub (`DEPLOY_GITHUB_TOKEN` ou `GITHUB_TOKEN`); `NPM_TOKEN` comum pode não autenticar no registry do GitHub.
-Para `npm.pkg.github.com`, o nome do pacote deve ser escopado com owner existente (`@owner/pacote`), por exemplo `@kaikybrofc/omnizap-system`.
-Para `registry.npmjs.org`, use token do npmjs (não token do GitHub). Se sua conta exigir 2FA para publish, use token granular com bypass 2FA habilitado ou informe OTP via `DEPLOY_PACKAGE_SECONDARY_OTP`.
-
-Exemplo sem restart do PM2:
-
-```bash
-DEPLOY_RESTART_PM2=0 npm run deploy
-```
-
-Exemplo com marcação explícita no GitHub:
-
-```bash
-DEPLOY_GITHUB_NOTIFY=1 DEPLOY_GITHUB_ENVIRONMENT=production npm run deploy
-```
-
-Exemplo com etapa package completa:
-
-```bash
-DEPLOY_PACKAGE_STEP=1 DEPLOY_PACKAGE_TEST=1 DEPLOY_PACKAGE_PACK=1 npm run deploy
-```
-
-Exemplo publicando no GitHub Packages:
-
-```bash
-DEPLOY_PACKAGE_STEP=1 DEPLOY_PACKAGE_PUBLISH=1 DEPLOY_PACKAGE_TOKEN=seu_token npm run deploy
-```
-
-Exemplo de dual publish (GitHub Packages + npmjs):
-
-```bash
-DEPLOY_PACKAGE_STEP=1 \
-DEPLOY_PACKAGE_PUBLISH=1 \
-DEPLOY_PACKAGE_PUBLISH_SECONDARY=1 \
-DEPLOY_PACKAGE_SECONDARY_TOKEN=seu_token_npmjs \
-npm run deploy
-```
-
-Comando único de release (patch + deploy + publish):
-
-```bash
-npm run release
-```
-
-`npm run release` executa publish primário + secundário por padrão e valida consistência final de versão.
-
-Variáveis do fluxo de release (git):
-
-- `RELEASE_TYPE` (default: `patch`)
-- `RELEASE_FORCE_VERSION` (opcional) - força versão exata (ex.: `2.2.0`)
-- `RELEASE_PATCH_ROLLOVER_ENABLED` (default: `1`) - rollover automático de patch
-- `RELEASE_PATCH_ROLLOVER_AT` (default: `10`) - quando patch atingir este valor, próximo release vira `major.(minor+1).0`
-- `RELEASE_GIT_AUTO_COMMIT` (default: `1`) - commit automático se houver alterações pendentes
-- `RELEASE_GIT_AUTO_PUSH` (default: `1`) - push automático dos commits gerados
-- `RELEASE_GIT_REMOTE` (default: `origin`)
-- `RELEASE_GIT_BRANCH` (opcional; vazio usa branch atual)
-- `RELEASE_GIT_PRE_COMMIT_MESSAGE` (default: `chore(release): auto-commit before release`)
-- `RELEASE_GIT_COMMIT_VERSION` (default: `1`) - commita alteração da versão após sucesso
-- `RELEASE_README_SYNC` (default: `1`) - sincroniza bloco dinâmico do README via API antes do commit/tag
-- `RELEASE_README_SYNC_REQUIRED` (default: `0`) - se `1`, falha o release quando a sincronização do README falhar
-- `RELEASE_README_SYNC_COMMAND` (default: `npm run readme:sync-snapshot`) - comando customizável para sincronização
-- `RELEASE_GIT_VERSION_COMMIT_PREFIX` (default: `chore(release): v`)
-- `RELEASE_GIT_TAG_CREATE` (default: `1`) - cria tag `vX.Y.Z` no release
-- `RELEASE_GIT_TAG_PUSH` (default: `1`) - envia a tag para o remoto
-- `RELEASE_GIT_TAG_ANNOTATED` (default: `1`) - usa tag anotada (`git tag -a`)
-- `RELEASE_GITHUB_RELEASE` (default: `1`) - cria/atualiza GitHub Release na aba Releases
-- `RELEASE_REQUIRE_GITHUB_RELEASE` (default: `1`) - falha se GitHub Release estiver desativado
-- `RELEASE_GITHUB_REPO` (opcional; ex.: `kaikybrofc/omnizap-system`)
-- `RELEASE_GITHUB_TOKEN` (opcional; fallback: `DEPLOY_GITHUB_TOKEN`/`GITHUB_TOKEN`/`GH_TOKEN`)
-- `RELEASE_GITHUB_TAG_PREFIX` (default: `v`) - prefixo da tag (`v2.1.9`)
-- `RELEASE_GITHUB_NAME_PREFIX` (default: `v`) - prefixo do nome exibido na release
-- `RELEASE_GITHUB_GENERATE_NOTES` (default: `1`) - usa notas automáticas do GitHub
-- `RELEASE_GITHUB_RELEASE_INCLUDE_CHANGED_FILES` (default: `1`) - adiciona markdown com arquivos alterados no corpo da release
-- `RELEASE_GITHUB_RELEASE_MAX_FILES` (default: `300`) - limite de arquivos listados no markdown
-- `RELEASE_GITHUB_PRERELEASE` (default: auto) - vazio detecta `-` na versão como prerelease
-- `RELEASE_GITHUB_DRAFT` (default: `0`)
-- `RELEASE_GITHUB_TARGET` (opcional; vazio usa `HEAD`)
-- `RELEASE_REQUIRE_DUAL_PUBLISH` (default: `1`) - exige publish em GitHub Packages e npmjs
-- `RELEASE_VERIFY_UNIFIED_VERSION` (default: `1`) - valida versão final em local + registries + GitHub Release
-- `RELEASE_VERIFY_PRIMARY_REGISTRY` (default: `https://npm.pkg.github.com`)
-- `RELEASE_VERIFY_SECONDARY_REGISTRY` (default: `https://registry.npmjs.org`)
-- `RELEASE_VERIFY_PRIMARY_TOKEN_KEYS` / `RELEASE_VERIFY_SECONDARY_TOKEN_KEYS` - ordem de fallback de tokens para verificação
-
-Exemplo de rollover automático:
-
-- `2.1.9` + `npm run release` -> `2.1.10`
-- `2.1.10` + `npm run release` -> `2.2.0`
-
-## Execução com PM2
-
-Após conectar o QR uma primeira vez em modo normal:
-
-```bash
-npm run pm2:prod
-```
-
-Comandos úteis:
+## Experiencia OmniZap
 
-```bash
-pm2 status
-pm2 logs
-pm2 restart omnizap-system-production
-```
+- Login seguro com Google e vinculacao ao numero do WhatsApp.
+- Sessao web compartilhada entre as paginas (login unico).
+- Criacao de packs com capa, descricao, tags e visibilidade.
+- Catalogo publico com busca por packs e figurinhas.
+- Comandos rapidos para transformar imagem/video/texto em sticker.
 
-> O QR Code não é exibido no fluxo do PM2. Conecte primeiro no modo normal.
+## Comandos mais usados no WhatsApp
 
-## Comandos principais
-
-Use `menu` para ver os comandos por categoria. Exemplos:
+O prefixo pode variar no seu grupo. Nos exemplos abaixo, foi usado `/`.
 
-- `<prefix>menu`
-- `<prefix>menu figurinhas`
-- `<prefix>menu midia`
-- `<prefix>menu ia`
-- `<prefix>menu stats`
-- `<prefix>menuadm`
+- `/s` ou `/sticker`: cria figurinha da midia respondida.
+- `/st`, `/stw`, `/stb`: sticker de texto (normal, branco, blink).
+- `/toimg`: converte figurinha para imagem.
+- `/pack create "Meu Pack"`: cria um novo pack.
+- `/pack add <pack>`: adiciona a ultima figurinha no pack.
+- `/pack list`: lista seus packs.
+- `/pack send <pack>`: envia figurinhas de um pack.
+- `/pack publish <pack> <public|private|unlisted>`: define visibilidade.
+- `/user perfil`: mostra dados e resumo do usuario.
 
-Comandos mais usados:
-
-- `<prefix>sticker` / `<prefix>s`
-- `<prefix>stickertext` / `<prefix>st` / `<prefix>stw` / `<prefix>stb`
-- `<prefix>toimg` / `<prefix>tovideo`
-- `<prefix>play <busca|url>`
-- `<prefix>playvid <busca|url>`
-- `<prefix>tiktok <url>`
-- `<prefix>quote`
-- `<prefix>cat`, `<prefix>catimg`, `<prefix>catprompt`
-- `<prefix>ranking`, `<prefix>rankingglobal`, `<prefix>semmsg`
-- `<prefix>user perfil`
+## Fluxo rapido de packs
 
-## Sticker packs persistentes
-
-Exemplos de fluxo:
-
-```text
-<prefix>pack create "Meu Pack"
-<prefix>pack add <pack>
-<prefix>pack list
-<prefix>pack info <pack>
-<prefix>pack send <pack>
-<prefix>pack publish <pack> <private|public|unlisted>
-<prefix>pack delete <pack>
-```
+1. Crie o pack com `/pack create "Nome do Pack"`.
+2. Gere figurinhas com `/s` e adicione com `/pack add <pack>`.
+3. Confira com `/pack list`.
+4. Publique com `/pack publish <pack> public`.
+5. Veja no catalogo web em `https://omnizap.shop/stickers/`.
 
-Notas:
+## Paginas web principais
 
-- Edição de pack é restrita ao dono (`owner_jid`).
-- O envio tenta sticker pack nativo e faz fallback automático quando necessário.
-- O sistema captura “última figurinha” para simplificar `add` e `setcover`.
+- `/login/`: autenticacao e vinculacao da conta.
+- `/user/`: painel com perfil, estatisticas e seus packs.
+- `/stickers/`: busca de packs publicados e visualizacao das figurinhas.
 
-### Catálogo web de packs
+## Nao estou vendo meu pack. E agora?
 
-O servidor HTTP de observabilidade também expõe um catálogo web simples para os packs publicados:
+- Confirme se o pack foi publicado com visibilidade correta.
+- Rode `/pack list` para validar se o pack esta na sua conta.
+- No painel `/user/`, verifique se voce esta logado com o mesmo Google usado no WhatsApp.
+- Se estiver em outra conta/sessao antiga, saia e faça login novamente.
 
-- Página web: `http://localhost:9102/stickers`
-- API: `http://localhost:9102/api/sticker-packs`
-- Endpoint de métricas permanece em: `http://localhost:9102/metrics`
+## Boas praticas
 
-Em produção (instância oficial):
+- Nao compartilhe o link de login recebido no WhatsApp.
+- Use apenas o dominio oficial `omnizap.shop`.
+- Revise os termos antes de publicar conteudo publico.
 
-- Página web: `https://omnizap.shop/stickers/`
-- API: `https://omnizap.shop/api/sticker-packs`
-- API Docs: `https://omnizap.shop/api-docs/`
+## Snapshot dinamico do sistema
 
-Principais rotas da API:
+Este bloco pode ser atualizado automaticamente pela API (`/api/sticker-packs/readme-markdown`).
 
-- `GET /api/sticker-packs?q=&visibility=public|unlisted|all&limit=&offset=`
-- `GET /api/sticker-packs/orphan-stickers?q=&limit=&offset=` (figurinhas salvas sem pack)
-- `GET /api/sticker-packs/:packKey`
-- `GET /api/sticker-packs/:packKey/stickers/:stickerId.webp`
-- `GET /api/sticker-packs/data-files?q=&limit=&offset=` (lista imagens da pasta `data`)
-- `GET /data/<caminho-da-imagem>` (acesso direto ao arquivo de imagem)
-
-## Suporte a LID/JID
-
-O WhatsApp pode alternar IDs entre `@lid` e `@s.whatsapp.net`.  
-O OmniZap resolve isso com um `sender_id` canônico para manter métricas/rankings consistentes.
-
-- Tabela dedicada: `lid_map`.
-- Cache em memória com TTL.
-- Reconciliação automática quando o JID real aparece.
-- Backfill opcional no startup.
-
-## Classificação de imagens (CLIP / MobileCLIP)
-
-Para categorizar packs e stickers solos (ex.: anime/game/real/cartoon/nsfw), foi adicionado um microserviço Python:
-
-- Caminho: `ml/clip_classifier`
-- Stack: `FastAPI + MobileCLIP (OpenCLIP) + PyTorch`
-- Endpoint: `POST /classify` (upload de imagem)
-
-Documentação e execução:
-
-```bash
-cd ml/clip_classifier
-cat README.md
-```
-
-## Observabilidade (Prometheus + Grafana + Loki)
-
-O projeto inclui `docker-compose.yml` com:
-
-- Prometheus
-- Grafana
-- Loki
-- Promtail
-- MySQL Exporter
-- Node Exporter
-
-Subir stack:
-
-```bash
-docker compose up -d
-```
-
-Setup recomendado de métricas MySQL:
-
-```bash
-sudo mysql < observability/mysql-setup.sql
-```
-
-Acessos padrão:
-
-- Grafana: `http://localhost:3003`
-- Prometheus: `http://localhost:9090`
-- Loki: `http://localhost:3100`
-- Métricas do app: `http://localhost:9102/metrics`
-
-Arquivos úteis:
-
-- `observability/prometheus.yml`
-- `observability/alert-rules.yml`
-- `observability/grafana/dashboards/omnizap-overview.json`
-- `observability/grafana/dashboards/omnizap-mysql.json`
-
-## Troubleshooting
-
-**QR não aparece no PM2**
-
-- Inicie com `npm run start`, conecte o QR e depois volte para PM2.
-- Se necessário, limpe sessão salva e reconecte.
-
-**Erro de conexão MySQL**
-
-- Verifique `DB_HOST`, `DB_USER`, `DB_PASSWORD`, `DB_NAME`.
-- Confirme se o usuário possui permissão de leitura/escrita.
+<!-- README_SNAPSHOT:START -->
 
-**FFmpeg não encontrado**
+### Snapshot do Sistema
 
-- Instale FFmpeg no sistema ou configure `FFMPEG_PATH`/`FFPROBE_PATH`.
+> Atualizado em `2026-03-01T02:48:19.346Z` | cache `1800s`
 
-**Comando `play` falhando**
+| Metrica               |   Valor |
+| --------------------- | ------: |
+| Usuarios (lid_map)    |   5.516 |
+| Grupos                |     116 |
+| Packs                 |     307 |
+| Stickers              |   7.245 |
+| Mensagens registradas | 446.542 |
 
-- Verifique se o serviço configurado em `YTDLS_BASE_URL`/`YT_DLS_BASE_URL` está ativo.
+#### Tipos de mensagem mais usados (amostra: 25.000)
 
-**Comando `tiktok` falhando**
+| Tipo        |  Total |
+| ----------- | -----: |
+| `texto`     | 15.772 |
+| `figurinha` |  4.775 |
+| `reacao`    |  1.652 |
+| `imagem`    |  1.386 |
+| `outros`    |  1.000 |
+| `video`     |    225 |
+| `audio`     |    183 |
+| `documento` |      7 |
 
-- Verifique se sua API local está ativa em `TIKTOK_EXTRACT_BASE_URL` + `TIKTOK_EXTRACT_PATH` (ex.: `http://127.0.0.1:8000/extract`).
+<details><summary>Comandos disponiveis (62)</summary>
 
-## Tecnologias
+`/add` · `/addmode` · `/autorequests` · `/autosticker` · `/ban` · `/captcha` · `/cat` · `/catimg` · `/catprompt` · `/catprompt reset` · `/dado` · `/down` · `/farewell` · `/groups` · `/info` · `/invite` · `/join` · `/leave` · `/menu anime` · `/menu figurinhas` · `/menu ia` · `/menu midia` · `/menu quote` · `/menu stats` · `/menuadm` · `/metadata` · `/newgroup` · `/noticias` · `/nsfw` · `/pack add` · `/pack create` · `/pack list` · `/pack send` · `/ping` · `/play` · `/playvid` · `/prefix` · `/premium` · `/quote` · `/ranking` · `/rankingglobal` · `/requests` · `/revoke` · `/s` · `/semmsg` · `/setdesc` · `/setgroup` · `/setsubject` · `/st` · `/stb` · `/sticker` · `/stickertext` · `/stickertextblink` · `/stickertextwhite` · `/stw` · `/temp` · `/tiktok` · `/toimg` · `/up` · `/updaterequests` · `/user perfil` · `/welcome`
 
-- Node.js
-- MySQL (`mysql2`)
-- Baileys (`@whiskeysockets/baileys`)
-- OpenAI SDK
-- Axios
-- Canvas
-- PM2
-- Prometheus / Grafana / Loki
+</details>
+<!-- README_SNAPSHOT:END -->
 
-## Contribuições
+## Suporte
 
-1. Faça um fork.
-2. Crie uma branch: `git checkout -b feature/minha-feature`.
-3. Commit: `git commit -m "feat: minha feature"`.
-4. Push: `git push origin feature/minha-feature`.
-5. Abra um Pull Request.
+- Canal principal: https://omnizap.shop/
+- Para problemas de acesso/login, gere um novo link enviando `iniciar` no WhatsApp do bot.
 
-## Licença
+## Licenca
 
-Licença MIT. Veja [`LICENSE`](LICENSE).
+Licenca MIT. Consulte o arquivo `LICENSE`.