domain

type AccessDomainTLSConfig struct {
	Enabled         bool   `json:"enabled"`
	SecretName      string `json:"secret_name,omitempty"`
	SecretNamespace string `json:"secret_namespace,omitempty"`
	IssuerName      string `json:"issuer_name,omitempty"`
}

type ArchImageSource struct {
	// Archs 는 이 출처의 이미지가 내는 아키텍처다. 한 벌의 이미지가 모든 노드에
	// 깔리므로, 이 출처를 쓰려면 클러스터의 노드 아키텍처를 전부 덮어야 한다.
	Archs []string
	// Registry 는 컴포넌트 이미지 이름 앞에 붙는 저장소 경로다.
	// 컴포넌트 이름(harbor-core 등)은 차트를 아는 설치 어댑터가 붙인다.
	Registry string
	Tag      string
	// Reference 는 이미지를 만드는 저장소다. 설치 로그에 출처로 남긴다.
	Reference string
}

type ArtifactsConfig struct {
	PackageRegistry   ToolSelection `json:"package_registry"`
	SourceRepository  ToolSelection `json:"source_repository"`
	ContainerRegistry ToolSelection `json:"container_registry"`
	StorageBackend    ToolSelection `json:"storage_backend"`
}

type AuthenticationConfig struct {
	Provider string `json:"provider,omitempty"`
}

type CVEFinding struct {
	ID string
	// Packages 는 "패키지 설치버전 → 수정버전" 이다.
	Packages []string
	Images   []string
	// Exposed 는 그 CVE 가 든 이미지 중 하나라도 클러스터 밖에 열려 있는지다.
	Exposed bool
	Hosts   []string
}

type CompatibilityMatrix struct {
	ID         string
	Name       string
	Status     string // verified | untested | unsupported
	Kubernetes KubernetesCompat
	Tools      map[string]ToolVersion
}

type ConfigDiff struct {
	Field    string
	OldValue string
	NewValue string
}

type ConnectionInfo struct {
	StackID       string            `json:"stack_id"`
	Namespace     string            `json:"namespace"`
	AccessDomain  string            `json:"access_domain,omitempty"`
	Database      StorageConnection `json:"database"`
	ObjectStorage StorageConnection `json:"object_storage"`
	Tools         []ToolCredential  `json:"tools"`
}

type DeploymentState string

type GatewayBackend struct {
	Service string
	Port    int
}

type HelmStepMetadata struct {
	StepName    string    `json:"step_name"`
	ReleaseName string    `json:"release_name,omitempty"`
	ChartName   string    `json:"chart_name"`
	RepoURL     string    `json:"repo_url,omitempty"`
	Version     string    `json:"version,omitempty"`
	Namespace   string    `json:"namespace,omitempty"`
	Phase       string    `json:"phase,omitempty"`
	SortOrder   int       `json:"sort_order"`
	Wait        bool      `json:"wait"`
	IsEnabled   bool      `json:"is_enabled"`
	CreatedAt   time.Time `json:"created_at"`
	UpdatedAt   time.Time `json:"updated_at"`
}

type ImageScanSkipReason string

type ImageScanState string

type ImageScanStatus string

type ImageSourceResolution struct {
	// Source 가 nil 이면 공식 이미지를 그대로 쓴다.
	Source *ArchImageSource
	// Unsupported 는 어느 이미지로도 뜰 수 없는 노드 아키텍처다.
	Unsupported []string
}

type KubernetesCompat struct {
	Min         string
	Max         string
	Recommended string
}

