MACD_Scout/struktur-direktori.md

1.8 KiB

Struktur Direktori

Berikut saran struktur file/folder untuk EA “MACD Scout” agar rapi, mudah diuji, dan mudah dirawat.

Struktur direktori

  • src/ MACDScout.mq5: entry point EA (OnInit, OnTick, routing logika).
  • src/modules/ Indicators.mqh: wrapper iMACD & iStochastic, pembacaan buffer, util parsing histogram.
  • src/modules/ SignalEngine.mqh: EvaluateSetups (MACD histogram rebound sebelum nol + Stochastic 20/80 cross), filter spread/sesi.
  • src/modules/ RiskManager.mqh: hitung SL dari base candle, kalkulasi lot berbasis risiko, konversi pips↔points, validasi volume/margin.
  • src/modules/ Execution.mqh: kirim order BUY/SELL, set SL/TP awal, error handling, retry sederhana.
  • src/modules/ PositionManager.mqh: partial 80/20, SL→breakeven setelah TP1, TP2=2R, tracking ticket/status.
  • src/modules/ Utils.mqh: waktu/sesi, spread/slippage, logging/telemetri, format teks.
  • presets/ MACDScout-default.set: parameter default (MACD/Stoch, spread, sesi, risiko).
  • tests/ backtest-scenarios.md: skenario uji & metrik; scripts/.ini untuk tester MT5.
  • docs/ UML-classes.puml, UML-activity-entry.puml, UML-sequence-exec.puml, README.md (cara pakai & catatan versi).

Contoh skeleton file utama

  • MACDScout.mq5 mengimpor modul dan hanya mengoordinasikan alur: inisialisasi indikator, cek bar baru, evaluasi sinyal, eksekusi, dan manajemen posisi.
  • Modul terpisah memudahkan perubahan aturan (mis. pola histogram lebih presisi) tanpa mengganggu eksekusi dan risk.

Penamaan dan Magic/komentar

  • Gunakan Magic Number unik per preset; komentar order sertakan tag “MACDScout” dan tipe sinyal untuk pelacakan.

Struktur modular ini menyederhanakan debugging, pengujian, dan iterasi parameter sambil menjaga kesesuaian dengan aturan strategi dari dokumen.