Bridge-and-Join-s/internal/m2mcore/deal.go

package m2mcore

import (
	"context"
	"fmt"
	"sync"
	"time"

	"git.zetit.ru/zuevav/Bridge-and-Join-s/internal/m2m"
)

// StageRecord — запись о входе в состояние FSM, для аудита и метрик.
type StageRecord struct {
	State     State
	EnteredAt time.Time
	LeftAt    *time.Time
	Reason    string
}

// Event — доменное событие сделки (event sourcing для аудита).
type Event struct {
	Type      string
	Payload   any
	CreatedAt time.Time
	Actor     string
}

// Deal — корневая агрегатная сущность M2M-сделки.
type Deal struct {
	ID          string
	GUID        m2m.UUID
	State       State
	InvestorID  string
	SignedClaim []byte
	Request     *m2m.M2MTransferRequest
	Response    *m2m.M2MTransferResponse
	RawResponse []byte // точные байты ответа МОСТ от НРД (для пересылки в ТП)
	Decision    *m2m.M2MTransferDecision
	CreatedAt   time.Time
	UpdatedAt   time.Time
	Stages      []StageRecord

	mu     sync.Mutex
	events []Event
}

// NewDeal создаёт новую сделку в состоянии Draft.
func NewDeal(guid m2m.UUID, investorID string, signedClaim []byte) (*Deal, error) {
	if err := guid.Validate(); err != nil {
		return nil, fmt.Errorf("m2mcore: невалидный GUID при создании Deal: %w", err)
	}
	id, err := NewUUIDv4()
	if err != nil {
		return nil, err
	}
	now := time.Now().UTC()
	return &Deal{
		ID:          id,
		GUID:        guid,
		State:       StateDraft,
		InvestorID:  investorID,
		SignedClaim: signedClaim,
		CreatedAt:   now,
		UpdatedAt:   now,
		Stages:      []StageRecord{{State: StateDraft, EnteredAt: now}},
	}, nil
}

// Events возвращает накопленные события (копия слайса).
func (d *Deal) Events() []Event {
	d.mu.Lock()
	defer d.mu.Unlock()
	out := make([]Event, len(d.events))
	copy(out, d.events)
	return out
}

// recordEvent добавляет событие в журнал сделки.
func (d *Deal) recordEvent(eventType string, payload any, actor string) {
	d.events = append(d.events, Event{
		Type: eventType, Payload: payload,
		CreatedAt: time.Now().UTC(), Actor: actor,
	})
}

// shiftTo переводит FSM в новое состояние, фиксируя историю.
// Должен вызываться под d.mu.Lock.
func (d *Deal) shiftTo(next State, reason string) error {
	if err := transition(d.State, next); err != nil {
		return err
	}
	now := time.Now().UTC()
	if i := len(d.Stages) - 1; i >= 0 {
		d.Stages[i].LeftAt = &now
	}
	d.Stages = append(d.Stages, StageRecord{State: next, EnteredAt: now, Reason: reason})
	d.State = next
	d.UpdatedAt = now
	return nil
}

// Validate переводит Draft -> Validated и фиксирует событие.
// Сама валидация Request делается m2m.M2MTransferRequest.Validate(),
// которое следует вызвать перед этим методом.
func (d *Deal) Validate(_ context.Context, request *m2m.M2MTransferRequest) error {
	d.mu.Lock()
	defer d.mu.Unlock()
	if request == nil {
		return fmt.Errorf("m2mcore: Deal.Validate: request=nil")
	}
	if err := request.Validate(); err != nil {
		return fmt.Errorf("m2mcore: M2MTransferRequest.Validate: %w", err)
	}
	d.Request = request
	if err := d.shiftTo(StateValidated, ""); err != nil {
		return err
	}
	d.recordEvent("validated", request.Header.GUID, "system")
	return nil
}

// Submit переводит Validated -> SubmittedToNSD после успешной отправки.
func (d *Deal) Submit(_ context.Context) error {
	d.mu.Lock()
	defer d.mu.Unlock()
	if err := d.shiftTo(StateSubmittedToNSD, ""); err != nil {
		return err
	}
	d.recordEvent("submitted_to_nsd", nil, "system")
	if err := d.shiftTo(StateAwaitingDecision, ""); err != nil {
		return err
	}
	d.recordEvent("awaiting_decision", nil, "system")
	return nil
}

// ReceiveDecision принимает M2MTransferDecision от принимающей стороны и
// меняет состояние на Confirmed или Rejected в зависимости от содержимого.
func (d *Deal) ReceiveDecision(_ context.Context, decision *m2m.M2MTransferDecision) error {
	d.mu.Lock()
	defer d.mu.Unlock()
	if decision == nil {
		return fmt.Errorf("m2mcore: ReceiveDecision: decision=nil")
	}
	if err := decision.Validate(); err != nil {
		return fmt.Errorf("m2mcore: M2MTransferDecision.Validate: %w", err)
	}
	d.Decision = decision

	// Если все Security содержат Confirmation — Confirmed; если хотя бы
	// одна Rejection — Rejected. Смешанные сценарии XSD НРД не запрещает,
	// но на нашей стороне их трактуем как Rejected (требует ручного разбора).
	rejected := false
	for _, s := range decision.Data.Securities {
		if s.TransferDecision.Rejection != nil {
			rejected = true
			break
		}
	}
	target := StateConfirmed
	reason := ""
	if rejected {
		target = StateRejected
		reason = "decision_contains_rejection"
	}
	if err := d.shiftTo(target, reason); err != nil {
		return err
	}
	d.recordEvent("decision_received", decision.Header.GUID, "nsd")
	return nil
}

