@omnizap-system/omnizap 2.5.12

package/app/modules/rpgPokemonModule/rpgProfileCanvasRenderer.js

@@ -0,0 +1,354 @@
+import axios from 'axios';
+import { createCanvas, loadImage } from 'canvas';
+import logger from '#logger';
+
+const WIDTH = 1600;
+const HEIGHT = 1200;
+const PANEL_RADIUS = 26;
+const IMAGE_TIMEOUT_MS = Math.max(2_000, Number(process.env.RPG_PROFILE_CANVAS_TIMEOUT_MS) || 6_000);
+const IMAGE_CACHE_TTL_MS = Math.max(2 * 60 * 1000, Number(process.env.RPG_PROFILE_CANVAS_CACHE_TTL_MS) || 10 * 60 * 1000);
+const IMAGE_CACHE_LIMIT = Math.max(20, Number(process.env.RPG_PROFILE_CANVAS_CACHE_LIMIT) || 80);
+
+const imageCache = globalThis.__omnizapProfileCanvasImageCache instanceof Map ? globalThis.__omnizapProfileCanvasImageCache : new Map();
+globalThis.__omnizapProfileCanvasImageCache = imageCache;
+
+const TYPE_COLORS = new Map([
+  ['normal', '#a8a77a'],
+  ['fire', '#ee8130'],
+  ['water', '#6390f0'],
+  ['electric', '#f7d02c'],
+  ['grass', '#7ac74c'],
+  ['ice', '#96d9d6'],
+  ['fighting', '#c22e28'],
+  ['poison', '#a33ea1'],
+  ['ground', '#e2bf65'],
+  ['flying', '#a98ff3'],
+  ['psychic', '#f95587'],
+  ['bug', '#a6b91a'],
+  ['rock', '#b6a136'],
+  ['ghost', '#735797'],
+  ['dragon', '#6f35fc'],
+  ['dark', '#705746'],
+  ['steel', '#b7b7ce'],
+  ['fairy', '#d685ad'],
+]);
+
+const clamp = (value, min, max) => Math.max(min, Math.min(max, value));
+
+const toInt = (value, fallback = 0) => {
+  const numeric = Number(value);
+  return Number.isFinite(numeric) ? Math.trunc(numeric) : fallback;
+};
+
+const toText = (value, fallback = 'N/D') => {
+  if (value === null || value === undefined) return fallback;
+  const text = String(value).trim();
+  return text || fallback;
+};
+
+const trimText = (value, max = 120) => {
+  const text = String(value || '')
+    .replace(/\s+/g, ' ')
+    .trim();
+  if (!text) return '';
+  if (text.length <= max) return text;
+  return `${text.slice(0, Math.max(16, max - 1)).trimEnd()}…`;
+};
+
+const drawRoundRect = (ctx, x, y, width, height, radius, fillStyle) => {
+  ctx.beginPath();
+  ctx.moveTo(x + radius, y);
+  ctx.lineTo(x + width - radius, y);
+  ctx.quadraticCurveTo(x + width, y, x + width, y + radius);
+  ctx.lineTo(x + width, y + height - radius);
+  ctx.quadraticCurveTo(x + width, y + height, x + width - radius, y + height);
+  ctx.lineTo(x + radius, y + height);
+  ctx.quadraticCurveTo(x, y + height, x, y + height - radius);
+  ctx.lineTo(x, y + radius);
+  ctx.quadraticCurveTo(x, y, x + radius, y);
+  ctx.closePath();
+  if (fillStyle) {
+    ctx.fillStyle = fillStyle;
+    ctx.fill();
+  }
+};
+
+const cleanupImageCache = () => {
+  if (imageCache.size <= IMAGE_CACHE_LIMIT) return;
+  const now = Date.now();
+  for (const [key, value] of imageCache.entries()) {
+    if (!value || value.expiresAt <= now) imageCache.delete(key);
+  }
+  while (imageCache.size > IMAGE_CACHE_LIMIT) {
+    const oldest = imageCache.keys().next().value;
+    imageCache.delete(oldest);
+  }
+};
+
+const resolveImage = async (url) => {
+  const normalized = String(url || '').trim();
+  if (!normalized) return null;
+
+  const cached = imageCache.get(normalized);
+  if (cached && cached.expiresAt > Date.now()) return cached.image;
+
+  try {
+    const response = await axios.get(normalized, {
+      responseType: 'arraybuffer',
+      timeout: IMAGE_TIMEOUT_MS,
+      validateStatus: (status) => status >= 200 && status < 400,
+    });
+    const image = await loadImage(Buffer.from(response.data));
+    imageCache.set(normalized, {
+      image,
+      expiresAt: Date.now() + IMAGE_CACHE_TTL_MS,
+    });
+    cleanupImageCache();
+    return image;
+  } catch (error) {
+    logger.debug('Falha ao carregar imagem para perfil canvas.', {
+      url: normalized,
+      error: error.message,
+    });
+    return null;
+  }
+};
+
+const drawProgressBar = ({ ctx, x, y, width, height, progressPct = 0, color = '#22d3ee', background = 'rgba(15,23,42,0.75)' }) => {
+  drawRoundRect(ctx, x, y, width, height, Math.min(14, Math.round(height / 2)), background);
+  const ratio = clamp(Number(progressPct) / 100, 0, 1);
+  if (ratio <= 0) return;
+  drawRoundRect(ctx, x + 2, y + 2, Math.max(0, (width - 4) * ratio), Math.max(0, height - 4), Math.min(12, Math.round((height - 4) / 2)), color);
+};
+
+const sanitizeProfileText = (text) => {
+  const raw = String(text || '');
+  return raw
+    .split('\n')
+    .map((line) =>
+      String(line || '')
+        .replace(/\*/g, '')
+        .replace(/\s+$/g, ''),
+    )
+    .filter((line, index, lines) => line || (index > 0 && lines[index - 1]));
+};
+
+const wrapLine = (ctx, line, maxWidth) => {
+  const text = String(line || '').trim();
+  if (!text) return [''];
+
+  const words = text.split(' ');
+  const wrapped = [];
+  let current = '';
+
+  for (const word of words) {
+    const candidate = current ? `${current} ${word}` : word;
+    if (ctx.measureText(candidate).width <= maxWidth) {
+      current = candidate;
+      continue;
+    }
+    if (current) {
+      wrapped.push(current);
+      current = word;
+      continue;
+    }
+
+    let chunk = word;
+    while (chunk.length > 1 && ctx.measureText(chunk).width > maxWidth) {
+      const safeSize = Math.max(1, Math.floor((maxWidth / Math.max(1, ctx.measureText(chunk).width)) * chunk.length));
+      const part = chunk.slice(0, safeSize);
+      wrapped.push(`${part}…`);
+      chunk = chunk.slice(safeSize);
+    }
+    current = chunk;
+  }
+
+  if (current) wrapped.push(current);
+  return wrapped.length ? wrapped : [''];
+};
+
+const isHeaderLine = (line) => {
+  const value = String(line || '').trim();
+  if (!value) return false;
+  if (/^\d+\./.test(value)) return false;
+  if (value.startsWith('•')) return false;
+  return value.length <= 36;
+};
+
+export const renderProfileCanvasCard = async ({ trainerLabel = 'Treinador', generatedAtLabel = null, activePokemon = null, summary = {}, profileText = '' }) => {
+  const canvas = createCanvas(WIDTH, HEIGHT);
+  const ctx = canvas.getContext('2d');
+
+  const primaryType = String(activePokemon?.types?.[0] || '')
+    .trim()
+    .toLowerCase();
+  const accent = TYPE_COLORS.get(primaryType) || '#38bdf8';
+
+  const bgGradient = ctx.createLinearGradient(0, 0, WIDTH, HEIGHT);
+  bgGradient.addColorStop(0, '#0b1220');
+  bgGradient.addColorStop(0.55, '#111827');
+  bgGradient.addColorStop(1, '#1e293b');
+  ctx.fillStyle = bgGradient;
+  ctx.fillRect(0, 0, WIDTH, HEIGHT);
+
+  const glow = ctx.createRadialGradient(240, 240, 40, 240, 240, 560);
+  glow.addColorStop(0, `${accent}70`);
+  glow.addColorStop(1, 'rgba(2,6,23,0)');
+  ctx.fillStyle = glow;
+  ctx.fillRect(0, 0, WIDTH, HEIGHT);
+
+  const leftX = 40;
+  const leftY = 40;
+  const leftW = 470;
+  const leftH = HEIGHT - 80;
+  drawRoundRect(ctx, leftX, leftY, leftW, leftH, PANEL_RADIUS, 'rgba(2, 6, 23, 0.72)');
+
+  const rightX = leftX + leftW + 24;
+  const rightY = 40;
+  const rightW = WIDTH - rightX - 40;
+  const rightH = HEIGHT - 80;
+  drawRoundRect(ctx, rightX, rightY, rightW, rightH, PANEL_RADIUS, 'rgba(2, 6, 23, 0.65)');
+
+  ctx.fillStyle = '#e2e8f0';
+  ctx.font = '700 40px Sans';
+  ctx.fillText('PERFIL RPG', leftX + 30, leftY + 62);
+
+  ctx.fillStyle = '#94a3b8';
+  ctx.font = '500 22px Sans';
+  ctx.fillText(trimText(trainerLabel, 22), leftX + 30, leftY + 96);
+
+  const levelText = `Nivel ${toInt(summary?.level, 1)}`;
+  const goldText = `${toInt(summary?.gold, 0)} gold`;
+  ctx.fillStyle = '#f8fafc';
+  ctx.font = '700 28px Sans';
+  ctx.fillText(levelText, leftX + 30, leftY + 146);
+  ctx.fillText(goldText, leftX + 30, leftY + 184);
+
+  ctx.fillStyle = '#94a3b8';
+  ctx.font = '500 20px Sans';
+  const rankText = Number.isFinite(Number(summary?.pvpWeeklyRank)) ? `Rank PvP: #${toInt(summary?.pvpWeeklyRank, 0)}` : 'Rank PvP: sem rank';
+  const streakText = `Streak: ${toText(summary?.streakLabel, 'Sem historico')}`;
+  ctx.fillText(trimText(rankText, 34), leftX + 30, leftY + 220);
+  ctx.fillText(trimText(streakText, 34), leftX + 30, leftY + 248);
+
+  const xpProgressPct = clamp(toInt(summary?.xpProgressPct, 0), 0, 100);
+  drawProgressBar({
+    ctx,
+    x: leftX + 30,
+    y: leftY + 272,
+    width: leftW - 60,
+    height: 24,
+    progressPct: xpProgressPct,
+    color: accent,
+  });
+
+  ctx.fillStyle = '#e2e8f0';
+  ctx.font = '600 18px Sans';
+  ctx.fillText(`XP: ${toInt(summary?.xp, 0)} (${xpProgressPct}%)`, leftX + 30, leftY + 325);
+  if (toInt(summary?.xpToNextLevel, 0) > 0) {
+    ctx.fillText(`Faltam ${toInt(summary?.xpToNextLevel, 0)} XP para o nivel ${toInt(summary?.nextLevel, toInt(summary?.level, 1) + 1)}`, leftX + 30, leftY + 350);
+  } else {
+    ctx.fillText('Nivel maximo alcancado', leftX + 30, leftY + 350);
+  }
+
+  const spriteX = leftX + 30;
+  const spriteY = leftY + 380;
+  const spriteW = leftW - 60;
+  const spriteH = 330;
+  drawRoundRect(ctx, spriteX, spriteY, spriteW, spriteH, 22, 'rgba(15, 23, 42, 0.8)');
+
+  const image = await resolveImage(activePokemon?.imageUrl || activePokemon?.sprite || null);
+  if (image) {
+    const size = Math.min(spriteW - 36, spriteH - 36);
+    const drawX = spriteX + (spriteW - size) / 2;
+    const drawY = spriteY + (spriteH - size) / 2;
+    ctx.drawImage(image, drawX, drawY, size, size);
+  } else {
+    ctx.fillStyle = 'rgba(148, 163, 184, 0.2)';
+    drawRoundRect(ctx, spriteX + 18, spriteY + 18, spriteW - 36, spriteH - 36, 18, 'rgba(148, 163, 184, 0.14)');
+    ctx.fillStyle = '#94a3b8';
+    ctx.font = '600 22px Sans';
+    ctx.textAlign = 'center';
+    ctx.fillText('Imagem indisponivel', spriteX + spriteW / 2, spriteY + spriteH / 2 + 8);
+    ctx.textAlign = 'start';
+  }
+
+  const pokemonName = trimText(activePokemon?.displayName || activePokemon?.name || 'Sem Pokemon ativo', 28);
+  ctx.fillStyle = '#f8fafc';
+  ctx.font = '700 26px Sans';
+  ctx.fillText(pokemonName, leftX + 30, leftY + 748);
+
+  const hpCurrent = Math.max(0, toInt(activePokemon?.currentHp, 0));
+  const hpMax = Math.max(1, toInt(activePokemon?.maxHp, 1));
+  const typeText = Array.isArray(activePokemon?.types) && activePokemon.types.length ? activePokemon.types.join(', ') : 'tipo indefinido';
+  ctx.fillStyle = '#94a3b8';
+  ctx.font = '500 20px Sans';
+  ctx.fillText(`Lv.${Math.max(1, toInt(activePokemon?.level, 1))}  |  HP ${hpCurrent}/${hpMax}`, leftX + 30, leftY + 782);
+  ctx.fillText(trimText(`Tipos: ${typeText}`, 36), leftX + 30, leftY + 812);
+
+  if (generatedAtLabel) {
+    ctx.fillStyle = '#64748b';
+    ctx.font = '500 17px Sans';
+    ctx.fillText(`Atualizado em ${generatedAtLabel}`, leftX + 30, leftY + leftH - 24);
+  }
+
+  ctx.fillStyle = '#e2e8f0';
+  ctx.font = '700 34px Sans';
+  ctx.fillText('Informacoes do jogador', rightX + 28, rightY + 56);
+
+  ctx.fillStyle = '#94a3b8';
+  ctx.font = '500 18px Sans';
+  ctx.fillText('Resumo completo em duas colunas', rightX + 28, rightY + 84);
+
+  const textLines = sanitizeProfileText(profileText);
+  ctx.font = '500 20px Sans';
+
+  const contentTop = rightY + 122;
+  const contentBottom = rightY + rightH - 28;
+  const lineHeight = 24;
+  const colGap = 28;
+  const colWidth = Math.floor((rightW - 56 - colGap) / 2);
+  const colOneX = rightX + 28;
+  const colTwoX = colOneX + colWidth + colGap;
+  const maxLinesPerCol = Math.max(1, Math.floor((contentBottom - contentTop) / lineHeight));
+  const maxLines = maxLinesPerCol * 2;
+
+  const wrapped = [];
+  for (const line of textLines) {
+    const normalized = String(line || '');
+    if (!normalized.trim()) {
+      wrapped.push('');
+      continue;
+    }
+    const segments = wrapLine(ctx, normalized, colWidth - 2);
+    segments.forEach((segment) => wrapped.push(segment));
+  }
+
+  const truncated = wrapped.length > maxLines;
+  const visible = wrapped.slice(0, maxLines);
+  if (truncated && visible.length) {
+    visible[visible.length - 1] = '... use /rpg perfil para ver texto completo';
+  }
+
+  visible.forEach((line, index) => {
+    const colIndex = Math.floor(index / maxLinesPerCol);
+    const rowIndex = index % maxLinesPerCol;
+    const x = colIndex === 0 ? colOneX : colTwoX;
+    const y = contentTop + rowIndex * lineHeight;
+
+    if (!line) return;
+
+    if (isHeaderLine(line)) {
+      ctx.fillStyle = '#f8fafc';
+      ctx.font = '700 20px Sans';
+      ctx.fillText(trimText(line, 64), x, y);
+      return;
+    }
+
+    ctx.fillStyle = '#cbd5e1';
+    ctx.font = '500 19px Sans';
+    ctx.fillText(trimText(line, 94), x, y);
+  });
+
+  return canvas.toBuffer('image/png', { compressionLevel: 4 });
+};

