Bell-PriceActionWithEma-EA/Experts/RSIForceStateEA/README.md

# RSIForceStateEA

EA giao dịch pullback theo động lực RSI, lọc xu hướng bằng EMA200, điều phối bằng state
machine 4 trạng thái. Mỗi pullback chỉ một lệnh, vào bằng **BUY/SELL LIMIT** (không đuổi giá market).

## 1) Cấu trúc thư mục

- EA chính: `Experts/RSIForceStateEA.mq5`
- Các module:
  - `Experts/RSIForceStateEA/Config.mqh` — toàn bộ tham số đầu vào (`input`)
  - `Experts/RSIForceStateEA/State.mqh` — `enum` + `struct` (không chứa biến global)
  - `Experts/RSIForceStateEA/Indicators.mqh` — handle chỉ báo + buffer + hàm slope/cross
  - `Experts/RSIForceStateEA/Trade.mqh` — đặt lệnh, khối lượng theo rủi ro, partial + BE
  - `Experts/RSIForceStateEA/StateMachine.mqh` — luồng 4 trạng thái
  - `Experts/RSIForceStateEA/Visualizer.mqh` — dashboard, bảng thống kê, mức Entry/SL/TP
  - `Experts/RSIForceStateEA/README.md` — tài liệu này

Thứ tự `#include` trong file `.mq5`:

```
Layer 1 : Config -> State -> Indicators
Globals : g_State, g_Pending, g_OpenTrade
Layer 2 : Trade -> StateMachine
Layer 3 : Visualizer
```

## 2) Logic tổng thể

### 2.1 Các chỉ báo

- `RSI(InpRSIPeriod)` — động lực giá.
- `EMA(InpRSI_EMA9Period)` — tính **trên** chuỗi RSI.
- `WMA(InpRSI_WMA45Period)` — tính **trên** chuỗi RSI.
- `EMA(InpEMA200Period)` — trên **giá đóng** — lọc xu hướng.
- `ATR(InpATRPeriod)` — dùng cho vùng đệm trend và SL.

### 2.2 Bộ lọc xu hướng (trend)

- **Uptrend** khi `Close > EMA200 + buffer`.
- **Downtrend** khi `Close < EMA200 - buffer`.
- **Buffer**:
  - Theo `%` EMA200 mặc định (`InpTrendBufferPercent = 0.10%`), hoặc
  - Theo ATR nếu `InpUseATRTrendBuffer = true`.
- `InpSkipFlatEMA200`: bỏ qua khi EMA200 “phẳng” (chênh lệch giữa hai nến ≤ `ATR * InpFlatEMA_ATRMult`).

### 2.3 Bốn trạng thái

| Trạng thái | Ý nghĩa |
| ----------- | ------- |
| `STATE_NO_TRADE` | Chưa có setup hợp lệ |
| `STATE_WATCHING` | Đã có pullback hợp lệ, đang chờ tín hiệu vào lệnh |
| `STATE_PENDING_ORDER` | Đã đặt BUY/SELL LIMIT, chờ khớp |
| `STATE_IN_TRADE` | Đã khớp, đang quản lý vị thế (partial + BE + TP) |

### 2.4 Pullback (`NO_TRADE` → `WATCHING`)

- Pullback trong **uptrend**:
  - `RSI < EMA9 < WMA45`
  - Cả ba đường cùng **slope giảm** (kiểm tra trên `InpSlopeLookbackBars` nến).
- Pullback trong **downtrend**: đối xứng (slope tăng).

### 2.5 Kích hoạt vào lệnh (`WATCHING` → `PENDING_ORDER`)

- **Tín hiệu BUY**:
  - RSI cắt **lên** WMA45 (so sánh nến `InpSignalBarShift` với nến trước).
  - EMA9 vẫn **dưới** WMA45.
  - Trong `InpMinBarsBetweenCrosses` nến trước đó **không** có cắt RSI/WMA45 (tín hiệu “cô lập”, tránh nhiễu sát WMA45).
