# 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.