agenzia/ISTRUZIONI_SINCRONIZZAZIONE.md

📊 Guida alla Sincronizzazione Real-Time dei Crediti Higgsfield AI

Questa guida spiega come abilitare il tracciamento automatico e in tempo reale del consumo crediti del tuo abbonamento Higgsfield AI (Pro Plan) all'interno della dashboard Streamlit.

Seguendo le tue indicazioni di sicurezza, il sistema non effettua scansioni del tuo browser Chrome né accede al portachiavi di sistema (Chrome Safe Storage). La sincronizzazione si basa unicamente sul token di sessione configurato nel file .env.

---

🛠️ Cosa è stato fatto

1. Automazione Completa: Rimosso il form manuale per regolare il budget dei crediti dal cruscotto Streamlit. Ora i crediti si allineano da soli online.
2. Aggiornamento REST Real-Time: Implementato un client REST ufficiale (HiggsClient) in src/app.py che, ad ogni avvio o refresh del cruscotto, interroga in tempo reale i server di Higgsfield per mostrare la percentuale e i crediti rimanenti effettivi.
3. Indicatori Grafici Premium:
   • 🟢 SINCRONIZZATO ONLINE: Indica che il token è valido e i crediti mostrati provengono in diretta dal tuo account, con data e ora dell'ultimo allineamento.
   • 🟡 CONTATORE LOCALE (CACHE): Compare se il token non è impostato nel file .env, indicandoti come procedere.
   • 🔴 ERRORE DI CONNESSIONE: Compare in caso di token scaduto o problemi temporanei di connessione, mantenendo visibile l'ultima cache per stabilità.

---

🔑 Come configurare la sincronizzazione automatica

Per sbloccare il monitoraggio automatico dei crediti reali, devi aggiungere il tuo token di sessione all'interno del file di configurazione ambientale. Segui questi passi semplici:

1. Apri il browser ed effettua l'accesso sul sito ufficiale higgsfield.ai.
2. Premi F12 (oppure clicca col tasto destro sulla pagina e seleziona Ispeziona) per aprire gli Strumenti per Sviluppatori del browser.
3. Spostati nella scheda Application (su Google Chrome) o Storage (su Firefox/Safari).
4. Nel menu laterale sinistro, espandi la voce Cookies e seleziona https://higgsfield.ai.
5. Cerca nell'elenco la riga con il nome __session.
6. Fai doppio clic sul valore del cookie per selezionarlo interamente e copialo (è una lunga stringa alfanumerica che inizia con eyJ...).
7. Apri il file .env situato nella cartella principale del progetto.
8. Aggiungi la seguente variabile in fondo al file incollando il token copiato:

   HIGGSFIELD_TOKEN=eyJ...[incolla_qui_il_tuo_token]
   

9. Salva il file .env.

---

🚀 Risultato Atteso

Una volta salvata la variabile nel file .env, ricarica il cruscotto Streamlit. Il pannello in basso dedicato ai crediti:

• Rileverà automaticamente il token.
• Mostrerà il badge verde 🟢 SINCRONIZZATO ONLINE con la data e l'ora dell'aggiornamento.
• Mostrerà i tuoi reali crediti rimanenti online e la percentuale esatta consumata, in perfetto allineamento con la dashboard ufficiale di Higgsfield!