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