Stage 03.5 - private account balance and portfolio UI

docs/decisions/0008-private-account-first.md

@@ -0,0 +1,86 @@
+# 0008 — Private API starts from Account Balance (Stable)
+
+## Решение
+Начать интеграцию private API с получения баланса аккаунта (`/api/v2/account`), а не с ордеров.
+
+---
+
+## Причины
+
+### 1. Безопасность
+- чтение баланса не изменяет состояние системы
+- отсутствует риск случайной торговли
+
+---
+
+### 2. Простота отладки
+Позволяет проверить:
+- API ключ
+- подпись (HMAC)
+- headers
+- timestamp
+
+---
+
+### 3. Быстрый UX результат
+Пользователь сразу видит:
+- баланс
+- активы
+
+---
+
+### 4. База для следующих этапов
+Баланс используется в:
+- расчёте риска
+- позициях
+- ордерах
+- журнале
+
+---
+
+## Реализация
+
+Добавлено:
+- ExchangePrivateClient
+- balance_parser
+- get_balance_summary()
+- get_private_auth_health()
+- экран 💼 Портфель
+- статус авторизации в ⚙️ Система
+
+---
+
+## Последствия
+
+### Положительные
+✔ быстрый результат  
+✔ безопасная интеграция  
+✔ понятный UI  
+✔ устойчивая архитектура  
+
+---
+
+### Отрицательные
+- не покрывает сразу торговый сценарий
+- требует следующего этапа (orders)
+
+---
+
+## Альтернативы
+
+### Начать с ордеров
+❌ отклонено:
+- риск
+- сложность
+- сложнее отлаживать
+
+---
+
+## Статус
+Stable
+
+---
+
+## Следующий шаг
+
+➡ Stage 03.6 — Orders skeleton