{{define "content"}} {{if .Flash}}

{{.Flash}}

{{end}}

{{/* ===== Боковая навигация разделов с индикаторами ===== */}}

{{if or .AdvancedUnlocked (index .Modules "quik-mnp")}} {{end}} {{if devOn}} {{end}}

{{/* ============ ОБЗОР ============ */}}

Обзор

Готовность системы: {{.ReadyCount}} из {{.TotalCount}}

{{range .Readiness}}

{{.Name}}

{{if .Configured}}настроено{{else}}не настроено{{end}}

{{end}}

Версии систем

Что установлено на этом сервере и с чем работает bj: собственные компоненты и внешние системы. Та же версия показана в разделе каждого модуля. Сведения на {{msk .Versions.At}}.

{{range .Versions.Items}}{{end}}

Система	Версия	Подробности
{{if and .Section (ne .Section "overview")}}{{.Title}}{{else}}{{.Title}}{{end}}	{{if .Version}}{{.Version}}{{else}}не определена{{end}}	{{.Detail}}{{with .Err}} {{.}}{{end}}

{{/* ============ БАЗА ДАННЫХ ============ */}}

База данных

{{template "verline" (.Versions.Get "postgres")}}

PostgreSQL

Журнал сделок m2m-core и принимающая БД. Сейчас: {{if .Settings.Postgres.DSN}}подключено{{else}}in-memory (данные не сохраняются){{end}}.

{{if and devOn (not .Settings.Postgres.DSN)}}

Подключить автоматически

Поднимем локальный PostgreSQL в контейнере, применим миграции и запишем DSN. Для дев-стенда. Для прода — укажите свой DSN ниже.

{{end}}

{{if .Settings.Postgres.DSN}}Изменить подключение{{else}}…или ввести DSN вручную{{end}}

{{if .AdvancedUnlocked}} {{/* ============ ОБМЕН FANCY (MSSQL) — перспективный модуль ============ */}}

Обмен Fancy (MSSQL / PostgreSQL)

{{template "verline" (.Versions.Get "depo")}}

Подключение к серверу БД клиента

Сервер учётной базы Fancy DEPO: картотека лиц, счета и договоры, остатки, опции (признак квалифицированного инвестора), трансферные таблицы обмена. Поддерживаются Microsoft SQL Server и PostgreSQL. База указывается ниже, в карточке «Трансферные таблицы DEPO».

Трансферные таблицы DEPO

Через эти таблицы bj обменивается с учётной системой DEPO: поручения FTV_M2M и их строки FTV_M2M_LINES, события FTV_M2M_EVENTS, справочник участников НРД FTV_M2M_HANDBOOK. Таблицы создаются в базе DEPO на сервере из подключения выше ({{if .DepoTables.Postgres}}PostgreSQL{{else}}Microsoft SQL Server{{end}}). Создание можно повторять: добавляются только недостающие таблицы, колонки и индексы, данные не меняются.

База DEPO Признак ИИС в названии брокерского договора (с чего начинается номер договора ИИС в DEPO; несколько — через запятую) Создаёт bj — вводите логин с правами на создание таблиц в базе DEPO. Он используется один раз и не сохраняется; bj заодно выдаст права своему логину. Создаёт администратор СУБД по скрипту — скачайте скрипт и передайте администратору, после выполнения нажмите «Проверить таблицы».

{{if eq .Settings.Fancy.DepoTablesMode "auto"}} {{else if eq .Settings.Fancy.DepoTablesMode "script"}}

Скрипт для администратора СУБД — скачать {{.DepoTables.ScriptFile}}

{{.DepoTables.Script}}

{{end}}

логином bj: таблицы на месте, колонки совпадают, есть права на чтение и запись

{{if .Settings.Fancy.DepoTablesCheck}}

{{if .Settings.Fancy.DepoTablesCheckOK}}✓{{else}}✗{{end}} {{.Settings.Fancy.DepoTablesCheck}} ({{.Settings.Fancy.DepoTablesCheckAt.Format "02.01.2006 15:04"}})

{{end}}

Где запускается обработка трансферных таблиц DEPO

Поручения и события, которые bj пишет в FTV_M2M*, обрабатывает процедура {{.DepoJob.Proc}} в базе DEPO. Выберите, кто её запускает, выполните инструкцию и нажмите «Проверить готовность» — без зелёной отметки обмен с DEPO работать не будет.

Внутри bj — bj сам вызывает процедуру по расписанию. На сервере клиента нужно одно право на процедуру. Рекомендуется. Джоба SQL Agent, создаёт bj — логину bj выдаётся роль оператора SQL Agent, bj создаёт джобу кнопкой. Джоба SQL Agent, настраивает администратор — передаёте скрипт, bj проверяет, что джоба работает.

Интервал, секунд Процедура Работает от имени

