Relatórios e Análise de Admin: Mudanças Incrementais

[chapoi]

Estamos começando uma reformulação mais ampla do painel de administração.
Este primeiro passo se concentra em tornar a seção de Relatórios e Análise mais clara e fácil de navegar.

Neste tópico, revisaremos as primeiras alterações incrementais e compartilharemos como você pode começar a usar isso hoje.

O que mudou

Agrupamento de relatórios

Uma primeira medida que estamos tomando é agrupar os relatórios. Nosso objetivo é agrupá-los pelo tipo de pergunta que eles podem responder. No momento, esses agrupamentos são:

• Engajamento
• Tráfego
• Membros
• Conteúdo e Saúde
• Moderação
• Segurança

Qualquer coisa que não se encaixe ou novos relatórios irão para uma categoria de descanso (“outros”).

O objetivo é reduzir a carga cognitiva e facilitar a localização do relatório que você precisa sem ter que escanear uma lista longa e plana.

Limpeza de relatórios

Com o tempo, a página de relatórios acumulou mais gráficos do que a maioria dos administradores usa de forma significativa.

Como parte desta atualização, removemos um conjunto de relatórios da visualização principal.

Visão geral dos relatórios legados

• bookmarks
• likes
• moderator_warning_private_messages
• notify_moderators_private_messages
• notify_user_private_messages
• post_edits
• profile_views
• system_private_messages
• top_users_by_likes_received_from_inferior_trust_level
• top_users_by_likes_received_from_a_variety_of_people
• user_to_user_private_messages

Por enquanto, eles ainda estão disponíveis por link direto, mas ocultos da página de relatórios, e eventualmente serão descontinuados. (Ficaremos felizes em reconsiderar se houver casos de uso fortes que tenhamos ignorado.)

Para análises mais granulares ou pontuais, eles podem sempre ser replicados através do data explorer.

Mudanças de Navegação e Layout

Nós também simplificamos a seção do cabeçalho para que ela corresponda ao nosso layout de administração mais recente e liberamos espaço ao não se repetir em cada página de relatório.

Como você pode ver: mais conteúdo acima da dobra.

A página de relatórios agora está desacoplada do painel de controle.
Em vez de renderizar dentro da visualização do painel de controle, agora ela reside em sua própria rota dedicada (/admin/reports).

Isso remove rotas duplicadas e simplifica a navegação à medida que avançamos para uma experiência de administração mais modular.

Este é um primeiro passo na maior reformulação do painel de controle e, embora esta área se comporte de forma inconsistente agora, ela melhorará nas iterações futuras.

Ativando melhorias de Relatórios em sua comunidade

Por enquanto, isso é considerado uma mudança experimental! Estamos abertos ao seu feedback, que nos ajudará a fazer melhorias e a expandir isso.

Para ativar isso, acesse a página Upcoming changes na sua área de administração (/admin/config/upcoming-changes) e encontre o item Reporting improvements. Atualize o campo Enabled for… para optar seu site por este novo design:

O que você achou?

A palavra está com você: adoraríamos saber o que você pensa desta reformulação. Os agrupamentos fazem sentido? Como você usa nossos relatórios?

Este tópico será atualizado com mais melhorias para esta área.

[hellekin]

Obrigado por cuidar dos administradores!

@chapoi

nós removemos um conjunto de relatórios da visualização principal.

Estes podem ser publicados como consultas do data-explorer em Data & reporting, ou alguém documentará como usar Discourse Prometheus para as pessoas interessadas?

@chapoi

Os agrupamentos fazem sentido?

@chapoi

Como você usa nossos relatórios?

Honestamente, acho que usarei mais os relatórios depois da reformulação. Até agora, eu não via muito interesse em explorar essa área, especialmente por causa da falta de estrutura, então… bom trabalho!

[Moin]

@hellekin

Isso pode ser publicado como consultas data-explorer na categoria Data & reporting

Elas são. Você ainda pode encontrá-las com a tag dashboard-sql e elas estão linkadas em Admin dashboard report reference guide

Para referência futura, pois é provável que sejam removidas destas em breve:

