🛠 ManualBacktester — Manuale del programma

1. Cos'è il programma

Caratteristiche principali

• Registrazione trade con 3 click sul grafico (Entry → Stop → Target)
• Salvataggio immediato su file a ogni chiusura trade (anti-perdita)
• Ripresa automatica del setup interrotto (tasto CONTINUA)
• Esportazione report HTML
• Protezioni dati: backup .bak, blocco sovrascrittura, log di caricamento
• Uscita rapida con il tasto Q

2. Installazione e attivazione

1. Il file sorgente è in MQL5\Experts\ManualBacktester.mq5 (compilato come .ex5)
2. Dalla Navigatore di MetaTrader (panello sinistro) trascina ManualBacktester sul grafico desiderato
3. Conferma di permettere l'Algo Trading (pulsante in alto, se richiesto)

Parametri del programma (menu EA, "cappellino blu")

3. Flusso di lavoro (come si usa)

4. Operazioni: pulsanti e click

4.1 Pulsanti strategia (etichette)

4.2 Click sul grafico (3 click = 1 trade)

1. 1° click → imposta il prezzo di ENTRY (linea blu)
2. 2° click → imposta lo STOP LOSS (linea arancione)
3. 3° click → imposta il TARGET: il trade viene subito registrato WIN al prezzo cliccato

4.3 Pulsanti di chiusura anticipata

Questi pulsanti agiscono solo quando esiste un setup completo (fasi TP/WATCH).

4.4 Altri controlli

4.5 Esempio pratico passo-passo

// Supponiamo EURUSD H1, strategia M, area storica visibile sul grafico
1. Premi M                    → "Strategia M selezionata: clicca l'ENTRY."
2. Click su 1.16566           → ENTRY (linea blu)
3. Click su 1.16515           → SL    (linea arancione) → PuntiStop = 51
4. Click su 1.16901           → TP
   → MBT_WIN 3click TP=1.16901
   → MBT_ESITO WIN LONG M | entry=1.16566 sl=1.16515 tp=1.16901 exit=1.16901 | R=+3.093
   → MBT_WIN registrato: LONG +3.093R [M entry 1.17 -> uscita 1.17]
5. Il trade è nel CSV con tutti i suoi valori.

5. Tasti

Il tasto Q non scrive nulla sul grafico: è documentato solo nei parametri EA.

6. Cosa viene registrato per ogni trade

7. File generati (cartella MQL5\Files)

Il "SIMBOLO" è il simbolo del grafico su cui è attaccato l'EA: ogni simbolo ha quindi i suoi file separati.

8. Funzioni interne (come è fatto il programma)

Sezioni semplificate a scopo di comprensione.

8.1 Gestione eventi — OnChartEvent

Unico punto d'ingresso per click, pulsanti e tasti:

void OnChartEvent(const int id,const long &lparam,const double &dparam,const string &sparam)
  {
   if(id==CHARTEVENT_KEYDOWN)            // pressione tasti (es. Q)
     { if(InpExitOnQ && (sparam=="Q" || sparam=="q")) { ExpertRemove(); return; } }
   if(id==CHARTEVENT_CLICK)              // click sul grafico (Entry/SL/TP)
      HandleClick((int)lparam,(int)dparam);
   // ... gestione pulsanti (B_SL, B_BE, strategie, REPORT, SVUOTA ...)
  }

8.2 Chiusura del 3° click — CheckPrice

if(!g_histChecked)
  {
   g_histChecked=true;
   PrintFormat(PREFIX+"WIN 3click TP=%.5f",g_tpPrice);
   CloseTrade(g_tpPrice);      // usa SEMPRE il prezzo cliccato
   return;
  }

8.3 Rispetto del prezzo cliccato — SnapCandle

snapPrice = price;                      // il valore resta quello del click
int base = iBarShift(_Symbol,_Period,t,false);
// cerca SOLO tra ±3 candele quella che incrocia il prezzo (tolleranza 0.5 punto)
// altrimenti usa la candela del click; mai ricerche lontane nel tempo

8.4 Data/ora di uscita — GetExitTime / FindHitTime

// WIN  -> cerca la prima candela che tocca il TP a partire dal 3° click (g_tpTime)
// STOP -> cerca la prima che tocca lo SL a partire da g_slTime
// Se nessun contatto: ClosestCandleAfterEntry() = prima candela dopo l'entry

8.5 Registrazione del trade — CloseTrade

t.id = g_nextId++;
t.de = g_entryTime;   t.entry = g_entryPrice;
t.sl = g_slPrice;     t.tp = g_tpPrice;
t.exitPrice = exitPrice;
t.dx = GetExitTime(exitPrice, isLong);   // data/ora di uscita
FillDerived(t);                          // direzione, punti, valore stop
CalcResult(t);                           // esito e R
g_tradeCount++;
g_trades[g_tradeCount-1] = t;
SaveTrades();                            // salvataggio immediato su CSV

8.6 Salvataggio e backup — SaveTrades / BackupFile

if(FileIsExist(g_fileName))
   BackupFile(g_fileName);               // 1) copia del CSV in .bak
if(g_tradeCount==0 && !g_deleting && FileIsExist(g_fileName))
  {
   Print("Salvataggio BLOCCATO: lista vuota ma CSV esistente"); // 2) guardia
   return;
  }
int h=FileOpen(g_fileName,FILE_WRITE|FILE_CSV|FILE_ANSI,';');
FileWrite(h,"Id","Strategia","Direzione", ...);   // riga intestazione (18 campi)
for(int i=0;i<g_tradeCount;i++) FileWrite(h, ...);  // tutte le righe
FileClose(h);

8.7 Caricamento al riavvio — LoadTrades

for(int hc=0; hc<18; hc++) FileReadString(h);   // salta l'INTERA intestazione
while(!FileIsEnding(h))
  {
   // legge i 18 campi di ogni riga; scarta quelle corrotte (id<1 o entry=0)
   ...
   g_tradeCount++;
  }
Print(PREFIX,"Caricati ",(string)g_tradeCount," trade da ",g_fileName);

8.8 Statistiche — RecomputeStats

// aggiorna: n, WIN/STOP/BE, win rate, R medio, profit factor, drawdown ...
// contiene la guardia anti "zero divide":
g_rr = (g_w>0 && g_l>0 && g_avgL<-0.0000001) ? (g_avgW/(-g_avgL)) : 0.0;

8.9 Report HTML — ExportHtml

Raccoglie l'elenco in memoria e genera ManualBacktester_SIMBOLO.html con tutte le righe.

9. Storico delle versioni

10. Controlli e avvisi da conoscere