ALAMO Hedge Module

Ln-1 Gap Handling

Xử lý trường hợp Ln-1 đã active nhưng đóng trước khi Ln khai hỏa

⚠️ Vấn đề

Điều kiện xảy ra

Ln-1 đã fire thành công nhưng đóng sớm trước khi Ln khai hỏa.

Hậu quả

• Hedge chain bị đứt
• Ln tính lot sai (thiếu coverage)
• Risk exposure tăng trong DD spike

📊 5 Kịch bản Ln-1 đóng

Profit Close

lệnh y > 0

EXPECTED

External Close

User/PosMan

EXPECTED

Fire Failure

Margin/Exec fail

BUG

Market Close

Stop-out

RISKY

Race Condition

Same tick

EDGE

🔧 6 Giải pháp đã phân tích

1. Spam Ln-1 — Re-open với volume gốc

REJECT

2× margin risk, checkpoint/lệnh y refs bị stale

2. Merge Volumes — Gộp Ln-1 lot vào Ln

Simple, 1 lệnh, nhưng không phân biệt lý do đóng

3. Dynamic Compensation — Tính loss delta

Over-engineered

4. Ghost Tracking — Persist metadata

Future-only

5. Conditional Response — Branch theo PnL

Complex

6. Hybrid Inheritance — Response theo lý do đóng

✨ BEST

Phân biệt profit/loss/fail → response tối ưu cho từng case

🔀 Decision Flow (Solution 6)

flowchart TD A[S3_MONITOR tick] --> B{prevLn cache valid?} B -->|NO| Z[Skip - existing behavior] B -->|YES| C{prevLn still open?} C -->|YES| D[Normal escalation] C -->|NO| E{Check closeReason} E -->|FIRE_FAIL| F[🔄 RETRY Ln-1] E -->|LOSS/MANUAL| G[📦 MERGE lot vào Ln] E -->|PROFIT| H[✅ Proceed fresh calc] F --> I{Retry success?} I -->|YES| D I -->|NO, max retries| G G --> J[Fire Ln với merged lot] H --> K[Fire Ln với fresh lot] D --> L[Fire Ln normal] style A fill:#1e3a5f,stroke:#3b82f6 style F fill:#854d0e,stroke:#eab308 style G fill:#14532d,stroke:#22c55e style H fill:#1e3a5f,stroke:#3b82f6

⚖️ Trade-off Matrix

Aspect	Spam Ln-1	Merge	Hybrid
Margin Impact	❌ 2× temp	✅ 1×	✅ Optimal
Precision	✅ Exact	⚠️ Worse fill	✅ Per-case
Complexity	✅ Low	✅ Low	⚠️ Medium
lệnh y Compat	❌ Breaks	✅ OK	✅ OK
High-Vol Risk	🔴 Margin spike	✅ Predictable	✅ Optimal

📋 6 Phases Implementation

1 Spec Clarification

4 câu hỏi cần SS confirm

30m • P1

2 Data Structure

Add close reason enum + struct fields

1h • P1

3 Close Tracking

Detect WHY Ln-1 closed

2h • P1

4 Merge Logic

Conditional merge based on reason

2h • P1

5 Retry Logic

Handle fire failure case

1h • P2

6 Testing

6 scenarios validation

2h • P1

❓ Câu hỏi cần SS trả lời

3 cases (profit/loss/fire_fail) có đúng ý định trading không?

Khi Ln-1 đóng lỗ: prefer Merge hay Re-open?

Fire fail retry bao nhiêu lần? (0 / 1 / 3 / unlimited)

Check margin trước khi fire? (No / 100% / 150% / custom)