mt5-manager/docs/README.md
Yuriy Bykov Yuriy Bykov 930b46b3c1 Добавить создание терминалов, обновление сервиса и документацию
- реализовать создание portable-экземпляров и настройку счетов
- обновить интерфейс и добавить обновление проекта через Git
- добавить сборку и распространение сервиса
- организовать материалы статей и описать актуальную версию
- запрашивать тестовый пароль интерактивно и расширить проверки
2026-10-29 14:39:39 +03:00

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

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

Руководство Что в нём описано
Установка Windows и Python, размещение проекта, подготовка MT5 и первый запуск
Конфигурация Параметры JSON, выбор исходных файлов, счета и параметры сервиса
Веб-интерфейс Создание, запуск, остановка, изменение счёта и чтение статусов
Эксплуатация Обновление сервиса, резервные копии, сеть и диагностика
Архитектура и API Компоненты, SQLite, фоновые задачи, маршруты и проверки
Статьи Материалы отдельных частей и порядок подготовки публикаций

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

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

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

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

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

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

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