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.