FFLogs Viewer

Propósito e intenção do usuário: a ferramenta resolve o problema exato de recuperação, filtragem e resumo de dados FFLogs para raids. Usuários são analistas de raid, líderes de guilda e teóricos que precisam examinar DPS, uptime e uso de habilidades ao longo de lutas. Quando uma equipe termina um raid, ela usa a ferramenta para avaliar rapidamente o desempenho, comparar lutas e identificar valores atípicos sem analisar logs manualmente.
Lógica central e recursos: a ferramenta conecta-se à API FFLogs, aplica filtros escolhidos pelo usuário (região, servidor, personagem, luta, faixa temporal) e calcula métricas. Obrigatório: região, servidor, luta, início, fim. Opcional/avançado: decomposição por habilidade, exportação de dados, normalização por percentil e comparação histórica. Aplica limites de taxa e faz cache dos resultados para minimizar chamadas à API.
Entradas e saídas: Entradas incluem região (US/EU), servidor, personagem (opcional), luta, início e fim (ISO8601) e limite. Saídas incluem DPS total, DPS médio, DPS máximo, DPS por segundo, dano por habilidade e um resumo curto formatado. Unidades: DPS em dano por segundo; tempos em UTC. Validação garante entradas obrigatórias, região válida e luta válida.
Algoritmos e cálculos: DPS = dano total / duração em segundos. DPS de pico é o máximo em janelas por segundo. Decomposição por habilidade soma dano e DPS por habilidade; classificação por percentil compara execuções com buckets históricos. Dados FFLogs são analisados e cacheados para eficiência.
Erros e casos especiais: entradas ausentes geram erros precisos; lacunas de dados ou falhas da API produzem resultados parciais com rótulos; limites de taxa produzem avisos temporários; períodos inválidos ou lutas desconhecidas retornam resultados vazios com códigos.
Indústria/região e localização: regiões US/EU suportadas; horários UTC; formatação numérica conforme a localidade quando possível. Suposições e exclusões: assume disponibilidade da API FFLogs e esquema de dados estável; exclui streaming ao vivo, coachings de rotação dentro do app ou edição de logs brutos.