Процедура обработки выполняется от имени пользователя базы DEPO (у разработчика Fancy это SYSDBA). У клиента такого пользователя может не быть или он называется иначе: «Проверить готовность» проверит, что он есть в базе.

{{if eq .Settings.Fancy.DepoJobMode "bj"}}

Инструкция для администратора SQL клиента — выполнить один раз:

{{.DepoJob.GrantScript}}

{{else if eq .Settings.Fancy.DepoJobMode "sql-auto"}}

Инструкция для администратора SQL клиента — выдать логину bj права оператора SQL Agent (SQL Agent должен быть запущен):

{{.DepoJob.AgentRights}}

{{else if eq .Settings.Fancy.DepoJobMode "sql-manual"}}

Инструкция для администратора SQL клиента — создать джобу (SQL Agent должен быть запущен, служебная учётная запись Agent должна иметь право выполнять процедуру):

{{.DepoJob.AgentScript}}

{{end}} {{if .Settings.Fancy.DepoJobMode}}

для вариантов с джобой bj пишет служебное событие BJ_PING и ждёт до 40 с, пока обработчик его отметит

{{if .Settings.Fancy.DepoJobCheck}}

{{if .Settings.Fancy.DepoJobCheckOK}}✓{{else}}✗{{end}} {{.Settings.Fancy.DepoJobCheck}} ({{.Settings.Fancy.DepoJobCheckAt.Format "02.01.2006 15:04"}})

{{end}} {{if and (eq .Settings.Fancy.DepoJobMode "bj") .Settings.Fancy.DepoJobLast}}

Последний вызов процедуры — {{.Settings.Fancy.DepoJobLast}}

{{end}} {{end}}

{{/* ============ QUIK МНП ============ */}}

QUIK — Модуль неторговых поручений

{{template "verline" (.Versions.Get "quik-mnp")}}

Подключение к БД МНП QUIK (MSSQL)

При выводе бумаг клиентом bj блокирует их количество в QUIK через API Модуля неторговых поручений (хранимые процедуры). БД боевая — проверка только на чтение (версия + наличие M2M-объектов), без записи. Подключение под логином с ролью InstrEu.
Инструкция для администратора QUIK — что настроить в QuikAdmin для M2M · документы ARQA.

Статус: {{if .Settings.Quik.Verified}}✓ подключение проверено{{else}}не проверено{{end}}

Автоматический цикл M2M в МНП{{if .Settings.Quik.Emulate}} {{if devOn}}имитация{{else}}остановлен{{end}}{{end}}

Что делает bj в Модуле неторговых поручений по ходу перевода: исходящий — при отправке в НРД регистрирует «Вывод ЦБ (M2M)» (QUIK блокирует бумаги), по подтверждению подписывает (списание), по отказу снимает с причиной; входящий — после приёма нашего поручения НРД регистрирует «Ввод ЦБ (M2M)» (зачисление сразу). Каждый шаг виден в карточке перевода и на странице QUIK МНП.

Разрешить записи в МНП (главный предохранитель — база боевая) {{if devOn}} Имитация: шаги цикла (блокировка, подпись, снятие, зачисление) проходят и отмечаются «имитация», в МНП ничего не пишется — пока нет пользователя QUIK для блокировок и лимитов. Имеет приоритет над записью.{{end}} Исходящие переводы: регистрировать при отправке, подписывать / снимать по ответу автоматически Входящие переводы: зачислять в QUIK после приёма поручения НРД автоматически Принимаем поручения M2M из QUIK: клиентам разрешена подача «Вывод ЦБ (M2M)» из терминала / мобильного приложения — bj опрашивает их и создаёт заявку оператору. Если фирма такую подачу не разрешает, оставьте выключенным: раздел «Поручения QUIK» их показывать не будет. Торговый счёт для регистрации поручений

МНП-инструмент вывода (пусто = взять из класса INSTROUTM2M) МНП-инструмент ввода (пусто = из класса INSTRINM2M)

Исключения кодов клиентов (по умолчанию «БР-001» → «BR001»; строка «номер портфеля=код QUIK»)

{{if .Settings.Quik.LastReport}}

Полный ответ сервера (последняя проверка)

Можно выделить и скопировать целиком — для отправки коллегам/аутсорсеру QUIK. {{if not .Settings.Quik.LastAt.IsZero}}Проверка от {{.Settings.Quik.LastAt.Format "02.01.2006 15:04:05"}} UTC.{{end}}

{{.Settings.Quik.LastReport}}

{{end}}

{{end}}{{/* /AdvancedUnlocked — конец перспективных модулей Fancy/QUIK */}} {{/* ============ ПОЛЬЗОВАТЕЛИ И ВХОД ============ */}}

{{$U := .Users}}{{$A := .Settings.Auth}}

Пользователи и вход

Кто может входить в bj и что ему разрешено. Вход — локальной учётной записью или доменной (Active Directory), роль доменного пользователя назначается по его группам AD.

{{if $U.Open}}

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

{{end}}