relatório	tópico
bookmarks	Dashboard Report - Bookmarks
likes	Dashboard Report - Likes
moderator_warning_private_messages	Dashboard Report - Moderator Warnings
notify_moderators_private_messages	Dashboard Report - Notify Moderators
notify_user_private_messages	Dashboard Report - Notify User
post_edits	Dashboard Report - Post Edits
profile_views	Dashboard Report - User Profile Views
system_private_messages	Dashboard Report - System
top_users_by_likes_received_from_inferior_trust_level	Dashboard Report - Top Users by Likes Received from a User with a Lower Trust Level
top_users_by_likes_received_from_a_variety_of_people	Dashboard Report - Top Users by Likes Received From a Variety of People
user_to_user_private_messages	Dashboard Report - User-to-User

[gormus (Osman Görmüş)]

Solicitação de funcionalidade:

Você consideraria mover os relatórios para um caminho não administrativo e gerenciar o acesso por meio de uma nova configuração ..._allowed_groups? :))

  access_reports_allowed_groups:
    default: "1|2" # grupos automáticos admins, moderadores
    mandatory_values: "1|2" # grupos automáticos admins, moderadores
    type: group_list
    allow_any: false

[Moin]

O aviso na tabela do meu painel é um resultado esperado?

[Moin]

O que determina a ordem em que os relatórios de plugin são exibidos? A ordem parece mudar com base no meu idioma de interface, mas não é alfabética.

Inglês	Alemão
resolvido	resolvido
categorias de documentação	AI
AI	notas do usuário
Reações	Calendário
Notas do usuário	categorias de documentação
Calendário	Reações

[chapoi]

No momento, isso não está em pauta de forma alguma. Sentimos que os relatórios são uma área administrativa muito específica.

Você tem um caso de uso específico em mente?

@Moin

O que determina a ordem em que os relatórios do plugin são exibidos?

Haha, então, ok, acho que fizemos algo muito especial aqui

Parece que eles são ordenados alfabeticamente, com base no nome do primeiro relatório no grupo…

Então, por exemplo, em inglês eu tenho:

Embora eu ache que há um certo charme peculiar nisso, nós vamos… resolver isso.

[gormus (Osman Görmüş)]

@chapoi

No momento isso não está em discussão de forma alguma. Sentimos que os relatórios são uma área administrativa muito específica.

Você tem um caso de uso específico em mente?

Recebi certos interesses em alguns dos relatórios da liderança que não são necessariamente técnicos e não deveriam ter a função de administrador ou moderador apenas para acessar os relatórios.

Eu poderia, é claro, recriar os relatórios usando o Data Explorer e compartilhar esses relatórios com eles também. Mas, por outro lado:

• Eu preciso manter esses relatórios do Data Explorer à medida que são atualizados no núcleo
• Gráficos e diagramas estão disponíveis apenas nos Relatórios, não nos relatórios do Data Explorer (a menos que eu tenha perdido alguma coisa)
• A interface de usuário dos Relatórios é menos administrativa (mais amigável) do que a interface de usuário dos relatórios do Data Explorer

Eu iria ainda mais longe e pediria para habilitar relatórios dos Relatórios para grupos selecionados, assim como os relatórios do Data Explorer fazem

No entanto, todo esse pedido seria um recurso “bom de se ter”, não um “obrigatório” : ))

[chapoi]

Obrigado por expandir o assunto – é um caso de uso interessante.

Não sei quanta sobrecarga algo assim traria; talvez seja mínima. Vou levantar o assunto internamente ao discutir este projeto!

[chapoi]

@chapoi

Embora eu ache que haja um certo charme peculiar nisso, nós vamos… resolver

Isso agora está feito – deve estar em ordem alfabética e mudar com o idioma da interface do usuário.

[Zanbabe (Suzanne)]

Eu uso o top_users_by_likes_received_from_a_variety_of_people para determinar um dos nossos prêmios de fim de ano. Gostaria de continuar tendo acesso a esse relatório por esse motivo.

Eu usei alguns dos outros que serão descontinuados também. Reitero o desejo de ainda ter acesso de alguma forma. … Na verdade, seria melhor ter um menu de relatórios e a capacidade de escolher quais queremos no nosso painel, incluindo os personalizados.

