mt5-manager/docs/user-guide.md

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Справа для загрузки файла нажмите «Выбрать», укажите файл и затем «Загрузить».
Загрузка действует на образец для новых экземпляров, а не на существующие копии.
Отдельные файлы можно не загружать: правила резервного выбора и компиляции
описаны в [справочнике конфигурации](configuration.md).

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

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

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

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

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

Менеджер сохраняет запись, затем применяет её к существующему терминалу. При
ошибке авторизации папка и программы сохраняются, но неудачные реквизиты остаются
в конфигурации: исправьте их перед следующим запуском. Автоматического бесконечного
повтора подключения нет.

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