Structuring code into files
This commit is contained in:
Bell
@@ -0,0 +1,134 @@
|
||||
# EA_ICT_CL – Kiến trúc & luồng chạy
|
||||
|
||||
File chính: `Experts/EA_ICT_CL.mq5`
|
||||
Thư mục module: `Experts/EA_ICT_CL/` (các `.mqh`)
|
||||
|
||||
## 1) Mục tiêu thiết kế
|
||||
|
||||
- `EA_ICT_CL.mq5` nên là **file “glue”**: `OnInit/OnDeinit/OnTick/...` + gọi hàm module.
|
||||
- Mỗi `.mqh` chỉ gánh **một trách nhiệm**: config/state/signals/risk/trade/filters/…
|
||||
- Migrate **từng phần nhỏ** để tránh trùng định nghĩa (enum/struct/global) và dễ debug.
|
||||
|
||||
## 2) Luồng chạy tổng thể (theo mô tả hiện tại trong header v4.3)
|
||||
|
||||
### Bối cảnh timeframe
|
||||
|
||||
- **BiasTF (D1)**: xác định bias (UP/DOWN/SIDEWAY/NONE)
|
||||
- **MiddleTF (H1)**: xác định trend + quét FVG thuận xu hướng
|
||||
- **TriggerTF (M5)**: xác nhận entry bằng **MSS** (market structure shift)
|
||||
|
||||
### State machine
|
||||
|
||||
EA đang dùng state machine:
|
||||
|
||||
- **`EA_IDLE`**
|
||||
- Mục tiêu: tìm/đặt “FVG tốt nhất” (MiddleTF) để theo dõi.
|
||||
- **`EA_WAIT_TOUCH`**
|
||||
- Mục tiêu: chờ giá retrace và **touch vào vùng FVG** (H1).
|
||||
- **`EA_WAIT_TRIGGER`**
|
||||
- Mục tiêu: khi đã touch FVG, chờ **M5 MSS** xác nhận đảo chiều theo trend.
|
||||
- v4.3: MSS chỉ detect khi state này.
|
||||
- **`EA_IN_TRADE`**
|
||||
- Mục tiêu: quản lý pending/position (trailing/timeout/cleanup tuỳ EA).
|
||||
|
||||
### Decision flow “từ trên xuống”
|
||||
|
||||
1) **D1 Bias**
|
||||
- Xác định `HTFBias` (UP/DOWN/SIDEWAY/NONE).
|
||||
2) **H1 Trend / Swing structure**
|
||||
- Xác định `MarketDir` (UP/DOWN/NONE) và các swing gần nhất: `h0/h1/l0/l1`.
|
||||
3) **Quét H1 FVG**
|
||||
- Tạo/duy trì pool FVG (`g_FVGPool`) tối đa `MAX_FVG_POOL`.
|
||||
- FVG có lifecycle: `PENDING → TOUCHED → USED`.
|
||||
4) **Touch FVG**
|
||||
- Khi bid/ask đi vào vùng gap → `touchTime` được set, chuyển state sang chờ trigger.
|
||||
5) **M5 MSS (chỉ khi `EA_WAIT_TRIGGER`)**
|
||||
- Nếu H1 UP: bull MSS khi close phá **OLD** `tH0` → entry = `tH0`, SL = `tL0`.
|
||||
- Nếu H1 DOWN: bear MSS khi close phá **OLD** `tL0` → entry = `tL0`, SL = `tH0`.
|
||||
6) **Lập kế hoạch lệnh (OrderPlan)**
|
||||
- `direction`: +1 BUY LIMIT / -1 SELL LIMIT
|
||||
- `entry`, `stopLoss`, `takeProfit`, `lot`
|
||||
7) **Risk sizing**
|
||||
- Lot theo `%risk` và khoảng SL (points).
|
||||
- Chặn trade nếu chạm max daily loss (`InpMaxDailyLossPct`).
|
||||
8) **Gửi pending limit**
|
||||
- Gắn `magic` và comment có `fvg_id` để trace.
|
||||
|
||||
## 3) Các folder/file module (vai trò + khi nào dùng)
|
||||
|
||||
Thư mục: `Experts/EA_ICT_CL/`
|
||||
|
||||
- **`Config.mqh`**
|
||||
- Nơi đưa `input`, `enum` và hằng số cấu hình.
|
||||
- Khi migrate: chuyển dần `input ...` và các enum khỏi `.mq5` sang đây (rồi include).
|
||||
|
||||
- **`State.mqh`**
|
||||
- Nơi đưa `struct` contexts (bias/trend/fvg/orderplan/daily risk) + state machine.
|
||||
- Khi migrate: chuyển dần các `struct`, `g_*` globals sang đây để module nào cũng dùng chung.
|
||||
|
||||
- **`Utils.mqh`**
|
||||
- Helper thuần: clamp/round/newbar/time formatting…
|
||||
- Ưu tiên migrate các hàm nhỏ, không phụ thuộc EA logic (vd `MyBarShift` cũng có thể đặt vào đây hoặc `Market/Indicators`).
|
||||
|
||||
- **`Logging.mqh`**
|
||||
- Chuẩn hoá log bật/tắt theo `InpDebugLog`.
|
||||
- Có thể mở rộng: prefix theo symbol/tf/state, ghi file, debug panel.
|
||||
|
||||
- **`Market.mqh`**
|
||||
- Helper về symbol specs (digits/point/spread), trade allowed, quote access…
|
||||
|
||||
- **`Sessions.mqh`**
|
||||
- Helper session/time filter (London/NY theo UTC).
|
||||
- Khi migrate: đưa logic “được trade trong giờ nào?” sang đây.
|
||||
|
||||
- **`Filters.mqh`**
|
||||
- Các bộ lọc: spread, news (nếu có), day-of-week, max trades/day, cooldown…
|
||||
|
||||
- **`Indicators.mqh`**
|
||||
- Wrapper CopyBuffer/CopyTime, quản lý handles nếu bạn dùng iMA/iATR/…
|
||||
|
||||
- **`Signals_BOS_FVG_OB.mqh`**
|
||||
- Nơi tập trung **logic tín hiệu**: BOS/MSS/FVG/OB… và build `OrderPlan`.
|
||||
- Mục tiêu: module này “pure” nhất có thể (input/state snapshot → plan).
|
||||
|
||||
- **`Risk.mqh`**
|
||||
- Tính lot, normalize volume, kiểm soát daily drawdown.
|
||||
|
||||
- **`Orders.mqh`**
|
||||
- Chuẩn hoá normalize price, build comment, mapping direction→order type…
|
||||
|
||||
- **`Trade.mqh`**
|
||||
- Các hàm “side-effect”: `OrderSend`, modify, cancel, close.
|
||||
|
||||
- **`Trailing.mqh`**
|
||||
- Trailing/BE/partial close (nếu có).
|
||||
|
||||
## 4) Gợi ý thứ tự migrate (an toàn, ít rủi ro nhất)
|
||||
|
||||
Để tránh trùng định nghĩa và lỗi include:
|
||||
|
||||
1) **Move helpers**: `MyBarShift`, swing helper functions → `Utils.mqh` (hoặc tách `Swing.mqh` nếu bạn muốn).
|
||||
2) **Move trade wrappers**: các đoạn `MqlTradeRequest/Result` → `Trade.mqh` + helper normalize → `Orders.mqh`.
|
||||
3) **Move risk**: tính lot / daily loss → `Risk.mqh`.
|
||||
4) **Move filters/session** → `Sessions.mqh`, `Filters.mqh`.
|
||||
5) **Cuối cùng mới move types**: enums/struct/global sang `Config.mqh` + `State.mqh`.
|
||||
|
||||
> Lưu ý: Chỉ include module nào khi bạn đã chuyển phần tương ứng khỏi `.mq5` (để tránh “redefinition”).
|
||||
|
||||
## 5) Quy ước include trong `EA_ICT_CL.mq5` (gợi ý)
|
||||
|
||||
Khi bắt đầu migrate, thường include theo thứ tự:
|
||||
|
||||
1. `Config.mqh`
|
||||
2. `State.mqh`
|
||||
3. `Utils.mqh`
|
||||
4. `Logging.mqh`
|
||||
5. `Market.mqh`
|
||||
6. `Indicators.mqh`
|
||||
7. `Sessions.mqh` / `Filters.mqh`
|
||||
8. `Risk.mqh`
|
||||
9. `Orders.mqh`
|
||||
10. `Trade.mqh`
|
||||
11. `Signals_BOS_FVG_OB.mqh`
|
||||
12. `Trailing.mqh`
|
||||
|
||||
Reference in New Issue
Block a user