[chapoi]

@Zanbabe

top_users_by_likes_received_from_a_variety_of_people

Você pode explicar por que o total de curtidas não seria suficiente? Isso seria para evitar que os prêmios fossem manipulados por curtidas intensivas entre um pequeno grupo?

[ToddZ]

@chapoi

nós removemos um conjunto de relatórios da visualização principal
…
e eles serão eventualmente descontinuados

Não estou protestando - apenas curioso: por que remover estes em vez de colocá-los sob um cabeçalho recolhido ou algo assim. Eles exigirão manutenção que não vale a pena?

[Zanbabe (Suzanne)]

Sim. Temos um pequeno grupo que explora o sistema extensivamente, embora eles também sejam úteis de outras maneiras, então não vamos expulsá-los ou algo assim. Eles tendem a dominar os prêmios… nós também damos prêmios pelos números diretos, mas queremos diversificar e dar prêmios (e chamar a atenção para) pessoas que estão se comportando melhor.

Quanto mais relatórios de usuários eu tiver que mostrem pessoas fazendo coisas que queremos motivar, melhor.

Fora do tópico desta conversa, mas eu também gostaria de poder ajustar os pontos de forma mais específica. Não quero desligá-los completamente nas áreas divertidas do meu site e desincentivar as pessoas que estão participando lá, mas adoraria dar MAIS pontos em certas categorias, em vez de apenas ligar ou desligar os pontos.

[chapoi]

@ToddZ

Não estou protestando - apenas curioso:

Pergunta justa.

@ToddZ

Eles exigirão manutenção que não vale a pena?

Em software, como regra de ouro, tudo exige manutenção! Os relatórios específicos talvez não tanto, então nós poderíamos mantê-los por perto.

Para responder à sua pergunta principal:

@ToddZ

por que remover estes em vez de colocá-los sob um cabeçalho recolhido ou algo assim

Porque ver se surgem reclamações é a maneira mais fácil de descobrir se algo é valioso ou não

E em design, e para mim pessoalmente, o conceito de ter uma categoria “extra” que é apenas enfiada sob algum cabeçalho recolhível é um sinal de que os recursos circundantes não são projetados bem. Parte de um bom design é também ousar podar coisas.

[ToddZ]

@chapoi

Parte de um bom design é também ousar podar coisas.

Isso é muito citável

Obrigado pela resposta – é sempre bom aprender o processo de pensamento por trás das mudanças. Eu não tinha feito muito uso desses relatórios, mas é bom saber que as consultas ainda estarão por perto se alguém realmente precisar delas.

[Moin]

Notei que relatórios sem dados no painel de controle precisam de muito mais espaço quando a próxima alteração for ativada.

[gassim (Al-Gassim Sharaf Addin)]

Olá

@chapoi

Para ativar isto, vá para a página Upcoming changes na sua área de administração (/admin/config/upcoming-changes) e encontre o item Reporting improvements. Atualize o campo Enabled for… para que seu site adote este novo design:

No meu menu suspenso não consigo ver a opção Staff only (Apenas equipe), mas em vez disso vejo Everyone (Todos)… o que isso significa, pois é diferente da opção Staff only na sua captura de tela? Por favor, veja a captura de tela abaixo:

Obrigado!

[zogstrip]

O menu suspenso está funcionando como esperado

A configuração “Melhorias no Relatório” é uma simples alternância liga/desliga, portanto, oferece apenas Todos (ligado) e Ninguém (desligado**)** — não há segmentação baseada em grupos para esta.

Fizemos essa alteração em 2026-02-15T23:00:00Z para evitar confusão sobre futuras alterações que não suportam ser restritas a grupos específicos. Como “Melhorias no Relatório” se aplica globalmente à interface de usuário de relatórios do administrador, oferecer uma opção “Somente equipe” não fazia sentido — ela está ativada ou não está.

A captura de tela na publicação original foi tirada antes dessa alteração. Selecionar Todos é a maneira correta de optar por participar.

[martin (Martin Brennan)]

Planejamos fazer mais uma pequena alteração aqui para que itens como este possam ter as opções “Somente equipe” ou “Ninguém”, já que “Todos” ainda não faz muito sentido.