cloud-ip-validator/internal/dashboard/dto.go

package dashboard

import (
	"strconv"
	"time"
)

// Wire shapes for control-api's /api/v1/admin/* surface, defined locally
// rather than importing internal/httpapi's (unexported) DTOs or
// internal/db's models — the same "each binary owns the wire shapes it
// needs" pattern already used by internal/probercore and internal/agentcore.
//
// The read-only list/detail endpoints (ipQueueItem, validator, check,
// event below) mirror internal/db model structs field-for-field: those
// endpoints marshal Go structs with no json tags, so encoding/json matches
// fields by name (case-insensitively) with no tags needed here either.
// Everything else mirrors internal/httpapi/dto_admin.go's snake_case tags.

type statusResponse struct {
	TotalIPs        int            `json:"total_ips"`
	IPsByState      map[string]int `json:"ips_by_state"`
	TotalValidators int            `json:"total_validators"`
}

type ipQueueItem struct {
	ID               int64
	IPAddress        string
	Sequence         int
	State            string
	OwnerValidatorID *string
	FIPID            string
	AttemptNumber    int
	RetryCount       int
	LeaseExpiresAt   *time.Time
	EgressComplete   bool
	OverallResult    string
	AssignedAt       *time.Time
	FIPAssociatedAt  *time.Time
	AggregatedAt     *time.Time
	FIPReleasedAt    *time.Time
	CreatedAt        time.Time
	UpdatedAt        time.Time
}

type check struct {
	ID            int64
	RegistryID    int64
	CycleID       int
	IPID          int64
	IPAddress     string
	AttemptNumber int
	ValidatorID   string
	Source        string
	CheckType     string
	Target        string
	Success       bool
	LatencyMS     int64
	Detail        string
	CheckedAt     time.Time
}

type event struct {
	ID         int64
	SourceType string
	SourceID   string
	IPID       *int64
	EventType  string
	Payload    string
	OccurredAt time.Time
}

type ipDetailResponse struct {
	IP     ipQueueItem `json:"ip"`
	Checks []check     `json:"checks"`
	Events []event     `json:"events"`
}

type validator struct {
	ValidatorID     string
	Hostname        string
	OSPortID        string
	State           string
	CurrentIPID     *int64
	AgentVersion    string
	LastHeartbeatAt *time.Time
}

type submitIPsResponse struct {
	Added             []string `json:"added"`
	Requeued          []string `json:"requeued"`
	Reordered         []string `json:"reordered"`
	SkippedInProgress []string `json:"skipped_in_progress"`
}

type deleteIPsResponse struct {
	Deleted  []string `json:"deleted"`
	NotFound []string `json:"not_found"`
}

type clearQueueResponse struct {
	Deleted []string `json:"deleted"`
}

type scanIPsResponse struct {
	ScannedFree       int      `json:"scanned_free"`
	Added             []string `json:"added"`
	Requeued          []string `json:"requeued"`
	Reordered         []string `json:"reordered"`
	SkippedInProgress []string `json:"skipped_in_progress"`
}

// registryItem is one row of the durable per-address registry — see
// httpapi's registryDTO. Survives an address being deleted from the check
// queue and later re-added, unlike ipQueueItem above.
type registryItem struct {
	IPAddress     string     `json:"ip_address"`
	FirstSeenAt   time.Time  `json:"first_seen_at"`
	LastSeenAt    time.Time  `json:"last_seen_at"`
	TotalCycles   int        `json:"total_cycles"`
	LastResult    string     `json:"last_result"`
	LastCheckedAt *time.Time `json:"last_checked_at"`
	InQueue       bool       `json:"in_queue"`
	CurrentState  string     `json:"current_state"`
}

type registryHistoryResponse struct {
	Registry registryItem `json:"registry"`
	Checks   []check      `json:"checks"`
}

type validatorDTO struct {
	ValidatorID     string     `json:"validator_id"`
	Hostname        string     `json:"hostname"`
	OSPortID        string     `json:"os_port_id"`
	State           string     `json:"state"`
	LastHeartbeatAt *time.Time `json:"last_heartbeat_at"`
}

type siteDTO struct {
	Index           int        `json:"index"`
	SiteID          string     `json:"site_id"`
	Hostname        string     `json:"hostname"`
	State           string     `json:"state"`
	LastHeartbeatAt *time.Time `json:"last_heartbeat_at"`
}

type targetGroupDTO struct {
	Name    string   `json:"name"`
	Targets []string `json:"targets"`
}

type checkTypeDTO struct {
	Name    string   `json:"name"`
	Enabled bool     `json:"enabled"`
	Targets []string `json:"targets"`
}

type errorResponse struct {
	Error string `json:"error"`
}

type orchestratorSettingsDTO struct {
	FIPSettleSeconds       int `json:"fip_settle_seconds"`
	HistoryRetentionCycles int `json:"history_retention_cycles"`
}

type inboundChecksDTO struct {
	Ports []int `json:"ports"`
	ICMP  bool  `json:"icmp"`
}

// autoCycleDTO mirrors internal/httpapi's autoCycleDTO — the status and
// parameters of the automatic check cycle (/api/v1/admin/auto-cycle).
type autoCycleDTO struct {
	Enabled           bool       `json:"enabled"`
	IntervalSeconds   int        `json:"interval_seconds"`
	MaxRunSeconds     int        `json:"max_run_seconds"`
	Phase             string     `json:"phase"`
	RunStartedAt      *time.Time `json:"run_started_at"`
	NextRunAt         *time.Time `json:"next_run_at"`
	LastRunStartedAt  *time.Time `json:"last_run_started_at"`
	LastRunFinishedAt *time.Time `json:"last_run_finished_at"`
	LastOutcome       string     `json:"last_outcome"`
	LastError         string     `json:"last_error"`
	LastScannedFree   int        `json:"last_scanned_free"`
	RunsTotal         int        `json:"runs_total"`
}

// secondsToMinutes renders seconds as minutes for the settings form: a
// whole number when divisible by 60, otherwise a decimal ("1.5").
func secondsToMinutes(sec int) string {
	return strconv.FormatFloat(float64(sec)/60, 'f', -1, 64)
}

// IntervalMinutes and MaxRunMinutes are used by the settings template: the
// UI works in minutes, the API in seconds.
func (a autoCycleDTO) IntervalMinutes() string { return secondsToMinutes(a.IntervalSeconds) }
func (a autoCycleDTO) MaxRunMinutes() string   { return secondsToMinutes(a.MaxRunSeconds) }

// PhaseLabel is the Russian description of the current phase.
func (a autoCycleDTO) PhaseLabel() string {
	switch a.Phase {
	case "running":
		return "идёт проверка"
	case "waiting":
		return "пауза между циклами"
	case "idle":
		return "ожидает запуска"
	default:
		return a.Phase
	}
}

// OutcomeLabel is the Russian description of the last cycle's outcome.
func (a autoCycleDTO) OutcomeLabel() string {
	switch a.LastOutcome {
	case "completed":
		return "завершён"
	case "no_free_ips":
		return "нет свободных IP"
	case "timeout":
		return "превышено время ожидания"
	case "error":
		return "ошибка"
	case "stopped":
		return "остановлен"
	case "":
		return "—"
	default:
		return a.LastOutcome
	}
}

// OutcomePillClass picks the pill style for the last outcome.
func (a autoCycleDTO) OutcomePillClass() string {
	switch a.LastOutcome {
	case "completed":
		return "pill-success"
	case "no_free_ips", "timeout", "stopped":
		return "pill-warning"
	case "error":
		return "pill-danger"
	default:
		return "pill-neutral"
	}
}