Stage 07.4.3.5 — Debug commands & test mode
This commit is contained in:
@@ -129,19 +129,19 @@
|
||||
✔ confidence scoring
|
||||
✔ UI integration
|
||||
|
||||
### 07.4.3.1 — UI Optimization
|
||||
#### 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)
|
||||
#### 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
|
||||
#### 07.4.3.3 — Paper Position & Execution Engine ✅
|
||||
- добавлен ExecutionEngine
|
||||
- реализованы paper-позиции (LONG / SHORT)
|
||||
- интеграция с AutoTradeService
|
||||
@@ -149,7 +149,7 @@
|
||||
- логирование paper execution
|
||||
- EventBus события (paper_position_opened)
|
||||
|
||||
### Stage 07.4.3.4 — Telegram Strong Signal Alerts
|
||||
#### Stage 07.4.3.4 — Telegram Strong Signal Alerts ✅
|
||||
- EventBus-driven уведомления
|
||||
- Фильтрация READY сигналов
|
||||
- Поддержка BUY / SELL
|
||||
@@ -157,6 +157,15 @@
|
||||
- Интеграция с 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
|
||||
|
||||
### 07.4.4
|
||||
⏳ Grid Strategy
|
||||
|
||||
|
||||
@@ -96,7 +96,7 @@
|
||||
|
||||
---
|
||||
|
||||
### 07.4.3.1 — UI Optimization
|
||||
#### 07.4.3.1 — UI Optimization
|
||||
✔ компактный экран автоторговли
|
||||
✔ разделение OFF / ACTIVE / OBSERVING
|
||||
✔ убраны дубли (WAITING / HOLD и т.д.)
|
||||
@@ -104,7 +104,7 @@
|
||||
|
||||
---
|
||||
|
||||
### 07.4.3.2 — Engine Decoupling (NEXT)
|
||||
#### 07.4.3.2 — Engine Decoupling (NEXT)
|
||||
⏳ разделение:
|
||||
- analysis loop (частый)
|
||||
- UI loop (редкий)
|
||||
@@ -119,7 +119,7 @@
|
||||
|
||||
---
|
||||
|
||||
### Stage 07.4.3.3 — Paper Position & Execution Engine
|
||||
#### Stage 07.4.3.3 — Paper Position & Execution Engine
|
||||
- добавлен ExecutionEngine
|
||||
- реализованы paper-позиции (LONG / SHORT)
|
||||
- интеграция с AutoTradeService
|
||||
@@ -129,7 +129,7 @@
|
||||
|
||||
---
|
||||
|
||||
## Stage 07.4.3.4 — Telegram Strong Signal Alerts
|
||||
#### Stage 07.4.3.4 — Telegram Strong Signal Alerts
|
||||
- EventBus-driven уведомления
|
||||
- Фильтрация READY сигналов
|
||||
- Поддержка BUY / SELL
|
||||
@@ -144,6 +144,18 @@
|
||||
|
||||
---
|
||||
|
||||
#### 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
|
||||
|
||||
---
|
||||
|
||||
### 07.4.4
|
||||
⏳ Grid strategy
|
||||
|
||||
|
||||
281
docs/stages/stage-07_4_3_4-telegram_alerts-final.md
Normal file
281
docs/stages/stage-07_4_3_4-telegram_alerts-final.md
Normal file
@@ -0,0 +1,281 @@
|
||||
# Stage 07.4.3.4 — Telegram Strong Signal Alerts via EventBus
|
||||
|
||||
## Цель этапа
|
||||
|
||||
Добавить отдельные Telegram-уведомления для сильных торговых сигналов автоторговли.
|
||||
|
||||
Уведомление должно отправляться только тогда, когда сигнал действительно готов к действию:
|
||||
|
||||
- сигнал `BUY` или `SELL`;
|
||||
- `decision_status = READY`;
|
||||
- `is_signal_ready = True`;
|
||||
- событие пришло через `EventBus`;
|
||||
- уведомление не дублируется на каждом цикле анализа.
|
||||
|
||||
---
|
||||
|
||||
## Что реализовано
|
||||
|
||||
### 1. EventBus-событие для READY-сигналов
|
||||
|
||||
В `AutoTradeService` событие `auto_decision_changed` теперь передаёт расширенный payload:
|
||||
|
||||
```python
|
||||
EventBus.emit(
|
||||
"auto_decision_changed",
|
||||
{
|
||||
"previous_decision_status": previous_decision_status,
|
||||
"decision_status": state.decision_status,
|
||||
"signal": state.last_signal,
|
||||
"repeat_count": state.last_signal_repeat_count,
|
||||
"confidence": state.last_signal_confidence,
|
||||
"symbol": state.symbol,
|
||||
"strategy": state.strategy,
|
||||
"leverage": state.leverage,
|
||||
"reason": state.last_signal_reason,
|
||||
},
|
||||
)
|
||||
```
|
||||
|
||||
Это позволяет runner-слою принимать решение об отправке уведомления без прямой связи со стратегией.
|
||||
|
||||
---
|
||||
|
||||
### 2. AutoTradeRunner обрабатывает важные события
|
||||
|
||||
В `AutoTradeRunner` добавлена обработка последнего события из `EventBus`.
|
||||
|
||||
Runner проверяет:
|
||||
|
||||
```text
|
||||
event_type == auto_decision_changed
|
||||
decision_status == READY
|
||||
signal in BUY / SELL
|
||||
```
|
||||
|
||||
Если условия выполнены — отправляется отдельное Telegram-сообщение.
|
||||
|
||||
---
|
||||
|
||||
### 3. Отдельное Telegram-уведомление
|
||||
|
||||
Формат уведомления:
|
||||
|
||||
```text
|
||||
🚨 Сильный сигнал 🟢 BUY
|
||||
|
||||
BTC/USD_LEVERAGE · TREND · x2
|
||||
Confidence: 0.90
|
||||
Repeats: 2
|
||||
|
||||
Причина: DEBUG FORCE BUY
|
||||
```
|
||||
|
||||
Для `SELL` используется красный индикатор.
|
||||
|
||||
---
|
||||
|
||||
### 4. Защита от дублей
|
||||
|
||||
Добавлен ключ последнего уведомления:
|
||||
|
||||
```python
|
||||
_last_strong_alert_key
|
||||
```
|
||||
|
||||
Ключ строится из:
|
||||
|
||||
```text
|
||||
symbol + strategy + signal + repeat_count + confidence + decision_status
|
||||
```
|
||||
|
||||
Если такой же alert уже был отправлен — повторная отправка блокируется.
|
||||
|
||||
---
|
||||
|
||||
### 5. Логирование уведомлений
|
||||
|
||||
При успешной отправке уведомления пишется событие журнала:
|
||||
|
||||
```text
|
||||
auto_strong_signal_alert_sent
|
||||
```
|
||||
|
||||
Payload содержит:
|
||||
|
||||
- symbol;
|
||||
- strategy;
|
||||
- signal;
|
||||
- repeat_count;
|
||||
- confidence;
|
||||
- leverage;
|
||||
- reason.
|
||||
|
||||
---
|
||||
|
||||
### 6. Debug-команды для проверки
|
||||
|
||||
Для проверки сильных сигналов без ожидания рынка добавлены debug-команды.
|
||||
|
||||
Добавлен флаг:
|
||||
|
||||
```env
|
||||
DEBUG_ENABLED=true
|
||||
```
|
||||
|
||||
Команды:
|
||||
|
||||
```text
|
||||
/debug_signal BUY
|
||||
/debug_signal SELL
|
||||
/debug_ready
|
||||
/debug_state
|
||||
```
|
||||
|
||||
При выключенном debug mode команды не выполняются:
|
||||
|
||||
```env
|
||||
DEBUG_ENABLED=false
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 7. Мгновенная обработка debug-события
|
||||
|
||||
Добавлен публичный метод runner-а:
|
||||
|
||||
```python
|
||||
AutoTradeRunner.process_last_event_now()
|
||||
```
|
||||
|
||||
Он нужен для debug-сценариев, чтобы событие `READY BUY / SELL` было обработано сразу, а не ожидало следующего цикла автоторговли.
|
||||
|
||||
---
|
||||
|
||||
## Изменённые файлы
|
||||
|
||||
```text
|
||||
app/src/trading/auto/service.py
|
||||
app/src/trading/auto/runner.py
|
||||
app/src/core/config.py
|
||||
app/src/telegram/handlers/debug.py
|
||||
app/src/telegram/routers.py
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Проверка
|
||||
|
||||
### 1. Включить debug mode
|
||||
|
||||
```env
|
||||
DEBUG_ENABLED=true
|
||||
```
|
||||
|
||||
### 2. Запустить приложение
|
||||
|
||||
```bash
|
||||
python -m src.main
|
||||
```
|
||||
|
||||
### 3. Открыть экран автоторговли
|
||||
|
||||
Нужно, чтобы `AutoTradeRunner` зарегистрировал `bot` и `chat_id`.
|
||||
|
||||
### 4. Выполнить команду
|
||||
|
||||
```text
|
||||
/debug_signal BUY
|
||||
```
|
||||
|
||||
Ожидаемый результат:
|
||||
|
||||
```text
|
||||
🚨 Сильный сигнал 🟢 BUY
|
||||
|
||||
BTC/USD_LEVERAGE · TREND · x2
|
||||
Confidence: 0.90
|
||||
Repeats: 2
|
||||
|
||||
Причина: DEBUG FORCE BUY
|
||||
```
|
||||
|
||||
Также приходит подтверждение debug-команды:
|
||||
|
||||
```text
|
||||
✅ Debug signal forced
|
||||
Signal: BUY
|
||||
Decision: READY
|
||||
Confidence: 0.90
|
||||
Repeats: 2
|
||||
```
|
||||
|
||||
### 5. Проверить журнал
|
||||
|
||||
В журнале должно появиться событие:
|
||||
|
||||
```text
|
||||
auto_strong_signal_alert_sent
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Важное замечание по безопасности
|
||||
|
||||
Debug-команды можно оставлять в коде, но в боевом режиме они должны быть выключены:
|
||||
|
||||
```env
|
||||
DEBUG_ENABLED=false
|
||||
```
|
||||
|
||||
Это важно, потому что debug-команды могут вручную выставлять `READY BUY / SELL`.
|
||||
|
||||
---
|
||||
|
||||
## Ограничения текущего этапа
|
||||
|
||||
Пока не реализовано:
|
||||
|
||||
- cooldown между alert-ами;
|
||||
- настройка включения/выключения alert-ов из UI;
|
||||
- разные уровни сигналов;
|
||||
- подписки на отдельные типы уведомлений;
|
||||
- уведомления по закрытию позиции.
|
||||
|
||||
---
|
||||
|
||||
## Результат
|
||||
|
||||
Этап добавил полноценный механизм Telegram-уведомлений для сильных сигналов через событийную архитектуру.
|
||||
|
||||
Теперь цепочка работает так:
|
||||
|
||||
```text
|
||||
Strategy
|
||||
↓
|
||||
AutoTradeService
|
||||
↓
|
||||
EventBus
|
||||
↓
|
||||
AutoTradeRunner
|
||||
↓
|
||||
Telegram alert
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Следующий этап
|
||||
|
||||
Рекомендуемый следующий этап:
|
||||
|
||||
```text
|
||||
Stage 07.4.3.5 — Position lifecycle and PnL
|
||||
```
|
||||
|
||||
Цели следующего этапа:
|
||||
|
||||
- закрытие paper-позиции;
|
||||
- пересчёт PnL;
|
||||
- логирование закрытия;
|
||||
- обновление UI позиции;
|
||||
- подготовка к Risk Engine.
|
||||
272
docs/stages/stage-07_4_3_5-debug-mode.md
Normal file
272
docs/stages/stage-07_4_3_5-debug-mode.md
Normal file
@@ -0,0 +1,272 @@
|
||||
# Stage 07.4.3.5 — Debug Commands & Test Mode
|
||||
|
||||
## Цель этапа
|
||||
|
||||
Добавить безопасный механизм тестирования автоторговли без зависимости от рыночных условий.
|
||||
|
||||
Этап позволяет:
|
||||
|
||||
- принудительно генерировать сигналы BUY / SELL / READY;
|
||||
- тестировать Telegram-уведомления;
|
||||
- тестировать Execution Engine;
|
||||
- проверять состояние автоторговли в реальном времени.
|
||||
|
||||
---
|
||||
|
||||
## Что реализовано
|
||||
|
||||
### 1. Debug Mode через ENV
|
||||
|
||||
Добавлен флаг:
|
||||
|
||||
```env
|
||||
DEBUG_ENABLED=true
|
||||
```
|
||||
|
||||
При значении `false`:
|
||||
|
||||
- debug-команды полностью отключены;
|
||||
- любые попытки их вызвать возвращают сообщение "Debug mode выключен".
|
||||
|
||||
Это обеспечивает безопасность для production.
|
||||
|
||||
---
|
||||
|
||||
### 2. Debug API в AutoTradeService
|
||||
|
||||
Добавлен метод:
|
||||
|
||||
```python
|
||||
debug_force_signal(...)
|
||||
```
|
||||
|
||||
Позволяет вручную задать:
|
||||
|
||||
- signal (BUY / SELL / HOLD)
|
||||
- confidence
|
||||
- repeat_count
|
||||
- reason
|
||||
|
||||
Метод:
|
||||
|
||||
- обновляет `AutoTradeState`;
|
||||
- выставляет `decision_status = READY` (для BUY/SELL);
|
||||
- эмитит событие `auto_decision_changed`.
|
||||
|
||||
---
|
||||
|
||||
### 3. Интеграция с EventBus
|
||||
|
||||
После debug-сигнала:
|
||||
|
||||
```text
|
||||
AutoTradeService
|
||||
↓
|
||||
EventBus.emit(...)
|
||||
↓
|
||||
AutoTradeRunner
|
||||
```
|
||||
|
||||
Это позволяет тестировать всю цепочку без изменения стратегий.
|
||||
|
||||
---
|
||||
|
||||
### 4. Мгновенная обработка событий
|
||||
|
||||
Добавлен метод:
|
||||
|
||||
```python
|
||||
AutoTradeRunner.process_last_event_now()
|
||||
```
|
||||
|
||||
Он позволяет:
|
||||
|
||||
- обработать событие сразу;
|
||||
- не ждать следующий цикл (`run_cycle`);
|
||||
- использовать debug-команды в реальном времени.
|
||||
|
||||
---
|
||||
|
||||
### 5. Telegram Debug Commands
|
||||
|
||||
Добавлен handler:
|
||||
|
||||
```text
|
||||
app/src/telegram/handlers/debug.py
|
||||
```
|
||||
|
||||
Доступные команды:
|
||||
|
||||
```text
|
||||
/debug_signal BUY
|
||||
/debug_signal SELL
|
||||
/debug_ready
|
||||
/debug_state
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 6. Поведение команд
|
||||
|
||||
#### `/debug_signal BUY`
|
||||
|
||||
- выставляет сигнал BUY;
|
||||
- делает его READY;
|
||||
- запускает обработку EventBus;
|
||||
- отправляет alert (если включён этап 07.4.3.4).
|
||||
|
||||
---
|
||||
|
||||
#### `/debug_ready`
|
||||
|
||||
- shortcut для READY BUY;
|
||||
- максимальная уверенность;
|
||||
- используется для быстрого теста execution и alert.
|
||||
|
||||
---
|
||||
|
||||
#### `/debug_state`
|
||||
|
||||
Показывает текущее состояние:
|
||||
|
||||
```text
|
||||
Status
|
||||
Symbol
|
||||
Strategy
|
||||
Risk
|
||||
Leverage
|
||||
|
||||
Signal
|
||||
Repeats
|
||||
Confidence
|
||||
Decision
|
||||
|
||||
Position
|
||||
Entry
|
||||
PnL
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 7. Логирование
|
||||
|
||||
Добавлено событие:
|
||||
|
||||
```text
|
||||
debug_signal_forced
|
||||
```
|
||||
|
||||
Позволяет:
|
||||
|
||||
- отслеживать тестовые действия;
|
||||
- отделять debug от реальных сигналов.
|
||||
|
||||
---
|
||||
|
||||
## Изменённые файлы
|
||||
|
||||
```text
|
||||
app/src/core/config.py
|
||||
app/src/trading/auto/service.py
|
||||
app/src/trading/auto/runner.py
|
||||
app/src/telegram/handlers/debug.py
|
||||
app/src/telegram/routers.py
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Проверка
|
||||
|
||||
### 1. Включить debug
|
||||
|
||||
```env
|
||||
DEBUG_ENABLED=true
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2. Запустить приложение
|
||||
|
||||
```bash
|
||||
python -m src.main
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3. Открыть автоторговлю
|
||||
|
||||
Важно: чтобы runner получил bot/chat_id.
|
||||
|
||||
---
|
||||
|
||||
### 4. Выполнить команды
|
||||
|
||||
```text
|
||||
/debug_signal BUY
|
||||
/debug_signal SELL
|
||||
/debug_ready
|
||||
/debug_state
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 5. Ожидаемый результат
|
||||
|
||||
- приходит debug confirmation;
|
||||
- приходит Telegram alert (если READY);
|
||||
- обновляется UI;
|
||||
- пишется журнал.
|
||||
|
||||
---
|
||||
|
||||
## Важное замечание
|
||||
|
||||
Debug-режим нельзя оставлять включённым в production:
|
||||
|
||||
```env
|
||||
DEBUG_ENABLED=false
|
||||
```
|
||||
|
||||
Иначе:
|
||||
|
||||
- можно форсировать сделки;
|
||||
- можно обойти стратегию;
|
||||
- нарушается безопасность.
|
||||
|
||||
---
|
||||
|
||||
## Ограничения
|
||||
|
||||
Пока не реализовано:
|
||||
|
||||
- авторизация debug-команд (по user_id);
|
||||
- rate limit debug-команд;
|
||||
- отдельный debug-чат;
|
||||
- UI toggle debug mode.
|
||||
|
||||
---
|
||||
|
||||
## Результат
|
||||
|
||||
Добавлен полноценный test harness для автоторговли.
|
||||
|
||||
Теперь можно тестировать:
|
||||
|
||||
```text
|
||||
Strategy → Signal → Decision → EventBus → Runner → Telegram → Execution
|
||||
```
|
||||
|
||||
без ожидания рынка.
|
||||
|
||||
---
|
||||
|
||||
## Следующий этап
|
||||
|
||||
```text
|
||||
Stage 07.4.3.6 — Position lifecycle & PnL
|
||||
```
|
||||
|
||||
- закрытие позиции;
|
||||
- расчёт прибыли;
|
||||
- обновление UI;
|
||||
- подготовка к Risk Engine.
|
||||
Reference in New Issue
Block a user