# Market Intelligence

Документация подсистемы **Market Intelligence** проекта **Dzentra**.

---

# Назначение

Market Intelligence является аналитическим уровнем платформы.

Его задача — понимать текущее поведение рынка.

Market Intelligence не открывает сделки, не закрывает позиции и не управляет ордерами.

Он отвечает только на вопрос:

> **Что сейчас происходит с рынком?**

Все торговые решения принимаются верхними уровнями архитектуры платформы.

---

# Главная цель

Перевести Dzentra от модели

```text
бот принимает решения по индикаторам
```

к модели

```text
профессиональная автономная торговая платформа,
состоящая из специализированных аналитических движков
```

---

# Структура документации

| Документ | Назначение |
|----------|------------|
| `architecture_principles.md` | Архитектурные принципы Market Intelligence |
| `runtime_contract.md` | Контракт работы всех Engine |
| `build_history.md` | Общая история Build |
| `builds/` | Полная документация каждого Build |
| `decisions/` | Архитектурные решения |
| `reviews/` | Compile Check, Architecture Review и Domain Review |
| `common/` | Документация общего слоя |
| `engines/` | Документация отдельных Engine |
| `diagrams/` | Архитектурные схемы |
| `glossary/` | Словарь терминов |
| `roadmap/` | План развития платформы |

---

# Текущий фокус

Сейчас реализуется фундамент:

```text
app/src/trading/market_intelligence/common/
```

Этот слой определяет единый язык для всех будущих Engine.

---

# Статус Common

| Файл | Статус |
|------|---------|
| enums.py | ✅ Accepted |
| types.py | ✅ Accepted |
| constants.py | ✅ Accepted |
| reasons.py | ✅ Accepted |
| scores.py | ✅ Accepted |
| models.py | ✅ Accepted |
| validation.py | ⏳ Planned |
| checks.py | ⏳ Planned |
| payloads.py | ⏳ Planned |
| snapshots.py | ⏳ Planned |
| events.py | ⏳ Planned |
| timeframes.py | ⏳ Planned |

---

# Жизненный цикл разработки

```text
Architecture Design
        ↓
Implementation
        ↓
Compile Check
        ↓
Architecture Review
        ↓
Domain Review
        ↓
Documentation Update
        ↓
User Confirmation
        ↓
Build Closed
```

---

# Долгосрочная цель

Создать профессиональную аналитическую платформу, которую можно развивать годами без деградации архитектуры.

Добавление нового Engine не должно требовать переписывания уже существующих Engine.