type LoggingConfig struct {
	Collection ToolSelection `json:"collection"`
	Search     ToolSelection `json:"search"`
	TraceLayer ToolSelection `json:"trace_layer,omitempty"`
	// TraceExporter 는 애플리케이션이 보낸 텔레메트리를 받아 각 백엔드로
	// 흘려보내는 수집기다 (OpenTelemetry Collector).
	//
	// TraceLayer 와 칸을 따로 두는 이유는 역할이 다르기 때문이다 — TraceLayer 는
	// 추적을 저장·조회하는 백엔드(Tempo/Jaeger)이고, 이쪽은 그 앞에 서서 OTLP 를
	// 받아 추적·메트릭·로그를 각각의 저장소로 나눠 보낸다. 한 칸에 묶으면 둘 중
	// 하나만 설치할 수 있어 "수집기를 통해 관측한다"는 구성 자체가 불가능해진다.
	//
	// 프론트는 이전부터 이 값을 배포 요청에 실어 보냈으나 여기에 받는 칸이 없어
	// 조용히 버려졌다 — 설치 마법사의 Exporter/Agent 선택이 아무 일도 하지 않았다.
	TraceExporter ToolSelection `json:"trace_exporter,omitempty"`
}

type MonitoringConfig struct {
	Collection    ToolSelection `json:"collection"`
	Visualization ToolSelection `json:"visualization"`
}

type NewUpgradeBundleInput struct {
	// ID 를 비우면 <도구>-<출발 차트>-<대상 차트> 다.
	ID                     string
	Tool                   string
	ReleaseName            string
	ChartName              string
	RepoURL                string
	SourceChartVersion     string
	SourceAppVersion       string
	TargetChartVersion     string
	TargetAppVersion       string
	RiskLevel              string
	ExpectedDisruption     string
	ReleaseNotes           string
	RequiresBackup         bool
	SupportedArchitectures []string
	FixesCVEs              []string
	// Status 는 draft 또는 verified 다. 비우면 draft.
	Status string
	// RehearsalConfirmed 는 운영자가 "이 경로를 실클러스터에서 리허설했다" 고 확인한 것이다.
	// verified 는 이것 없이 만들 수 없다.
	RehearsalConfirmed bool
	Now                time.Time
}

type NewUpgradeRunInput struct {
	ID, StackID        string
	Bundle             UpgradeBundle
	SourceChartVersion string
	PreviousRevision   int
	RequestedBy        string
	Reason             string
	IdempotencyKey     string
	Checks             []UpgradeCheck
	Now                time.Time
}

type ObjectStorageBackend struct {
	// Tool 은 카탈로그 이름을 정규화한 값이다. storage_backend 선택과 맞춰 본다.
	Tool string
	// DisplayName 은 화면·로그에 쓰는 이름이다.
	DisplayName string
	// Step 은 이 구현체를 세우는 설치 단계다.
	Step string
	// ReleaseName 은 Helm 릴리스명이다. 파드 이름 접두사이기도 하다.
	ReleaseName string
	// ServiceName / ServicePort 는 S3 API 가 서는 클러스터 내부 주소다.
	ServiceName string
	ServicePort int

	// CredentialSecret 은 provisioning_secrets 가 금고에서 옮겨 오는 자격 Secret 이다.
	// 차트가 existingSecret 으로 읽으므로 키 이름은 차트가 정한다.
	CredentialSecret string
	AccessKeyKey     string
	SecretKeyKey     string

	// VaultAccessKeyPath / VaultSecretKeyPath 는 스택 금고 접두사 뒤의 경로다.
	// 자격의 원천이다 — GitLab 의 연결 Secret 도 같은 경로에서 만든다.
	VaultAccessKeyPath string
	VaultSecretKeyPath string
}

type OrgStackImageScan struct {
	Stack  *Stack
	Report StackImageScanReport
}

type PipelineConfig struct {
	CIPlatform ToolSelection `json:"ci_platform"`
	CDTool     ToolSelection `json:"cd_tool"`
}

type PlanningOptionDef struct {
	Key      string
	Baseline float64
	Min      float64
	Max      float64
	Weight   float64
	Impact   ResourceImpact
}

type PlanningRowUnit struct {
	Memory  string `json:"memory"`
	Storage string `json:"storage"`
}

type ProtectedValueKind string

type ProtectedValueViolation struct {
	Path    string             `json:"path"`
	Kind    ProtectedValueKind `json:"kind"`
	Message string             `json:"message"`
}

