feat: 07.4.1 base strategy + 07.4.2 strategy registry + docs sync

app/src/storage/repositories/__init__.py

@@ -0,0 +1 @@
+"""Package marker."""

app/src/telegram/live/__init__.py

@@ -0,0 +1 @@
+"""Package marker."""

app/src/trading/auto/__init__.py

@@ -0,0 +1 @@
+"""Package marker."""

app/src/trading/auto/service.py

@@ -3,11 +3,12 @@
 from __future__ import annotations
 
 import asyncio
-import random
 from datetime import datetime
 
 from src.core.config import load_settings
 from src.trading.auto.state import AutoTradeState
+from src.trading.strategies.base import BaseStrategy, StrategyContext
+from src.trading.strategies.registry import StrategyRegistry
 
 
 class AutoTradeService:
@@ -106,7 +107,7 @@ class AutoTradeService:
     # установить стратегию
     def set_strategy(self, strategy: str) -> AutoTradeState:
         state = self.get_state()
-        state.strategy = strategy
+        state.strategy = strategy.strip().upper()
         return state
 
     # установить риск
@@ -115,6 +116,21 @@ class AutoTradeService:
         state.risk_percent = risk_percent
         return state
 
+    # собрать контекст для стратегии
+    def _build_strategy_context(self) -> StrategyContext:
+        state = self.get_state()
+
+        return StrategyContext(
+            symbol=state.symbol,
+            status=state.status,
+            risk_percent=state.risk_percent,
+        )
+
+    # получить стратегию для текущего цикла
+    def _get_strategy(self) -> BaseStrategy:
+        state = self.get_state()
+        return StrategyRegistry.get(state.strategy)
+
     # выполнить один цикл анализа рынка
     def run_cycle(self) -> AutoTradeState:
         state = self.get_state()
@@ -122,7 +138,11 @@ class AutoTradeService:
         if state.status == "OFF":
             return state
 
+        strategy = self._get_strategy()
+        context = self._build_strategy_context()
+        result = strategy.analyze(context)
+
         state.last_check_at = datetime.now().strftime("%H:%M:%S")
-        state.last_signal = random.choice(["BUY", "SELL", "HOLD"])
+        state.last_signal = result.signal.value
 
         return state

app/src/trading/journal/__init__.py

@@ -0,0 +1 @@
+"""Package marker."""

app/src/trading/strategies/__init__.py

@@ -0,0 +1 @@
+"""Package marker."""

app/src/trading/strategies/base.py

@@ -0,0 +1,29 @@
+# app/src/trading/strategies/base.py
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Protocol
+
+from src.trading.strategies.signals import SignalResult
+
+
+@dataclass(slots=True)
+class StrategyContext:
+    # выбранный торговый инструмент
+    symbol: str
+
+    # текущий режим автоторговли: OBSERVING / RUNNING
+    status: str
+
+    # риск на сделку в процентах
+    risk_percent: float | None = None
+
+
+class BaseStrategy(Protocol):
+    # техническое имя стратегии
+    name: str
+
+    # выполнить анализ и вернуть торговый сигнал
+    def analyze(self, context: StrategyContext) -> SignalResult:
+        ...

app/src/trading/strategies/hold.py

@@ -0,0 +1,23 @@
+# app/src/trading/strategies/hold.py
+
+from __future__ import annotations
+
+from src.trading.strategies.base import StrategyContext
+from src.trading.strategies.signals import SignalResult, SignalType
+
+
+class HoldStrategy:
+    name = "HOLD"
+
+    # безопасная стратегия по умолчанию: ничего не делает
+    def analyze(self, context: StrategyContext) -> SignalResult:
+        return SignalResult(
+            signal=SignalType.HOLD,
+            reason="Стратегия не выбрана. Используется безопасный HOLD.",
+            confidence=0.0,
+            payload={
+                "symbol": context.symbol,
+                "status": context.status,
+                "strategy": self.name,
+            },
+        )

app/src/trading/strategies/registry.py

@@ -0,0 +1,30 @@
+# app/src/trading/strategies/registry.py
+
+from __future__ import annotations
+
+from src.trading.strategies.base import BaseStrategy
+from src.trading.strategies.hold import HoldStrategy
+
+
+class StrategyRegistry:
+    # доступные стратегии
+    _strategies: dict[str, BaseStrategy] = {
+        "HOLD": HoldStrategy(),
+        "TREND": HoldStrategy(),
+        "GRID": HoldStrategy(),
+        "SCALP": HoldStrategy(),
+    }
+
+    # получить стратегию по имени
+    @classmethod
+    def get(cls, name: str | None) -> BaseStrategy:
+        if not name:
+            return cls._strategies["HOLD"]
+
+        normalized_name = name.strip().upper()
+        return cls._strategies.get(normalized_name, cls._strategies["HOLD"])
+
+    # получить список доступных стратегий
+    @classmethod
+    def names(cls) -> list[str]:
+        return sorted(cls._strategies.keys())

app/src/trading/strategies/signals.py

@@ -0,0 +1,32 @@
+# app/src/trading/strategies/signals.py
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from enum import StrEnum
+
+
+class SignalType(StrEnum):
+    # купить
+    BUY = "BUY"
+
+    # продать
+    SELL = "SELL"
+
+    # ничего не делать
+    HOLD = "HOLD"
+
+
+@dataclass(slots=True)
+class SignalResult:
+    # итоговый сигнал стратегии
+    signal: SignalType
+
+    # человекочитаемая причина сигнала
+    reason: str
+
+    # уверенность стратегии от 0.0 до 1.0
+    confidence: float = 0.0
+
+    # дополнительные данные стратегии для логов / отладки
+    payload: dict | None = None