build 039: complete Quotes Feed migration foundation

docs/market_intelligence/runtime/README.md

@@ -0,0 +1,140 @@
+# Runtime
+
+Статус: **Active**
+
+Версия: **1.0**
+
+---
+
+# Назначение
+
+Каталог **Runtime** описывает архитектуру слоя выполнения (**Runtime Layer**) подсистемы **Market Intelligence**.
+
+Runtime является инфраструктурным уровнем платформы.
+
+Он обеспечивает единый жизненный цикл выполнения аналитических Engine, но сам не анализирует рынок.
+
+---
+
+# Место Runtime в архитектуре
+
+Runtime располагается между фундаментальными компонентами Common и аналитическими Engine.
+
+```text
+Common Layer
+        ↓
+Runtime Layer
+        ↓
+Engine Layer
+        ↓
+Coordinator Layer
+```
+
+Common предоставляет общие модели данных, типы и контракты.
+
+Runtime определяет единый способ выполнения аналитических компонентов.
+
+Engine реализуют конкретные алгоритмы анализа рынка.
+
+Coordinator объединяет результаты нескольких Engine.
+
+---
+
+# Ответственность Runtime
+
+Runtime отвечает исключительно за инфраструктуру выполнения Engine.
+
+В область ответственности Runtime входят:
+
+- единый контракт Engine;
+- единый жизненный цикл выполнения;
+- безопасный запуск Engine;
+- обработка исключений;
+- проверка корректности результатов;
+- управление зависимостями между Engine;
+- регистрация доступных Engine;
+- формирование безопасных fallback-результатов.
+
+Runtime не реализует аналитические алгоритмы.
+
+---
+
+# Что Runtime не делает
+
+Runtime не имеет права:
+
+- анализировать рынок;
+- рассчитывать индикаторы;
+- определять тренды;
+- определять волны;
+- принимать торговые решения;
+- открывать или закрывать позиции;
+- взаимодействовать с биржей;
+- работать с Telegram;
+- изменять состояние AutoTrade.
+
+Все подобные задачи относятся к другим архитектурным уровням.
+
+---
+
+# Планируемая структура Runtime
+
+```text
+runtime/
+
+├── protocol.py
+├── base.py
+├── runner.py
+├── registry.py
+├── dependencies.py
+└── validation.py
+```
+
+Каждый компонент Runtime имеет собственную область ответственности.
+
+---
+
+# Документация Runtime
+
+Основным архитектурным документом Runtime является:
+
+```text
+runtime/architecture.md
+```
+
+В нём описываются:
+
+- архитектура Runtime;
+- роли компонентов;
+- жизненный цикл выполнения Engine;
+- взаимодействие Runtime с Common;
+- взаимодействие Runtime с Coordinator.
+
+---
+
+# Связанные документы
+
+Основные документы Runtime:
+
+- `development_process.md`
+- `architecture_principles.md`
+- `runtime_contract.md`
+- `runtime/architecture.md`
+
+История реализации Runtime хранится в каталоге:
+
+```text
+builds/
+```
+
+---
+
+# Принцип развития Runtime
+
+Runtime развивается независимо от отдельных Engine.
+
+Добавление нового Engine не должно требовать изменения архитектуры Runtime.
+
+При необходимости Runtime расширяется путём добавления новых компонентов, а не изменения существующего контракта выполнения.
+
+Настоящий каталог является официальной документацией Runtime Layer подсистемы **Market Intelligence**.