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,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}}
@@ -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}}
@@ -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}}
@@ -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}}