mt5-manager/docs/user-guide.md

# Работа через веб-интерфейс

[Документация](README.md) · [Настройки](configuration.md) · [Диагностика](maintenance.md)

## Главная страница

Каждый экземпляр представлен карточкой с именем, счётом, сервером, состоянием,
балансом, средствами, прибылью, маржой и временем последнего обновления.
Номер счёта сокращён; полный номер доступен в подсказке. Поиск учитывает имя
папки, отображаемое имя, логин и сервер. Фильтры разделяют запущенные и
остановленные процессы. Сведения опрашиваются каждые 10 секунд.

| Состояние в интерфейсе | Что означает |
|---|---|
| «Остановлен» | Процесс этого экземпляра не найден |
| «Запускается» | Процесс есть, но свежих данных сервиса ещё нет |
| «Работает» | Получены свежие данные и подтверждено подключение к торговому серверу |
| «Нет подключения» | Процесс и сервис работают, но торговое соединение не подтверждено |
| «Выполняется операция» | Интерфейс ожидает завершения фоновой задачи |
| «Нет ответа» | Последний запрос состояния к менеджеру не удался |

Данные считаются свежими в течение 30 секунд. «Запускается» может также означать,
что сервис остановлен, пишет в другую базу или давно не обновлял состояние.
«Нет подключения» отличается от отсутствия самого процесса.

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

## Создание экземпляра

На странице «Настройки» проверьте базовую папку, папку исходной установки и наличие обоих EXE.
Вернитесь на главную и нажмите «Новый терминал». Имя папки предлагается автоматически;
его можно заменить. Отображаемое имя задаётся отдельно. При необходимости выберите
`servers.dat` из локального терминала с нужным брокером. Файл необязателен.

Раскрываемый раздел подключения можно оставить пустым. Для подключения к готовому
счёту заполните логин, торговый сервер и пароль. Необходимый сервер должен
быть известен терминалу; если его нет, загрузите подходящий `servers.dat`.
Нажмите «Создать и запустить» и дождитесь
результата операции. Открытие страницы или принятие запроса ещё не означает,
что терминал готов.

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

При создании без счёта достаточно свежей записи сервиса, даже если торгового
подключения нет. При заданном счёте выполняются первый вход, проверка данных,
штатное закрытие, удаление временного INI и повторный обычный запуск с проверкой
того же логина и сервера. Этот цикл может занять заметное время.

Если создание не удалось, менеджер пытается остановить процессы новой копии,
удалить созданную им папку и запись конфигурации. Занятые до операции папки
не используются. Если откат также завершился ошибкой, проверьте папку и JSON
вручную перед повторной попыткой.

## Запуск и остановка

Кнопка «Запустить» использует `/portable` и дожидается свежих данных сервиса.
Если заданы реквизиты, проверяются счёт и подключение. После перезапуска самого
менеджера полный набор реквизитов один раз применяется заново: подтверждение
предыдущего процесса хранится только в памяти.

«Стоп» завершает процесс терминала. Штатное закрытие с сохранением настроек счёта
используется отдельно в цикле авторизации; обычная кнопка остановки не является
этим циклом. Повторная операция для того же экземпляра во время незавершённой
задачи отклоняется. Длительные задачи для разных экземпляров выполняются по очереди.

Ход запуска и остановки показывается внутри карточки соответствующего терминала.
Можно отправить команды нескольким экземплярам подряд: сообщения не заменяют
друг друга. Ход операции виден до завершения; её результат автоматически
скрывается через пять секунд. Общие уведомления вверху страницы также скрываются
через пять секунд после завершения операции. Заполняющийся круг вокруг крестика
показывает время до автоматического закрытия; крестик позволяет скрыть сообщение сразу.

## Настройки и файлы

В блоке «Размещение терминалов» задаются базовая папка всех экземпляров и папка
исходной установки MT5. Вторая может располагаться где угодно на сервере.
«Сохранить настройки» обновляет JSON и конфигурацию в памяти без перезапуска.
Под полями папок находится сворачиваемая строка «Дополнительные параметры»:
в ней задаются максимальное время ожидания в секундах и запас свободного места
для предупреждения в МиБ. Изначально этот раздел закрыт.
При смене базовой папки появляется подтверждение переноса папок экземпляров.
Если терминалы запущены, кнопка «Остановить и перенести» сначала штатно закроет их.
Кнопка «Отмена» оставляет папки и настройки прежними. После переноса терминалы
остаются остановленными; новое расположение сохраняется после успешного перемещения.
Папки назначения с совпадающими именами не перезаписываются. При ошибке менеджер
пытается вернуть перемещённые папки на место, сохранив прежнюю конфигурацию.
Если вернуть папки не удалось, в сообщении будут указаны пути для ручной проверки.

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