type ResourceDefault struct {
	ToolKey          string    `json:"tool_key"`
	DisplayName      string    `json:"display_name"`
	CPURequest       float64   `json:"cpu_request"`
	CPULimit         float64   `json:"cpu_limit"`
	MemoryRequestGi  float64   `json:"memory_request_gi"`
	MemoryLimitGi    float64   `json:"memory_limit_gi"`
	StorageRequestGi float64   `json:"storage_request_gi"`
	StorageLimitGi   float64   `json:"storage_limit_gi"`
	IsDefault        bool      `json:"is_default"`
	UpdatedAt        time.Time `json:"updated_at"`
}

type ResourceEstimate struct {
	CPUCores       float64 `json:"cpu_cores"`
	MemoryGi       float64 `json:"memory_gi"`
	StorageGi      float64 `json:"storage_gi"`
	MonthlyCostUSD float64 `json:"monthly_cost_usd"`
}

type ResourceImpact struct {
	CPU     float64
	Memory  float64
	Storage float64
}

type ResourceMultipliers struct {
	CPU     float64
	Memory  float64
	Storage float64

	RawCPU     float64
	RawMemory  float64
	RawStorage float64

	ClampedCPU     bool
	ClampedMemory  bool
	ClampedStorage bool
}

type ResourceVector struct {
	CPURequest       float64 `json:"cpuRequest"`
	CPULimit         float64 `json:"cpuLimit"`
	MemoryRequestGi  float64 `json:"memoryRequestGi"`
	MemoryLimitGi    float64 `json:"memoryLimitGi"`
	StorageRequestGi float64 `json:"storageRequestGi"`
	StorageLimitGi   float64 `json:"storageLimitGi"`
}

type ResourcesConfig struct {
	DevCount          int              `json:"developers"`
	ConcurrentRunners int              `json:"concurrent_runners"`
	CommitsPerWeek    int              `json:"weekly_commits"`
	BuildFrequency    string           `json:"build_frequency"` // low/medium/high or hourly/daily/on-push
	Calculated        ResourceEstimate `json:"calculated,omitempty"`
}

type SecurityConfig struct {
	ImageScanner ToolSelection `json:"image_scanner,omitempty"`
	// SAST 는 소스 정적 분석 서버다(SonarQube Community). 이미지 스캐너와 같은
	// 선택 슬롯이다 — 고르지 않으면 설치되지 않고, 그 스택의 파이프라인은 SAST
	// 단계를 켤 수 없다.
	SAST ToolSelection `json:"sast,omitempty"`
	// SCA 는 서드파티 의존성 취약점 스캔이다(nullus-plan#79). 선택지는 Trivy 하나고 따로 설치하는
	// 것이 없다 — 파이프라인의 의존성 스캔 단계가 스택의 Trivy 서버에 붙는다. 그래서 이것만 골라도
	// Trivy 서버가 선다(HasTrivyServer). 고르지 않으면 그 스택의 파이프라인에 단계가 없다.
	SCA ToolSelection `json:"sca,omitempty"`
}

type SharedComponent struct {
	Release   string
	Namespace string
}

type SourceControlConfig struct {
	// Owner 는 리포지토리가 만들어질 GitHub Organization 또는 사용자 계정이다.
	Owner string `json:"owner,omitempty"`
	// APIBaseURL 은 GitHub Enterprise Server 의 API 주소다.
	// 비면 github.com 을 쓴다.
	APIBaseURL string `json:"api_base_url,omitempty"`
}