Роли

{{range $U.Roles}}{{end}} {{range $U.Hidden}}{{end}}

Роль	Что разрешено
{{.Title}} `{{.Key}}`	{{.Desc}}
{{.Title}}	Недоступна: в лицензии нет модуля «{{.Missing}}».

{{if $U.Modules}}Подключённые модули ({{range $i, $m := $U.Modules}}{{if $i}}, {{end}}«{{$m.Title}}»{{end}}) можно выдать любому пользователю дополнительно к роли. {{end}}Роли и модули показываются по лицензии: права модуля, которого нет в лицензии, не действуют. Настройки и пользователи — только администратор.

Пользователи ({{len $U.Users}})

{{range $U.Users}} {{else}}

Пользователей нет.

{{end}}

{{if $U.Open}}Создать первого администратора{{else}}Добавить пользователя{{end}}

Доменного пользователя можно заранее завести с источником «Active Directory», чтобы выдать ему модули; роль при входе возьмётся из групп AD. Если потерян доступ администратора — удалите файл /var/lib/bj/.bj/users.json на сервере: система вернётся в режим первичной настройки.

Вход через Active Directory

bj подключается к контроллеру домена и проверяет пароль пользователя (LDAP bind его же учётной записью). Роль назначается по членству в группах AD, включая вложенные. Пользователь появляется в списке при первом входе. Чтобы изменения групп действовали без повторного входа, укажите сервисную учётную запись только на чтение: bj будет перечитывать группы доменных пользователей по расписанию, менять роль и снимать доступ у удалённых из групп.

Разрешить вход доменной учётной записью

Контроллер домена Домен (суффикс UPN)

База поиска (Base DN) пусто = взять с контроллера

StartTLS для ldap:// Не проверять сертификат контроллера

Сертификат корпоративного ЦС (PEM), если проверяем

Сервисная учётная запись для перепроверки групп, только чтение Пароль сервисной учётной записи Перепроверять группы, минут

Группы AD → роли (имя группы или полный DN; первое совпадение сверху)

{{range $A.ADGroups}}

{{end}} {{range $i := list "1" "2"}}

{{end}}

Роль, если ни одна группа не совпала Выход при бездействии, часов

Без логина и пароля проверяется только доступность контроллера. С логином — вход, группы и вычисленная роль. Пароль проверки никуда не сохраняется.

{{$R := $U.ADRecheck}}

{{if and $A.ADEnabled $A.ADBindUser $A.ADBindPassword}} Перепроверка групп каждые {{if $A.ADRecheckMinutes}}{{$A.ADRecheckMinutes}}{{else}}15{{end}} мин: {{if $R.At.IsZero}}ещё не выполнялась{{else}}последняя {{msk $R.At}}, проверено {{$R.Checked}}, изменений {{$R.Changed}}{{if $R.Err}} — ошибка: {{$R.Err}}{{end}}{{end}} {{else}}Перепроверка групп выключена: роль доменного пользователя меняется только при следующем входе. Укажите сервисную учётную запись выше.{{end}}

Активные сессии ({{len $U.Sessions}})

{{if $U.Sessions}} {{range $U.Sessions}}{{end}}

Пользователь	Вход	Активность	Адрес	Браузер
{{.Login}}	{{msk .Created}}	{{msk .Seen}}	`{{.IP}}`	{{.UA}}

{{else}}

Сессий нет.

{{end}}

{{/* ============ ЭКСПОРТ БИРЖЕВОЙ ИНФОРМАЦИИ (QUIK) ============ */}}

{{.QuikExport.HTML}} {{/* модуль НПР/УДС работает поверх базы экспорта QUIK — его настройки здесь же */}}

Модуль «НПР / УДС» (риск-монитор по данным QUIK)

Показывает НПР1 / НПР2 / УДС клиентов маржинальной торговли по базе экспорта QUIK (схема npr). Отдельно лицензируемый модуль (признак npr); при включении в меню появляется пункт «НПР / УДС». Подключение — логин только для чтения.

{{template "verline" (.Versions.Get "bj-npr")}}

Лицензия

{{/* ============ КРИПТОГРАФИЯ ============ */}}

Криптография

{{template "verline" (.Versions.Get "crypto-service.jar")}}{{template "verline" (.Versions.Get "validata")}}{{template "verline" (.Versions.Get "java")}}

Установка ключа на флешку

Пошаговый мастер: загрузить архив НРД с паролем → запись на флешку → справочник сертификатов → проверка Валидаты → готово.

Открыть мастер установки ключа →

СКЗИ «Валидата Клиент L»

Активный профиль: {{if .Settings.Crypto.Profile}}{{.Settings.Crypto.Profile}}{{else}}—{{end}} · провайдер {{if and (not devOn) (or (eq .Settings.Crypto.Provider "stub") (eq .Settings.Crypto.Provider ""))}}не настроен{{else}}{{.Settings.Crypto.Provider}}{{end}}. Подробно — справка.

