========================================================
 SUITE SB per MetaTrader 5 - edizione BASE
 Salvatore Bilotta
========================================================

15 indicatori di analisi, 2 script e 1 servizio,
piu' i modelli di grafico che usiamo nelle analisi.
Nessun Expert Advisor: niente in questo pacchetto puo'
mandare ordini al mercato. Sono strumenti di lettura.


LICENZA - LEGGERE PRIMA DI INSTALLARE
-------------------------------------
La suite e' legata ai tuoi conti di trading e va attivata
da noi. Regole:

  * fino a 3 conti per persona
  * durata 1 anno dalla data di attivazione
  * alla scadenza gli indicatori smettono di funzionare

Per attivare scrivi a info@spfinance.biz indicando nome,
cognome e i numeri di login dei conti MT5 da abilitare.
Ti rispondiamo con la tua CHIAVE: una riga di testo per
ogni conto, cosi'

    SPF1|12345678|2027-07-31|3f9a1c...

Devi incollarla UNA VOLTA SOLA, e l'installer te la chiede
da solo mentre installa: la incolli li' e hai finito.
Finche' non c'e', gli strumenti si caricano e si fermano
subito con un avviso che ti dice cosa fare.

Il controllo e' offline: la chiave si verifica sul tuo PC,
senza chiamare nessun server. Non serve internet e non serve
autorizzare nessun indirizzo per far partire gli indicatori.


COME INSTALLARE (su un PC nuovo o una MT5 nuova)
------------------------------------------------
1) Copia l'intera cartella sul PC.
2) Doppio click su  install.bat
3) Scegli il terminale MetaTrader dalla lista (o "A" per tutti).
4) Quando te la chiede, INCOLLA LA CHIAVE ricevuta per email
   e premi Invio. Se hai piu' conti, una riga per volta.
   Puoi anche saltare e farlo dopo (vedi sotto).
5) In MetaTrader: Navigator > click destro > Aggiorna.

Installazione "portable" (MT5 non in AppData):
   apri PowerShell nella cartella e lancia:
   .\install.ps1 -TargetMql5 "C:\percorso\alla\tua\MQL5"


PRIMA COSA DA FARE SU UNA MT5 NUOVA
-----------------------------------
1) Strumenti > Opzioni > Grafici >
   "Numero massimo di barre nel grafico" = Illimitato.
   Se resta basso, il terminale butta via la storia vecchia
   mentre la scarica e i buchi restano.

2) L'ATTIVAZIONE, se l'hai saltata durante l'installazione.
   Nel Navigatore, sezione Script, trascina  SB_Attiva  su un
   grafico qualsiasi. Si apre una finestra con una casella:
   incolla dentro la chiave ricevuta per email e premi OK.
   Se hai piu' conti, ci sono tre caselle, una per conto.

   Ti risponde subito: "suite attivata sul conto ... valida
   fino al ...", oppure ti dice in parole cosa non va.

   Non devi creare nessun file e non devi cercare nessuna
   cartella: se ne occupa lui, e lo salva nel posto che vale
   per TUTTI i MetaTrader di quel computer. Chi ne ha due o
   tre lo fa una volta sola.

   Vale anche per i rinnovi: quando ti mandiamo la chiave
   nuova, la incolli allo stesso modo e sostituisce la vecchia.

3) Navigator > Script > trascina SB_HistoryLoader su un
   grafico qualsiasi e lascialo finire.
   Scarica tutto lo storico disponibile dal broker su tutti
   i simboli e tutti i timeframe. Senza questo passaggio ogni
   indicatore che guarda indietro (forza valute, profili,
   massimi di periodo, performance) legge dati incompleti
   senza dirtelo.
   A fine corsa scrive un report CSV in MQL5\Files: la colonna
   "esito" dice OK dove non hai buchi.


