229 lines
10 KiB
Markdown
229 lines
10 KiB
Markdown
# Master Roadmap — Dzentra
|
||
|
||
## Контроль документа
|
||
|
||
| Свойство | Значение |
|
||
|---|---|
|
||
| Тип | Master Delivery Roadmap |
|
||
| Статус | Active |
|
||
| Версия | 2.5 |
|
||
| Дата актуализации | 2026-08-03 |
|
||
| Текущий завершённый Build | 060.30 |
|
||
| Текущий Build | отсутствует |
|
||
| Следующий Build | 061.00 — Planned |
|
||
|
||
---
|
||
|
||
## Назначение
|
||
|
||
Dzentra развивается из работающего Telegram trading bot в модульную
|
||
алгоритмическую торговую платформу. Этот документ хранит порядок Builds,
|
||
их фактический статус и ссылки на источники решений.
|
||
|
||
Roadmap не дублирует архитектурные спецификации и test evidence. Для
|
||
этого используются:
|
||
|
||
- [целевая архитектура Dzentra](../architecture/dzentra_target_architecture.md);
|
||
- [текущая архитектура Trades Feed](../architecture/trades_feed.md);
|
||
- architecture и итоговые reports в [`docs/migrations`](../migrations/);
|
||
- [итог Build 060.30](../migrations/build_060_30.md).
|
||
|
||
---
|
||
|
||
## Текущая контрольная точка
|
||
|
||
```text
|
||
060.20–060.25 Trade Runtime и Production Integration Completed
|
||
↓
|
||
060.26 Integration / Stress / Live Verification Completed
|
||
↓
|
||
060.27 Persistent Market Data Storage Completed
|
||
↓
|
||
060.28 Persistent Checkpoint / Startup Recovery Completed
|
||
↓
|
||
060.29 Historical Access / Replay Completed
|
||
↓
|
||
060.30 Final Documentation Completed
|
||
↓
|
||
061.00 Validation Boundary Refactoring Planned
|
||
```
|
||
|
||
Build 060.30 завершён созданием итогового report и приёмкой Closure
|
||
060.30.8. Следующий запланированный Build — 061.00; он ещё не начат.
|
||
|
||
---
|
||
|
||
## Активная программа — Market Data Acquisition
|
||
|
||
### Последовательность Trades Feed
|
||
|
||
| Build | Результат | Статус |
|
||
|---|---|---|
|
||
| 060.1–060.19 | Canonical Trade, REST/WS pipelines, Consistency и Recovery foundation | Completed |
|
||
| 060.20 | [Trade Runtime Architecture](../migrations/build_060_20.md) | Completed |
|
||
| 060.20.1 | [Trade Stream State Ownership Alignment](../migrations/build_060_20_1.md) | Completed |
|
||
| 060.21 | [Runtime Protocol Integration](../migrations/build_060_21.md) | Completed |
|
||
| 060.22 | [Runtime Service Integration](../migrations/build_060_22.md) | Completed |
|
||
| 060.23 | [Trade Stream Acquisition Integration](../migrations/build_060_23.md) | Completed |
|
||
| 060.24 | [Runtime Recovery Architecture](../migrations/build_060_24.md) | Completed |
|
||
| 060.25 | [Production Runtime Integration](../migrations/build_060_25.md) | Completed |
|
||
| 060.26 | [Integration and Regression](../migrations/build_060_26.md) | Completed |
|
||
| 060.27 | [Persistent Market Data Storage](../migrations/build_060_27.md) | Completed |
|
||
| 060.28 | [Persistent Checkpoint and Startup Recovery](../migrations/build_060_28.md) | Completed |
|
||
| 060.29 | [Market Data Access and Replay](../migrations/build_060_29.md) | Completed |
|
||
| 060.30 | [Market Data Acquisition Final Documentation](../migrations/build_060_30.md) | Completed |
|
||
| 061.00 | Validation and Canonicalization Boundary Refactoring | Planned |
|
||
|
||
### Принятый результат 060.26–060.29
|
||
|
||
- 060.26 проверил Runtime на loopback network, fault injection,
|
||
stress/soak и opt-in Dzengi live scenarios.
|
||
- 060.27 добавил persistent repositories Trades, Quotes и Candle
|
||
revisions; Production writer подключён только для Trades.
|
||
- 060.28 добавил atomic Trade/checkpoint, Hydration и Startup Recovery с
|
||
закрытым Live gate.
|
||
- 060.29 добавил Historical Access и caller-owned deterministic Replay в
|
||
общем порядке сохранённых Canonical events.
|
||
|
||
Подробные контракты, ограничения и test evidence находятся только в
|
||
соответствующих итоговых reports, ссылки на которые приведены в таблице.
|
||
|
||
### Build 060.30 — Market Data Acquisition Final Documentation
|
||
|
||
**Статус:** Completed
|
||
|
||
Назначение:
|
||
|
||
- зафиксировать фактическую архитектуру Trades Feed;
|
||
- подготовить Production operations guide;
|
||
- актуализировать входные страницы, Target Architecture и roadmap;
|
||
- нормализовать историческую навигацию без переписывания evidence;
|
||
- добавить offline documentation integrity gate;
|
||
- выполнить финальную documentation/runtime verification;
|
||
- закрыть документационный цикл Trades Feed Builds 060.20–060.30 перед
|
||
061.00.
|
||
|
||
Все подэтапы 060.30.0–060.30.8 и corrective gate Docker Production
|
||
Safety Hardening приняты. Итоговый report создан; Build 060.30 завершён.
|
||
Следующий запланированный этап — read-only анализ 061.00.
|
||
|
||
### Build 061.00 — Validation and Canonicalization Boundary Refactoring
|
||
|
||
**Статус:** Planned
|
||
|
||
Сначала выполняется read-only аудит фактического ownership:
|
||
|
||
```text
|
||
schema validation
|
||
parser
|
||
value validation
|
||
normalization
|
||
mapper
|
||
canonical model
|
||
consistency
|
||
data quality
|
||
missing data recovery
|
||
```
|
||
|
||
Только после аудита определяется, нужен ли отдельный каталог
|
||
`market_data/normalization`. Механический перенос существующих
|
||
валидаторов заранее не утверждён.
|
||
|
||
---
|
||
|
||
## Дальнейшие программы
|
||
|
||
После 061.00 следующая Feed-ветка выбирается на основании фактических
|
||
production consumers и доступных данных Dzengi.
|
||
|
||
Кандидаты:
|
||
|
||
- Quotes lifecycle consolidation;
|
||
- OHLCV/Candles WebSocket, Consistency и persistence integration;
|
||
- Order Book snapshot and delta reconciliation;
|
||
- Derivatives Market Data;
|
||
- Market Index;
|
||
- Exchange Time;
|
||
- Exchange and Instrument Status.
|
||
|
||
Нумерация и точный scope этих Builds утверждаются только после отдельного
|
||
read-only архитектурного анализа.
|
||
|
||
Старый ориентировочный план из
|
||
[Build 044](../migrations/build_044.md) сохраняет историческую ценность,
|
||
но больше не определяет актуальную нумерацию.
|
||
|
||
Следующие верхнеуровневые программы пока не имеют утверждённых Builds:
|
||
|
||
- Market Data Processing;
|
||
- Feature Engineering;
|
||
- Market Intelligence consolidation;
|
||
- Scenario Evaluation;
|
||
- Portfolio and Risk boundary;
|
||
- Order Management System;
|
||
- Position and Account Reconciliation;
|
||
- Backtesting and Simulation;
|
||
- Production Deployment and Operations.
|
||
|
||
Persistent Storage и Replay уже создали prerequisites для Backtesting,
|
||
но сам Backtesting engine и exchange/OMS simulator не реализованы.
|
||
|
||
---
|
||
|
||
## Правила ведения roadmap
|
||
|
||
1. Один Build изменяет одну подтверждённую архитектурную область.
|
||
2. Перед Build выполняется read-only анализ фактического кода и тестов.
|
||
3. Дальние номера являются ориентиром до утверждения architecture plan.
|
||
4. Каждый Build имеет критерии завершения и проверяемый test evidence.
|
||
5. Архитектурные findings исправляются до статуса Accepted.
|
||
6. Итоговый migration report создаётся после завершения Build.
|
||
7. Master Roadmap хранит последовательность, статус и ссылки, а не
|
||
дублирует подробную архитектурную спецификацию.
|
||
8. Посторонние изменения рабочего каталога не включаются в Build.
|
||
9. Текущий Build переводится в `Completed` только после принятого
|
||
итогового report.
|
||
|
||
---
|
||
|
||
## Исторический Stage-roadmap
|
||
|
||
Stage 01–07 сохраняются в отдельных исторических документах. Их локальные
|
||
пометки `в работе`, `не начат` и прежняя нумерация не определяют текущий
|
||
следующий Build:
|
||
|
||
- [Stage 01 — Bootstrap / Foundation](stage-01-bootstrap-foundation-roadmap.md)
|
||
- [Stage 02 — System / Diagnostics](stage-02-system-diagnostics-roadmap.md)
|
||
- [Stage 03 — Exchange Integration](stage-03-exchange-integration-roadmap.md)
|
||
- [Stage 04 — Storage / Journal](stage-04-storage-journal-roadmap.md)
|
||
- [Stage 05 — Trading UI / Draft / Validation](stage-05-trading-ui-draft-validation-roadmap.md)
|
||
- [Stage 06 — Journal / Navigation / Settings](stage-06-journal-navigation-settings-roadmap.md)
|
||
- [Stage 07 — Auto Trading](stage-07-auto-trading-roadmap.md)
|
||
|
||
Каждый файл имеет явную архивную маркировку и ведёт обратно к Master
|
||
Roadmap и Target Architecture. Историческое содержимое сохранено без
|
||
переписывания.
|
||
|
||
Для Stage 08–09 отдельных roadmap-файлов не создавалось. Сохраняются их
|
||
короткие исторические placeholders:
|
||
|
||
### Stage 08 — Analytics / Reports
|
||
|
||
- отчёты;
|
||
- PnL;
|
||
- win rate;
|
||
- drawdown.
|
||
|
||
Исторический статус: не начат. Текущий будущий scope аналитики определяет
|
||
Target Architecture, а не прежняя Stage-нумерация.
|
||
|
||
### Stage 09 — Production Readiness
|
||
|
||
- deployment;
|
||
- monitoring;
|
||
- alerts;
|
||
- backups.
|
||
|
||
Исторический статус: не начат. Production Deployment and Operations
|
||
остаются будущей cross-cutting программой без утверждённого Build.
|