Files
Bridge-and-Join-s/internal/nsdadapter/mock
fontvielle 5fa6ea6ab1 feat(robot): эмулятор робота-автотеста НРД + help-страница + REPORT.md
Реализован внутренний робот-эмулятор в internal/nsdadapter/mock/robot.go.
Источник правил: DOC/instruktsiya-po-testirovaniyu-s-robotom.pdf (от
12.05.2026). Когда mock.Sender видит Header.ReceiverCode == MC0012500000
и DocumentSeries в {1111, 2001, 2002, 3333} — формирует Decision по
выбранному сценарию вместо default-логики.

Сценарии:
- 1111 «Ответ с отказом»: все бумаги Rejection, код ошибки берётся из
  последних 2 символов DocumentNumber (01..09 → M2M01..M2M09)
- 2001 «Принять все бумаги»: все Confirmation; i-й символ DocumentNumber
  = номер депозитария-получателя для i-й секции (1/2)
- 2002 «Принять частично»: 0 = отклонить с M2M05, иначе номер депозитария
- 3333 «Выступить принимающей стороной»: пока только первое сообщение
  (отказ M2M05). Встречный M2MTransferRequest от робота — TODO
  (требует приёмной стороны bj-server)

Тестовые наборы депозитариев (ИНН 7702165310, depcode MC0012500000,
счёт HL2603250011, разделы 31MC0012500000F00 и 36MC0012500000F00)
зашиты в robotDepositary — соответствуют таблице из инструкции.

Help-страница /admin/help/robot с полным описанием: коды робота,
сценарии, управление через DocumentNumber, тестовые данные, коды ошибок
M2M01-M2M09, как переключиться на реальный TEST3 после получения ИШ.

REPORT.md — сводный отчёт для руководства о ходе работ: ~65% общей
готовности системы, ~80% готовности к интеграционному тесту с роботом
(остальное — внешние блокеры: дистрибутив ИШ, сертификат УЦ МБ).
Расписан план первичного тестирования после получения ИШ — 2-3 недели
до продакшена.

.gitignore: исключены DOC/*.pdf.bak (бэкапы doc-watcher'a).
2026-05-14 16:53:52 +03:00
..

internal/nsdadapter/mock — заглушка NSDSender

Имитирует Интеграционный шлюз НРД для локальных стендов и сквозных тестов. Реализует интерфейс m2mcore.NSDSender:

  • Send — синхронно возвращает синтетический M2MTransferResponse с StatusCode=INFO и записями 01 по каждой ЦБ.
  • SendDecision — фиксирует и завершает (мы — отправители Decision).
  • Параллельно — спавнит горутину, которая через Config.DecisionDelay (по умолчанию 3 секунды) эмитит M2MTransferDecision в канал Decisions().

Исходы

Через Config.DefaultOutcome или SetOutcome(guid, ...):

  • OutcomeConfirm — Confirmation по всем ЦБ.
  • OutcomeReject — Rejection с кодом Config.RejectionCode (по умолчанию 07).
  • OutcomeTimeout — Decision вообще не приходит (эмуляция SLA-таймаута).

Параметры

cfg := mock.DefaultConfig()
cfg.DecisionDelay = 1 * time.Second
cfg.DefaultOutcome = mock.OutcomeConfirm
sender := mock.NewSender(cfg)

resp, _ := sender.Send(ctx, req)
// resp.StatusCode == "INFO"

decision := <-sender.Decisions()
// Через ~1с прилетает Decision с Confirmation

Подписка на эмитированные Decision

go func() {
    for d := range sender.Decisions() {
        _ = svc.ApplyDecision(ctx, d)
    }
}()

В lk-gateway это делает Server.consumeDecisions (запускается в Run).

Контекст эмиссии

Эмиссия Decision использует внутренний контекст mock'а (создаётся в NewSender через context.Background()), а не контекст HTTP-запроса вызывающего. Это критично — контекст HTTP-запроса закрывается сразу после возврата ответа, и без своего lifecycle мок бы прерывал эмиссию до истечения DecisionDelay. Stop() отменяет внутренний контекст.

Статистика

Stats() возвращает счётчики Sent, Confirmed, Rejected, TimedOut — для admin-страницы lk-gateway.