// ReceiveServiceResponse принимает M2MTransferResponse — ответ сервиса МОСТ
// (НРД), а не контрагента. Это сервисный уровень: подтверждение приёма в
// обработку (StatusCode=INFO) либо отказ сервиса (StatusCode=ERROR, код
// M2Mxx — напр. M2M14 «код отправителя отсутствует в справочнике M2M»).
//
//   - INFO  — заявка принята МОСТ в обработку; состояние не меняем, ждём
//     M2MTransferDecision контрагента. Сохраняем ответ для отображения.
//   - ERROR — сервис отклонил заявку до контрагента; Decision уже не придёт,
//     переводим сделку в Rejected. Сохраняем ответ, чтобы в карточке был
//     виден код и текст отказа НРД.
// raw — точные байты ответа (unpacked doc.xml от НРД); сохраняются как есть
// для дословной пересылки в техподдержку НРД. Может быть nil (mock-режим).
func (d *Deal) ReceiveServiceResponse(_ context.Context, resp *m2m.M2MTransferResponse, raw []byte) error {
	d.mu.Lock()
	defer d.mu.Unlock()
	if resp == nil {
		return fmt.Errorf("m2mcore: ReceiveServiceResponse: resp=nil")
	}
	d.Response = resp
	if len(raw) > 0 {
		d.RawResponse = raw
	}
	d.UpdatedAt = time.Now().UTC()

	if resp.StatusCode != m2m.StatusError {
		// INFO/приём в обработку — фиксируем, но не двигаем FSM.
		d.recordEvent("service_ack", responsePayload(resp), "nsd")
		return nil
	}

	// ERROR — отказ сервиса МОСТ. Если сделка уже в терминальном состоянии,
	// повторный ответ игнорируем (идемпотентность поллера).
	if IsTerminal(d.State) {
		d.recordEvent("service_error_ignored_terminal", responsePayload(resp), "nsd")
		return nil
	}
	if err := d.shiftTo(StateRejected, "service_error:"+firstCode(resp)); err != nil {
		return err
	}
	d.recordEvent("service_error", responsePayload(resp), "nsd")
	return nil
}

// responsePayload сворачивает M2MTransferResponse в компактную запись для
// журнала событий (коды + тексты ответов сервиса).
func responsePayload(resp *m2m.M2MTransferResponse) map[string]any {
	codes := make([]map[string]string, 0, len(resp.Responses))
	for _, r := range resp.Responses {
		codes = append(codes, map[string]string{"code": r.Code, "text": r.Text})
	}
	return map[string]any{
		"status": string(resp.StatusCode),
		"guid":   string(resp.GUID),
		"codes":  codes,
	}
}

// firstCode возвращает первый код ответа (для reason перехода).
func firstCode(resp *m2m.M2MTransferResponse) string {
	if len(resp.Responses) > 0 {
		return resp.Responses[0].Code
	}
	return "unknown"
}

// Timeout переводит сделку в TimedOut (когда не дождались Decision).
func (d *Deal) Timeout(_ context.Context) error {
	d.mu.Lock()
	defer d.mu.Unlock()
	if err := d.shiftTo(StateTimedOut, "no_decision_within_sla"); err != nil {
		return err
	}
	d.recordEvent("timed_out", nil, "system")
	return nil
}

// SendToManualApproval переводит на ручной разбор оператора.
func (d *Deal) SendToManualApproval(_ context.Context, reason string) error {
	d.mu.Lock()
	defer d.mu.Unlock()
	if err := d.shiftTo(StateManualApproval, reason); err != nil {
		return err
	}
	d.recordEvent("manual_approval_requested", reason, "system")
	return nil
}

// ApproveManually вручную подтверждает сделку (с операторской подписью).
func (d *Deal) ApproveManually(_ context.Context, operator string) error {
	d.mu.Lock()
	defer d.mu.Unlock()
	if err := d.shiftTo(StateConfirmed, "manual_approve"); err != nil {
		return err
	}
	d.recordEvent("manual_approve", nil, operator)
	return nil
}

// RejectManually вручную отказывает в сделке.
func (d *Deal) RejectManually(_ context.Context, operator, code, comment string) error {
	d.mu.Lock()
	defer d.mu.Unlock()
	if err := d.shiftTo(StateRejected, "manual_reject:"+code); err != nil {
		return err
	}
	d.recordEvent("manual_reject", map[string]string{"code": code, "comment": comment}, operator)
	return nil
}

// CompleteSUB16 фиксирует получение SUB16 от НРД и переводит Confirmed
// -> AwaitingSUB16 -> Done. Может вызываться один раз.
func (d *Deal) CompleteSUB16(_ context.Context) error {
	d.mu.Lock()
	defer d.mu.Unlock()
	if d.State == StateConfirmed {
		if err := d.shiftTo(StateAwaitingSUB16, ""); err != nil {
			return err
		}
		d.recordEvent("awaiting_sub16", nil, "nsd")
	}
	if err := d.shiftTo(StateDone, ""); err != nil {
		return err
	}
	d.recordEvent("done", nil, "nsd")
	return nil
}