Certamente. È un’ottima idea documentare questa funzionalità, anche se è per un’utenza avanzata. Una buona documentazione è sempre un valore aggiunto.
Ecco una bozza per la pagina del manuale.
Manuale Utente (Sezione Avanzata): Modalità di Debug per Sviluppatori
Versione Documento: 1.0 Data: 2025-09-19
1. Cos’è la “Developer Debug Mode”?
La Modalità di Debug per Sviluppatori è un’impostazione avanzata progettata principalmente per gli sviluppatori di FIRE, power user e per chiunque desideri “guardare sotto il cofano” dell’applicazione per scopi di diagnostica.
Quando questa modalità è disattivata (impostazione di default), FIRE presenta un’interfaccia pulita e ottimizzata per l’utente finale.
Quando è attivata, l’applicazione abilita una serie di strumenti di debug aggiuntivi, sia visivi che nei file di log, per aiutare a identificare e risolvere problemi.
Attenzione: Questa modalità può rendere l’interfaccia più “rumorosa” e potrebbe avere un leggero impatto sulle prestazioni. Si consiglia di tenerla disattivata durante il normale utilizzo.
2. Come si Attiva?
- Apri il menu delle impostazioni cliccando sul pulsante “Settings” nella toolbar principale.
- Nel dialogo che appare, seleziona la tab “Developer”.
- Spunta la casella “Enable developer debug mode”.
- Clicca su “Ok” per salvare le impostazioni.
3. Requisito Fondamentale: Riavvio dell’Applicazione
A causa della natura profonda delle modifiche che questa modalità introduce, le modifiche a questa impostazione richiedono un riavvio completo di FIRE per avere effetto.
- Per attivare: Spunta la casella, salva e chiudi completamente l’applicazione, poi riaprila.
- Per disattivare: Togli la spunta, salva e chiudi completamente l’applicazione, poi riaprila.
4. Quali Strumenti Abilita? (Versione Attuale)
Al momento, l’attivazione della modalità di debug ha effetto principalmente sul componente più complesso dell’applicazione: il Grafico dei Prezzi.
Con Debug ATTIVO:
-
Console di Debug JavaScript:
- Nell’angolo in alto a destra del pannello del grafico, apparirà una piccola console nera semitrasparente.
- Questa console mostra in tempo reale i messaggi di log generati dal codice JavaScript che disegna il grafico. È uno strumento indispensabile per diagnosticare problemi di rendering, come un overlay che non appare o dati che non vengono caricati correttamente.
- Messaggi come
Inizializzazione grafico...,Creazione serie volatilità...oERRORE...ti daranno una visione diretta di ciò che sta accadendo all’interno del motore di charting.
-
Log Aggiuntivi nel Terminale:
- Quando il debug è attivo, il terminale da cui hai lanciato FIRE stamperà informazioni di debug aggiuntive, contrassegnate dal prefisso
[DEBUG]. - Questi log possono includere dettagli sui dati che vengono passati al grafico (es.
[DEBUG] show_volatility: True), aiutando a tracciare il flusso di informazioni dal backend di Python al frontend di JavaScript.
- Quando il debug è attivo, il terminale da cui hai lanciato FIRE stamperà informazioni di debug aggiuntive, contrassegnate dal prefisso
Con Debug DISATTIVATO:
- La console di debug nel grafico scompare.
- I log di debug specifici del grafico non vengono stampati.
- L’interfaccia è pulita e le prestazioni sono ottimizzate.
Questa funzionalità è progettata per essere espandibile. In futuro, l’attivazione di questa modalità potrebbe abilitare ulteriori strumenti di diagnostica in altre parti dell’applicazione.