# Master Roadmap — Dzentra Bot

## Цель проекта
Создать Telegram-бота для:
- ручной торговли;
- мониторинга рынка;
- автоторговли;
- аналитики;
- управления стратегиями.

---

# Stage 01 — Bootstrap / Foundation
✔ app bootstrap  
✔ config layer  
✔ logging  
✔ router bootstrap  
✔ DB bootstrap  

✅ Статус: завершён

---

# Stage 02 — System / Diagnostics
✔ system screen  
✔ exchange health  
✔ DB health  
✔ runtime info  
✔ error rendering  

✅ Статус: завершён

---

# Stage 03 — Exchange Integration
✔ mock exchange  
✔ time handling  
✔ exchangeInfo  
✔ private auth  
✔ account + portfolio  
✔ market live polling  
⚠ websocket research / fallback polling  

✅ Статус: завершён (fallback mode)

---

# Stage 04 — Storage / Journal
✔ storage foundation  
✔ event log  
✔ repositories  
✔ UI integration  
✔ journal management  

✅ Статус: завершён

---

# Stage 05 — Trading UI / Draft / Validation
✔ order draft flow  
✔ interactive builder  
✔ validation  
✔ runtime mode helpers  
✔ UI unification  
✔ quantity normalization  

✅ Статус: завершён

---

# Stage 06 — Journal / Navigation / Settings
✔ journal UI  
✔ navigation improvements  
✔ settings screen  
✔ system info  

✅ Статус: завершён

---

# Stage 07 — Auto Trading

## 07.1 — Skeleton UI
✔ экран автоторговли  
✔ state machine  

## 07.2 — Real settings
✔ стратегия  
✔ риск  
✔ символ  
✔ leverage (default x2)

## 07.3 — Analysis Cycle
✔ run_cycle()  
✔ mock signals  
✔ live updates  

### 07.3.1 — Background Runner
✔ asyncio loop  

### 07.3.2 — Live Screens
✔ market  
✔ portfolio  
✔ journal  

### 07.3.3 — Multi Live
✔ multi-screen  
✔ duplicate protection  

### 07.3.4 — Monitoring redesign
✔ новый экран мониторинга  

### 07.3.5 — WebSocket probe
✔ ws skeleton  
⚠ fallback REST polling  

## 07.4 — Strategy Plugin Architecture

### 07.4.1
✔ BaseStrategy  
✔ SignalResult  

### 07.4.2
✔ Strategy Registry  

### 07.4.3 — Trend Strategy
✔ signal generation  
✔ repeat confirmation logic  
✔ confidence scoring  
✔ UI integration  

#### 07.4.3.1 — UI Optimization ✅
✔ compact auto screen  
✔ state-based rendering (OFF / RUNNING / OBSERVING)  
✔ minimal trading layout  
✔ duplicate info removal  

#### 07.4.3.2 — Engine Decoupling (NEXT) ✅
✔ split analysis / UI refresh  
✔ fast price polling (1s)  
✔ slow UI updates (event-driven / 60s)  
✔ anti-flood protection

#### 07.4.3.3 — Paper Position & Execution Engine ✅
- добавлен ExecutionEngine
- реализованы paper-позиции (LONG / SHORT)
- интеграция с AutoTradeService
- синхронизация с UI
- логирование paper execution
- EventBus события (paper_position_opened)

#### Stage 07.4.3.4 — Telegram Strong Signal Alerts ✅
- EventBus-driven уведомления
- Фильтрация READY сигналов
- Поддержка BUY / SELL
- Анти-спам (deduplication)
- Интеграция с Journal
- Runner полностью управляет Telegram-уведомлениями

#### Stage 07.4.3.5 — Debug Commands & Test Mode ✅
- DEBUG_ENABLED env flag
- debug_force_signal API
- instant EventBus processing
- Telegram debug commands
- state inspection (/debug_state)
- journal logging for debug actions
- full pipeline testing without market dependency

#### Stage 07.4.3.6 - Smart Alert Throttling ✅
- cooldown для Telegram сигналов
- suppression повторных BUY/SELL
- journal logging suppressed событий
- не влияет на execution pipeline

#### 07.4.3.7 — Alert priority & UX improvements ✅
- priority levels: HIGH / MEDIUM / LOW
- improved Telegram alert layout
- normalized symbol & leverage formatting
- compatible with cooldown & suppression
- extended debug_signal parameters

#### 07.4.3.8 — Telegram Execution Alerts ✅
- Telegram alerts for paper position opened
- Telegram alerts for paper position closed
- Entry / Exit / Size / PnL rendering
- readable USD formatting
- signal alerts separated from execution alerts

#### 07.4.3.9 — Position flip flow ✅
- instant LONG ↔ SHORT reversal (FLIP)
- new EventBus event: paper_position_flipped
- unified execution alert for flip
- improved execution realism (no idle gap)

#### 07.4.3.10 — Auto UI Refactor & Live Screen ✅

- разделение auto.py → main.py + ui.py
- единый render-пайплайн через AutoTradeRunner
- live-обновление экрана без дублирования сообщений
- компактный UI: Signal / Decision / Position / PnL
- отображение Position Risk и Est. Size
- унификация форматирования (USD / price / leverage)
- защита от лишних edit (message is not modified)

#### 07.4.3.11 — Risk Settings UI & UX ✅

- отдельный экран Risk Settings (SL / TP / Max Loss)
- FSM-ввод значений (проценты и USD)
- inline-редактирование (без новых сообщений)
- временные статусы (auto-clear через ~2.5 сек)
- защита от race condition (убран “скачок” экранов)
- reset risk controls (все параметры → off)
- интеграция в Auto screen (Controls строка)
- интеграция в Settings (Risk Controls summary)
- единая навигация: Auto ↔ Settings ↔ Risk
- UX-подсказки и валидация ввода

#### 07.4.3.12 — Real Risk Engine (execution-level) ✅
- risk checks внутри ExecutionEngine
- SL / TP / ML закрывают позицию
- forced close с risk_reason
- интеграция в основной цикл автоторговли
- Telegram execution alerts с причиной риска
- единая точка принятия решений (execution layer)

#### 07.4.3.13 — Risk-Based Position Sizing & Margin Protection ✅
- risk-based position sizing через SL distance
- размер позиции теперь рассчитывается от Risk %
- execution-level margin validation
- защита от oversized positions
- max reserved balance limit
- execution block reason state
- блокировка ENTRY / FLIP при превышении margin limit
- compact mobile UI redesign
- новый формат SL / TP / ML
- compact position rendering
- estimated margin preview
- max reserved preview
- execution blocked status в UI
- улучшенный mobile formatting
- SL стал обязательным для risk-engine sizing
- risk_percent теперь реально влияет на размер позиции
- flip теперь проходит через margin protection

### 07.4.4
⏳ Grid Strategy  

### 07.4.5
⏳ Scalping Strategy  

### 07.3.6 — Signal Engine
⏳ реальные сигналы  

### 07.3.7 — Execution Engine
⏳ исполнение ордеров  

### 07.3.8 — Analytics
⏳ статистика торговли  

🟡 Статус: в работе

---

# Stage 08 — Analytics / Reports
⏳ отчёты  
⏳ pnl  
⏳ winrate  
⏳ drawdown  

⚪ Статус: не начат

---

# Stage 09 — Production Readiness
⏳ deployment  
⏳ monitoring  
⏳ alerts  
⏳ backups  

⚪ Статус: не начат

---

## Текущий статус проекта

👉 Завершён: 07.4.3.1  
👉 Следующий шаг: 07.4.3.2 — Engine Decoupling + Price Polling