feat(m2m): сквозной поток с веб-интерфейсами — lk-gateway BFF + admin UI + lk-emulator + mock NSD

Реализован M2-шаг-1: первый рабочий сквозной поток M2M-заявки от ЛК через нашу систему и обратно, с двумя видимыми веб-интерфейсами. internal/nsdadapter/mock/: - mock NSDSender с реалистичным синтетическим Response и асинхронной эмиссией Decision через настраиваемую задержку (Confirm/Reject/Timeout) - использует собственный жизненный цикл, чтобы HTTP-контексты вызывающего не прерывали эмиссию Decision до истечения DecisionDelay internal/lkgateway/: - REST по контракту ESIA Finance V1 (POST/GET/PATCH/list claims) - admin web UI (/admin/, /admin/claims, /admin/claims/{id}, /admin/status): - дашборд со статусом подсистем (postgres, crypto-service UDS, nsd-adapter, lk-emulator callback) и счётчиками сделок - журнал и карточка заявки с историей FSM, ответом НРД, решением принимающей стороны и последним callback'ом - in-memory SeedStore с 5 тестовыми клиентами и счетами депо - фоновый consumeDecisions: подписан на mock.Sender.Decisions(), применяет ApplyDecision и отправляет PATCH callback в ЛК internal/lkemulator/: - имитация ЛК клиента (порт 8083) - веб-формы: журнал, форма «новая заявка», карточка заявки - HTTP-клиент к lk-gateway (создание заявки + регистрация callback URL) - приёмник PATCH callback'ов, локальное хранилище заявок, автообновление страницы каждые 3 сек cmd/lk-gateway/main.go и cmd/lk-emulator/main.go — заглушки заменены на полные сервисы с graceful shutdown. Сквозной поток проверен smoke-test'ом: подача заявки через форму эмулятора → создание сделки в lk-gateway → Send в mock NSD → эмиссия Decision через 3 сек → ApplyDecision → PATCH callback в ЛК → эмулятор показывает confirmed. Дашборд lk-gateway: Total=1, Подтверждено=1. make ci зелёный. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 11:17:11 +03:00
parent e2720c09f7
commit c5695bf0b6
30 changed files with 3496 additions and 19 deletions
@@ -0,0 +1,59 @@
+# 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-таймаута).
+
+## Параметры
+
+```go
+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
+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.
@@ -0,0 +1,219 @@
+// Package mock — заглушка NSDSender для локальных стендов без реального
+// Интеграционного шлюза НРД. Возвращает синтетические M2MTransferResponse
+// (синхронно, сразу) и эмитит M2MTransferDecision (асинхронно, через
+// настраиваемую задержку) для каждой отправленной заявки.
+//
+// Подходит для:
+//   - сквозного дев-теста (ЛК → m2m-core → mock → callback в ЛК);
+//   - демонстраций «увидеть как оно работает» без подключения к НРД;
+//   - юнит-тестов компонентов выше уровня транспорта.
+package mock
+
+import (
+	"context"
+	"errors"
+	"sync"
+	"time"
+
+	"git.zetit.ru/zuevav/Bridge-and-Join-s/internal/m2m"
+	"git.zetit.ru/zuevav/Bridge-and-Join-s/internal/m2mcore"
+	"git.zetit.ru/zuevav/Bridge-and-Join-s/internal/nsdxml"
+)
+
+// DecisionOutcome — что должен вернуть mock после задержки.
+type DecisionOutcome int
+
+const (
+	OutcomeConfirm DecisionOutcome = iota
+	OutcomeReject
+	OutcomeTimeout
+)
+
+// Config — настройки mock-сендера.
+type Config struct {
+	// DecisionDelay — задержка между Send и эмиссией Decision в канал.
+	DecisionDelay time.Duration
+	// DefaultOutcome — каким будет Decision, если не задан per-Request override.
+	DefaultOutcome DecisionOutcome
+	// RejectionCode — какой код отказа возвращать в OutcomeReject (6 chars max).
+	RejectionCode string
+	// SenderCode/ReceiverCode для эмитированной Decision Header (берётся из
+	// исходного Request обменом местами).
+	NSDSenderCode m2m.DeponentCode
+}
+
+// DefaultConfig — разумные дефолты: подтверждение через 3 секунды.
+func DefaultConfig() Config {
+	return Config{
+		DecisionDelay:  3 * time.Second,
+		DefaultOutcome: OutcomeConfirm,
+		RejectionCode:  "07",
+	}
+}
+
+// Sender — mock реализация m2mcore.NSDSender.
+type Sender struct {
+	cfg        Config
+	decisions  chan *m2m.M2MTransferDecision
+	outcomes   sync.Map // map[m2m.UUID]DecisionOutcome — override per GUID
+	mu         sync.Mutex
+	stats      stats
+	lifeCtx    context.Context // независимый от HTTP-запроса контекст для эмиссии Decision
+	lifeCancel context.CancelFunc
+}
+
+type stats struct {
+	Sent      uint64
+	Confirmed uint64
+	Rejected  uint64
+	TimedOut  uint64
+}
+
+// NewSender создаёт mock с указанной конфигурацией.
+func NewSender(cfg Config) *Sender {
+	ctx, cancel := context.WithCancel(context.Background())
+	return &Sender{
+		cfg:        cfg,
+		decisions:  make(chan *m2m.M2MTransferDecision, 64),
+		lifeCtx:    ctx,
+		lifeCancel: cancel,
+	}
+}
+
+// Stop отменяет внутренний контекст mock'а, останавливая все запущенные
+// emit-горутины.
+func (s *Sender) Stop() { s.lifeCancel() }
+
+// SetOutcome задаёт исход для конкретной заявки по GUID (вызывается до Send).
+func (s *Sender) SetOutcome(guid m2m.UUID, out DecisionOutcome) {
+	s.outcomes.Store(guid, out)
+}
+
+// Decisions — канал эмитированных от имени принимающей стороны Decision'ов.
+// Подписаться, считать в горутине, передавать в m2mcore.Deal.ReceiveDecision.
+func (s *Sender) Decisions() <-chan *m2m.M2MTransferDecision { return s.decisions }
+
+// Stats — текущие счётчики (для UI).
+func (s *Sender) Stats() (sent, confirmed, rejected, timedOut uint64) {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	return s.stats.Sent, s.stats.Confirmed, s.stats.Rejected, s.stats.TimedOut
+}
+
+// Send имитирует отправку в НРД. Возвращает синтетический Response
+// с StatusCode=INFO. Через DecisionDelay в канал прилетает Decision.
+func (s *Sender) Send(ctx context.Context, req *m2m.M2MTransferRequest) (*m2m.M2MTransferResponse, error) {
+	if req == nil {
+		return nil, errors.New("nsdadapter/mock: Send: req=nil")
+	}
+	if err := req.Validate(); err != nil {
+		return nil, err
+	}
+
+	s.mu.Lock()
+	s.stats.Sent++
+	s.mu.Unlock()
+
+	// Синтетический Response: принимаем заявку, по каждой ЦБ — INFO 01.
+	resp := &m2m.M2MTransferResponse{
+		GUID:       req.Header.GUID,
+		StatusCode: m2m.StatusInfo,
+	}
+	for _, sec := range req.Data.TransferredSecurities.Securities {
+		refID := sec.ReferenceID
+		resp.Responses = append(resp.Responses, m2m.Response{
+			ReferenceID: &refID,
+			Code:        "01",
+			Text:        "Запрос на перевод принят НРД и направлен принимающей стороне (mock).",
+		})
+	}
+
+	// Эмитим Decision в отдельной горутине. Используем lifeCtx, чтобы
+	// HTTP-таймауты вызывающего не прерывали эмиссию.
+	outcome := s.cfg.DefaultOutcome
+	if v, ok := s.outcomes.Load(req.Header.GUID); ok {
+		outcome = v.(DecisionOutcome)
+	}
+	go s.emitDecision(s.lifeCtx, req, outcome)
+	_ = ctx
+
+	return resp, nil
+}
+
+// SendDecision имитирует отправку нашего Decision принимающей стороне (мы — реципиент).
+// Mock просто фиксирует статистику.
+func (s *Sender) SendDecision(_ context.Context, decision *m2m.M2MTransferDecision) error {
+	if decision == nil {
+		return errors.New("nsdadapter/mock: SendDecision: decision=nil")
+	}
+	if err := decision.Validate(); err != nil {
+		return err
+	}
+	s.mu.Lock()
+	s.stats.Sent++
+	s.mu.Unlock()
+	return nil
+}
+
+func (s *Sender) emitDecision(ctx context.Context, req *m2m.M2MTransferRequest, outcome DecisionOutcome) {
+	select {
+	case <-ctx.Done():
+		return
+	case <-time.After(s.cfg.DecisionDelay):
+	}
+
+	if outcome == OutcomeTimeout {
+		s.mu.Lock()
+		s.stats.TimedOut++
+		s.mu.Unlock()
+		// При таймауте Decision не приходит вообще — это и эмулируем.
+		return
+	}
+
+	decision := &m2m.M2MTransferDecision{
+		Header: m2m.DecisionHeader{
+			GUID:              req.Header.GUID,
+			CreationTimestamp: nsdxml.Now(),
+			SenderCode:        req.Header.ReceiverCode,
+			ReceiverCode:      req.Header.SenderCode,
+			CostInfo:          m2m.CostInfo{No: &m2m.CostInfoNo{}},
+		},
+		Data: m2m.DecisionData{
+			ReceivingDepository: req.Data.ReceivingDepository,
+		},
+	}
+	for _, sec := range req.Data.TransferredSecurities.Securities {
+		ds := m2m.DecisionSecurity{ReferenceID: sec.ReferenceID}
+		if outcome == OutcomeConfirm {
+			ds.TransferDecision = m2m.DecisionTransfer{
+				Confirmation: &m2m.Confirmation{
+					SettlementAccount: sec.SettlementAccount[0],
+				},
+			}
+		} else {
+			ds.TransferDecision = m2m.DecisionTransfer{
+				Rejection: &m2m.Rejection{
+					Codes: []string{s.cfg.RejectionCode},
+				},
+			}
+		}
+		decision.Data.Securities = append(decision.Data.Securities, ds)
+	}
+
+	s.mu.Lock()
+	switch outcome {
+	case OutcomeConfirm:
+		s.stats.Confirmed++
+	case OutcomeReject:
+		s.stats.Rejected++
+	}
+	s.mu.Unlock()
+
+	select {
+	case <-ctx.Done():
+	case s.decisions <- decision:
+	}
+}
+
+// Verify тип Sender удовлетворяет m2mcore.NSDSender.
+var _ m2mcore.NSDSender = (*Sender)(nil)
@@ -0,0 +1,140 @@
+package mock_test
+
+import (
+	"context"
+	"testing"
+	"time"
+
+	"git.zetit.ru/zuevav/Bridge-and-Join-s/internal/m2m"
+	"git.zetit.ru/zuevav/Bridge-and-Join-s/internal/nsdadapter/mock"
+)
+
+func validRequest() *m2m.M2MTransferRequest {
+	whole := uint64(100)
+	isin := m2m.ISIN("RU0007661625")
+	return &m2m.M2MTransferRequest{
+		Header: m2m.RequestHeader{
+			GUID:         m2m.UUID("c02a1d5e-c2af-4799-bab4-953f133c5133"),
+			SenderCode:   "MC0079200000",
+			ReceiverCode: "MC0010300000",
+			CostInfo:     m2m.CostInfo{No: &m2m.CostInfoNo{}},
+		},
+		Data: m2m.RequestData{
+			InvestorInformation: m2m.InvestorInformation{
+				LastName:  "Иванов",
+				FirstName: "Иван",
+				IdentityDocument: m2m.IdentityDocument{
+					DocumentType:   m2m.DocCode21,
+					DocumentNumber: m2m.IdentityDocSerial("654321"),
+				},
+			},
+			TransferringDepository: m2m.SettlementRequisites{INN: "7702070139"},
+			ReceivingDepository:    m2m.SettlementRequisites{INN: "7802031669"},
+			TransferredSecurities: m2m.RequestTransferredSecurities{
+				Securities: []m2m.RequestSecurity{
+					{
+						ReferenceID:     "M2M2026030200001",
+						SecurityCode:    "MM0766162534",
+						SecurityDetails: m2m.SecurityDetails{ISIN: &isin},
+						Quantity:        m2m.Quantity{Whole: &whole},
+						SettlementAccount: []m2m.RequestSettlementAccount{
+							{
+								SettlementRequisites: m2m.SettlementRequisites{INN: "7702070139"},
+								SettlementLocation: m2m.SettlementDepositoryLocation{
+									DeponentCode: "DP789456",
+									AccountID:    "31MC0021900000F01",
+									SectionID:    "P001",
+								},
+							},
+						},
+						IsolationStatus: m2m.IsolationSGDN,
+					},
+				},
+			},
+		},
+	}
+}
+
+func TestMockSendReturnsResponseAndEmitsConfirmation(t *testing.T) {
+	cfg := mock.DefaultConfig()
+	cfg.DecisionDelay = 20 * time.Millisecond
+	s := mock.NewSender(cfg)
+
+	resp, err := s.Send(context.Background(), validRequest())
+	if err != nil {
+		t.Fatal(err)
+	}
+	if resp.StatusCode != m2m.StatusInfo {
+		t.Errorf("StatusCode = %s, ожидалось INFO", resp.StatusCode)
+	}
+	if len(resp.Responses) != 1 {
+		t.Errorf("ожидалась 1 Response, получено %d", len(resp.Responses))
+	}
+
+	select {
+	case d := <-s.Decisions():
+		if d.Data.Securities[0].TransferDecision.Confirmation == nil {
+			t.Errorf("ожидалось Confirmation, получено %+v", d.Data.Securities[0].TransferDecision)
+		}
+	case <-time.After(time.Second):
+		t.Fatal("Decision не пришёл в канал")
+	}
+}
+
+func TestMockRejectOutcome(t *testing.T) {
+	cfg := mock.DefaultConfig()
+	cfg.DecisionDelay = 20 * time.Millisecond
+	cfg.DefaultOutcome = mock.OutcomeReject
+	s := mock.NewSender(cfg)
+	req := validRequest()
+	if _, err := s.Send(context.Background(), req); err != nil {
+		t.Fatal(err)
+	}
+	select {
+	case d := <-s.Decisions():
+		if d.Data.Securities[0].TransferDecision.Rejection == nil {
+			t.Errorf("ожидалось Rejection")
+		}
+	case <-time.After(time.Second):
+		t.Fatal("Decision не пришёл")
+	}
+}
+
+func TestMockTimeoutOutcome(t *testing.T) {
+	cfg := mock.DefaultConfig()
+	cfg.DecisionDelay = 20 * time.Millisecond
+	cfg.DefaultOutcome = mock.OutcomeTimeout
+	s := mock.NewSender(cfg)
+	if _, err := s.Send(context.Background(), validRequest()); err != nil {
+		t.Fatal(err)
+	}
+	select {
+	case <-s.Decisions():
+		t.Error("при OutcomeTimeout Decision не должен прилетать")
+	case <-time.After(100 * time.Millisecond):
+	}
+	_, _, _, timedOut := s.Stats()
+	if timedOut != 1 {
+		t.Errorf("счётчик timeout = %d, ожидалось 1", timedOut)
+	}
+}
+
+func TestMockSetOutcomeOverride(t *testing.T) {
+	cfg := mock.DefaultConfig()
+	cfg.DecisionDelay = 20 * time.Millisecond
+	cfg.DefaultOutcome = mock.OutcomeConfirm
+	s := mock.NewSender(cfg)
+	req := validRequest()
+	s.SetOutcome(req.Header.GUID, mock.OutcomeReject)
+	if _, err := s.Send(context.Background(), req); err != nil {
+		t.Fatal(err)
+	}
+	select {
+	case d := <-s.Decisions():
+		if d.Data.Securities[0].TransferDecision.Rejection == nil {
+			t.Errorf("override не сработал, ожидалось Rejection")
+		}
+	case <-time.After(time.Second):
+		t.Fatal("Decision не пришёл")
+	}
+}