После сохранения под полем исходной установки показывается результат проверки
`terminal64.exe` и `MetaEditor64.exe`. Если оба найдены, появляется подтверждение
готовности. Если файла нет, здесь же доступен сворачиваемый раздел «Загрузить
недостающие файлы». Разверните его, нажмите «Выбрать» и «Загрузить»: файл будет
сохранён в указанную папку. После загрузки обоих EXE раздел скрывается.
При изменении пути сначала сохраните настройки, чтобы проверить новую папку.

`servers.dat` выбирается на главной странице в форме «Новый терминал». Возьмите его
из папки `config` локального терминала с нужным брокером. Для каждого создания
можно выбрать другой файл; существующие экземпляры не меняются. Сервис менеджер
собирает автоматически через MetaEditor выбранной исходной установки.

## Обновление проекта и сервиса

В настройках нажмите «Проверить обновления». Если в upstream появились новые
коммиты, станет доступна кнопка «Загрузить обновление», при условии чистого
рабочего дерева и отсутствия собственных коммитов. Проверка сборки покажет,
нужна ли перекомпиляция и у каких экземпляров требуется обновить EX5 или автозапуск.

«Собрать и разложить сервис» компилирует исходник текущего проекта и копирует
результат по папкам существующих терминалов, а также восстанавливает запись
автозапуска нашего сервиса в `config/services.ini`. Если конфигурацию требуется
изменить, сначала остановите соответствующий терминал и повторите операцию.
После завершения перезапустите
экземпляры, перечисленные в сообщении. Подробнее о режиме `--reload`, Git,
зависимостях и частичных ошибках — в [руководстве по эксплуатации](maintenance.md).

## Изменение торгового счёта

Нажмите значок настроек на карточке или раскройте нужный экземпляр в разделе
«Торговые счета». Измените реквизиты и нажмите «Сохранить».
Если реквизиты ещё не сохранены, поля подключения находятся в свёрнутой группе
«Указать реквизиты счёта». Флажок удаления реквизитов также находится внутри неё.
При сохранённых реквизитах группа сразу раскрыта.
Если отображаемое имя совпадает с именем папки, вместо поля показан флажок
«Отображать в списке под другим именем». Нажмите его, чтобы ввести отдельное имя; кнопка «Сбросить»
возвращает имя папки. Без отдельного имени оно меняется вместе с папкой.
Пустое поле пароля сохраняет прежнее значение. Для перехода на новый счёт
укажите полный набор реквизитов, если сохранённый пароль к нему не подходит.

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

Кнопка «Проверить подключение» использует текущие реквизиты из формы, включая
ещё не сохранённые. Пустой пароль подставляется из настроек экземпляра, если он
там есть. Проверка может временно запустить или переподключить терминал, но не
сохраняет поля формы в конфигурацию менеджера. После успешной проверки или ошибки
терминал возвращается в прежнее состояние: работающий остаётся запущенным,
а остановленный закрывается. Новое имя папки или выбранный servers.dat сначала
нужно сохранить. Ошибка проверки не изменяет сохранённые реквизиты.

Чтобы вернуть управление выбором счёта самому терминалу, установите флажок
«Убрать реквизиты из менеджера» и сохраните изменения. Это не удаляет настройки
счёта, сохранённые самим MT5. Изменение отображаемого имени также не переименовывает
папку. Для переименования папки измените отдельное поле «Имя папки экземпляра».
Сначала закройте терминал и заново раскройте форму: у работающего экземпляра
это поле доступно только для чтения. При сохранении менеджер переименует папку
на диске и ключ экземпляра в конфигурации, оставив терминал остановленным.

Рядом с торговым сервером кнопка «Заменить servers.dat» позволяет выбрать
новый файл из папки `config` локального
терминала с нужным брокером. Файл заменяется только у этого экземпляра; без
загрузки сохраняется прежний. Перед заменой закройте терминал самостоятельно.
Сохранение не останавливает и не запускает его.
Выбранный файл применяется только после нажатия «Сохранить»;
до сохранения выбор можно отменить.

Автоматическое открытие торговых счетов через интерфейс пока не реализовано.

## Удаление экземпляра

Остановите терминал, раскройте его настройки и нажмите «Удалить экземпляр».
В окне подтверждения показаны имя и путь папки. Подтверждение удаляет всю папку
с программами, настройками, историей и журналами, а также запись в конфигурации.
Удаление нельзя отменить. Для работающего терминала кнопка недоступна.

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