Stage 05.7 - trade draft UI restructuring and order context display

docs/terminology.md

@@ -0,0 +1,65 @@
+# 🧭 Терминология: биржа → UI бота → код
+
+| 🏦 Термин биржи                | 🤖 UI бота (как показываем)        | 🧠 В коде (модель)              | 💬 Комментарий |
+|------------------------------|------------------------------------|--------------------------------|---------------|
+| Купить                       | Купить (LONG)                      | `side = "BUY"`                 | Открытие long |
+| Продать                      | Продать (SHORT)                    | `side = "SELL"`                | Открытие short |
+| Режим левереджа              | 📈 Левередж                        | `trade_mode = "leverage"`      | Основной режим |
+| Режим торгов                 | 💱 Торги / Спот                    | `trade_mode = "spot"`          | Без плеча |
+| Купить сейчас                | ⚡ MARKET                          | `order_type = "MARKET"`        | Исполнение сразу |
+| Купить когда цена = X        | 🎯 LIMIT                           | `order_type = "LIMIT"`         | Отложенный ордер |
+| Цена                         | Цена                               | `price`                        | Только для LIMIT |
+| Количество / Размер          | Количество                         | `quantity`                     | Базовая величина |
+| % от баланса                 | 5% / 10% / ...                     | `quantity` (расчёт)            | UI-обёртка |
+| Левередж                     | Плечо                              | `leverage`                     | Пока нет в модели |
+| Доступно                     | Доступно                           | `available_balance`            | из context |
+| Ориентир цены (Last/Bid/Ask) | Ориентир цены                      | `reference_price`              | для UI |
+| Стоп-лосс                    | Стоп-лосс                          | `stop_loss`                    | будущий параметр |
+| Тейк-профит                  | Тейк-профит                        | `take_profit`                  | будущий параметр |
+| Сумма ордера                 | Сумма                              | `notional`                     | `price * quantity` |
+| Мин. сумма                   | Мин. сумма                         | `min_notional`                 | правило биржи |
+| Шаг количества               | Шаг                                | `step_size`                    | правило |
+| Мин. количество              | Минимум                            | `min_qty`                      | правило |
+| Черновик                     | Черновик                           | `draft`                        | статус |
+| Подтвердить                  | Подтвердить                        | —                              | UI-действие |
+
+---
+
+## 🔥 Основные принципы
+
+### 1. UI ≠ код
+- UI: язык биржи (понятный пользователю)
+- Код: строгая техническая модель
+
+---
+
+### 2. MARKET / LIMIT — это тип ордера
+- не путать с режимом торговли (левередж / спот)
+
+---
+
+### 3. LONG / SHORT
+- LONG = `BUY`
+- SHORT = `SELL`
+
+---
+
+### 4. Текущий статус модели
+
+✔ Уже есть:
+- `side`
+- `order_type`
+- `quantity`
+- `price`
+
+🔜 Нужно добавить:
+- `leverage`
+- `stop_loss`
+- `take_profit`
+
+---
+
+## 🧭 Итог
+
+Пользователь видит **терминологию биржи**,  
+система работает на **нормализованной модели**.