==========================================================
 SizerCalculator v3.19 - Guida rapida di installazione
==========================================================

 Cos'e'
------
Expert Advisor per MetaTrader 5: calcola il lotto dal rischio
in percentuale, gestisce SL/TP1/TP2 con linee trascinabili,
a TP1 chiude una parte del position e sposta lo SL a
break-even (commissioni incluse). Supporta ordini pendenti.
L'EA non apre MAI operazioni da solo: solo sui tuoi BUY/SELL.

 Requisiti
---------
- MetaTrader 5 (qualsiasi broker), build recente
- Un conto in modalita' HEDGING per la chiusura parziale a TP1
- Pacchetto sorgente compilato sul TUO terminale (vedi sotto)

 Installazione - Windows (5 minuti)
-----------------------------------
1. Estrai lo ZIP in una cartella qualsiasi.
2. Apri MT5 -> menu File -> "Apri cartella dati".
3. Copia i file:
   MQL5\Experts\SizerCalculator.mq5    ->  <dati>\MQL5\Experts\
   MQL5\Presets\SizerCalculator.set    ->  <dati>\MQL5\Presets\
4. Premi F4 (MetaEditor), apri SizerCalculator.mq5, premi F7.
   Risultato atteso: "0 errors, 0 warnings".
5. Torna a MT5: finestra Navigatore (Ctrl+N) -> tasto destro
   su "Expert Advisors" -> Refresh.
6. Trascina "SizerCalculator" dal Navigatore al grafico.
7. Nella finestrella che si apre: tab "Comune" -> spunta
   "Consentite il trading algoritmico"; poi OK.
8. Click destro sull'EA nel grafico -> Proprieta' -> tab
   "Input" -> "Carica" -> scegli SizerCalculator.set -> OK.

 Installazione - macOS
---------------------
MT5 su Mac gira sotto Wine/CrossOver: stesse identiche
istruzioni, cambia solo dove si trova la "cartella dati".
Usa lo script incluso:  INSTALL_macOS.txt  (contiene anche
i permessi di esecuzione e la gestione di Gatekeeper).

 Primi passi nel terminale
-------------------------
- Il pannello mostra: rischio %, conto, rischio in USD,
  lotto calcolato, Entry/SL/TP1/TP2 (prezzo, punti, USD),
  timer della candela e stato ("Ready" ecc.).
- Trascina le linee: SL rossa, TP1 verde, TP2 verde
  (partono gia' posizionate sul 10%/10%/20% del range).
- Imposta il rischio % nel campo "Risk %" (es. 0.50).
- Se le TP sono invertite compare "WRONG!" e BUY/SELL sono
  bloccati: rimetti TP1 piu' vicina del TP2.
- BUY o SELL: dopo la conferma apre con il lotto calcolato.
- A TP1: chiusura parziale (PartialTP1Percent, default 50%)
  + SL portato a break-even comprensivo dei costi.

 Modalita' PENDING
-----------------
- Premi il pulsante PENDING: appare la linea blu Entry,
  trascinabile. Ogni BUY/SELL piazza un ordine pendente
  (Auto/Limit/Stop) con SL+TP2 e snapshot TP1 propri.
- Massimo 5 pendenti; rischio totale max 3% (configurabile).
- CANCEL LAST / CANCEL ALL compaiono solo in pending.
- Ricorda: MT5 ammette UN solo TP per ordine -> il TP1 e'
  gestito internamente dall'EA, il broker vede SL e TP2.

 Personalizzazione
-----------------
- Per cambiare parametri permanenti (es. chiudere l'80% a
  TP1): modifica l'input PartialTP1Percent e usa
  "Salva con nome..." nel tab Input per il preset.
- Commissioni: imposta CommissionPerLot per un break-even
  corretto (valore una-way in valuta conto per lotto).

 Note e sicurezza
----------------
- Testa SEMPRE su un conto demo prima di usare l'EA in reale.
- Il pacchetto contiene solo il sorgente .mq5: la compilazione
  avviene sul tuo MetaEditor (nessun file binario di terzi).
- L'EA non invia dati ne' ordini senza il tuo click.

 Buon trading,
 by Cram
==========================================================
