Docs - add missing stage documentation for 05.4-05.7

This commit is contained in:
2026-04-19 17:10:15 +03:00
parent cec7c761be
commit c36e43f5e8
3 changed files with 229 additions and 0 deletions

View File

@@ -0,0 +1,69 @@
# Stage 05.4 — runtime mode helpers (demo/real)
## Что сделано
На этом этапе была введена единая инфраструктура для работы с режимом запуска приложения и отображения режима аккаунта в интерфейсе.
Основная цель этапа — перестать размазывать логику demo/real по разным частям проекта и подготовить один общий источник правды для UI и runtime-поведения.
---
## Основные изменения
### 1. Введены runtime mode helpers
Добавлены вспомогательные функции для определения и отображения режима запуска:
- demo
- real
Эти helper-функции стали базой для единообразной работы с режимом в приложении.
### 2. Нормализовано текстовое отображение режима
Режим стал отображаться в понятном для пользователя виде, например:
- `ДЕМО аккаунт`
- `REAL аккаунт`
Это позволило в дальнейшем использовать одну и ту же строку в разных экранах без ручного дублирования.
### 3. Подготовлена база для дальнейшей UI-унификации
Этап заложил основу для последующих улучшений:
- общей строки режима на экранах
- единого рендера режима в trade UI
- уменьшения дублирования текста и условий
---
## Зачем это было нужно
До этого режим demo/real существовал как техническая настройка, но не был полноценно оформлен как общий UI/runtime-механизм.
После Stage 05.4 режим:
- стал явно доступен в коде через helper-уровень
- получил единый формат отображения
- стал пригоден для повторного использования в интерфейсе
---
## Результат этапа
После завершения этапа проект получил:
- единый helper-слой для runtime mode
- понятное пользовательское имя режима
- основу для дальнейшей унификации UI
---
## Что подготовлено для следующего этапа
Этот этап подготовил основу для:
- встраивания строки режима в экраны trade UI
- переиспользования отображения режима в других разделах
- уменьшения количества ручных проверок demo/real в интерфейсном коде

View File

@@ -0,0 +1,77 @@
# Stage 05.5 — trade UI unification and mode display
## Что сделано
На этом этапе была проведена первая большая унификация экранов торгового интерфейса.
Главная цель этапа — привести trade UI к единому стилю и встроить в него единое отображение режима аккаунта.
---
## Основные изменения
### 1. Унифицирован стиль trade-экранов
Экраны торгового раздела были приведены к общему визуальному формату:
- единый заголовок
- единая структура текста
- единый стиль шагов
- единый подход к кнопкам и возврату назад
### 2. Добавлено единое отображение режима аккаунта
В trade UI была встроена общая строка режима, например:
- `ДЕМО аккаунт`
- `REAL аккаунт`
Это позволило пользователю постоянно видеть, в каком контуре он работает.
### 3. Уменьшено дублирование UI-логики
Часть повторяющегося кода была сведена к общим helper-функциям и рендерам, что сделало интерфейс более согласованным.
### 4. Подготовлена почва для дальнейшей декомпозиции trade-модуля
После унификации стало проще разделять:
- flow-логику
- UI-рендеры
- навигацию
- отдельные сценарии работы с черновиками
---
## Зачем это было нужно
До этого торговые экраны росли постепенно и начинали расходиться по оформлению и поведению.
Проблемы, которые решал этап:
- разный стиль экранов
- дублирование текста
- отсутствие общей строки режима
- сложность дальнейших UX-улучшений
---
## Результат этапа
После завершения Stage 05.5 торговый интерфейс стал:
- визуально более целостным
- понятнее для пользователя
- проще для дальнейшей поддержки
- готовым к более глубокому рефакторингу
---
## Что подготовлено для следующего этапа
Этот этап подготовил основу для:
- улучшения сценария формирования черновика
- вынесения UI в отдельные модули
- добавления контекста ордера на экраны
- углубления UX в сценарии draft builder

View File

@@ -0,0 +1,83 @@
# Stage 05.6 — order draft logic improvements
## Что сделано
На этом этапе была улучшена прикладная логика сценария формирования черновика ордера.
Цель этапа — сделать поведение сценария более устойчивым, понятным и ближе к реальной логике формирования ордера.
---
## Основные изменения
### 1. Улучшена логика работы draft flow
Были доработаны сценарные переходы и обработка параметров ордера при создании черновика.
Особое внимание уделялось:
- корректности шагов сценария
- согласованности данных между этапами
- предсказуемости поведения при возвратах назад
### 2. Улучшена работа с quantity / price / confirm
Были уточнены переходы между шагами:
- выбор стороны
- выбор типа ордера
- ввод количества
- ввод цены
- подтверждение черновика
### 3. Подготовлен фундамент для отображения контекста ордера
Логика начала лучше передавать данные, нужные для UI:
- текущий инструмент
- ориентир цены
- количество
- параметры подтверждения
### 4. Снижена хрупкость сценария
Часть проблемных мест в flow была стабилизирована:
- возвраты назад
- ручной ввод
- повторная сборка confirm-данных
- повторное открытие/редактирование черновиков
---
## Зачем это было нужно
До этого основная логика черновика уже работала, но сценарий оставался чувствительным к усложнению UI и UX.
Этап был нужен, чтобы:
- укрепить основу перед более крупным UI-рефакторингом
- подготовить структуру данных для улучшенного интерфейса
- упростить дальнейшую декомпозицию trade draft модуля
---
## Результат этапа
После Stage 05.6 логика формирования черновика стала:
- стабильнее
- чище по переходам
- лучше подготовлена к UI-расширению
- пригодной для дальнейшей модульной переработки
---
## Что подготовлено для следующего этапа
Этот этап подготовил основу для:
- выноса trade draft UI в отдельные файлы
- показа валют, активов и суммы ордера
- более информативных экранов подтверждения
- дальнейшего рефакторинга структуры trade-модуля