dzentra_bot/docs/roadmap/master-roadmap.md

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.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