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,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)