Files

Sergey 64a5bdd04c Build 060.30: finalize Market Data Acquisition documentation

2026-08-04 00:29:56 +03:00

10 KiB

Raw Blame History

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;
текущая архитектура Trades Feed;
architecture и итоговые reports в docs/migrations;
итог Build 060.30.

Текущая контрольная точка

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	Completed
060.20.1	Trade Stream State Ownership Alignment	Completed
060.21	Runtime Protocol Integration	Completed
060.22	Runtime Service Integration	Completed
060.23	Trade Stream Acquisition Integration	Completed
060.24	Runtime Recovery Architecture	Completed
060.25	Production Runtime Integration	Completed
060.26	Integration and Regression	Completed
060.27	Persistent Market Data Storage	Completed
060.28	Persistent Checkpoint and Startup Recovery	Completed
060.29	Market Data Access and Replay	Completed
060.30	Market Data Acquisition Final Documentation	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:

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 сохраняет историческую ценность, но больше не определяет актуальную нумерацию.

Следующие верхнеуровневые программы пока не имеют утверждённых 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

Один Build изменяет одну подтверждённую архитектурную область.
Перед Build выполняется read-only анализ фактического кода и тестов.
Дальние номера являются ориентиром до утверждения architecture plan.
Каждый Build имеет критерии завершения и проверяемый test evidence.
Архитектурные findings исправляются до статуса Accepted.
Итоговый migration report создаётся после завершения Build.
Master Roadmap хранит последовательность, статус и ссылки, а не дублирует подробную архитектурную спецификацию.
Посторонние изменения рабочего каталога не включаются в Build.
Текущий Build переводится в Completed только после принятого итогового report.

Исторический Stage-roadmap

Stage 01–07 сохраняются в отдельных исторических документах. Их локальные пометки в работе, не начат и прежняя нумерация не определяют текущий следующий Build:

Каждый файл имеет явную архивную маркировку и ведёт обратно к 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.

10 KiB Raw Blame History Unescape Escape