- **Tín hiệu SELL**: đối xứng.

### 2.6 Đặt lệnh LIMIT

- `Entry = (Close(nến tín hiệu) + SwingExtreme) / 2`
  - **BUY**: SwingExtreme = đáy gần nhất trong `InpSwingLookbackBars`.
  - **SELL**: SwingExtreme = đỉnh gần nhất.
- Lệnh: `BuyLimit` / `SellLimit` (không vào market).
- Pending tối đa `InpPendingMaxAliveBars` nến; hết hạn → hủy.
- Nếu `InpInvalidateIfCrossBack = true`: RSI cắt ngược lại WMA45 hoặc mất trend → hủy.
- `WATCHING` tối đa `InpWatchingMaxBars` nến không có trigger → về `NO_TRADE`.

### 2.7 Stop Loss

| Chế độ | Công thức |
| ------ | --------- |
| `SL_SWING` | Cực trị swing ± `InpSL_SwingBufferPoints` (point) |
| `SL_ATR` | `Entry ± ATR * InpSL_ATRMult` |
| `SL_HYBRID` | Chọn SL **rộng hơn** giữa swing và ATR (mặc định, an toàn hơn) |

### 2.8 Take Profit

- `TP = Entry ± R * InpRiskRewardRatio` (mặc định `2R`).

### 2.9 Quản lý khi `IN_TRADE`

- Rủi ro: `InpRiskPercent` (% số dư, mặc định 1%).
- Khi giá đạt `InpPartialCloseAtR` lần **R thực tế** (mặc định `1.5R`):
  - Đóng `InpPartialClosePercent` % khối lượng (mặc định 50%).
  - Dời SL về **giá khớp** (BE).
- Nếu không chia được lot (bị `volume min` chặn): vẫn dời SL về BE, bỏ qua partial.
- Không có hành động đặc biệt tại `1R`.

### 2.10 Chống spam (một pullback — một lệnh thử)

- Biến `g_HasTradedThisPullback`: sau khi **đặt thành công** pending cho pullback hiện tại → bật.
- **Reset** `g_HasTradedThisPullback` khi:
  - Pending bị hủy / hết hạn / invalid (chưa khớp → được thử pullback khác).
  - Vị thế đã đóng hoàn toàn (TP/SL/đóng tay).
  - **Đảo chiều xu hướng có hướng** UP ↔ DOWN (đi qua `TREND_NONE` ngắn **không** coi là đảo chiều).
- Khi đảo chiều UP ↔ DOWN mà còn pending ngược hướng → hủy pending.

### 2.11 Bộ lọc RSI sideway

- `InpUseRSISidewayFilter`: nếu **tất cả** `InpSidewayLookbackBars` giá trị RSI gần nhất nằm trong `[InpSidewayRSILow, InpSidewayRSIHigh]` → bỏ qua tìm setup mới.
- Bộ lọc này **chỉ** chặn nhánh `NO_TRADE → WATCHING`; **không** chặn vòng đời pending và **không** chặn quản lý vị thế.

## 3) Cách biên dịch và chạy

1. Mở MetaEditor.
2. Mở `MQL5/Experts/RSIForceStateEA.mq5` và biên dịch (F7).
3. Quay lại MT5, gắn EA vào biểu đồ cần giao dịch.
4. Bật **Algo Trading**.
5. Có thể chỉnh `Inputs` ngay trên giao diện khi gắn EA.

## 4) Các tham số quan trọng (mặc định)

