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>

internal/lkemulator/README.md

@@ -0,0 +1,48 @@
+# internal/lkemulator — имитация ЛК клиента (ESIA Finance)
+
+Веб-приложение, которое играет роль ЛК ESIA Finance в сквозных тестах
+без подключения к реальному ЛК. Используется:
+
+- для дев-демо «увидеть как работает сквозной поток заявки M2M»;
+- для приёмочного теста перед интеграцией с реальным ЛК;
+- как QA-инструмент, который остаётся после внедрения реального ЛК.
+
+## Веб-страницы
+
+- `/` — журнал моих заявок с автообновлением каждые 3 сек (показывает
+  изменение статуса по callback'у от lk-gateway).
+- `/new` — форма «подать заявку M2M»: выпадающий список инвесторов
+  (из `seed-data`), реквизиты сторон, ИИС, одна ЦБ, выбор имитируемого
+  исхода (confirm/reject/timeout).
+- `/claims/{id}` — карточка с историей: тело POST в lk-gateway,
+  ответ lk-gateway, полученный callback, расшифровка ответа НРД.
+- `/healthz` — health.
+- `/api/v1/back_office/claims/{id}` (PATCH) — приёмник callback'ов от
+  lk-gateway.
+
+## Состав пакета
+
+- `server.go` — HTTP-сервер, маршруты, рендер шаблонов.
+- `client.go` — `GatewayClient` (POST заявка, регистрация callback URL).
+- `types.go` — `Store` (in-memory) и `Claim`/`CallbackRecord` модели.
+- `web/templates/` — `layout.html`, `home.html`, `new.html`, `claim.html`.
+
+## Конфигурация (cmd/lk-emulator/main.go, ENV)
+
+| Переменная | По умолчанию | Назначение |
+|---|---|---|
+| `BJ_HTTP_ADDR` | `:8083` | Адрес HTTP |
+| `BJ_GATEWAY_URL` | `http://127.0.0.1:8080` | URL lk-gateway, куда шлём POST заявки |
+| `BJ_EMULATOR_PUBLIC_URL` | `http://127.0.0.1:8083` | Куда gateway должен слать callback'и (регистрируется при старте) |
+
+## Сквозной поток для проверки
+
+1. Запустить `./bin/lk-gateway` (порт 8080) и `./bin/lk-emulator` (порт 8083).
+2. Открыть в браузере `http://127.0.0.1:8083/new`.
+3. Подать заявку с дефолтными значениями + исход `confirm`.
+4. На странице `http://127.0.0.1:8083/` через ~3 секунды увидеть
+   статус заявки `confirmed`.
+5. На странице `http://127.0.0.1:8080/admin/` — дашборд lk-gateway со
+   счётчиком «Подтверждено: 1» и заявкой в журнале.
+6. На странице `http://127.0.0.1:8080/admin/status` — состояние всех
+   подсистем.

internal/lkemulator/client.go

@@ -0,0 +1,75 @@
+package lkemulator
+
+import (
+	"bytes"
+	"context"
+	"encoding/json"
+	"fmt"
+	"io"
+	"net/http"
+	"time"
+)
+
+// GatewayClient — клиент к lk-gateway по REST.
+type GatewayClient struct {
+	baseURL string
+	httpc   *http.Client
+}
+
+// NewGatewayClient — конструктор.
+func NewGatewayClient(baseURL string) *GatewayClient {
+	return &GatewayClient{
+		baseURL: baseURL,
+		httpc:   &http.Client{Timeout: 10 * time.Second},
+	}
+}
+
+// CreateClaim шлёт POST /api/v1/back_office/claims/ и возвращает ответ.
+func (c *GatewayClient) CreateClaim(ctx context.Context, body map[string]any) (map[string]any, error) {
+	raw, err := json.Marshal(body)
+	if err != nil {
+		return nil, err
+	}
+	req, err := http.NewRequestWithContext(ctx, http.MethodPost,
+		c.baseURL+"/api/v1/back_office/claims/", bytes.NewReader(raw))
+	if err != nil {
+		return nil, err
+	}
+	req.Header.Set("Content-Type", "application/json")
+	resp, err := c.httpc.Do(req)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+	out, err := io.ReadAll(resp.Body)
+	if err != nil {
+		return nil, err
+	}
+	if resp.StatusCode >= 400 {
+		return nil, fmt.Errorf("lk-gateway HTTP %d: %s", resp.StatusCode, string(out))
+	}
+	var parsed map[string]any
+	if err := json.Unmarshal(out, &parsed); err != nil {
+		return nil, fmt.Errorf("lk-gateway: разбор JSON: %w; raw: %s", err, string(out))
+	}
+	return parsed, nil
+}
+
+// SetCallbackURL сообщает gateway свой URL — куда слать PATCH callback'и.
+func (c *GatewayClient) SetCallbackURL(ctx context.Context, url string) error {
+	req, err := http.NewRequestWithContext(ctx, http.MethodPost,
+		c.baseURL+"/admin/api/callback-url?url="+url, nil)
+	if err != nil {
+		return err
+	}
+	resp, err := c.httpc.Do(req)
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+	if resp.StatusCode >= 400 {
+		buf, _ := io.ReadAll(resp.Body)
+		return fmt.Errorf("set callback url HTTP %d: %s", resp.StatusCode, string(buf))
+	}
+	return nil
+}

internal/lkemulator/server.go

@@ -0,0 +1,427 @@
+package lkemulator
+
+import (
+	"context"
+	"crypto/rand"
+	"embed"
+	"encoding/base64"
+	"encoding/json"
+	"errors"
+	"fmt"
+	"html/template"
+	"io"
+	"log"
+	"net/http"
+	"strconv"
+	"strings"
+	"time"
+)
+
+//go:embed web/templates/*.html
+var tplFS embed.FS
+
+// ServerConfig — настройки эмулятора ЛК.
+type ServerConfig struct {
+	Addr          string
+	GatewayURL    string
+	SelfPublicURL string // адрес, который мы сообщим gateway для callback'ов
+}
+
+// Server — HTTP-сервер эмулятора.
+type Server struct {
+	cfg              ServerConfig
+	store            *Store
+	gw               *GatewayClient
+	home, new, claim *template.Template
+	srv              *http.Server
+	mux              *http.ServeMux
+}
+
+// NewServer собирает Server.
+func NewServer(cfg ServerConfig) (*Server, error) {
+	parse := func(content string) (*template.Template, error) {
+		return template.ParseFS(tplFS, "web/templates/layout.html", "web/templates/"+content)
+	}
+	home, err := parse("home.html")
+	if err != nil {
+		return nil, fmt.Errorf("parse home: %w", err)
+	}
+	newTpl, err := parse("new.html")
+	if err != nil {
+		return nil, fmt.Errorf("parse new: %w", err)
+	}
+	claimTpl, err := parse("claim.html")
+	if err != nil {
+		return nil, fmt.Errorf("parse claim: %w", err)
+	}
+	s := &Server{
+		cfg:   cfg,
+		store: NewStore(),
+		gw:    NewGatewayClient(cfg.GatewayURL),
+		home:  home,
+		new:   newTpl,
+		claim: claimTpl,
+		mux:   http.NewServeMux(),
+	}
+	s.routes()
+	s.srv = &http.Server{
+		Addr:              cfg.Addr,
+		Handler:           s.mux,
+		ReadHeaderTimeout: 5 * time.Second,
+	}
+	return s, nil
+}
+
+// Run поднимает сервер, регистрирует свой URL у gateway, ждёт ctx.Done().
+func (s *Server) Run(ctx context.Context) error {
+	go func() {
+		// Дать серверу подняться, потом попытаться зарегистрировать callback URL.
+		time.Sleep(200 * time.Millisecond)
+		if s.cfg.SelfPublicURL != "" {
+			if err := s.gw.SetCallbackURL(ctx, s.cfg.SelfPublicURL); err != nil {
+				log.Printf("lk-emulator: не получилось зарегистрировать callback URL: %v", err)
+			} else {
+				log.Printf("lk-emulator: callback URL %s зарегистрирован в lk-gateway", s.cfg.SelfPublicURL)
+			}
+		}
+	}()
+
+	errCh := make(chan error, 1)
+	go func() {
+		log.Printf("lk-emulator: listen %s", s.cfg.Addr)
+		errCh <- s.srv.ListenAndServe()
+	}()
+
+	select {
+	case <-ctx.Done():
+		shutCtx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
+		defer cancel()
+		_ = s.srv.Shutdown(shutCtx)
+		return nil
+	case err := <-errCh:
+		if errors.Is(err, http.ErrServerClosed) {
+			return nil
+		}
+		return err
+	}
+}
+
+// Mux возвращает обработчик (для httptest).
+func (s *Server) Mux() http.Handler { return s.mux }
+
+// Store возвращает store (для тестов).
+func (s *Server) Store() *Store { return s.store }
+
+func (s *Server) routes() {
+	s.mux.HandleFunc("/", s.handleHome)
+	s.mux.HandleFunc("/new", s.handleNew)
+	s.mux.HandleFunc("/claims/", s.handleClaim)
+	s.mux.HandleFunc("/healthz", func(w http.ResponseWriter, _ *http.Request) {
+		w.WriteHeader(http.StatusOK)
+		_, _ = w.Write([]byte("ok"))
+	})
+	// Принимаем callback'и от lk-gateway (PATCH).
+	s.mux.HandleFunc("/api/v1/back_office/claims/", s.handleCallback)
+}
+
+type pageData struct {
+	Title       string
+	Active      string
+	GatewayURL  string
+	AutoRefresh bool
+	Flash       string
+	Error       string
+}
+
+func (s *Server) basePage(title, active string, autoRefresh bool) pageData {
+	return pageData{Title: title, Active: active, GatewayURL: s.cfg.GatewayURL, AutoRefresh: autoRefresh}
+}
+
+type homeData struct {
+	pageData
+	Claims []*Claim
+}
+
+func (s *Server) handleHome(w http.ResponseWriter, r *http.Request) {
+	if r.URL.Path != "/" {
+		http.NotFound(w, r)
+		return
+	}
+	data := homeData{
+		pageData: s.basePage("Мои заявки", "home", true),
+		Claims:   s.store.All(),
+	}
+	if msg := r.URL.Query().Get("flash"); msg != "" {
+		data.Flash = msg
+	}
+	s.renderTpl(w, s.home, data)
+}
+
+// clientView — DTO от gateway для выпадающего списка инвесторов.
+type clientView struct {
+	ID         string `json:"ID"`
+	LastName   string `json:"LastName"`
+	FirstName  string `json:"FirstName"`
+	MiddleName string `json:"MiddleName"`
+}
+
+type newData struct {
+	pageData
+	Clients []clientView
+}
+
+func (s *Server) handleNew(w http.ResponseWriter, r *http.Request) {
+	if r.Method == http.MethodGet {
+		clients, err := s.fetchClients(r.Context())
+		if err != nil {
+			s.renderTpl(w, s.new, newData{pageData: s.basePage("Новая заявка", "new", false), Clients: nil})
+			return
+		}
+		s.renderTpl(w, s.new, newData{pageData: s.basePage("Новая заявка", "new", false), Clients: clients})
+		return
+	}
+	if r.Method != http.MethodPost {
+		http.Error(w, "method", http.StatusMethodNotAllowed)
+		return
+	}
+	if err := s.submitNew(r); err != nil {
+		clients, _ := s.fetchClients(r.Context())
+		d := newData{pageData: s.basePage("Новая заявка", "new", false), Clients: clients}
+		d.Error = err.Error()
+		s.renderTpl(w, s.new, d)
+		return
+	}
+	http.Redirect(w, r, "/?flash=Заявка+отправлена+в+lk-gateway.+Ждём+callback...", http.StatusSeeOther)
+}
+
+func (s *Server) submitNew(r *http.Request) error {
+	if err := r.ParseForm(); err != nil {
+		return fmt.Errorf("разбор формы: %w", err)
+	}
+	investorID := r.FormValue("investor_id")
+	if investorID == "" {
+		return errors.New("укажите инвестора")
+	}
+	clients, err := s.fetchClients(r.Context())
+	if err != nil {
+		return fmt.Errorf("список инвесторов: %w", err)
+	}
+	investorName := ""
+	for _, c := range clients {
+		if c.ID == investorID {
+			investorName = strings.TrimSpace(c.LastName + " " + c.FirstName + " " + c.MiddleName)
+			break
+		}
+	}
+
+	tInn := r.FormValue("transferring_depository_inn")
+	rInn := r.FormValue("receiving_depository_inn")
+	secCode := r.FormValue("security_code")
+	isin := r.FormValue("isin")
+	qStr := r.FormValue("quantity")
+	whole, err := strconv.ParseUint(qStr, 10, 64)
+	if err != nil || whole == 0 {
+		return errors.New("количество должно быть положительным целым")
+	}
+
+	body := map[string]any{
+		"investor": map[string]any{
+			"id":         investorID,
+			"last_name":  splitFio(investorName, 0),
+			"first_name": splitFio(investorName, 1),
+			"document": map[string]any{
+				"document_type": "21",
+				"series":        "4512",
+				"number":        "654321",
+			},
+		},
+		"transferring_depository_inn": tInn,
+		"receiving_depository_inn":    rInn,
+		"securities": []any{
+			map[string]any{
+				"security_code":    secCode,
+				"security_details": map[string]any{"isin": isin},
+				"quantity":         map[string]any{"whole": whole},
+				"settlement_accounts": []any{
+					map[string]any{
+						"settlement_requisites_inn": "7702070139",
+						"settlement_location": map[string]any{
+							"deponent_code": "DP789456",
+							"account_id":    "31MC0021900000F01",
+							"section_id":    "P001",
+						},
+					},
+				},
+			},
+		},
+		"signed_document":  base64.StdEncoding.EncodeToString([]byte("<xml>demo</xml>")),
+		"signature_format": "XMLDSig-GOST",
+	}
+	if code := r.FormValue("cost_info_code"); code != "" {
+		body["cost_info"] = map[string]any{"yes": map[string]any{"code": code}}
+	} else {
+		body["cost_info"] = map[string]any{"no": map[string]any{}}
+	}
+	if iiaType := r.FormValue("iia_type"); iiaType != "" {
+		body["iia_agreement"] = map[string]any{
+			"agreement_type":   iiaType,
+			"agreement_number": r.FormValue("iia_number"),
+			"agreement_date":   r.FormValue("iia_date"),
+			"broker_inn":       r.FormValue("iia_broker_inn"),
+		}
+	}
+
+	resp, err := s.gw.CreateClaim(r.Context(), body)
+	if err != nil {
+		return err
+	}
+	gwID, _ := resp["id"].(string)
+	status, _ := resp["status"].(string)
+
+	c := &Claim{
+		ID:                        randomID(),
+		GatewayID:                 gwID,
+		Status:                    status,
+		LocalStatus:               "submitted",
+		CreatedAt:                 time.Now().UTC(),
+		UpdatedAt:                 time.Now().UTC(),
+		InvestorName:              investorName,
+		TransferringDepositoryINN: tInn,
+		ReceivingDepositoryINN:    rInn,
+		SecuritiesCount:           1,
+		RawRequest:                body,
+		RawResponse:               resp,
+	}
+	s.store.Add(c)
+	return nil
+}
+
+type claimPage struct {
+	pageData
+	Claim          *Claim
+	PrettyRequest  string
+	PrettyResponse string
+}
+
+func (s *Server) handleClaim(w http.ResponseWriter, r *http.Request) {
+	id := strings.TrimPrefix(r.URL.Path, "/claims/")
+	if id == "" || strings.Contains(id, "/") {
+		http.NotFound(w, r)
+		return
+	}
+	c := s.store.Get(id)
+	if c == nil {
+		http.NotFound(w, r)
+		return
+	}
+	d := claimPage{
+		pageData: s.basePage("Заявка", "home", c.LastCallback == nil),
+		Claim:    c,
+	}
+	if b, err := json.MarshalIndent(c.RawRequest, "", "  "); err == nil {
+		d.PrettyRequest = string(b)
+	}
+	if b, err := json.MarshalIndent(c.RawResponse, "", "  "); err == nil {
+		d.PrettyResponse = string(b)
+	}
+	s.renderTpl(w, s.claim, d)
+}
+
+// handleCallback принимает PATCH /api/v1/back_office/claims/{id} от lk-gateway.
+func (s *Server) handleCallback(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodPatch {
+		http.Error(w, "method", http.StatusMethodNotAllowed)
+		return
+	}
+	gwID := strings.TrimPrefix(r.URL.Path, "/api/v1/back_office/claims/")
+	if gwID == "" {
+		http.Error(w, "id required", http.StatusBadRequest)
+		return
+	}
+	defer r.Body.Close()
+	raw, err := io.ReadAll(r.Body)
+	if err != nil {
+		http.Error(w, err.Error(), http.StatusBadRequest)
+		return
+	}
+	var payload struct {
+		NewStatus  string    `json:"new_status"`
+		ReasonCode string    `json:"reason_code"`
+		ReasonText string    `json:"reason_text"`
+		UpdatedAt  time.Time `json:"updated_at"`
+		NSDResp    *struct {
+			GUID       string `json:"guid"`
+			StatusCode string `json:"status_code"`
+			Responses  []struct {
+				ReferenceID string `json:"reference_id"`
+				Code        string `json:"code"`
+				Text        string `json:"text"`
+			} `json:"responses"`
+		} `json:"nsd_response"`
+	}
+	if err := json.Unmarshal(raw, &payload); err != nil {
+		http.Error(w, err.Error(), http.StatusBadRequest)
+		return
+	}
+	cb := &CallbackRecord{
+		NewStatus:  payload.NewStatus,
+		ReasonCode: payload.ReasonCode,
+		ReasonText: payload.ReasonText,
+		UpdatedAt:  payload.UpdatedAt,
+	}
+	if payload.NSDResp != nil {
+		cb.GUID = payload.NSDResp.GUID
+		cb.StatusCode = payload.NSDResp.StatusCode
+		for _, rr := range payload.NSDResp.Responses {
+			cb.Responses = append(cb.Responses, CallbackResponseEntry{
+				ReferenceID: rr.ReferenceID, Code: rr.Code, Text: rr.Text,
+			})
+		}
+	}
+	if !s.store.ApplyCallback(gwID, cb) {
+		http.Error(w, "claim not found in emulator", http.StatusNotFound)
+		return
+	}
+	w.WriteHeader(http.StatusOK)
+	_, _ = w.Write([]byte(`{"success":true}`))
+}
+
+func (s *Server) fetchClients(ctx context.Context) ([]clientView, error) {
+	req, err := http.NewRequestWithContext(ctx, http.MethodGet, s.cfg.GatewayURL+"/admin/api/clients", nil)
+	if err != nil {
+		return nil, err
+	}
+	resp, err := http.DefaultClient.Do(req)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+	var out []clientView
+	if err := json.NewDecoder(resp.Body).Decode(&out); err != nil {
+		return nil, err
+	}
+	return out, nil
+}
+
+func (s *Server) renderTpl(w http.ResponseWriter, t *template.Template, data any) {
+	w.Header().Set("Content-Type", "text/html; charset=utf-8")
+	if err := t.ExecuteTemplate(w, "layout", data); err != nil {
+		log.Printf("lk-emulator: render: %v", err)
+		http.Error(w, err.Error(), http.StatusInternalServerError)
+	}
+}
+
+// randomID — генерирует короткий локальный ID заявки (8 hex).
+func randomID() string {
+	var b [4]byte
+	_, _ = rand.Read(b[:])
+	return fmt.Sprintf("%x", b)
+}
+
+func splitFio(fio string, idx int) string {
+	parts := strings.Fields(fio)
+	if idx < len(parts) {
+		return parts[idx]
+	}
+	return ""
+}

internal/lkemulator/server_test.go

@@ -0,0 +1,105 @@
+package lkemulator_test
+
+import (
+	"bytes"
+	"encoding/json"
+	"net/http"
+	"net/http/httptest"
+	"strings"
+	"testing"
+	"time"
+
+	"git.zetit.ru/zuevav/Bridge-and-Join-s/internal/lkemulator"
+)
+
+func TestCallbackUpdatesStore(t *testing.T) {
+	srv, err := lkemulator.NewServer(lkemulator.ServerConfig{
+		Addr:       ":0",
+		GatewayURL: "http://example.invalid",
+	})
+	if err != nil {
+		t.Fatal(err)
+	}
+
+	// Положим заявку в store вручную.
+	c := &lkemulator.Claim{
+		ID:        "local-1",
+		GatewayID: "gw-abc",
+		Status:    "submitted_to_nsd",
+		CreatedAt: time.Now(),
+		UpdatedAt: time.Now(),
+	}
+	srv.Store().Add(c)
+
+	body := map[string]any{
+		"claim_id":   "gw-abc",
+		"new_status": "confirmed",
+		"updated_at": time.Now().Format(time.RFC3339),
+		"nsd_response": map[string]any{
+			"guid":        "c02a1d5e-c2af-4799-bab4-953f133c5133",
+			"status_code": "INFO",
+			"responses":   []map[string]any{{"reference_id": "M2M2026030200001", "code": "01", "text": "ok"}},
+		},
+	}
+	raw, _ := json.Marshal(body)
+	w := httptest.NewRecorder()
+	req := httptest.NewRequest(http.MethodPatch, "/api/v1/back_office/claims/gw-abc", bytes.NewReader(raw))
+	srv.Mux().ServeHTTP(w, req)
+
+	if w.Code != http.StatusOK {
+		t.Fatalf("callback code=%d body=%s", w.Code, w.Body.String())
+	}
+
+	got := srv.Store().Get("local-1")
+	if got.Status != "confirmed" {
+		t.Errorf("статус не обновился, got=%s", got.Status)
+	}
+	if got.LastCallback == nil {
+		t.Fatal("LastCallback nil")
+	}
+	if len(got.LastCallback.Responses) != 1 {
+		t.Errorf("ожидался 1 response, получено %d", len(got.LastCallback.Responses))
+	}
+}
+
+func TestCallbackUnknownClaim(t *testing.T) {
+	srv, err := lkemulator.NewServer(lkemulator.ServerConfig{Addr: ":0", GatewayURL: "http://example.invalid"})
+	if err != nil {
+		t.Fatal(err)
+	}
+	w := httptest.NewRecorder()
+	req := httptest.NewRequest(http.MethodPatch, "/api/v1/back_office/claims/unknown", strings.NewReader(`{"new_status":"confirmed"}`))
+	srv.Mux().ServeHTTP(w, req)
+	if w.Code != http.StatusNotFound {
+		t.Errorf("ожидался 404, получено %d", w.Code)
+	}
+}
+
+func TestHomePageEmpty(t *testing.T) {
+	srv, err := lkemulator.NewServer(lkemulator.ServerConfig{Addr: ":0", GatewayURL: "http://example.invalid"})
+	if err != nil {
+		t.Fatal(err)
+	}
+	w := httptest.NewRecorder()
+	req := httptest.NewRequest(http.MethodGet, "/", nil)
+	srv.Mux().ServeHTTP(w, req)
+	if w.Code != http.StatusOK {
+		t.Errorf("home: %d", w.Code)
+	}
+	if !strings.Contains(w.Body.String(), "Заявок ещё нет") {
+		t.Errorf("ожидалось сообщение об отсутствии заявок")
+	}
+}
+
+func TestHealthz(t *testing.T) {
+	srv, err := lkemulator.NewServer(lkemulator.ServerConfig{Addr: ":0", GatewayURL: "http://example.invalid"})
+	if err != nil {
+		t.Fatal(err)
+	}
+	w := httptest.NewRecorder()
+	req := httptest.NewRequest(http.MethodGet, "/healthz", nil)
+	srv.Mux().ServeHTTP(w, req)
+	if w.Code != http.StatusOK {
+		t.Errorf("healthz: %d", w.Code)
+	}
+}

internal/lkemulator/types.go

@@ -0,0 +1,109 @@
+// Package lkemulator — имитация ЛК клиента (ESIA Finance). Предоставляет
+// HTML-формы для подачи заявок M2M и приёмник callback'ов от lk-gateway.
+// Используется для сквозного дев-теста системы Bridge-and-Join-s без
+// реальной интеграции с ЛК.
+package lkemulator
+
+import (
+	"sync"
+	"time"
+)
+
+// Claim — локальная сохранённая копия заявки + последний callback.
+type Claim struct {
+	ID                        string
+	GatewayID                 string // ID присвоенный lk-gateway (совпадает с m2mcore.Deal.ID)
+	Status                    string
+	LocalStatus               string // "submitted" | "callback_received" — внутренняя метка эмулятора
+	CreatedAt                 time.Time
+	UpdatedAt                 time.Time
+	InvestorName              string
+	TransferringDepositoryINN string
+	ReceivingDepositoryINN    string
+	SecuritiesCount           int
+	LastCallback              *CallbackRecord
+	RawRequest                map[string]any
+	RawResponse               map[string]any
+}
+
+// CallbackRecord — сохранённый callback от lk-gateway.
+type CallbackRecord struct {
+	NewStatus  string
+	ReasonCode string
+	ReasonText string
+	UpdatedAt  time.Time
+	GUID       string
+	StatusCode string
+	Responses  []CallbackResponseEntry
+}
+
+// CallbackResponseEntry — одна строка из NSDResponse в callback'е.
+type CallbackResponseEntry struct {
+	ReferenceID string
+	Code        string
+	Text        string
+}
+
+// Store — in-memory хранилище заявок эмулятора.
+type Store struct {
+	mu    sync.RWMutex
+	byID  map[string]*Claim
+	byGw  map[string]*Claim
+	order []string
+}
+
+// NewStore — пустое хранилище.
+func NewStore() *Store {
+	return &Store{byID: make(map[string]*Claim), byGw: make(map[string]*Claim)}
+}
+
+// Add сохраняет новую заявку.
+func (s *Store) Add(c *Claim) {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	s.byID[c.ID] = c
+	if c.GatewayID != "" {
+		s.byGw[c.GatewayID] = c
+	}
+	s.order = append(s.order, c.ID)
+}
+
+// Get — по локальному ID.
+func (s *Store) Get(id string) *Claim {
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	return s.byID[id]
+}
+
+// GetByGatewayID — по ID от lk-gateway (используется при приёме callback).
+func (s *Store) GetByGatewayID(id string) *Claim {
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	return s.byGw[id]
+}
+
+// All возвращает все заявки в обратном порядке создания.
+func (s *Store) All() []*Claim {
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	out := make([]*Claim, 0, len(s.order))
+	for i := len(s.order) - 1; i >= 0; i-- {
+		out = append(out, s.byID[s.order[i]])
+	}
+	return out
+}
+
+// ApplyCallback обновляет заявку при получении callback'а от lk-gateway.
+func (s *Store) ApplyCallback(gatewayID string, cb *CallbackRecord) bool {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	c, ok := s.byGw[gatewayID]
+	if !ok {
+		return false
+	}
+	c.Status = cb.NewStatus
+	c.LocalStatus = "callback_received"
+	c.UpdatedAt = cb.UpdatedAt
+	c.LastCallback = cb
+	return true
+}

internal/lkemulator/web/templates/claim.html

@@ -0,0 +1,61 @@
+{{define "content"}}
+<div class="card">
+  <h2>Заявка <code>{{slice .Claim.ID 0 8}}</code> · <span class="badge {{.Claim.Status}}">{{.Claim.Status}}</span></h2>
+  <div class="kv">
+    <div>Создана</div><div>{{.Claim.CreatedAt.Format "02.01.2006 15:04:05"}}</div>
+    <div>Обновлена</div><div>{{.Claim.UpdatedAt.Format "02.01.2006 15:04:05"}}</div>
+    <div>ID lk-gateway</div><div><code>{{.Claim.GatewayID}}</code></div>
+    <div>Инвестор</div><div>{{.Claim.InvestorName}}</div>
+    <div>Передающий депозитарий</div><div><code>ИНН {{.Claim.TransferringDepositoryINN}}</code></div>
+    <div>Принимающий депозитарий</div><div><code>ИНН {{.Claim.ReceivingDepositoryINN}}</code></div>
+    <div>Локально</div><div>{{.Claim.LocalStatus}}</div>
+  </div>
+</div>
+
+{{if .Claim.RawRequest}}
+<div class="card">
+  <h2>Тело отправленной заявки (REST в lk-gateway)</h2>
+  <pre>{{.PrettyRequest}}</pre>
+</div>
+{{end}}
+
+{{if .Claim.RawResponse}}
+<div class="card">
+  <h2>Ответ lk-gateway на создание</h2>
+  <pre>{{.PrettyResponse}}</pre>
+</div>
+{{end}}
+
+{{if .Claim.LastCallback}}
+<div class="card">
+  <h2>Полученный callback от lk-gateway</h2>
+  <div class="kv">
+    <div>Новый статус</div><div><span class="badge {{.Claim.LastCallback.NewStatus}}">{{.Claim.LastCallback.NewStatus}}</span></div>
+    {{if .Claim.LastCallback.ReasonCode}}
+    <div>Код причины</div><div><code>{{.Claim.LastCallback.ReasonCode}}</code> {{.Claim.LastCallback.ReasonText}}</div>
+    {{end}}
+    <div>Время</div><div>{{.Claim.LastCallback.UpdatedAt.Format "02.01.2006 15:04:05"}}</div>
+    {{if .Claim.LastCallback.GUID}}
+    <div>NSD GUID</div><div><code>{{.Claim.LastCallback.GUID}}</code></div>
+    {{end}}
+  </div>
+  {{if .Claim.LastCallback.Responses}}
+  <h3 style="margin-top:18px;font-size:14px">NSD Response (детально)</h3>
+  <table>
+    <thead><tr><th>ReferenceID</th><th>Код</th><th>Текст</th></tr></thead>
+    <tbody>
+      {{range .Claim.LastCallback.Responses}}
+      <tr><td><code>{{.ReferenceID}}</code></td><td>{{.Code}}</td><td>{{.Text}}</td></tr>
+      {{end}}
+    </tbody>
+  </table>
+  {{end}}
+</div>
+{{else}}
+<div class="card">
+  <p class="muted">Callback от lk-gateway ещё не пришёл. Страница автообновится через 3 секунды.</p>
+</div>
+{{end}}
+
+<p style="margin-top:16px"><a href="/">← все заявки</a></p>
+{{end}}

internal/lkemulator/web/templates/home.html

@@ -0,0 +1,31 @@
+{{define "content"}}
+{{if .Flash}}<div class="notice">{{.Flash}}</div>{{end}}
+
+<div class="card">
+  <h2>Журнал моих заявок ({{len .Claims}})</h2>
+  {{if .Claims}}
+  <table>
+    <thead>
+      <tr><th>Создана</th><th>ID gateway</th><th>Инвестор</th><th>ЦБ</th><th>Передающий</th><th>Принимающий</th><th>Статус</th><th></th></tr>
+    </thead>
+    <tbody>
+      {{range .Claims}}
+      <tr>
+        <td>{{.CreatedAt.Format "02.01 15:04:05"}}</td>
+        <td><code>{{if .GatewayID}}{{slice .GatewayID 0 8}}{{else}}—{{end}}</code></td>
+        <td>{{.InvestorName}}</td>
+        <td>{{.SecuritiesCount}}</td>
+        <td><code>{{.TransferringDepositoryINN}}</code></td>
+        <td><code>{{.ReceivingDepositoryINN}}</code></td>
+        <td><span class="badge {{.Status}}">{{.Status}}</span></td>
+        <td><a href="/claims/{{.ID}}">детали →</a></td>
+      </tr>
+      {{end}}
+    </tbody>
+  </table>
+  <p class="muted" style="margin-top:12px">Страница автообновляется каждые 3 сек, чтобы видеть переход статуса по callback'у от lk-gateway.</p>
+  {{else}}
+  <p class="muted">Заявок ещё нет. <a href="/new">Подайте первую</a>.</p>
+  {{end}}
+</div>
+{{end}}

internal/lkemulator/web/templates/layout.html

@@ -0,0 +1,63 @@
+{{define "layout"}}<!DOCTYPE html>
+<html lang="ru">
+<head>
+<meta charset="utf-8">
+<title>{{.Title}} · lk-emulator</title>
+<style>
+:root { --bg:#0c1320; --card:#162032; --border:#27334a; --text:#dde6f4; --muted:#7d8aa0; --accent:#6bb5ff; --ok:#3fbf6c; --warn:#e8b13a; --err:#e85a5a; }
+* { box-sizing: border-box; }
+body { margin:0; font-family: system-ui, sans-serif; background: var(--bg); color: var(--text); }
+header { padding: 16px 24px; border-bottom: 1px solid var(--border); display: flex; align-items: center; gap: 24px; background: #0a0f1a; }
+header h1 { margin: 0; font-size: 18px; font-weight: 600; }
+header h1 .small { font-weight: 400; font-size: 13px; color: var(--muted); margin-left: 8px; }
+header nav a { color: var(--muted); text-decoration: none; margin-right: 16px; font-size: 14px; }
+header nav a:hover, header nav a.active { color: var(--text); }
+main { padding: 24px; max-width: 1100px; margin: 0 auto; }
+h2 { font-size: 16px; margin: 0 0 12px; font-weight: 600; }
+.card { background: var(--card); border: 1px solid var(--border); border-radius: 6px; padding: 18px; margin-bottom: 16px; }
+table { width: 100%; border-collapse: collapse; font-size: 14px; }
+th, td { text-align: left; padding: 8px 12px; border-bottom: 1px solid var(--border); }
+th { color: var(--muted); font-weight: 500; font-size: 12px; text-transform: uppercase; letter-spacing: .04em; }
+tr:hover td { background: rgba(107,181,255,0.05); }
+a { color: var(--accent); }
+code { background: var(--border); padding: 2px 6px; border-radius: 3px; font-size: 12px; }
+.muted { color: var(--muted); font-size: 13px; }
+form { display: grid; gap: 12px; }
+.form-row { display: grid; grid-template-columns: 200px 1fr; gap: 12px; align-items: center; }
+input[type=text], input[type=number], select { width: 100%; padding: 8px 10px; background: #0a0f1a; border: 1px solid var(--border); border-radius: 4px; color: var(--text); font-size: 14px; }
+input:focus, select:focus { outline: none; border-color: var(--accent); }
+.btn { background: var(--accent); color: #0a0f1a; border: none; padding: 10px 20px; border-radius: 4px; cursor: pointer; font-size: 14px; font-weight: 600; }
+.btn:hover { opacity: .85; }
+.btn-secondary { background: var(--border); color: var(--text); }
+.badge { display: inline-block; padding: 2px 8px; border-radius: 4px; font-size: 11px; font-weight: 600; }
+.badge.draft, .badge.validated, .badge.submitted_to_nsd { background: rgba(107,181,255,0.15); color: var(--accent); }
+.badge.awaiting_decision { background: rgba(232,177,58,0.15); color: var(--warn); }
+.badge.confirmed, .badge.awaiting_sub16, .badge.done { background: rgba(63,191,108,0.15); color: var(--ok); }
+.badge.rejected, .badge.timed_out { background: rgba(232,90,90,0.15); color: var(--err); }
+.notice { padding: 12px 16px; border-radius: 4px; margin-bottom: 16px; background: rgba(63,191,108,0.1); border-left: 3px solid var(--ok); }
+.notice.error { background: rgba(232,90,90,0.1); border-left-color: var(--err); }
+.kv { display: grid; grid-template-columns: 200px 1fr; gap: 4px 16px; font-size: 14px; }
+.kv > div:nth-child(odd) { color: var(--muted); }
+pre { background: #0a0f1a; border: 1px solid var(--border); border-radius: 4px; padding: 12px; font-size: 12px; overflow: auto; max-height: 400px; }
+</style>
+</head>
+<body>
+<header>
+  <h1>lk-emulator <span class="small">имитация ЛК ESIA Finance</span></h1>
+  <nav>
+    <a href="/" class="{{if eq .Active "home"}}active{{end}}">Мои заявки</a>
+    <a href="/new" class="{{if eq .Active "new"}}active{{end}}">Подать новую</a>
+  </nav>
+  <span class="muted" style="margin-left:auto">gateway: <code>{{.GatewayURL}}</code></span>
+</header>
+<main>
+{{template "content" .}}
+</main>
+<script>
+{{if .AutoRefresh}}
+setTimeout(() => location.reload(), 3000);
+{{end}}
+</script>
+</body>
+</html>
+{{end}}

internal/lkemulator/web/templates/new.html

@@ -0,0 +1,77 @@
+{{define "content"}}
+{{if .Error}}<div class="notice error">{{.Error}}</div>{{end}}
+
+<div class="card">
+  <h2>Подача заявки M2M</h2>
+  <p class="muted">Минимальная форма; остальные поля заполняются автоматически по seed-данным (см. <code>docs/fansy-contract/v1/examples/seed-data.sql</code>).</p>
+  <form method="post" action="/new">
+    <div class="form-row">
+      <label>Инвестор</label>
+      <select name="investor_id" required>
+        {{range .Clients}}
+        <option value="{{.ID}}">{{.LastName}} {{.FirstName}} {{.MiddleName}} (id <code>{{slice .ID 0 8}}</code>)</option>
+        {{end}}
+      </select>
+    </div>
+    <div class="form-row">
+      <label>Передающий депозитарий ИНН</label>
+      <input type="text" name="transferring_depository_inn" value="0702345678" required pattern="[0-9]{10}">
+    </div>
+    <div class="form-row">
+      <label>Принимающий депозитарий ИНН</label>
+      <input type="text" name="receiving_depository_inn" value="0710987654" required pattern="[0-9]{10}">
+    </div>
+    <div class="form-row">
+      <label>Код источника учёта</label>
+      <input type="text" name="cost_info_code" value="MC0010300032" placeholder="оставьте пустым = учёт не ведётся">
+    </div>
+    <div class="form-row">
+      <label>Тип ИИС</label>
+      <select name="iia_type">
+        <option value="">— нет ИИС —</option>
+        <option value="T12">T12 (ИИС-1/ИИС-2)</option>
+        <option value="T03" selected>T03 (ИИС-3)</option>
+      </select>
+    </div>
+    <div class="form-row">
+      <label>Номер договора ИИС</label>
+      <input type="text" name="iia_number" value="ИИС78/2024">
+    </div>
+    <div class="form-row">
+      <label>Дата ИИС</label>
+      <input type="text" name="iia_date" value="2026-01-15" pattern="\d{4}-\d{2}-\d{2}">
+    </div>
+    <div class="form-row">
+      <label>ИНН брокера ИИС</label>
+      <input type="text" name="iia_broker_inn" value="0707083893" pattern="[0-9]{10}">
+    </div>
+
+    <h2 style="margin-top:24px">Ценная бумага (1 шт. в эмуляторе)</h2>
+    <div class="form-row">
+      <label>SecurityCode</label>
+      <input type="text" name="security_code" value="MM0766162534" required pattern="[0-9A-Z_/-]{12}">
+    </div>
+    <div class="form-row">
+      <label>ISIN</label>
+      <input type="text" name="isin" value="RU0007661625" required pattern="[A-Z]{2}[A-Z0-9]{9}[0-9]">
+    </div>
+    <div class="form-row">
+      <label>Количество (целое)</label>
+      <input type="number" name="quantity" value="1500" min="1" required>
+    </div>
+    <div class="form-row">
+      <label>Имитировать ответ принимающей стороны</label>
+      <select name="outcome">
+        <option value="confirm" selected>Подтверждение (через 3 сек)</option>
+        <option value="reject">Отказ с кодом 07</option>
+        <option value="timeout">Таймаут — Decision не придёт</option>
+      </select>
+    </div>
+
+    <div style="margin-top:16px">
+      <button class="btn" type="submit">Отправить заявку</button>
+      <a class="btn btn-secondary" href="/" style="text-decoration:none; padding:10px 20px">Отмена</a>
+    </div>
+  </form>
+</div>
+{{end}}