Параметры провайдера (для совместимости)

{{/* Доверенные сертификаты НРД в справочнике ИШ */}}

Сертификаты НРД в справочнике ИШ

Комплект доверенных сертификатов крипто-сервера НРД поставляется вместе с bj и при обновлении приезжает всем клиентам. bj сам сверяет справочник активного профиля ИШ{{if .NSDCerts.Profile}} ({{.NSDCerts.Profile}}){{end}}: недостающие добавляет (только если их УЦ уже есть в справочнике — боевой сертификат не попадёт в тестовый профиль), старые удаляет строго после разрешённого НРД срока. Каждое изменение — с бэкапом, проверкой подписи и откатом при ошибке; ИШ перезапускается на несколько секунд.

{{range .NSDCerts.Rows}}{{end}}

Сертификат	Контур	Действует	Статус
{{.Title}} {{.SubjectCN}} · выдан: {{.IssuerCN}} · серийный `{{.Serial}}`	{{.Contour}}	{{.ValidFrom}} — {{.ValidTo}}	{{if eq .Kind "ok"}}✓ {{.Status}}{{else if eq .Kind "add"}}⬆ {{.Status}}{{else}}{{.Status}}{{end}}{{if .RemoveNote}} {{.RemoveNote}} {{end}}

{{if not .NSDCerts.LastRun.IsZero}}сверено {{.NSDCerts.LastRun.Format "02.01.2006 15:04"}}{{end}}

{{if .NSDCerts.LastLog}}

{{.NSDCerts.LastLog}}

{{end}} {{if .NSDCerts.Store}}

Содержимое справочника профиля ({{len .NSDCerts.Store}} записей)

{{range .NSDCerts.Store}}{{end}}

Владелец	Издатель	Серийный	До	Хранилище
{{if eq .Kind "crl"}}CRL{{else}}{{.SubjectCN}}{{if .SelfSigned}} (УЦ){{end}}{{end}}	{{.IssuerCN}}	`{{.Serial}}`	{{.NotAfter}}	{{.Store}}

{{end}}

Свои сертификаты можно положить в /var/lib/bj/.bj/nsd-certs/*.cer — они добавляются по тем же правилам и никогда не удаляются автоматически.

{{/* Сертификаты УЦ */}}

Сертификаты УЦ (авто-загрузка)

URL .cer-файлов УЦ НРД (nsd.ru). Скачиваются, парсятся и сохраняются в /var/lib/bj/ca-certs/.

{{if .Settings.CACerts.FetchedCerts}} {{range .Settings.CACerts.FetchedCerts}}{{end}}

Владелец	Тип	До	Статус
{{.SubjectCN}}	`{{.Store}}`	{{if not .NotAfter.IsZero}}{{.NotAfter.Format "02.01.2006"}}{{end}}	{{if .Error}}ошибка{{else}}ок{{end}}

{{end}}

{{/* ============ НРД ============ */}}

НРД

{{template "verline" (.Versions.Get "ish")}}

Наша организация

Депозитарий — участник MOEX МОСТ, от имени которого bj отправляет и принимает переводы: ИНН передающего и зачисляющего депозитария в пакетах, код отправителя и код фирмы в QUIK. Выберите себя из справочника участников НРД или введите данные вручную.

{{if and .OrgINN .OrgCode}}

{{if .OrgName}}{{.OrgName}}{{else}}—{{end}} · ИНН {{.OrgINN}} · код {{.OrgCode}}{{if not .Settings.NSD.OrgINN}} (ИНН взят из справочника по коду){{end}}

{{else}}

Организация не задана — переводы не будут сформированы.

{{end}}

Автоматический режим M2M

Без участия оператора, чтобы соблюдать сроки: ответ на входящие переводы по свежей сверке с DEPO (пакет принимается только целиком; бумага для квалифицированных инвесторов при неполной или непрочитанной квалификации клиента — отказ M2M08), подача поручения 16/1, как только НРД пришлёт черновик после нашего согласия, и подача поручения 16 по исходящим после согласия контрагента. Если DEPO или ИШ недоступны — bj повторяет каждые 3 минуты и шлёт оповещение; без сверки ничего не принимается. Обрабатывается только то, что пришло не раньше чем за сутки до включения. Кнопки в карточках остаются для ручной работы.

{{if not .Settings.M2MAuto.ChangedAt.IsZero}}

{{if .Settings.M2MAuto.Enabled}}Включён{{else}}Выключен{{end}} {{msk .Settings.M2MAuto.ChangedAt}}{{with .Settings.M2MAuto.ChangedBy}} · {{.}}{{end}}.{{if .Settings.Quik.Emulate}}{{if devOn}} Шаги QUIK МНП — в режиме имитации.{{else}} Записи в QUIK МНП сейчас не выполняются.{{end}}{{end}}

{{end}}

Интеграционный шлюз (ИШ)