| Tham số | Mặc định | Mô tả |
| ------- | -------- | ----- |
| `InpMagicNumber` | 26050901 | Magic; đổi nếu chạy nhiều bản EA |
| `InpRiskPercent` | 1.0 | % số dư / mỗi lệnh |
| `InpRiskRewardRatio` | 2.0 | TP = R × hệ số này |
| `InpPartialCloseAtR` | 1.5 | Chốt một phần khi đạt R này (phải < RR) |
| `InpPartialClosePercent` | 50.0 | % khối lượng chốt partial |
| `InpPendingMaxAliveBars` | 5 | Hủy pending sau N nến |
| `InpWatchingMaxBars` | 10 | Thoát WATCHING nếu không có trigger |
| `InpMinBarsBetweenCrosses` | 10 | Khoảng cách tối thiểu giữa các lần cắt RSI/WMA45 |
| `InpSlopeLookbackBars` | 3 | Số nến kiểm tra slope |
| `InpSwingLookbackBars` | 20 | Cửa sổ tìm swing cho entry/SL |
| `InpStopLossMode` | SL_HYBRID | `SL_SWING` / `SL_ATR` / `SL_HYBRID` |
| `InpSL_ATRMult` | 1.2 | Hệ số ATR cho SL kiểu ATR |
| `InpSL_SwingBufferPoints` | 20 | Đệm thêm (point) ngoài cực trị swing |
| `InpUseRSISidewayFilter` | true | Bật/tắt lọc sideway RSI |
| `InpSidewayRSILow / High` | 45 / 55 | Dải sideway theo RSI |
| `InpUseATRTrendBuffer` | false | Dùng buffer trend theo ATR |

## 5) Gợi ý kiểm thử và tối ưu

- Nên backtest từng symbol ít nhất 6–12 tháng trước khi chạy thật.
- Thị trường biến động mạnh: thử `InpUseATRTrendBuffer = true`.
- Muốn **ít tín hiệu hơn nhưng chọn lọc hơn**:
  - Tăng `InpMinBarsBetweenCrosses`
  - Tăng `InpSlopeLookbackBars`
  - Giữ `SL_HYBRID`
- Muốn **nhiều tín hiệu hơn**:
  - Giảm `InpSlopeLookbackBars` xuống 2
  - Tắt `InpUseRSISidewayFilter`
- Theo dõi tab **Experts** / **Journal** để xem log `[STATE]`, `[TREND]`, `[PENDING]`, `[TRADE]`.

## 6) Hiển thị trực quan (Visualization)

EA có thể tự vẽ để quan sát và đánh giá (bật/tắt bằng `InpVisualize` và các cờ con).

### 6.1 Dashboard (góc trên-trái)

Hiển thị:

- **Trend**: UP / DOWN / NONE (màu xanh / đỏ / xám)
- **State**: `STATE_NO_TRADE` / `STATE_WATCHING` / `STATE_PENDING_ORDER` / `STATE_IN_TRADE`
- **RSI**: giá trị RSI, EMA9, WMA45 tại nến tín hiệu (`InpSignalBarShift`)
- **EMA200**: giá trị EMA200 + giá đóng hiện tại
- **ATR**: giá trị ATR
- **Context**: tùy trạng thái — ví dụ số nến WATCHING, thời gian sống pending, đã partial hay chưa

### 6.2 Bảng thống kê (góc dưới-trái)

Quét lịch sử `InpStatsLookbackDays` ngày (mặc định 60), lọc theo `InpMagicNumber` + `_Symbol`:

- **Total**: số vị thế đã đóng (gộp theo `POSITION_ID`, tránh đếm trùng partial)
- **TP hit**: số deal đóng với lý do `DEAL_REASON_TP`
- **SL hit**: số deal đóng với lý do `DEAL_REASON_SL`
- **Other**: đóng tay / partial / đóng bởi expert
- **Net PL**: tổng P/L (profit + swap + hoa hồng)

### 6.3 Mức giá Entry / SL / TP (kiểu TradingView)

Khi `STATE_PENDING_ORDER` hoặc `STATE_IN_TRADE`, vẽ 3 đường ngang:

- **ENTRY** (chấm, màu `InpColorEntry`)
- **SL** (gạch, màu `InpColorSL`)
- **TP** (gạch, màu `InpColorTP`)

