67e81e5d7f
В admin-панели lk-gateway добавлен раздел /admin/help — справка по основным интеграциям, читается прямо на сервере, без выхода во внешнюю документацию. Состав /admin/help: - /admin/help — hub-страница с 4 карточками-ссылками - /admin/help/database — подключение PostgreSQL, схемы fansy/fansy_staging/m2m_core, что подгружается через ETL Fansy и что пишет сама система, роли, миграции, полезные запросы - /admin/help/lk-api — REST-контракт ESIA Finance V1: аутентификация, POST/GET/PATCH/list, формат callback'ов и ошибок, эмулятор для тестов, примеры curl - /admin/help/cryptopro — установка КриптоПро CSP на РЕД ОС и Ubuntu, ввод серийного номера лицензии (cpconfig), путь к PKCS#11 модулю libcppkcs11.so, подключение Рутокен ЭЦП 2.0 для подписи оператора, тестирование подписи через csptest и cryptcp - /admin/help/systems — Интеграционный шлюз НРД (профили guest/test3/prod), команда Fansy (порядок согласования контракта), уведомления (SMTP/Yandex Messenger/Telegram), контакты команд Русификация статусов: - Добавлены template-функции ruState и ruOutcome (в lkgateway и lkemulator) - "draft" → "Черновик", "confirmed" → "Подтверждена", "rejected" → "Отклонена" и т.д. - CSS-классы бейджей сохраняются (по исходному state), меняется только отображаемый текст. Технические термины (PostgreSQL, ИНН, GUID, REST) остаются как есть — они являются именами программного обеспечения. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
462 lines
13 KiB
Go
462 lines
13 KiB
Go
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
|
|
}
|
|
|
|
// templateFuncs — функции, доступные внутри шаблонов эмулятора
|
|
// (русификация статусов).
|
|
var templateFuncs = template.FuncMap{
|
|
"ruState": ruState,
|
|
}
|
|
|
|
// ruState — те же значения, что и в lkgateway.russianState. Дублирование
|
|
// допустимое: lkemulator — отдельный пакет и не зависит от lkgateway.
|
|
func ruState(s string) string {
|
|
switch s {
|
|
case "draft":
|
|
return "Черновик"
|
|
case "validated":
|
|
return "Валидирована"
|
|
case "submitted_to_nsd":
|
|
return "Отправлена в НРД"
|
|
case "awaiting_decision":
|
|
return "Ожидает решение"
|
|
case "confirmed":
|
|
return "Подтверждена"
|
|
case "awaiting_sub16":
|
|
return "Ожидает SUB16"
|
|
case "done":
|
|
return "Завершена"
|
|
case "rejected":
|
|
return "Отклонена"
|
|
case "timed_out":
|
|
return "Таймаут SLA"
|
|
case "manual_approval":
|
|
return "На ручном разборе"
|
|
}
|
|
return s
|
|
}
|
|
|
|
// NewServer собирает Server.
|
|
func NewServer(cfg ServerConfig) (*Server, error) {
|
|
parse := func(content string) (*template.Template, error) {
|
|
return template.New("layout.html").Funcs(templateFuncs).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 ""
|
|
}
|