{{if not .Settings.NSD.IGWBaseURL}}{{if devOn}}mock-режим — без реального ИШ.{{else}}ИШ не настроен — обмен с НРД не выполняется.{{end}}{{else}}Профиль {{.Settings.NSD.Profile}}, ИШ {{.Settings.NSD.IGWBaseURL}}.{{end}} Стенды и установка — справка.

Профиль / контур URL ONYX (WSL) НРД Ключевой контейнер

Депозитарные реквизиты (откуда списываются бумаги) — из договора/письма НРД. Нужны для формирования заявки на перевод.

Депозитарный код Депозитарный счёт Раздел счёта ИШ версии 107.0.0.904+ (Astra 107.0.907+)
С этой версии в config.xml добавляется businessLine=MOST (обязательно для M2M по Указанию ЦБ 7317-У). На версиях младше — не включать.

{{/* ============ ЛИЧНЫЙ КАБИНЕТ ============ */}}

Личный кабинет · ЕСИА Финанс

Интеграция с платформой ЛК ЕСИА Финанс: адрес для клиента, приём заявок M2M, возврат статуса и подключение к API (тест/бой). НРД настраивается отдельно — в разделе «НРД».

{{template "verline" (.Versions.Get "bj-lk")}}

Кабинет клиента на своём сервере

Кабинет (bj-lk) — отдельная программа для веб-сервера депозитария или хостинга. Своей базы у неё нет: данные она берёт у ядра по защищённому каналу и не хранит дольше запроса. Порядок: 1) создайте ключ доступа, 2) выберите способ связи, 3) скачайте архив и распакуйте его на сервере кабинета, 4) запустите программу (sudo ./install.sh заводит службу), 5) откройте адрес кабинета в браузере — установщик проверит сервер, спросит ключ, проверит связь и заведёт администратора, 6) опубликуйте кабинет через nginx с сертификатом (пример в README архива).

Ключ доступа модуля

{{if .LKKeyMask}}{{.LKKeyMask}}{{else}}не создан — кабинет не сможет обращаться к ядру{{end}}

{{if .Settings.LK.APIKey}}{{end}}

В архив ключ не попадает: его вводят в установщике кабинета (или вписывают в lk.env при установке без браузера). Здесь он показан целиком — понадобится при переустановке кабинета.

Как кабинет и ядро находят друг друга Кабинет обращается к ядру — обычный случай: у ядра есть адрес, доступный серверу кабинета. Ядро подключается к кабинету — если у ядра нет адреса в интернете. Ядро само звонит кабинету по его имени, забирает запросы клиентов и возвращает ответы; входящих соединений и открытых портов не требуется.

Адрес ядра для кабинета — для режима «кабинет обращается к ядру» Куда кабинет обращается за данными. Если кабинет и ядро в одной сети — внутренний адрес; если в разных — тот, что открыт межсетевым экраном. Только https: по этому каналу идут ключ и сессии клиентов.

Адрес кабинета на хостинге — для режима «ядро подключается к кабинету» Имя, по которому ядро дозванивается до кабинета. Оно же — адрес, по которому входят клиенты.

Привязывать сессию клиента к его сети — к браузеру сессия привязана всегда; эта отметка добавляет сверку сети. Строже, но клиентов с мобильным интернетом будет выбрасывать при смене адреса оператором.

{{if .Settings.LK.APIKey}}Скачать для своего сервера (Linux) Скачать для PHP-хостинга{{end}} Инструкция по размещению

{{if .Settings.LK.AgentMode}}

Связь с кабинетом {{if .LKAgent.Connected}}ядро подключено к {{.LKAgent.Cabinet}}{{else}}ядро не дозвонилось до кабинета{{end}}

{{if .LKAgent.LastOK}}Последний обмен: {{.LKAgent.LastOK}}. {{end}}Обслужено запросов: {{.LKAgent.Served}}. {{if .LKAgent.LastErr}}
Ошибка: {{.LKAgent.LastErr}}{{end}}

{{end}}

Где собираются страницы. Для PHP-хостинга — всегда в ядре: на хостинге лежит только ретранслятор (index.php), который передаёт запросы браузера ядру. Для своего сервера установщик спросит: собирать страницы в ядре (тогда программа на сервере — тоже ретранслятор, новые разделы появляются обновлением ядра) или на месте. Ключа ни в одном архиве нет.

В архиве для своего сервера: исполняемый файл, служба systemd (отдельный пользователь, ограничения доступа к файловой системе), файл настроек службы, установщик и README. Ключа в архиве нет — его спрашивает веб-установщик. Кабинет входит в модуль «Личный кабинет клиента» и обновляется отдельно от ядра.

Пользователи кабинета

Учётные записи кабинета живут здесь, в базе ядра: кабинет на хостинге своей базы не имеет. Клиент привязан к номеру договора депозитария — по нему кабинет показывает портфель. Сотрудник («администратор кабинета») видит список клиентов и открывает их кабинеты на просмотр. Письма не отправляются: почта только хранится, пароль сообщите лично.

