usecase

type AddToolsInput struct {
	StackID string
	Tools   []domain.ToolConfig
}

type AddToolsUseCase struct {
	// contains filtered or unexported fields
}

type ApplyReleaseValuesInput struct {
	StackID     string
	ReleaseName string
	Mode        ReleaseValuesMode
	YAML        string
	DryRun      bool
	ChangedBy   string
}

type ApplyReleaseValuesOutput struct {
	ReleaseName string                           `json:"release_name"`
	StepName    string                           `json:"step_name,omitempty"`
	Namespace   string                           `json:"namespace"`
	Mode        ReleaseValuesMode                `json:"mode"`
	Revision    int                              `json:"revision"`
	Status      string                           `json:"status,omitempty"`
	DryRun      bool                             `json:"dry_run"`
	Warnings    []domain.ProtectedValueViolation `json:"warnings,omitempty"`
	// EffectiveYAML 은 실제로 helm 에 넘어간 values 다. 오버라이드 모드에서
	// 병합 결과를 확인하는 용도이므로 드라이런에서 특히 중요하다.
	EffectiveYAML string `json:"effective_yaml,omitempty"`
	Manifest      string `json:"manifest,omitempty"`
	// RenderError 는 미리보기에서만 채워진다. 차트가 렌더되지 않는 것은
	// 편집 결과이지 서버 오류가 아니므로, 경고와 함께 돌려준다.
	RenderError string `json:"render_error,omitempty"`
}

type BundleOption func(*ManageUpgradeBundles)

type CalculateResources struct{}

type CompatibilityValidationError struct {
	Field   string
	Message string
}

type CreateStack struct {
	// contains filtered or unexported fields
}

type CreateStackInput struct {
	Name       string
	OrgID      string
	ClusterID  string
	Namespace  string
	TemplateID string
	Config     domain.StackConfig
}

type CreateStackOption func(*CreateStack)

type CreateStackOutput struct {
	Stack *domain.Stack
}

type DeleteStack struct {
	// contains filtered or unexported fields
}

type DiffResult struct {
	Added   map[string]any    `json:"added"`
	Removed map[string]any    `json:"removed"`
	Changed map[string][2]any `json:"changed"`
}

type DiffVersions struct {
	// contains filtered or unexported fields
}

type DiffVersionsInput struct {
	StackID  string
	VersionA int
	VersionB int
}

type EnsureSharedComponents struct {
	// contains filtered or unexported fields
}

type EstimateResourcesInput struct {
	Tools    []ToolInstance
	Workload WorkloadInput
}

type EstimateResourcesOutput struct {
	Summary             domain.ResourceEstimate
	PerTool             []ToolResourceEstimate
	Notes               []string
	WorkloadScaleFactor float64
	ArtifactStorageGi   float64
	CostBreakdown       ResourceCostBreakdown
}

type ExportConfig struct {
	// contains filtered or unexported fields
}

type ExportSpec struct {
	SchemaVersion string                 `json:"schema_version" yaml:"schema_version"`
	Name          string                 `json:"name" yaml:"name"`
	TemplateID    string                 `json:"template_id" yaml:"template_id"`
	OrgID         string                 `json:"org_id" yaml:"org_id"`
	ClusterID     string                 `json:"cluster_id" yaml:"cluster_id"`
	Namespace     string                 `json:"namespace" yaml:"namespace"`
	State         domain.DeploymentState `json:"state,omitempty" yaml:"state,omitempty"`
	Tools         []domain.ToolConfig    `json:"tools,omitempty" yaml:"tools,omitempty"`
	Config        domain.StackConfig     `json:"config" yaml:"config"`
	Resources     domain.ResourcesConfig `json:"resources" yaml:"resources"`
}

type ExportedStack struct {
	Kind       string     `json:"kind" yaml:"kind"`
	APIVersion string     `json:"apiVersion" yaml:"apiVersion"`
	Spec       ExportSpec `json:"spec" yaml:"spec"`
}

type GatewayAddressReaderFactory func(kubeconfig []byte) (port.GatewayAddressReader, error)

type GatewayAliasRepin struct {
	// contains filtered or unexported fields
}

type GetConnectionInfo struct {
	// contains filtered or unexported fields
}

type GetDiffInput struct {
	StackID   string
	VersionID string
}

type GetDiffOutput struct {
	Diffs []domain.ConfigDiff
}

type GetReleaseValuesInput struct {
	StackID     string
	ReleaseName string
	Mode        ReleaseValuesMode
}

type GetTemplate struct {
	// contains filtered or unexported fields
}