type Stack struct {
	ID                string          `json:"id"`
	Name              string          `json:"name"`
	TemplateID        string          `json:"template_id"`
	OrgID             string          `json:"org_id"`
	ClusterID         string          `json:"cluster_id"`
	Namespace         string          `json:"namespace"`
	Tools             []ToolConfig    `json:"tools,omitempty"`
	State             DeploymentState `json:"state"`
	Config            interface{}     `json:"config"` // JSONB
	CurrentStep       string          `json:"current_step,omitempty"`
	LastCompletedStep string          `json:"last_completed_step,omitempty"`
	LastFailedStep    string          `json:"last_failed_step,omitempty"`
	LastFailureReason string          `json:"last_failure_reason,omitempty"`
	CreatedAt         time.Time       `json:"created_at"`
	UpdatedAt         time.Time       `json:"updated_at"`
	DeletedAt         *time.Time      `json:"deleted_at,omitempty"`
}

type StackConfig struct {
	AccessDomain             string                        `json:"access_domain,omitempty"`
	AccessDomainTLS          *AccessDomainTLSConfig        `json:"access_domain_tls,omitempty"`
	Authentication           *AuthenticationConfig         `json:"authentication,omitempty"`
	YAMLOverrides            map[string]string             `json:"yaml_overrides,omitempty"`
	Artifacts                ArtifactsConfig               `json:"artifacts"`
	Pipeline                 PipelineConfig                `json:"pipeline"`
	Monitoring               MonitoringConfig              `json:"monitoring"`
	Logging                  LoggingConfig                 `json:"logging"`
	Security                 SecurityConfig                `json:"security"`
	Resources                ResourcesConfig               `json:"resources"`
	OptionOverrides          map[string]map[string]float64 `json:"option_overrides,omitempty"`
	AppliedResourceOverrides map[string]ResourceVector     `json:"applied_resource_overrides,omitempty"`
	RowUnits                 map[string]PlanningRowUnit    `json:"row_units,omitempty"`
	Storage                  *StorageConfig                `json:"storage,omitempty"`
	SourceControl            *SourceControlConfig          `json:"source_control,omitempty"`
}

type StackImageScan struct {
	StackID string
	// Image 는 파드 스펙에 적힌 표기(태그)다. 사람이 읽는 이름이다.
	Image string
	// ImageDigest 에 결과를 붙인다 — 태그는 움직인다.
	ImageDigest string
	Release     string
	Workloads   []string
	// Namespace 는 이미지를 돌리는 파드의 네임스페이스다. Shared 는 그것이 스택 네임스페이스 밖의
	// 클러스터 공용 구성요소(cert-manager 등)라는 뜻이다.
	Namespace string
	Shared    bool
	// Exposed 는 이 이미지를 쓰는 파드가 게이트웨이(HTTPRoute)로 클러스터 밖에 열려 있는지다.
	// ExposedHosts 는 그 HTTPRoute 의 호스트 이름이다(호스트를 적지 않은 경로면 비어 있다).
	// 같은 CVE 라도 밖에서 닿는 서비스의 것을 먼저 고친다(설치 OSS CVE 대응 정책).
	Exposed      bool
	ExposedHosts []string

	Status ImageScanStatus
	Error  string

	// Counts 는 모든 취약점, FixableCounts 는 수정본이 있는 것만 센 값이다.
	// 스캔하지 못한 이미지는 nil 이다 — 0 으로 채우면 "취약점 0건" 으로 읽힌다.
	Counts        *shareddomain.SeverityCounts
	FixableCounts *shareddomain.SeverityCounts

	ScannerVersion string
	DBUpdatedAt    *time.Time
	ScannedAt      time.Time

	// Vulnerabilities 는 취약점 목록이다. VulnerabilitiesRecorded 가 거짓이면 목록을
	// 모른다(스캔 실패, 목록 기능 전 스캔) — 빈 목록과 다르다.
	Vulnerabilities         []shareddomain.ImageVulnerability
	VulnerabilitiesRecorded bool
}

type StackImageScanReport struct {
	StackID string
	Status  ImageScanState
	Reason  ImageScanSkipReason
	// Airgap 은 에어갭 설치의 결과라는 뜻이다. 취약점 DB 가 번들을 반입한 날짜 기준이다.
	Airgap        bool
	LastScannedAt *time.Time
	// Summary 는 스캔에 성공한 이미지의 건수 합이다.
	Summary *shareddomain.SeverityCounts
	Items   []StackImageScan
}