{{if .LKUsersError}}

База кабинета недоступна: {{.LKUsersError}}

{{end}} {{if .LKUsers}}

{{range .LKUsers}}{{end}}

Логин	Договор	Имя	Почта	Роль	Поручения	Состояние
`{{.Login}}`	{{.Contract}}	{{.FullName}}	{{.Email}}	{{if .IsAdmin}}сотрудник{{else}}клиент{{end}}	{{if .CanTransfer}}разрешены{{else}}просмотр{{end}}	{{if .Active}}активна{{else}}заблокирована{{end}}	{{if .Active}}{{else}}{{end}} {{if .IsAdmin}}{{else}} {{if .CanTransfer}}{{else}}{{end}}{{end}}

{{else}}{{if not .LKUsersError}}

Учётных записей пока нет. Первого администратора можно завести из установщика кабинета или здесь.

{{end}}{{end}}

Личный кабинет — интеграция

Адрес ЛК (стенд/бой), куда клиент подаёт заявку M2M. Заявка приходит к нам по контракту POST /api/v1/back_office/claims/, а мы возвращаем статус через Callback URL.

Подключение к API ЛК — тест и бой

Реквизиты, по которым bj обращается к API платформы ЛК ЕСИА Финанс (HTTP Basic). Заполните нужные окружения и нажмите «Проверить связь» — сразу видно, есть подключение или нет.

{{/* --- Тест --- */}}

Тестовый стенд {{if .Settings.LK.Test.LastMsg}}{{if .Settings.LK.Test.LastOK}}связь есть{{else}}нет связи{{end}}{{end}} {{if eq .Settings.LK.ActiveEnv "test"}}активно{{end}}

{{if .Settings.LK.Test.LastMsg}}

Последняя проверка: {{.Settings.LK.Test.LastMsg}} · {{.Settings.LK.Test.LastAt.Format "02.01 15:04"}}

{{end}}

{{/* --- Бой --- */}}

Боевой контур {{if .Settings.LK.Prod.LastMsg}}{{if .Settings.LK.Prod.LastOK}}связь есть{{else}}нет связи{{end}}{{end}} {{if eq .Settings.LK.ActiveEnv "prod"}}активно{{end}}

{{if .Settings.LK.Prod.LastMsg}}

Последняя проверка: {{.Settings.LK.Prod.LastMsg}} · {{.Settings.LK.Prod.LastAt.Format "02.01 15:04"}}

{{end}}

{{if devOn}}

Симулятор заявки M2M

Пока подача через веб-форму у ЕСИА Финанс не готова — bj сам собирает заявку depo_m2m и отправляет её в API ЛК (POST /claims/) через активное окружение. Ответ показывается ниже; затем заявку ловим опросом в «Переводы». Поля предзаполнены рабочим тестовым договором.

ID договора (owner_id)

ID клиента (user_id)

Счёт депо (account)

Раздел (section)

Название бумаги

ISIN

Вид бумаги

№ госрегистрации

Количество

ИНН контрагента

Наименование контрагента

Место расчётов

Передать информацию о расходах

Результат (сырой ответ API) появится вверху страницы. Если «Раздел счёта не доступен для быстрых переводов» — Финансы должны включить признак M2M на разделе счёта.

{{end}}

Забрать заявки из ЛК

Коннектор bj вычитывает заявки depo_m2m активного окружения в статусах «В очереди» и «В работе», которые ещё не обрабатывал, для каждой собирает M2M-пакет, отправляет в НРД и переводит заявку в статус «В работе». По ответу НРД статус в ЛК замыкается автоматически (Исполнена / Отклонена).{{if devOn}} В режиме имитации НРД перед отправкой идёт сверка с DEPO: отказ сразу уходит в ЛК с кодом и причиной, одобренная заявка блокируется в QUIK и через 30 с получает имитированный ответ контрагента.{{end}} Штатно это делает фоновый поллер раз в минуту — кнопка для ручного запуска.

Итог (сколько получено / отправлено, ошибки) появится вверху страницы.

{{/* ============ ДИАГНОСТИКА (id sec-tests сохранён для ссылок) ============ */}}

Диагностика

Здоровье сервиса

Фоновые компоненты под самоконтролем: при сбое перезапускаются автоматически, при зависании — перезапуск всего сервиса и запись в «Новости». Ниже — живой статус.

{{if .Health}}

{{range .Health}} {{end}}

Компонент	Состояние	Последняя отметка	Последняя ошибка
{{healthLabel .Name}}	{{if .Healthy}}работает{{else}}не отвечает{{end}}	{{dur .Age}} назад	{{if .LastErr}}{{.LastErr}}{{else}}—{{end}}

{{else}}

Компоненты ещё не зарегистрированы (сервис только запущен).