type GetTemplateInput struct {
	ID string
}

type GetTemplateOutput struct {
	Template *domain.Template
}

type ImportConfig struct {
	// contains filtered or unexported fields
}

type ImportConfigInput struct {
	OrgID           string
	Payload         []byte
	ReplaceExisting bool
}

type ImportConfigOutput struct {
	Stack *domain.Stack
}

type ImportPreviewOutput struct {
	Mode            string      `json:"mode"`
	Name            string      `json:"name"`
	ClusterID       string      `json:"cluster_id"`
	ExistingStackID string      `json:"existing_stack_id,omitempty"`
	ExistingState   string      `json:"existing_state,omitempty"`
	Changes         *DiffResult `json:"changes,omitempty"`
}

type InstallStack struct {
	// contains filtered or unexported fields
}

type InstallStackInput struct {
	StackID        string
	Continue       bool
	PreserveLogs   bool
	ResumeFromStep string
	// SourceControl 은 외부 SCM 자격증명이다. 요청에서만 흐르고
	// stacks.config 에는 저장되지 않는다 — 설치가 끝나면 OpenBao 로 옮겨진다.
	SourceControl SourceControlCredentials
}

type InstallStackOption func(*InstallStack)

type ListResourceDefaults struct {
	// contains filtered or unexported fields
}

type ListResourceDefaultsOutput struct {
	Items []*domain.ResourceDefault
}

type ListStacks struct {
	// contains filtered or unexported fields
}

type ListStacksInput struct {
	OrgID          string
	IncludeDeleted bool
}

type ListStacksOutput struct {
	Stacks []*domain.Stack
}

type ListTemplates struct {
	// contains filtered or unexported fields
}

type ListTemplatesOutput struct {
	Templates []*domain.Template
}

type ListVersionsInput struct {
	StackID string
}

type ListVersionsOutput struct {
	Versions []*domain.StackVersion
}

type ManageCompatibility struct {
	// contains filtered or unexported fields
}

type ManageCompatibilityOption func(*ManageCompatibility)

type ManageHistory struct {
	// contains filtered or unexported fields
}

type ManageReleaseValues struct {
	// contains filtered or unexported fields
}

type ManageReleaseValuesOption func(*ManageReleaseValues)

type ManageUpgradeBundles struct {
	// contains filtered or unexported fields
}

type MemoryVerdictCache struct {
	// contains filtered or unexported fields
}

type ReapStaleInstalls struct {
	// contains filtered or unexported fields
}

type RegisterUpgradeBundleInput struct {
	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                 string
	RehearsalConfirmed     bool
}

type ReleaseManagerFactory func(kubeconfig []byte) port.HelmReleaseManager

type ReleaseValuesMode string

type ReleaseValuesOutput struct {
	ReleaseName string            `json:"release_name"`
	StepName    string            `json:"step_name,omitempty"`
	Namespace   string            `json:"namespace"`
	Revision    int               `json:"revision"`
	Mode        ReleaseValuesMode `json:"mode"`
	YAML        string            `json:"yaml"`
	// ProtectedPaths 는 이 릴리스에서 플랫폼이 소유한 경로다. 에디터가 미리
	// 표시해 두면 사용자가 건드리기 전에 알 수 있다.
	ProtectedPaths []string `json:"protected_paths,omitempty"`
}

type ResourceCostBreakdown struct {
	CPUCostUSD     float64
	MemoryCostUSD  float64
	StorageCostUSD float64
}

type SaveVersionInput struct {
	StackID      string
	Config       domain.StackConfig
	ChangedBy    string
	ChangeReason string
}

type SaveVersionOutput struct {
	Version *domain.StackVersion
}

type ScanStackImages struct {
	// contains filtered or unexported fields
}

type SourceControlCredentials struct {
	// PersonalAccessToken 은 GitHub PAT 다 (repo·workflow·read:packages).
	PersonalAccessToken string
}

type StartUpgradeInput struct{ StackID, BundleID, RequestedBy, Reason, IdempotencyKey string }

type ToolInstance struct {
	Name      string
	Instances int
}

type ToolResourceEstimate struct {
	Name      string
	Instances int
	CPUCores  float64
	MemoryGi  float64
	StorageGi float64
}

type UpdateStack struct {
	// contains filtered or unexported fields
}

type UpdateStackInput struct {
	StackID   string
	Name      *string
	ClusterID *string
	Namespace *string
	Config    *domain.StackConfig
	Tools     []domain.ToolConfig
}

type UpdateStackOutput struct {
	Stack *domain.Stack
}