ALTRI PASSI MANUALI CHE MT5 NON PERMETTE DI AUTOMATIZZARE
---------------------------------------------------------
* SERVE SOLO AI 2 INDICATORI SENTIMENT, non agli altri.
  Sono due passaggi, si fanno una volta sola.

  1) Strumenti > Opzioni > Expert Advisors >
     spunta "Consenti WebRequest per gli URL elencati" e
     aggiungi questo indirizzo, COPIANDOLO:
         https://elegant-pegasus-6c5504.netlify.app
     Attenzione a scriverlo a mano: se manca una lettera
     (netify invece di netlify) MetaTrader blocca tutto e
     nel log compare l'errore 4014.

  2) Nel Navigatore, sezione SERVIZI: tasto destro su
     SB_SentimentService > Aggiungi servizio > OK, poi
     tasto destro > Avvia.
     Da quel momento i dati si aggiornano DA SOLI ogni sei
     ore, senza che tu faccia piu' niente, e il servizio
     riparte insieme a MetaTrader.

  Un servizio serve perche' MT5 non lascia scaricare niente
  agli indicatori: girano tutti nel thread della grafica.
  Il servizio invece gira in sottofondo, non occupa nessun
  grafico e non ha bisogno del trading algoritmico.

  Se preferisci fare a mano, nel pacchetto resta lo script
  SB_SentimentSync: si trascina su un grafico e scarica gli
  stessi dati in quel momento.

* Se uno strumento non compare o da errore di build (MT5 con
  build diversa): scrivici e ti mandiamo la versione
  compilata per la tua build.


COSA SERVE / COSA NON SERVE
---------------------------
* Gli indicatori usano solo i dati di prezzo del broker e la
  chiave sul tuo PC: NON serve internet per farli partire e
  non c'e' nessun controllo periodico da superare.
* I 2 Sentiment mostrano i dati scaricati da SB_SentimentSync
  (vedi sopra): NON serve Python, ne generate.py, ne scheduler
  sul PC. Se non hai mai lanciato lo script restano vuoti e te
  lo scrivono nella scheda Esperti.