Tự xóa khi về `NO_TRADE`.

### 6.4 Tự gắn chỉ báo lên chart

Khi `InpAttachIndicators = true` (mặc định):

- **EMA200** vào cửa sổ chính.
- **RSI**, **EMA trên RSI**, **WMA trên RSI** vào **cửa sổ phụ** (subwindow).

Có thể tắt từng phần:

| Tham số | Mặc định | Tác dụng |
| ------- | -------- | -------- |
| `InpVisualize` | true | Bật/tắt toàn bộ lớp hiển thị |
| `InpAttachIndicators` | true | Tự thêm EMA200 + cụm RSI lên chart |
| `InpShowDashboard` | true | Panel góc trên-trái |
| `InpShowStatsPanel` | true | Panel góc dưới-trái |
| `InpShowTradeLevels` | true | Đường Entry/SL/TP |
| `InpStatsLookbackDays` | 60 | Số ngày quét thống kê |

Mọi đối tượng đồ họa dùng tiền tố `RSIForce_` và được xóa trong `OnDeinit`.

## 7) Luồng chạy chi tiết (từng bước)

### 7.1 Toàn cảnh kiến trúc

```
+-------------------------------------------------------------+
|                  RSIForceStateEA.mq5                        |
|  (điểm vào — chỉ có OnInit / OnTick / OnTradeTransaction    |
|   / OnDeinit, không chứa logic nghiệp vụ)                   |
+-------------------------------------------------------------+
            |
            | #include theo thứ tự:
            v
+-------- Tầng 1 (dữ liệu + kiểu) ---------------------------+
|  Config.mqh       — toàn bộ input                           |
|  State.mqh        — enum EAState, struct SignalSnapshot...   |
|  Indicators.mqh   — handle iRSI/iMA + buffer g_RSI[]...      |
+------------------------------------------------------------+
            |
            | Khai báo global trong .mq5:
            |   g_State, g_Pending, g_OpenTrade
            v
+-------- Tầng 2 (logic) ------------------------------------+
|  Trade.mqh        — CalcLotsForRisk, PlaceLimitOrderFromPlan,|
|                     ManagePartialAndBreakEven...             |
|  StateMachine.mqh — DetectTrend, IsPullback*, IsBuyTrigger*, |
|                     BuildSignalPlan, RunStateMachine...      |
+------------------------------------------------------------+
            |
            v
+-------- Tầng 3 (giao diện) --------------------------------+
|  Visualizer.mqh   — DrawDashboardPanel, DrawStatsPanel,      |
|                     DrawTradeLevels, AttachIndicatorsToChart |
+------------------------------------------------------------+
```

### 7.2 Vòng đời — từ lúc gắn EA

#### Bước 0. MT5 gọi `OnInit()` (file `RSIForceStateEA.mq5`)

