Rankings
Ranking Global com Posição do Usuário
Obtém o ranking global e inclui a posição específica do usuário autenticado
GET
Descrição
Obtém o ranking global dos top 100 leitores e inclui a posição específica do usuário autenticado, mesmo que ele esteja fora do top 100. Esta rota combina o ranking geral com informações personalizadas do usuário.Autenticação
Esta rota requer autenticação JWT. O usuário é identificado pelo token fornecido no header
Authorization: Bearer <token>.Response
Indica se a operação foi bem-sucedida
Comportamento
Quando o usuário está no Top 100
- Retorna apenas o ranking global normal
- Usuário aparece destacado na lista do ranking
- Campo
userPositionnão é incluído
Quando o usuário está fora do Top 100
- Retorna o ranking global dos top 100
- Adiciona campo
userPositioncom informações específicas do usuário - Calcula posição real do usuário no ranking geral (considerando todos os leitores ativos)
Casos Especiais
- Se o usuário não tem streak ativo (currentStreak = 0),
userPositionseránull - Se o usuário não existe no sistema, apenas o ranking global é retornado
- Cache é compartilhado com a rota de ranking global para melhor performance
Notas de Implementação
- Utiliza o mesmo cache do ranking global
- Posição do usuário é calculada em tempo real quando necessário
- Filtro de 30 dias para cálculo de posição (vs 7 dias para o ranking global)