* SB_StrengthFX vuole le 7 coppie EUR/* nel Market Watch
  (EURUSD, EURCAD, EURGBP, EURCHF, EURAUD, EURNZD, EURJPY).
  Il suffisso del broker (es. EURUSD.i) viene rilevato da solo.
* SB_OverlayClass legge il Market Watch: piu' simboli ci tieni,
  piu' classi di attivo ha da confrontare.


COSA C'E' DENTRO
----------------

Struttura e prezzo:
  SB_SwingPoint          swing high/low, ricolora le candele
                         esistenti secondo la struttura rotta
  SB_SwingRibbon         compagno del precedente: la stessa
                         lettura come fascia in finestra separata
                         (usare gli stessi Bars Left/Right)
  SB_PeriodHighLow       massimi e minimi di periodo (24h, 7g, 30g,
                         90g, 365g, ieri, settimana/mese/anno in
                         corso, ore/giorni custom) con proiezione

Volumi e aree di prezzo:
  SB_MarketProfile       profilo ancorato al calendario: uno per
                         ogni mese, settimana, giorno, H4 o H1.
                         Multi-istanza sullo stesso grafico
  SB_MarketProfileCustom profilo a range libero: sposti il
                         rettangolo VP_ZONE e il profilo si
                         ricalcola dentro quel range (POC/VAH/VAL)

Forza e confronto fra mercati:
  SB_StrengthFX          dashboard FX: forza delle 8 valute come
                         media geometrica dei 7 cambi, somma zero
  SB_Overlay3            tre asset a scelta sovrapposti, base 100
                         dalla prima barra: traiettorie confrontabili
  SB_OverlayClass        come sopra ma per intera classe di attivo,
                         letta dal Market Watch (FX majors, minors,
                         esotici, indici, metalli, energia, crypto)
  SB_PerfPanel           performance dell'asset corrente su piu'
                         timeframe, una tile per periodo

Rischio e portafoglio:
  SB_ExposureDesk        calcolatore di esposizione a leva. Nei due
                         versi: dai la leva e ti dice i lotti, dai
                         i lotti e ti dice la leva. Con lo stop
                         dichiarato ti dice quanto perdi. SOLO
                         CALCOLO, e' un indicatore, non puo'
                         mandare ordini nemmeno volendo
  SB_PortfolioDesk       dashboard di portafoglio: legge le posizioni
                         aperte come un tutt'uno. Esposizione per
                         classe di attivo, esposizione netta di
                         valuta sul forex a gambe compensate

Sentiment retail (dati Myfxbook, scaricati da SB_SentimentSync):
  SB_RetailSentiment     pannello completo: coppie, basket cliccabile,
                         dettaglio del singolo strumento
  SB_SentimentMini       versione per grafico singolo: semaforo,
                         storico 30 giorni, PMC tracciato sul grafico,
                         draggabile

Comodita':
  SB_ChartSync           aggancia piu' grafici sullo stesso gruppo:
                         cambi asset su uno e gli altri lo seguono.
                         Gruppi A, B, C indipendenti
  SB_Watermark           filigrana di fondo sul grafico (simbolo,
                         timeframe, descrizione). Sta sempre sul
                         fondo: dietro le candele e dietro ogni
                         altro indicatore, non copre mai la lettura

Script (Navigator > Script, si trascinano sul grafico e finiscono):
  SB_Attiva              incolli la chiave in una casella e la suite
                         si attiva. Nessun file da creare a mano,
                         nessuna cartella da cercare. Serve una volta
                         all'inizio e a ogni rinnovo
  SB_HistoryLoader       scarica tutto lo storico disponibile dal
                         broker su tutti i simboli e tutti i
                         timeframe. Da lanciare per primo su una MT5
                         nuova e ogni tanto sulle altre. Report CSV
                         in MQL5\Files con barre e prima data per
                         ogni serie: e' li' che si vedono i buchi
  SB_SentimentSync       scarica i dati del sentiment retail per i
                         due indicatori qui sopra, subito. Serve solo
                         se non usi il servizio qui sotto o se vuoi
                         i dati adesso. Richiede l'URL autorizzato in
                         Strumenti > Opzioni > Expert Advisors

Servizio (Navigator > Servizi, si accende una volta e lavora da solo):
  SB_SentimentService    tiene aggiornati i dati del sentiment retail
                         ogni sei ore, senza occupare nessun grafico
                         e senza trading algoritmico. Riparte insieme
                         a MetaTrader. Tasto destro > Aggiungi
                         servizio, poi Avvia: e' l'unica volta che ci
                         devi mettere le mani


I MODELLI E LE IMPOSTAZIONI
---------------------------
Nel pacchetto ci sono anche i grafici che usiamo nelle analisi,
gia' pronti. Hanno tutti il nome che inizia per SPF:

  SPF Analisi            struttura, profilo volumetrico, massimi e
                         minimi di periodo, performance
  SPF Analisi FX         come sopra piu' il sentiment retail e il
                         profilo a range libero, per le valute
  SPF Basket valutario   il grafico dei panieri di valuta
  SPF Overlay            confronto fra tre asset in base 100
  SPF Black              solo lo schema di colori scuro, senza
                         indicatori: la base per costruirti il tuo

Si caricano da tasto destro sul grafico > Modelli > Carica Modello.

I TUOI MODELLI NON VENGONO TOCCATI. I nostri si aggiungono
all'elenco accanto ai tuoi, e i grafici nuovi continuano ad
aprirsi come si aprivano prima: cambia solo se lo carichi tu.

Nella cartella Presets trovi le impostazioni dei singoli
indicatori, sempre col prefisso SPF: si caricano col pulsante
"Carica" in fondo alla finestra che si apre quando trascini un
indicatore sul grafico. Servono se vuoi un indicatore da solo,
con i nostri valori, fuori dai modelli.


SE VUOI TOGLIERE LA SUITE
-------------------------
Doppio click su  disinstalla.bat  (chiudi prima MetaTrader,
altrimenti Windows tiene i file bloccati e la pulizia resta
a meta': il programma se ne accorge e te lo dice).

Ti mostra quanti file toglie e chiede conferma prima di
muovere qualsiasi cosa. Toglie SOLO la roba nostra: gli
strumenti che iniziano per SB_, i modelli e le impostazioni
che iniziano per SPF, e i due file di dati del sentiment.

I tuoi indicatori, i tuoi modelli, la cronologia dei prezzi,
i conti e le impostazioni del terminale non vengono toccati.

Alla fine ti chiede se vuoi togliere anche la chiave di
licenza. Conviene tenerla: se un domani reinstalli, non devi
richiedercela.


COSA QUESTI STRUMENTI NON FANNO
-------------------------------
Non danno segnali di acquisto o vendita, non prevedono i prezzi
e non gestiscono posizioni. Misurano e mostrano. La decisione
resta interamente di chi guarda il grafico.