```
RSIForceStateEA.mq5 :: OnInit()
  |
  +-- ValidateInputs()              (file .mq5 — kiểm tra cấu hình)
  |   nếu sai  -> INIT_PARAMETERS_INCORRECT (EA không khởi động)
  |
  +-- ZeroMemory(g_Pending), ZeroMemory(g_OpenTrade)
  |   đưa global về trạng thái sạch
  |
  +-- InitIndicators()              (Indicators.mqh)
  |   |
  |   +-- iRSI(...)        -> g_hRSI
  |   +-- iMA(g_hRSI, EMA) -> g_hEMA9   (EMA trên RSI)
  |   +-- iMA(g_hRSI, WMA) -> g_hWMA45  (WMA trên RSI)
  |   +-- iMA(close, EMA)  -> g_hEMA200 (EMA trên giá đóng)
  |   +-- iATR(...)        -> g_hATR
  |   +-- ArraySetAsSeries(...) cho mọi buffer
  |
  +-- RefreshIndicatorData()        (Indicators.mqh)
  |   |
  |   +-- CopyRates()    -> g_Bars[]
  |   +-- CopyBuffer() -> g_RSI[], g_EMA9[], g_WMA45[], g_EMA200[], g_ATR[]
  |   nếu chart chưa đủ lịch sử (< 200 nến) -> INIT_FAILED
  |
  +-- InitTradeOps()                (Trade.mqh)
  |   |
  |   +-- g_TradeOps.SetExpertMagicNumber(InpMagicNumber)
  |   +-- g_TradeOps.SetDeviationInPoints(10)
  |   +-- g_TradeOps.SetTypeFillingBySymbol(_Symbol)
  |
  +-- g_LastTrend = DetectTrend(InpSignalBarShift)
  |   khởi tạo trend ngay từ đầu để tick đầu không báo “đảo chiều” giả
  |
  +-- AttachIndicatorsToChart()     (Visualizer.mqh)
  |   |
  |   +-- IsIndicatorAlreadyAttached(...) — tránh trùng khi reload EA
  |   +-- ChartIndicatorAdd(0, 0, g_hEMA200)        -> cửa sổ chính
  |   +-- ChartIndicatorAdd(0, sub, g_hRSI)        -> subwindow
  |   +-- ChartIndicatorAdd(0, sub, g_hEMA9)
  |   +-- ChartIndicatorAdd(0, sub, g_hWMA45)
  |
  +-- DrawAllVisuals(g_LastTrend)   (Visualizer.mqh)
      vẽ dashboard + stats lần đầu
```

#### Bước 1. Mỗi tick — `OnTick()` (`RSIForceStateEA.mq5`)

```
RSIForceStateEA.mq5 :: OnTick()
  |
  +-- RefreshIndicatorData()        (Indicators.mqh)
  |   cập nhật g_Bars / g_RSI / g_EMA9 / g_WMA45 / g_EMA200 / g_ATR
  |   nếu copy lỗi (ví dụ thị trường vừa mở) -> return, chờ tick sau
  |
  +-- SyncStateWithBroker()         (StateMachine.mqh)
  |   |
  |   nếu state = PENDING_ORDER:
  |     +- HasOurOpenPosition() = true ? (Trade.mqh)
  |     |    -> chuyển IN_TRADE, copy kế hoạch từ g_Pending sang g_OpenTrade
  |     +- HasOurPendingOrder() = false (hủy/hết hạn/từ chối) ?
  |          -> reset g_HasTradedThisPullback, về NO_TRADE
  |
  |   nếu state = IN_TRADE:
  |     +- HasOurOpenPosition() = false (TP/SL/đóng tay) ?
  |          -> reset g_HasTradedThisPullback, về NO_TRADE
  |
  +-- if (state == IN_TRADE):
  |     ManagePartialAndBreakEven(g_OpenTrade)   (Trade.mqh)
  |     |
  |     +- PositionSelectByTicket(positionTicket)
  |     +- profitDist = giá hiện tại so với giá mở (BUY/SELL)
  |     +- initRisk = |openPrice - SL|  (lấy từ broker, không dùng plan)
  |     +- nếu profitDist >= InpPartialCloseAtR * initRisk:
  |          - PositionClosePartial(ticket, % volume) nếu chia lot được
  |          - PositionModify(ticket, openPrice, tp) — SL về BE
  |          - g_OpenTrade.partialClosedDone = true (chỉ một lần)
  |
  +-- newBar = IsNewBar()           (StateMachine.mqh)
  |   so sánh g_Bars[0].time với lastBarTime — true khi nến mới mở
  |
  +-- if (newBar): RunStateMachine()   <-- xem Bước 2
  |
  +-- if (newBar HOẶC đã qua 2 giây kể từ lần vẽ trước):
        DrawAllVisuals(DetectTrend(InpSignalBarShift))   (Visualizer.mqh)
        |
        +- DrawDashboardPanel(trend)
        +- DrawStatsPanel()
        +- DrawTradeLevels()
```

