FFLogs Viewer

Objectif et intention utilisateur: L’outil résout le problème exact de récupération, filtrage et synthèse des données FFLogs pour les raids. Les utilisateurs sont des analystes de raid, des chefs de guilde et des théoriciens qui doivent examiner le DPS, l’uptime et l’utilisation des capacités au cours de combats. Lorsqu’une équipe termine un raid, elle l’utilise pour évaluer rapidement les performances, comparer les combats et identifier les valeurs aberrantes sans analyser manuellement les logs.
Logique centrale et fonctionnalités: L’outil se connecte à l’API FFLogs, applique les filtres sélectionnés par l’utilisateur (région, serveur, personnage, combat, plage temporelle) et calcule des métriques. Requis: région, serveur, combat, start_time, end_time. Optionnel/avancé: répartition par compétence, exportation des données, normalisation par percentile et comparaison historique. Il applique des limites de débit et met en cache les résultats pour limiter les appels API.
Entrées et sorties: Les entrées incluent région (US/EU), serveur, personnage (facultatif), combat, start_time et end_time (ISO8601), et limite. Les sorties incluent DPS total, DPS moyen, DPS maximal, DPS par seconde, dégâts par compétence et un résumé court et formaté. Unités: DPS en dégâts par seconde; heures en UTC. Validation: vérifie les entrées requises, la région et le combat valides.
Algorithmes et calculs: DPS = dégâts totaux / durée en secondes. Le DPS de pointe est le maximum sur des fenêtres par seconde. La répartition par compétence additionne les dégâts et le DPS par compétence; le classement par percentile compare les runs à des buckets historiques. Les données FFLogs sont analysées et mises en cache pour l’efficacité.
Erreurs et cas limites: Entrées manquantes déclenchent des erreurs précises; les lacunes de données ou les erreurs API génèrent des résultats partiels avec étiquettes; les limites de débit produisent des avis temporaires; les périodes invalides ou les combats non présents renvoient des résultats vides avec des codes.
Industrie/Région & Localisation: régions US/EU prises en charge; heures UTC; formatage numérique selon la locale lorsque possible. Hypothèses & exclusions: disponibilité de l’API FFLogs et schéma de données stable; exclusion du streaming en direct, du coaching de rotation intégré ou de l’édition brute des logs.