MACD_Scout/Persiapan-Dokumen.md

Berikut paket dokumen yang sebaiknya disiapkan agar pengembangan EA sesuai harapan dan mudah diuji/dirawat.

### 1) Spesifikasi fungsional

- Tujuan EA, simbol/instrumen, time frame utama (M5), sesi trading, dan kondisi eksekusi (per bar vs per tick).  
- Aturan sinyal lengkap: pola histogram MACD (rebound sebelum nol), syarat Slow Stochastic (20/80 dan arah cross), serta konfirmasi candle close.  
- Filter operasional: spread maksimum, news/sesi, kondisi pasar yang dihindari.  


### 2) Desain teknis

- Arsitektur modul: indikator (MACD/Stoch), evaluator sinyal, risk manager, order executor, position manager (partial 80/20, BE, TP2), logging/telemetri.  
- Diagram UML: class diagram modul, activity untuk aturan entry/exit, sequence untuk flow eksekusi order dan partial close.  
- Definisi parameter input dan default, tipe data, serta satuan (pips/points).  


### 3) Spesifikasi manajemen risiko

- Aturan SL (base candle ±1 pip; short menambah spread), target 1R/2R, pemindahan SL ke breakeven setelah TP1, dan kebijakan partial 80/20.  
- Perhitungan ukuran posisi berbasis persentase risiko ekuitas, batas minimal/maksimal lot, dan validasi SYMBOL_VOLUME_{MIN,MAX,STEP}.  


### 4) Rencana pengujian

- Skenario backtest: periode data, simbol, kondisi spread variabel, dan metrik evaluasi (PF, win rate, max DD, avg R, expectancy).  
- Uji robustnes: forward test, walk‑forward, dan sensitivity terhadap parameter MACD/Stoch dan filter spread.  
- Daftar edge case: volatilitas ekstrem, gap, requote, koneksi putus, dan handling order reject.  


### 5) Panduan operasi

- Cara instalasi, pengaturan parameter, log yang dihasilkan, dan interpretasi sinyal/posisi.  
- SOP eksekusi: kapan aktif/nonaktif (mis. menjelang berita), penggantian parameter untuk simbol berbeda, dan batasan penggunaan.  


### 6) Catatan eksperimen/riset

- Hasil backtest/forward test per versi, perubahan parameter, grafik ekuitas, dan catatan insight (mis. performa memburuk saat spread > X).  
- Variasi aturan: definisi lebih presisi untuk “rebound sebelum nol” histogram serta dampaknya pada win rate dan R-multiple.  


### 7) Checklist rilis

- Kesesuaian Magic Number, komentar order, validasi margin/volume, penanganan error (GetLastError), dan stabilitas pada simbol 5-digit/3-digit.  
- Kompatibilitas MetaTrader (build), izin algo trading terminal/server, dan pengujian pada akun/demo broker target.  

Saran organisasi:

- Simpan semua dokumen di repo proyek (docs/) dan sertakan file PlantUML untuk diagram, template preset parameter (.set), dan skrip uji/backtest agar reproducible.