#### Bước 2. Có nến mới — `RunStateMachine()` (`StateMachine.mqh`)

```
StateMachine.mqh :: RunStateMachine()
  |
  +-- signalShift = InpSignalBarShift          (mặc định = 1, nến vừa đóng)
  +-- trendNow    = DetectTrend(signalShift)   (Up / Down / None)
  |
  +-- Phát hiện đảo chiều **có hướng** thật (UP <-> DOWN):
  |   |
  |   nếu trendNow != NONE:
  |     +- so với g_LastDirTrend (xu hướng có hướng trước đó)
  |     +- nếu g_LastDirTrend khác hướng và cả hai đều không NONE
  |          -> dirFlipped = true
  |     +- cập nhật g_LastDirTrend = trendNow
  |
  +-- if (dirFlipped):              <-- chỉ reset khi UP <-> DOWN
  |     +- ResetPullbackCycle()
  |     +- nếu PENDING_ORDER -> CancelPendingOrder, về NO_TRADE
  |     +- nếu WATCHING      -> về NO_TRADE
  |
  +-- g_LastTrend = trendNow
  |
  +-- switch (g_State):
        |
        case STATE_NO_TRADE:
        |   HandleStateNoTrade(...)
        |
        case STATE_WATCHING:
        |   HandleStateWatching(...)
        |     (timeout, BuildSignalPlan, PlaceLimitOrderFromPlan...)
        |
        case STATE_PENDING_ORDER:
        |   TickPendingOrderLifecycle(...)
        |     (đếm nến, hết hạn/invalid -> hủy, reset anti-spam)
        |
        case STATE_IN_TRADE:
            (không làm gì ở đây — partial/BE chạy trong OnTick)
```

#### Bước 3. Biến động lệnh — `OnTradeTransaction()`

```
RSIForceStateEA.mq5 :: OnTradeTransaction(...)
  |
  +-- SyncStateWithBroker()
      đồng bộ ngay khi broker báo sự kiện (không chỉ dựa vào tick)
```

#### Bước 4. Gỡ EA — `OnDeinit()`

```
RSIForceStateEA.mq5 :: OnDeinit(reason)
  |
  +-- RemoveAllVisuals()            (Visualizer.mqh)
  |   ObjectsDeleteAll(0, "RSIForce_")
  |
  +-- ReleaseIndicators()           (Indicators.mqh)
      IndicatorRelease cho mọi handle
```

### 7.3 Bảng phân công: file nào làm việc gì

| Trách nhiệm | File | Hàm chính |
| ----------- | ---- | --------- |
| Toàn bộ input | `Config.mqh` | (chỉ khai báo) |
| Enum / struct | `State.mqh` | `EAState`, `TrendDirection`, `SignalSnapshot`, `PendingContext`, `TradeContext` |
| Tạo & cập nhật chỉ báo | `Indicators.mqh` | `InitIndicators`, `RefreshIndicatorData`, `IsBufferSlopingDown/Up`, `HasCrossInLastNBars` |
| Lot, đặt/hủy/quản lý lệnh | `Trade.mqh` | `CalcLotsForRisk`, `PlaceLimitOrderFromPlan`, `CancelPendingOrder`, `ManagePartialAndBreakEven` |
| Trend, pullback, trigger | `StateMachine.mqh` | `DetectTrend`, `IsPullbackInUptrend/Downtrend`, `IsBuyTriggerSignal`, `IsSellTriggerSignal` |
| Điều phối state machine | `StateMachine.mqh` | `RunStateMachine`, `HandleStateNoTrade`, `HandleStateWatching`, `TickPendingOrderLifecycle` |
| Đồng bộ broker | `StateMachine.mqh` | `SyncStateWithBroker` (+ `HasOurOpenPosition` / `HasOurPendingOrder` trong `Trade.mqh`) |
| UI & mức giá | `Visualizer.mqh` | `DrawDashboardPanel`, `DrawStatsPanel`, `DrawTradeLevels`, `AttachIndicatorsToChart` |
| Vòng đời & validate | `RSIForceStateEA.mq5` | `OnInit`, `OnTick`, `OnTradeTransaction`, `OnDeinit`, `ValidateInputs` |

