# Документация MT5 Manager

Здесь описано текущее состояние приложения. Для первого знакомства начните
с [быстрого старта](../README.md); подробности распределены по задачам.

| Руководство | Что в нём описано |
|---|---|
| [Установка](installation.md) | Windows и Python, размещение проекта, подготовка MT5 и первый запуск |
| [Конфигурация](configuration.md) | Параметры JSON, выбор исходных файлов, счета и параметры сервиса |
| [Веб-интерфейс](user-guide.md) | Создание, запуск, остановка, изменение счёта и чтение статусов |
| [Эксплуатация](maintenance.md) | Обновление сервиса, резервные копии, сеть и диагностика |
| [Архитектура и API](architecture.md) | Компоненты, SQLite, фоновые задачи, маршруты и проверки |
| [Статьи](articles/README.md) | Материалы отдельных частей и порядок подготовки публикаций |

## Что уже работает

Менеджер создаёт portable-экземпляры из подготовленных файлов, раскладывает сервис
и его конфигурацию, дожидается свежих данных и при необходимости проверяет счёт.
Имеющимися экземплярами можно управлять через браузер. Настройки сохраняются
в JSON, последнее состояние терминалов и счетов — в общей SQLite. Для работы
приложения модуль Python `MetaTrader5` не нужен.

Текущая реализация рассчитана на один сервер Windows и один процесс менеджера.
Нет автоматического открытия торговых счетов, истории показателей и сделок,
управления советниками, автоматических миграций базы и входа пользователей.
Замена общего файла-образца `servers.dat` действует только на новые экземпляры.

Связь нескольких серверов остаётся возможным направлением: на каждом работает
самостоятельный менеджер, а сведения соседних узлов можно просматривать из любого
из них без обязательного главного сервера. Сейчас это не реализовано.

## Как поддерживать документацию

При изменении поведения приложения обновляйте соответствующее руководство,
примеры конфигурации и API. Если меняется первый запуск, меняйте также README.
Описание существующих возможностей должно соответствовать коду текущей ветки;
планы следует явно обозначать как планы.

Новая статья хранится в своей папке `articles/part-NN`. В ней можно объяснять
эксперименты и промежуточные решения, но пользователю не должно требоваться
читать цикл целиком, чтобы установить актуальную версию приложения. Материалы
опубликованных частей сохраняются как описание их версии; порядок хранения
изложен в [каталоге статей](articles/README.md).