O Registro de auditoria guarda o que as pessoas fazem dentro do painel do YAWBDB: quem ativou um recurso, alterou uma configuração, adicionou um membro à equipe, ou o que um administrador da plataforma fez no backoffice. É o seu rastro de responsabilidade para tudo o que acontece no painel.
Não é o mesmo que os Logs do servidor. Os Logs do servidor registram eventos do Discord (entradas, mensagens apagadas, atividade de voz...). O Registro de auditoria registra ações no painel (mudanças de configuração, gestão da equipe, moderação). Eles respondem a perguntas diferentes: "o que aconteceu no meu servidor do Discord?" contra "quem mudou o quê no meu painel?".
🔭 Três visões, um só rastro
O Registro de auditoria é o mesmo rastro visto em três escopos. Uma ação aparece automaticamente em todas as visões em que for relevante: você nunca precisa olhar em mais de um lugar.
| Visão | Onde | Mostra |
|---|---|---|
| Atividade do servidor | Um servidor → Registro de auditoria | Tudo o que foi feito na configuração desse servidor |
| Atividade da equipe | Configurações da Equipe → Registro de atividade | Toda a governança da equipe e tudo o que foi feito em cada servidor que a equipe possui |
| Backoffice (administradores) | Admin → Registro de auditoria | Todas as ações de toda a plataforma, todas as equipes e servidores |
Como as visões são interligadas, uma única ação aparece em todos os lugares em que importa, ao mesmo tempo. Ativar um recurso em um servidor aparece no log desse servidor, no log da equipe dele e no backoffice. Quando um administrador da plataforma age em um dos seus servidores, você também vê isso nos logs da sua equipe e do seu servidor, claramente marcado como ADMIN, então uma intervenção do backoffice nunca fica invisível para você.
👁️ Quem pode ver o quê
- Atividade do servidor e da equipe - o dono da equipe e os membros com direitos de gestão (cargo de Administrador). Os membros sem direitos de gestão não conseguem abri-la.
- Backoffice - somente os administradores da plataforma. Eles veem o rastro completo, sem filtros.
📋 O que é registrado
Configuração do servidor
- Recursos ativados ou desativados
- Configurações de recursos salvas (Automod, Verificação de entrada, Starboard, Logs do servidor e os demais)
- Um servidor removido da equipe
Governança da equipe
- Membros convidados, adicionados, removidos ou que saem
- Equipe renomeada ou excluída
Ações do backoffice (admin)
- Um usuário banido, desbanido ou com um novo cargo na plataforma
- Configurações de SEO da plataforma e credenciais de integração atualizadas
- Um mailing enviado, um anúncio publicado ou reenviado
- O preço de um plano alterado ou sincronizado com o PayPal, um recurso colocado ou retirado do beta
- A rotação de status do bot reescrita, uma seção do wiki excluída
- A limpeza que exclui todos os servidores dos quais o bot já não faz parte
Moderação - decisões tomadas sobre uma pessoa
- Um membro sancionado, o motivo reescrito, um histórico apagado
- Uma candidatura aceita ou rejeitada, as respostas dela excluídas
- Uma denúncia encerrada, ou uma sanção aplicada direto a partir dela
- Uma contestação julgada; um ticket fechado ou excluído
- O XP de alguém ajustado ou zerado, um membro removido da lista de aniversários, uma sugestão julgada
Recursos do servidor, criados, reescritos e excluídos
- Regras de automod, comandos personalizados, modelos de embed, sorteios
- Mensagens de cargos por reação, mensagens agendadas, alertas sociais
- Aniversários, sugestões, as configurações de níveis e o seu gráfico de recompensas
Cada entrada registra quem fez (mantido mesmo que a conta dessa pessoa seja excluída depois), quando e o item afetado.
Por que a moderação é uma categoria própria. Uma decisão tomada sobre uma pessoa não pertence à mesma lista que um seletor de cores. Sanções, históricos apagados, candidaturas rejeitadas e XP ajustado ficam separados das mudanças de configuração, para que o dono de um servidor possa ler uns sem atravessar os outros.
A lacuna que isso fechou. A moderação costumava deixar o rastro no canal de logs do Discord, que é opcional. Em um servidor sem esse canal, apagar o histórico de um membro não deixava absolutamente nada. E sancionar direto a partir de uma denúncia ignorava por completo a página de moderação: era a única sanção sem nenhum rastro no painel.
Deliberadamente não registrado
- Respostas da equipe e notas internas - já são registros duráveis que carregam o seu autor; auditá-las copiaria cada mensagem para uma segunda tabela à toa.
- Reordenar planos, seções do wiki ou páginas do wiki - isso só move uma coluna de ordenação e nada mais.
- O corpo de uma página do wiki - já arquivado versão por versão, com o seu autor.
- O que uma entrada de memória de IA dizia. O rastro registra que um fato foi escrito, editado ou excluído, nunca o conteúdo dele. O rastro sobrevive ao fato e é podado em um calendário próprio, então copiar a frase para ele desfaria em silêncio a exclusão.
🔍 O que exatamente mudou
A maioria das entradas traz uma tabela de antes / depois: não apenas "Configurações do Wordle salvas", mas os campos que mudaram e de que valor para qual.
| Campo | Antes | Depois |
|---|---|---|
channel_id |
8412… | 9930… |
cooldown_seconds |
10 | 30 |
Abra Detalhes em qualquer entrada para vê-la. Vale saber algumas coisas sobre como ela é montada:
- Só o que de fato mudou é listado. Salvar um formulário sem mexer em nada não registra nada, e um campo que voltou do formulário em outro formato (
"1"em vez de1) não é reportado como mudança. - As listas são comparadas inteiras. Adicionar um canal a uma lista de permissões aparece como uma mudança nessa lista, e não como todas as entradas trocando de posição.
- As configurações aninhadas aparecem como um caminho, então
categories.voice.enableddiz qual categoria você desativou. - As credenciais nunca são gravadas. Se um token ou um segredo for alterado, a entrada registra que ele foi rotacionado: os dois lados mostram
••••••••. Isso vale em todo lugar, inclusive para as credenciais de integração do admin.
Cada entrada é lida no seu idioma: a frase segue o idioma que você escolheu para o painel, e a linha em inglês com que ela foi registrada continua logo abaixo quando for diferente. As entradas registradas antes de isso ser adicionado continuam sendo lidas somente em inglês.
🎚️ Encontrando uma entrada
Os mesmos filtros estão disponíveis nas três visões:
- Pesquisar - autor, ação, descrição ou o item afetado
- Categoria - recurso, servidor, equipe, membro, assinatura, cobrança, admin, autenticação
- Ação - a ação exata, escolhida entre o que realmente existe no seu log
- Autor - uma pessoa
- Período - de / até
- Servidor (visões de equipe e backoffice) e Origem: admin ou usuário (somente no backoffice)
Os filtros ativos aparecem como chips acima da tabela; clique em um para removê-lo. Os contadores acima dos filtros mostram o total, as últimas 24 horas, quantas ações do backoffice houve e quantas pessoas diferentes agiram.
🪝 Envie para o seu próprio servidor
O rastro da equipe não precisa ser lido nesta página. Configurações da Equipe → Webhooks aponta o rastro para uma URL sua: cada entrada em que você se inscrever chega como um POST JSON assinado, no momento em que é gravada.
Um webhook traz exatamente o que esta página mostra e nada além: as mesmas linhas, os mesmos campos, menos o endereço IP, que nunca sai do painel. Configuração completa, formato do payload e verificação da assinatura: Webhooks de saída.
⏳ Retenção
As entradas são mantidas por uma janela móvel (180 dias por padrão) e as mais antigas são podadas automaticamente. O rastro é somente de acréscimo: as entradas nunca são editadas depois.