Торговый терминал: скрипт PHP

Торговый терминал в скрипте PHP — график, панель ордера и запись результата в историю. Для БО важны экспирация и выплата; для Forex — объём, плечо, маржа и PnL. В обоих случаях терминал без живых котировок — декорация: сначала лента, потом кнопка сделки.

Терминал обычно открывается из кабинета на том же домене white label. Потеря сессии между кабинетом и terminal.example.com без общего cookie — частая боль после «красивого» разнесения по поддоменам.

Общее ядро

• График (часто TradingView Library) и last/bid-ask.
• Выбор инструмента из того же словаря, что лента.
• Форма сделки и подтверждение.
• Список открытых/недавних операций.
• Индикатор состояния ленты (live/stale).

Лента: котировки, API, WebSocket. График: TradingView. Кабинет: кабинет.

Разница БО и Forex

БО: сумма, направление, срок, фиксированная выплата. Forex: лот/объём, плечо, SL/TP по возможности, своп. Не смешивайте формы до нечитаемого комбайна. Продукты: скрипт БО, платформа БО, скрипт Forex, платформа Forex.

1. Демо-сделка проходит end-to-end.
2. Цена в истории объяснима лентой в момент клика.
3. Обрыв WS показывает статус, не «тихий» стоячий last.

Web против MT4

Веб-терминал: быстрый онбординг, свой бренд, один KYC. MT4: десктоп, советники, привычка аудитории. Если скрипт — браузерный, честно позиционируйте как альтернативу установке: альтернатива MT4. White label: white label.

Демо/real в UI

Бейдж счёта в шапке терминала обязателен. Сброс демо не из терминала «наобум» без confirm. Переключение счёта не должно оставлять висящий ордер-форму с чужим балансом. Демо: демо-счёт. Деньги: депозит и вывод. KYC: KYC.

Производительность

Не подписывайтесь на все символы сразу. Индикаторы по умолчанию — минимум. Мобильная вёрстка: крупные кнопки направления, график выше формы или по табам — проверьте на реальном телефоне, не только в DevTools.

Сервер ордеров/PHP не должен держать тики в fpm-воркерах. Тики — WS/сервис; PHP — авторизация, приём ордера, расчёт по правилам.

Приёмка терминала

Сценарии БО и/или Forex по продукту, stale ленты, мобильный ордер, совпадение session с кабинетом, учебная история. Инфра: MicroPanel, MicroDrive.

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

UX ордера

Кнопка сделки не должна быть активна при stale ленте или при market closed. Подтверждение на крупные суммы — по политике. Защита от двойного клика: disable кнопки до ответа сервера и идемпотентный ключ ордера. Сообщение об ошибке — человеческое: «недостаточно маржи», «рынок закрыт», «лот вне шага», а не stacktrace.

Звук/визуал исполнения опциональны; не делайте агрессивных анимаций, крадущих FPS графика. На мобиле фиксируйте нижнюю панель суммы и направления.

Состояние и восстановление

После reload терминал восстанавливает выбранный символ, таймфрейм и счёт. Открытые позиции подтягиваются с backend, не из localStorage. localStorage — только для UI-предпочтений.

Если сервер ордеров недоступен, а лента жива — покажите баннер «торговля временно недоступна». Обратное тоже бывает: торговля есть, график нет — отдельный баннер на datafeed.

Доступность и брендинг

Контраст кнопок Buy/Sell не опирайте только на цвет. White label цвета проверяйте на читаемость. Логотип не должен перекрывать last price. Скрывайте debug-виджеты на проде.

Связка с кабинетом: баланс в шапке терминала кликабелен и ведёт на историю/депозит. Пользователь не обязан помнить URL кабинета отдельно.

Журнал событий клиента

На клиенте в режиме support можно включить кольцевой лог: смена символа, ошибки subscribe, код отказа ордера, latency. Пользователь экспортирует файл в тикет — диагностика короче на порядок. На проде по умолчанию выключено.

Серверный лог ордеров коррелируйте по request_id, который виден в ответе ошибки. «Ордер не прошёл» без id не расследовать.

Синхронизация времени браузера и сервера: расхождение больше N секунд — предупреждение. Для БО экспираций это критично.

Критерии готовности

Терминал готов к трафику, когда: лента live, ордер идемпотентен, история пишется, демо/real разделены, мобильный прогон пройден, баннеры stale/maintenance работают, логи коррелируются по id. Документы: white label, демо, деньги.

Операционный ритм терминала

Метрики RUM: время до первого тика, ошибки JS, доля stale banner. Если после релиза фронта растёт время до тика — откатывайте ассеты, не копайте PHP сутки. Держите предыдущую версию static на CDN для быстрого rollback.

Саппорт с правом view-only видит состояние ленты глазами пользователя (символ, last, ts). Это быстрее, чем просить «пришлите скрин».

Согласуйте релизы терминала с релизом словаря символов. Несовместимый id ломает график точечно и выглядит как «у меня одного не работает».

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

Приёмка терминала

Видео: выбор счёта, живой тик, ордер, появление в истории, обрыв сети с баннером, мобильный ордер. Приложите список кодов ошибок и их текстов. Проверьте, что white-label логотип не режет цену на узком экране. Связка мануалов: лента, кабинет, демо, Forex / БО.

Убедитесь, что серверные часы и отображаемое время экспирации/ордера в одном поясе или с явной меткой UTC. Подпись часового пояса в истории убирает целый класс споров. Это особенно важно для команд с поддержкой в другом регионе, чем сервер.

Проверьте доступность терминала для клавиатуры: фокус на сумме, Tab к кнопке сделки, Escape закрывает модалку подтверждения. Не все трейдеры только с мышью. Это не «красота», а скорость входа в сделку и меньше мискликов на мобильной клавиатуре с тачпадом ноутбука.

После сдачи оставьте staging-терминал с тестовым логином для саппорта — воспроизведение багов ускоряется в разы.