type UpgradeExecutorFactory func(kubeconfig []byte) port.ChartUpgradeExecutor

type UpgradeStack struct {
	// contains filtered or unexported fields
}

type UpgradeStackDeps struct {
	Stacks      port.StackRepository
	Runs        port.UpgradeRepository
	Kubeconfigs port.KubeconfigProvider
	Releases    ReleaseManagerFactory
	Executors   UpgradeExecutorFactory
	// Backups 가 없으면(백업 기능 꺼짐) 백업이 필요한 번들은 막힌다 — 안전 조건을 완화하지 않는다.
	Backups      port.UpgradeBackupLookup
	BackupMaxAge time.Duration
	Health       port.UpgradeHealthVerifier
	// Vulnerabilities 는 스택의 설치 이미지 스캔 결과에서 릴리스별 CVE 를 읽는다. 없으면 후보는 번들이
	// 고치는 CVE 목록만 싣고, 그중 무엇이 이 스택에 있는지는 비운다.
	Vulnerabilities port.ReleaseVulnerabilityLookup
	Now             func() time.Time
	NewID           func() string
	// Launch 는 실행을 요청 밖으로 넘긴다. 기본은 goroutine 이다.
	Launch func(job func())
	// Context 는 API 프로세스의 수명이다. 종료 때 취소되면 Helm 이 --atomic 으로 스스로 되돌리기
	// 시작하고, 실행은 사람에게 넘긴다. 요청 ctx 와는 묶지 않는다 — 화면을 닫아도 이어진다.
	Context context.Context
	// HeartbeatInterval 은 실행 중 박동 주기다(기본 1분). domain.UpgradeHeartbeatTimeout 보다 짧아야 한다.
	HeartbeatInterval time.Duration
	// RetryBackoff 는 상태 저장 재시도의 첫 대기다(기본 1초, 두 배씩).
	RetryBackoff time.Duration
	Logger       *slog.Logger
}

type UpsertResourceDefault struct {
	// contains filtered or unexported fields
}

type UpsertResourceDefaultInput struct {
	ToolKey          string
	DisplayName      string
	CPURequest       float64
	CPULimit         float64
	MemoryRequestGi  float64
	MemoryLimitGi    float64
	StorageRequestGi float64
	StorageLimitGi   float64
	IsDefault        bool
}

type UpsertResourceDefaultOutput struct {
	Item *domain.ResourceDefault
}

type ValidateCompatibility struct {
	// contains filtered or unexported fields
}

type ValidateCompatibilityInput struct {
	// Tools maps tool category to tool name, e.g. {"ci_platform": "GitLab CI"}.
	Tools map[string]string

	// StackID, when set with empty Tools, triggers persisted mode: load the
	// stack from StackRepository, derive tools from stack.Tools, and fall
	// back to stack.ClusterID when ClusterID is empty.
	StackID string

	// ClusterID, when set, instructs the use case to resolve cluster node
	// architectures from the admin bounded context via ClusterReader. Takes
	// precedence over NodeArchitectures.
	ClusterID string

	// NodeArchitectures is the explicit override. Callers who already have
	// the fleet arch list (e.g. on-the-fly validation in the wizard before
	// a cluster row exists) should populate this directly.
	NodeArchitectures []string
}

type ValidateCompatibilityOption func(*ValidateCompatibility)

type ValidateCompatibilityOutput struct {
	Compatible        bool
	Matrix            *domain.CompatibilityMatrix
	Message           string
	Overall           ValidationOverall
	Issues            []ValidationIssue
	NodeArchitectures []string
	CheckedAt         time.Time
}

type ValidationIssue struct {
	Tool     string `json:"tool"`
	Message  string `json:"message"`
	Severity string `json:"severity"`
	Code     string `json:"code,omitempty"`
}

type ValidationOverall struct {
	State string `json:"state"`
	Score int    `json:"score"`
}

type VerdictCache interface {
	Get(key string) (*ValidateCompatibilityOutput, bool)
	Put(key string, out *ValidateCompatibilityOutput)
	// Invalidate evicts all entries whose key starts with the given prefix.
	// Used when stack/cluster/matrix state changes; callers can also pass
	// an empty string to blow the whole cache (the initial implementation
	// uses a simple full-clear to avoid prefix-matching complexity).
	Invalidate(prefix string)
}

type VerdictCacheClearer interface {
	Clear()
}

type WorkloadInput struct {
	Developers        int
	ConcurrentRunners int
	WeeklyCommits     int
	BuildFrequency    string // hourly, daily, on-push
}