{{end}}

Справочник участников M2M

Запрос актуального справочника участников сервиса (пакет #M2MHR в НРД). В ответ НРД присылает #M2MTH — карту ИНН → MC-код депозитариев/брокеров и перечень мест расчётов. Нужно для сопоставления ИНН контрагента с кодом участника (блокеры вида M2M14/M2M15) и понимания, кто вообще зарегистрирован.

Ответ придёт во входящие ИШ (~30-60с). Список появится в логе bj-server и в m2m-handbook.json.

{{if devOn}}

Тестовый пакет роботу НРД

Робот MC0012500000 эмулирует вторую сторону перевода. Выберите сценарий — bj-server отправит эталонный запрос через ИШ, ответ придёт во входящие. Требуется настроенный ИШ + профиль Валидаты.

Ответ робота — асинхронно (~30-60 сек) во входящие ИШ.

Сквозной тестовый прогон (mock/реальный)

Заявка с предзаполненными данными через всю цепочку до финального статуса.

{{if .Settings.LastTest}}

Последний прогон

Статус	{{if .Settings.LastTest.OK}}✓ успешно{{else}}✗ не прошёл{{end}}
FSM-статус	`{{.Settings.LastTest.FinalStatus}}`
ClaimID	`{{.Settings.LastTest.ClaimID}}` {{if .Settings.LastTest.ClaimID}}→ карточка{{end}}
Сообщение	{{.Settings.LastTest.Message}}

{{end}}

{{end}}

{{/* ============ ОПОВЕЩЕНИЯ ============ */}}

Оповещения

Системные события (сбой или зависание фонового компонента, аварийный перезапуск) всегда попадают в ленту «Новости». Дополнительно их можно доставлять наружу — на почту оператору и/или в мониторинг Zabbix, чтобы узнать о проблеме, даже когда интерфейс bj никто не открыл.

Почта (SMTP)

Отправка уведомлений по e-mail. Пароль хранится в конфигурации сервиса.

{{if .Settings.Alerts.SMTP.LastMsg}}

Последняя проверка: {{.Settings.Alerts.SMTP.LastMsg}}

{{end}}

Zabbix (хук мониторинга)

bj шлёт значение на элемент типа Zabbix trapper (протокол zabbix_sender). В Zabbix заведите host и item-trapper с этим ключом, затем триггер по значению — уведомления настроит сам Zabbix.

{{if .Settings.Alerts.Zabbix.LastMsg}}

Последняя проверка: {{.Settings.Alerts.Zabbix.LastMsg}}

{{end}}

Адресаты уведомлений: депозитарий, бэк-офис, мидл-офис

Три группы адресов и таблица «какой тип уведомления кому отправлять». Письма идут через SMTP из раздела «Почта». Адрес алертов из раздела «Почта» получает системные оповещения всегда; группы ниже добавляются по маршруту.

Включить уведомления о переводах

Депозитарий (через запятую)

Бэк-офис (через запятую)

Мидл-офис (через запятую)

{{range .NotifyGroups}}{{end}}{{$inc := .Settings.Incoming}}{{range $k := .NotifyKinds}}{{range $g := $.NotifyGroups}}{{end}}{{end}}

Тип уведомления	{{.Title}}
{{$k.Title}}

Требуется настроенный и включённый SMTP в разделе «Почта».

{{/* ============ ОБНОВЛЕНИЯ ============ */}}

Обновления

{{template "verline" (.Versions.Get "bj-server")}}

Компоненты

Каждый компонент обновляется отдельно: своя версия в релизе, перезапускается только его служба. Файлы ставит root-установщик после повторной проверки подписи и контрольных сумм. Модули, которых нет на этом сервере, обновлением не ставятся — кроме выделенных из ядра (НПР / УДС, экспорт QUIK): если модуль входит в лицензию, он ставится вместе с обновлением, иначе его раздел перестал бы работать.

{{range .Components}}{{end}}

Компонент	Установлена	Доступна	Служба
{{.Title}} `{{.Name}}`	{{if .Present}}{{if .Installed}}{{.Installed}}{{else}}неизвестна{{end}}{{else}}не установлен{{end}}	{{if .Available}}{{.Available}}{{if .New}} к установке{{else if .Update}} новее{{end}}{{else}}нет данных{{end}}	`{{.Unit}}`	{{if .Update}} {{end}}

{{if .UpdatesAvailable}}{{end}}

{{if .Settings.Update.Notes}}

Что нового в релизе {{.Settings.Update.Available}}: {{.Settings.Update.Notes}}

{{end}} {{if not .Settings.Update.LastCheck.IsZero}}

Последняя проверка: {{.Settings.Update.LastCheck.Format "02.01.2006 15:04"}}. {{.Settings.Update.LastResult}}

{{end}} {{if and .License.Present (not .License.AllowsUpdates)}}

Текущий план «{{.License.Plan}}» не включает обновления.

{{end}}

Источник обновлений

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

{{/* ============ ЛИЦЕНЗИЯ ============ */}}

{{if .License.Valid}}Активна {{else if .License.Present}}Недействительна {{else}}Не активирована{{end}}

{{if .License.Present}} {{if .License.Tenant}}{{end}} {{if .License.Plan}}{{end}} {{if not .License.ExpiresAt.IsZero}}{{end}} {{if not .License.ContractUntil.IsZero}}{{end}}

Организация	{{.License.Tenant}}
План	{{.License.Plan}}
Тип ключа	{{if .License.Online}}онлайн: выдан сервером лицензий этой установке, продлевается автоматически{{else}}офлайн (закрытый контур){{end}}
Ключ действует до	{{.License.ExpiresAt.Format "02.01.2006"}} {{if .License.Valid}}(осталось {{.License.DaysLeft}} дн.){{end}}
Договор до	{{.License.ContractUntil.Format "02.01.2006"}}
Обновления	{{if .License.AllowsUpdates}}включены{{else}}не входят в план{{end}}
Модули	{{range .Features}} {{.Title}} `{{.Key}}`{{if not .On}}— не входит в лицензию{{end}} {{end}}
Статус	{{.License.Message}}

{{else}}

Лицензионный ключ не введён. Без лицензии сервис работает, но автообновления заблокированы.

{{end}}

Активация на сервере лицензий

Введите код активации от поставщика (вида BJ-XXXX-XXXX-XXXX). bj зарегистрирует эту установку на сервере лицензий lic.zetit.ru и дальше сам продлевает ключ раз в сутки. Серверу bj нужен доступ по HTTPS к lic.zetit.ru.

Установка {{if .Settings.License.InstallID}}{{.Settings.License.InstallID}}{{else}}будет создана при первом обращении{{end}}{{if not .Settings.License.LastSync.IsZero}} · последнее продление {{.Settings.License.LastSync.Format "02.01.2006 15:04"}}{{end}}

{{if .Settings.License.LastMsg}}

{{if .Settings.License.LastOK}}✓{{else}}✗{{end}} {{.Settings.License.LastMsg}} ({{.Settings.License.LastAttempt.Format "02.01.2006 15:04"}})

{{end}}

Офлайн-ключ для закрытого контура

Если у сервера bj нет доступа в интернет, вставьте офлайн-ключ, выданный поставщиком. Он проверяется по подписи без связи с сервером лицензий и не продлевается.

{{/* ============ ОФОРМЛЕНИЕ (логотип отчётов) ============ */}}

Оформление отчётов

Логотип организации в шапке отчётов

Логотип показывается справа в шапке всех отчётов для регулятора (слева — логотип MOEX МОСТ / НРД){{if devOn}} и на титульной сводке пакета тестов{{end}}. Встраивается прямо в HTML — отчёт остаётся автономным. Если не загружать — используется стандартный логотип «Фонтвьель».

Сейчас в отчётах:

{{if .Settings.Branding.LogoDataURI}}Загружен свой логотип{{if .Settings.Branding.LogoName}}: {{.Settings.Branding.LogoName}}{{end}}.{{else}}Используется стандартный (встроенный) логотип.{{end}}

Форматы: PNG, JPG, GIF, WEBP, SVG. Максимум 512 КБ. Рекомендуется горизонтальный логотип (высота в шапке — 28px).

{{if .Settings.Branding.LogoDataURI}} {{end}}

{{if devOn}} {{/* ============ ПЕРСПЕКТИВНЫЕ МОДУЛИ (под паролем) ============ */}}

Перспективные модули

Модули для будущих профилей внедрения «автомат» и «полуавтомат» (когда используется собственный личный кабинет, а не ЕСИА Финанс). Пока не в проде — скрыты, чтобы не мешать текущей работе. В профиле «через Финансы» они не нужны: проверку и блокировку бумаг закрывает сам ЕСИА Финанс.

Что здесь будет

QUIK — Модуль неторговых поручений	Блокировка/разблокировка и проверка количества бумаг в торговой системе — для собственного ЛК.
Обмен Fancy	Проверка заявки по учёту клиента через БД («кран») перед отправкой в НРД — для фирм без ЕСИА Финанс.

{{if .AdvancedUnlocked}}

Доступ открыт

Разделы «Обмен Fancy» и «QUIK МНП» появились в меню слева. Это незавершённые модули — меняйте настройки, только если понимаете последствия.

{{else}}

Открыть модули

Введите пароль администратора, чтобы временно открыть перспективные разделы. Доступ запоминается в этом браузере до нажатия «Скрыть».

{{end}}

{{end}}

{{end}} {{define "verline"}}{{if .Title}}

{{.Title}}: {{if .Version}}{{.Version}}{{else}}не определена{{end}}{{with .Detail}} · {{.}}{{end}}{{with .Err}} · {{.}}{{end}}

{{end}}{{end}}