FFLogs Viewer

Scopo e intenzione dell’utente: lo strumento risolve il problema esatto di recupero, filtraggio e sintesi dei dati FFLogs per i raid. Gli utenti sono analisti di raid, capi gilda e theorycrafter che devono esaminare DPS, uptime e utilizzo delle capacità tra le battaglie. Quando una squadra termina un raid, lo strumento viene usato per valutare rapidamente le prestazioni, confrontare i combattimenti e identificare anomalie senza analisi manuale dei log.
Logica centrale e caratteristiche: lo strumento si collega all’API FFLogs, applica filtri scelti dall’utente (regione, server, personaggio, combattimento, intervallo temporale) e calcola metriche. Obbligatorio: regione, server, combattimento, inizio, fine. Opzionale/avanzato: suddivisione per abilità, esportazione dati, normalizzazione percentile e confronto storico. Applica limitazioni di velocità e memorizza nella cache i risultati per ridurre le chiamate API.
Ingressi & uscite: Ingressi includono regione (US/EU), server, personaggio (facoltativo), combattimento, inizio e fine (ISO8601) e limite. Uscite includono DPS totale, DPS medio, DPS massimo, DPS per secondo, danni per abilità e un riepilogo breve e formattato. Unità: DPS in danni al secondo; orari in UTC. Validazione garantisce input necessari, regione valida e combattimento valido.
Algoritmi & calcoli: DPS = danno totale / durata in secondi. DPS di picco è il massimo su finestre per secondo. Suddivisione per abilità somma danno e DPS per abilità; ranking percentile confronta run con bucket storici. I dati FFLogs sono analizzati e memorizzati nella cache per efficienza.
Errori & casi limite: Input mancanti causano errori precisi; lacune di dati o errori API producono risultati parziali con etichette; limiti di velocità producono avvisi temporanei; intervalli di tempo non validi o combattimenti sconosciuti restituiscono risultati vuoti con codici.
Settore/Regione & Localizzazione: regioni US/EU supportate; orari UTC; formattazione numerica conforme alle impostazioni locali quando possibile. Ipotesi & esclusioni: si presuppone disponibilità dell’API FFLogs e dello schema dati stabile; esclude livestreaming, coaching di rotazione in-app o modifica dei log grezzi.