type StackImageVulnerabilities struct {
	// Found 는 그 이미지의 스캔 결과가 있는지다.
	Found bool
	// Recorded 는 목록을 저장했는지다. 거짓이면 Items 가 비어도 0건이 아니다.
	Recorded bool
	Items    []shareddomain.ImageVulnerability
}

type StackVersion struct {
	ID           string
	StackID      string
	Version      int
	Config       StackConfig
	ChangedBy    string
	ChangeReason string
	CreatedAt    time.Time
}

type StorageConfig struct {
	PlanMode      string        `json:"plan_mode"`
	Database      StorageTarget `json:"database"`
	ObjectStorage StorageTarget `json:"object_storage"`
	// StorageClass is the Kubernetes StorageClass used by every PVC the stack
	// creates. Empty means "use the cluster default StorageClass"; installs on
	// clusters without a default SC must set it explicitly or PVCs stay Pending.
	StorageClass string `json:"storage_class,omitempty"`
}

type StorageConnection struct {
	Mode     string `json:"mode"`
	Engine   string `json:"engine"`
	Endpoint string `json:"endpoint"`
	// ResourceName 은 데이터베이스명 또는 버킷명이다.
	ResourceName string `json:"resource_name"`
	AuthID       string `json:"auth_id"`
	// SecretRef / SecretKey 는 비밀번호가 담긴 Secret 과 그 키다.
	SecretRef string `json:"secret_ref,omitempty"`
	SecretKey string `json:"secret_key,omitempty"`
}

type StorageTarget struct {
	Mode             string  `json:"mode"`
	ExistingRef      string  `json:"existing_ref,omitempty"`
	Endpoint         string  `json:"endpoint,omitempty"`
	ResourceName     string  `json:"resource_name,omitempty"`
	AccessSecretRef  string  `json:"access_secret_ref,omitempty"`
	AuthID           string  `json:"auth_id,omitempty"`
	AuthPasswordKey  string  `json:"auth_password_key,omitempty"`
	ProviderOrEngine string  `json:"provider_or_engine,omitempty"`
	Version          string  `json:"version,omitempty"`
	Size             float64 `json:"size,omitempty"`
}

type Template struct {
	ID                   string        `json:"id"`
	Name                 string        `json:"name"`
	Description          string        `json:"description"`
	Tools                []ToolConfig  `json:"tools"`
	EstimatedInstallTime time.Duration `json:"estimated_install_time"`
	RecommendedUseCase   string        `json:"recommended_use_case"`
	MinResources         string        `json:"min_resources"`
	PlanningProfile      string        `json:"planning_profile,omitempty"`
	CreatedBy            string        `json:"created_by,omitempty"`
}

type ToolConfig struct {
	Category    string `json:"category"`
	Name        string `json:"name"`
	HelmVersion string `json:"helm_version"`
	AppVersion  string `json:"app_version"`
	Tool        string `json:"tool,omitempty"`
	Version     string `json:"version,omitempty"`
}

type ToolCredential struct {
	Name      string `json:"name"`
	Username  string `json:"username,omitempty"`
	SecretRef string `json:"secret_ref,omitempty"`
	SecretKey string `json:"secret_key,omitempty"`
	Note      string `json:"note,omitempty"`
}

type ToolImageProfile struct {
	// Tool 은 호환성 매트릭스의 도구 이름이다.
	Tool string
	// Step 은 이 도구를 설치하는 단계다.
	Step string
	// NativeArchs 는 공식 이미지가 내는 아키텍처다.
	NativeArchs []string
	// Sources 는 공식 이미지가 못 덮는 클러스터에 쓸 대체 출처다. 앞의 것이 먼저다.
	Sources []ArchImageSource
}

type ToolSelection struct {
	Name    string `json:"name"`
	Version string `json:"version"`
	Enabled bool   `json:"enabled"`
}