package/app/modules/statsModule/AGENT.md

@@ -0,0 +1,320 @@
+# StatsModule Agent Guide
+
+Este arquivo e destinado a agentes de IA para gerar respostas no contexto dos comandos deste modulo.
+
+## Fonte de Verdade
+
+- arquivo_base: `app/modules/statsModule/commandConfig.json`
+- schema_version: `2.0.0`
+- module_enabled: `true`
+- generated_at: `2026-03-11T02:35:17.177Z`
+
+## Escopo do Modulo
+
+- module: `statsModule`
+- source_files:
+- rankingCommand.js
+- globalRankingCommand.js
+- total_commands: `2`
+- total_enabled_commands: `2`
+
+## Defaults Schema v2
+
+- inheritance_mode: deep_merge_with_command_overrides
+- compatibility_mode: legacy_and_v2_fields
+- legacy_field_aliases:
+- descricao: description
+- metodos_de_uso: usage
+- permissao_necessaria: permission
+- local_de_uso: contexts
+- informacoes_coletadas: collected_data
+- pre_condicoes: requirements
+- dependencias_externas: dependencies
+- efeitos_colaterais: side_effects
+- observabilidade: observability
+- privacidade: privacy
+- limite_uso_por_plano: plan_limits
+- argumentos: arguments
+- acesso: access
+- defaults.command:
+- enabled: true
+- category: estatisticas
+- version: 1.0.0
+- stability: stable
+- deprecated: false
+- replaced_by: null
+- risk_level: medium
+- defaults.requirements (legacy view):
+- requer_grupo: sim
+- requer_admin: nao
+- requer_admin_principal: nao
+- requer_google_login: sim
+- requer_nsfw: nao
+- requer_midia: nao
+- requer_mensagem_respondida: nao
+
+## Protocolo de Resposta para IA
+
+- Passo 1: identificar comando pelo token apos o prefixo.
+- Passo 2: resolver alias para nome canonico usando campo `aliases`.
+- Passo 3: validar `enabled`, `pre_condicoes`, permissao e local de uso.
+- Passo 4: se houver erro de uso, responder com `mensagens_uso` (quando existir) ou `metodos_de_uso`.
+- Passo 5: seguir `respostas_padrao` como fallback de texto.
+- Passo 6: considerar `informacoes_coletadas`, `privacidade` e `observabilidade` ao elaborar resposta.
+
+## Regras de Seguranca para IA
+
+- A IA orienta, mas nao executa acao administrativa automaticamente.
+- Nao inventar comandos, subcomandos ou permissao fora do JSON.
+- Sempre informar onde pode usar (grupo/privado) e quem pode usar.
+- Em duvida de permissao, responder com orientacao conservadora.
+
+## Catalogo de Comandos
+
+### classificacao
+
+- id: stats.classificacao
+- aliases: rank, top5, ranking
+- enabled: true
+- categoria: estatisticas
+- descricao: Mostra top 5 mais ativos do grupo.
+- permissao_necessaria: usuario comum
+- version: 1.0.0
+- stability: stable
+- deprecated: nao
+- risk_level: low
+- local_de_uso:
+- grupo
+- metodos_de_uso:
+- <prefix>classificacao
+- <prefix>rank
+- <prefix>top5
+- mensagens_uso (variantes):
+- default:
+- <prefix>classificacao
+- <prefix>rank
+- <prefix>top5
+- subcomandos:
+- (nenhum)
+- argumentos:
+- (nenhum)
+- pre_condicoes:
+- requer_grupo: sim
+- requer_admin: nao
+- requer_admin_principal: nao
+- requer_google_login: sim
+- requer_nsfw: nao
+- requer_midia: nao
+- requer_mensagem_respondida: nao
+- rate_limit:
+- max: null
+- janela_ms: null
+- escopo: sem_rate_limit_explicito
+- acesso:
+- somente_premium: nao
+- planos_permitidos: comum, premium
+- limite_uso_por_plano:
+- comum: max=25, janela_ms=60000, escopo=usuario
+- premium: max=120, janela_ms=60000, escopo=usuario
+- informacoes_coletadas:
+- identificador do chat (remoteJid)
+- identificador do remetente (senderJid)
+- texto do comando e argumentos
+- contexto da mensagem (citacao e mencoes, quando existir)
+- escopo do grupo (group id)
+- estatisticas de mensagens agregadas no banco
+- nomes de exibicao para composicao do ranking
+- dependencias_externas:
+- banco de dados de mensagens
+- efeitos_colaterais:
+- consulta agregações no banco
+- envia ranking
+- respostas_padrao:
+- success: Comando executado com sucesso.
+- usage_error: Formato de uso inválido. Consulte metodos_de_uso.
+- permission_error: Permissão insuficiente para executar este comando.
+- sucesso: Comando executado com sucesso.
+- erro_uso: Formato de uso inválido. Consulte metodos_de_uso.
+- erro_permissao: Permissão insuficiente para executar este comando.
+- mensagens_sistema:
+- (nao informado)
+- limites_operacionais:
+- (nao informado)
+- opcoes:
+- toggle_on_off_status.type: toggle
+- toggle_on_off_status.allowed_actions: on, off, status
+- toggle_on_off_status.action_argument: acao
+- add_remove_list.type: list_management
+- add_remove_list.allowed_actions: add, remove, list
+- add_remove_list.action_argument: acao
+- approve_reject.type: moderation_decision
+- approve_reject.allowed_actions: approve, reject
+- approve_reject.action_argument: acao
+- approve_reject.requires_targets: true
+- set_status_reset.type: configuration_window
+- set_status_reset.allowed_actions: set, status, reset
+- set_status_reset.action_argument: valor
+- observabilidade:
+- event_name: command.executed
+- analytics_event: whatsapp_command_ranking
+- tags_log: whatsapp, command, statsModule, ranking
+- nivel_log: info
+- privacidade:
+- dados_sensiveis:
+- chat_identifier
+- sender_identifier
+- command_content
+- retencao: standard_app_logs
+- base_legal: service_execution_and_legitimate_interest
+- docs:
+- summary: Mostra top 5 mais ativos do grupo.
+- usage_examples: <prefix>classificacao, <prefix>rank, <prefix>top5
+- usage_variants.default: <prefix>classificacao, <prefix>rank, <prefix>top5
+- behavior:
+- type: simple_action
+- allowed_actions: (nenhum)
+- limits:
+- usage_description: retorna top 5
+- rate_limit.max: null
+- rate_limit.janela_ms: null
+- rate_limit.escopo: sem_rate_limit_explicito
+- access.somente_premium: false
+- access.planos_permitidos: comum, premium
+- plan_limits.comum.max: 25
+- plan_limits.comum.janela_ms: 60000
+- plan_limits.comum.escopo: usuario
+- plan_limits.premium.max: 120
+- plan_limits.premium.janela_ms: 60000
+- plan_limits.premium.escopo: usuario
+- discovery:
+- keywords: classificacao, rank, top5, estatisticas, grupo
+- faq_queries: como usar classificacao, o que faz classificacao, comando classificacao
+- user_phrasings: quero usar classificacao, me ajuda com classificacao, mostra top 5 mais
+- suggestion_priority: 100
+- handler:
+- file: rankingCommand.js
+- method: handleRankingCommand
+- command_case: classificacao
+
+### classificacaoglobal
+
+- id: stats.classificacaoglobal
+- aliases: rankglobal, globalrank, globalranking, rankingglobal
+- enabled: true
+- categoria: estatisticas
+- descricao: Mostra top 5 global de atividade.
+- permissao_necessaria: usuario comum
+- version: 1.0.0
+- stability: stable
+- deprecated: nao
+- risk_level: low
+- local_de_uso:
+- privado
+- grupo
+- metodos_de_uso:
+- <prefix>classificacaoglobal
+- <prefix>globalrank
+- mensagens_uso (variantes):
+- default:
+- <prefix>classificacaoglobal
+- <prefix>globalrank
+- subcomandos:
+- (nenhum)
+- argumentos:
+- (nenhum)
+- pre_condicoes:
+- requer_grupo: nao
+- requer_admin: nao
+- requer_admin_principal: nao
+- requer_google_login: sim
+- requer_nsfw: nao
+- requer_midia: nao
+- requer_mensagem_respondida: nao
+- rate_limit:
+- max: null
+- janela_ms: null
+- escopo: sem_rate_limit_explicito
+- acesso:
+- somente_premium: nao
+- planos_permitidos: comum, premium
+- limite_uso_por_plano:
+- comum: max=25, janela_ms=60000, escopo=usuario
+- premium: max=120, janela_ms=60000, escopo=usuario
+- informacoes_coletadas:
+- identificador do chat (remoteJid)
+- identificador do remetente (senderJid)
+- texto do comando e argumentos
+- contexto da mensagem (citacao e mencoes, quando existir)
+- estatisticas globais de mensagens agregadas no banco
+- nomes de exibicao para composicao do ranking
+- dependencias_externas:
+- banco de dados de mensagens
+- efeitos_colaterais:
+- consulta agregações no banco
+- envia ranking
+- respostas_padrao:
+- success: Comando executado com sucesso.
+- usage_error: Formato de uso inválido. Consulte metodos_de_uso.
+- permission_error: Permissão insuficiente para executar este comando.
+- sucesso: Comando executado com sucesso.
+- erro_uso: Formato de uso inválido. Consulte metodos_de_uso.
+- erro_permissao: Permissão insuficiente para executar este comando.
+- mensagens_sistema:
+- (nao informado)
+- limites_operacionais:
+- (nao informado)
+- opcoes:
+- toggle_on_off_status.type: toggle
+- toggle_on_off_status.allowed_actions: on, off, status
+- toggle_on_off_status.action_argument: acao
+- add_remove_list.type: list_management
+- add_remove_list.allowed_actions: add, remove, list
+- add_remove_list.action_argument: acao
+- approve_reject.type: moderation_decision
+- approve_reject.allowed_actions: approve, reject
+- approve_reject.action_argument: acao
+- approve_reject.requires_targets: true
+- set_status_reset.type: configuration_window
+- set_status_reset.allowed_actions: set, status, reset
+- set_status_reset.action_argument: valor
+- observabilidade:
+- event_name: command.executed
+- analytics_event: whatsapp_command_rankingglobal
+- tags_log: whatsapp, command, statsModule, rankingglobal
+- nivel_log: info
+- privacidade:
+- dados_sensiveis:
+- chat_identifier
+- sender_identifier
+- command_content
+- retencao: standard_app_logs
+- base_legal: service_execution_and_legitimate_interest
+- docs:
+- summary: Mostra top 5 global de atividade.
+- usage_examples: <prefix>classificacaoglobal, <prefix>globalrank
+- usage_variants.default: <prefix>classificacaoglobal, <prefix>globalrank
+- behavior:
+- type: simple_action
+- allowed_actions: (nenhum)
+- limits:
+- usage_description: retorna top 5
+- rate_limit.max: null
+- rate_limit.janela_ms: null
+- rate_limit.escopo: sem_rate_limit_explicito
+- access.somente_premium: false
+- access.planos_permitidos: comum, premium
+- plan_limits.comum.max: 25
+- plan_limits.comum.janela_ms: 60000
+- plan_limits.comum.escopo: usuario
+- plan_limits.premium.max: 120
+- plan_limits.premium.janela_ms: 60000
+- plan_limits.premium.escopo: usuario
+- discovery:
+- keywords: classificacaoglobal, rankglobal, globalrank, globalranking, estatisticas, privado, grupo
+- faq_queries: como usar classificacaoglobal, o que faz classificacaoglobal, comando classificacaoglobal
+- user_phrasings: quero usar classificacaoglobal, me ajuda com classificacaoglobal, mostra top 5 global
+- suggestion_priority: 100
+- handler:
+- file: globalRankingCommand.js
+- method: handleGlobalRankingCommand
+- command_case: classificacaoglobal