### 7.4 Global của EA và ai được sửa

| Global | Kiểu | Vai trò | Thường sửa tại |
| ------ | ---- | ------- | -------------- |
| `g_State` | `EAState` | Trạng thái SM | `TransitionTo` (StateMachine.mqh) |
| `g_Pending` | `PendingContext` | Lệnh chờ | `PlaceLimitOrderFromPlan`, `CancelPendingOrder` |
| `g_OpenTrade` | `TradeContext` | Vị thế mở | `SyncStateWithBroker`, `ManagePartialAndBreakEven` |
| `g_HasTradedThisPullback` | `bool` | Chống spam | Khi đặt lệnh; reset khi hủy/đóng/đảo chiều |
| `g_BarsInWatching` | `int` | Timeout WATCHING | `HandleStateWatching` và khi chuyển trạng thái |
| `g_LastTrend` | `TrendDirection` | Trend mới nhất | Cuối `RunStateMachine` |
| `g_LastDirTrend` | `TrendDirection` | Trend có hướng gần nhất | `RunStateMachine` khi `trendNow != NONE` |

### 7.5 Sự kiện broker → cách code phản ứng

| Sự kiện thực tế | Cách phát hiện | Phản ứng trong code |
| --------------- | -------------- | ------------------- |
| Limit khớp | `OnTradeTransaction` + `SyncStateWithBroker` | `PENDING` → `IN_TRADE`, copy plan |
| Pending hết hạn / bị hủy | `Sync` (không còn order) | `PENDING` → `NO_TRADE`, reset anti-spam |
| Pending bị từ chối | `PlaceLimit...` false hoặc `Sync` | Ở `NO_TRADE`, có log retcode |
| Chạm TP | `Sync` (không còn position) | `IN_TRADE` → `NO_TRADE`, reset anti-spam |
| Chạm SL | như trên | như trên |
| Đóng tay | như trên | như trên |
| Đạt mức partial R | `OnTick` → `ManagePartialAndBreakEven` | Partial (nếu được) + SL về BE |
| Đảo chiều UP ↔ DOWN | `RunStateMachine` — `dirFlipped` | Hủy pending ngược hướng, reset chu kỳ |
| Đi qua NONE rồi về cùng hướng | `RunStateMachine` | **Không** coi là flip; `g_LastDirTrend` giữ ngữ cảnh |
| Nến mới | `OnTick` → `IsNewBar` | Gọi `RunStateMachine` một lần |

## 8) Ghi chú kiến trúc

- State machine chạy theo **nến mới** (`IsNewBar()`), tránh bắn tín hiệu nhiều lần trong cùng một nến.
- Quản lý vị thế (partial + BE) chạy **mỗi tick** để phản ứng nhanh theo giá.
- `SyncStateWithBroker()` chạy mỗi tick và sau `OnTradeTransaction` để trạng thái nội bộ luôn khớp broker (đóng tay, từ chối lệnh, v.v.).
- Phân tầng `#include`:
  - **Tầng 1** chỉ khai báo dữ liệu và hàm thuần.
  - **Tầng 2** dùng các global khai báo giữa hai tầng.
  - **Tầng 3** chỉ đọc/hiển thị, không sửa logic nghiệp vụ cốt lõi.

---

*Tệp README dùng mã hóa UTF-8. Tiếng Việt có dấu an toàn với Git, GitHub và trình soạn thảo hiện đại; không ảnh hưởng tới biên dịch EA (MetaEditor không compile file `.md`).*