type ToolVersion struct {
	Name          string
	HelmVersion   string
	AppVersion    string
	MinK8sVersion string
	ArchSupport   []string
	Tier          string
}

type ToolWorkload struct {
	Key          string
	Name         string
	Version      string
	NamePrefixes []string
}

type UpgradeBundle struct {
	ID                     string   `json:"id"`
	Tool                   string   `json:"tool"`
	ReleaseName            string   `json:"release_name"`
	ChartName              string   `json:"chart_name"`
	RepoURL                string   `json:"repo_url"`
	SourceChartVersion     string   `json:"source_chart_version"`
	SourceAppVersion       string   `json:"source_app_version"`
	TargetChartVersion     string   `json:"target_chart_version"`
	TargetAppVersion       string   `json:"target_app_version"`
	RiskLevel              string   `json:"risk_level"`
	ExpectedDisruption     string   `json:"expected_disruption"`
	ReleaseNotes           string   `json:"release_notes,omitempty"`
	RequiresBackup         bool     `json:"requires_backup"`
	SupportedArchitectures []string `json:"supported_architectures,omitempty"`
	Status                 string   `json:"status"`
	// FixesCVEs 는 이 업그레이드가 고치는 CVE 다. 번들을 리허설할 때 함께 등록한다 — 설치 OSS CVE
	// 대응(nullus-plan#78)이 "어느 검증된 업그레이드가 이 CVE 를 고치는가" 를 여기서 읽는다.
	FixesCVEs []string  `json:"fixes_cves,omitempty"`
	CreatedAt time.Time `json:"created_at"`
}

type UpgradeCandidate struct {
	Tool                string         `json:"tool"`
	ReleaseName         string         `json:"release_name"`
	CurrentChartVersion string         `json:"current_chart_version"`
	CurrentAppVersion   string         `json:"current_app_version"`
	CurrentRevision     int            `json:"current_revision"`
	ReleaseStatus       string         `json:"release_status"`
	Bundle              *UpgradeBundle `json:"bundle,omitempty"`
	BlockedReason       string         `json:"blocked_reason,omitempty"`
	// FixesFound 는 번들이 고치는 CVE 중 이 스택의 그 릴리스 이미지에서 지금 발견된 것이다.
	FixesFound []string `json:"fixes_found,omitempty"`
	// FixesChecked 는 그 릴리스의 스캔 결과로 확인했는지다. 거짓이면 FixesFound 가 비어도 "이 스택엔
	// 없다" 가 아니다(스캐너가 없거나 아직 스캔하지 않았거나 읽지 못했다).
	FixesChecked bool        `json:"fixes_checked,omitempty"`
	LastRun      *UpgradeRun `json:"last_run,omitempty"`
	CheckedAt    time.Time   `json:"checked_at"`
}

type UpgradeCheck struct {
	Name        string `json:"name"`
	Status      string `json:"status"` // pass | warning | blocked
	Message     string `json:"message"`
	Remediation string `json:"remediation,omitempty"`
}

type UpgradeRun struct {
	ID                 string         `json:"id"`
	StackID            string         `json:"stack_id"`
	BundleID           string         `json:"bundle_id"`
	Tool               string         `json:"tool"`
	Status             string         `json:"status"`
	CurrentStep        string         `json:"current_step"`
	RequestedBy        string         `json:"requested_by"`
	Reason             string         `json:"reason"`
	IdempotencyKey     string         `json:"-"`
	SourceChartVersion string         `json:"source_chart_version"`
	TargetChartVersion string         `json:"target_chart_version"`
	PreviousRevision   int            `json:"previous_revision"`
	ResultRevision     int            `json:"result_revision,omitempty"`
	Checks             []UpgradeCheck `json:"checks"`
	Error              string         `json:"error,omitempty"`
	StartedAt          time.Time      `json:"started_at"`
	UpdatedAt          time.Time      `json:"updated_at"`
	FinishedAt         *time.Time     `json:"finished_at,omitempty"`
}