domain

type AppType string

type BuildProfile string

type CICDGoldenPath struct {
	ID                   string     `json:"id"`
	Name                 string     `json:"name"`
	Description          string     `json:"description"`
	Tools                []CICDTool `json:"tools"`
	EstimatedInstallTime int        `json:"estimated_install_time"` // in minutes
	RecommendedUseCase   string     `json:"recommended_use_case"`
	MinResources         string     `json:"min_resources"`
	CreatedAt            time.Time  `json:"created_at"`
}

type CICDTool struct {
	Category    string `json:"category"` // ci_platform, cd_tool, monitoring, etc.
	Name        string `json:"name"`     // GitLab CI, ArgoCD, Prometheus, etc.
	HelmVersion string `json:"helm_version"`
	AppVersion  string `json:"app_version"`
}

type DependencyScanResult struct {
	ID           string `json:"id"`
	PipelineID   string `json:"pipeline_id"`
	DeploymentID string `json:"deployment_id"`

	Scanner        string     `json:"scanner"`
	ScannerVersion string     `json:"scanner_version,omitempty"`
	DBUpdatedAt    *time.Time `json:"db_updated_at,omitempty"`

	// Counts 는 리포트를 읽었을 때만 있다. nil 은 "모름" 이다 — 0 으로 채우면 "취약점 0건" 으로 읽힌다.
	// 스택 정책의 ignore_unfixed 를 따른다(판정이 본 숫자와 같아야 한다).
	Counts *SeverityCounts `json:"counts,omitempty"`
	// Targets 는 검사한 락파일 수(리포트의 Results 수)다. nil 은 모름, 0 은 검사할 것이 없었다는 뜻이다 —
	// 스캐폴딩은 락파일을 만들지 않아 "0 개 검사 · 통과" 가 흔하다(#79 §1). 통과와 가른다.
	Targets *int `json:"targets,omitempty"`

	GateResult GateResult `json:"gate_result"`
	ReportURI  string     `json:"report_uri,omitempty"`
	ScannedAt  time.Time  `json:"scanned_at"`

	// ReportRef 는 CI 리포트를 다시 읽을 위치다. 화면에는 내보내지 않는다.
	ReportRef *ScanReportRef `json:"-"`
}

type DeployStep struct {
	Name      string   `json:"name"`
	Status    string   `json:"status"`
	Kind      string   `json:"kind"`
	Message   string   `json:"message,omitempty"`
	AppliedAt string   `json:"applied_at,omitempty"`
	Logs      []string `json:"logs,omitempty"`
}

type Deployment struct {
	ID          string           `json:"id"`
	PipelineID  string           `json:"pipeline_id"`
	Version     string           `json:"version"`
	Status      DeploymentStatus `json:"status"`
	Steps       []DeployStep     `json:"steps,omitempty"`
	StartedAt   time.Time        `json:"started_at"`
	CompletedAt *time.Time       `json:"completed_at,omitempty"`
	DeployedBy  string           `json:"deployed_by"`
}

type DeploymentStatus string

type GateResult string

type ImageScanResult struct {
	ID           string `json:"id"`
	PipelineID   string `json:"pipeline_id"`
	DeploymentID string `json:"deployment_id,omitempty"`

	ImageRepository string `json:"image_repository,omitempty"`
	ImageTag        string `json:"image_tag,omitempty"`
	// ImageDigest 에 결과를 붙인다 — 태그는 움직인다.
	ImageDigest string `json:"image_digest,omitempty"`

	ScanSource     string     `json:"scan_source"`
	Scanner        string     `json:"scanner"`
	ScannerVersion string     `json:"scanner_version,omitempty"`
	DBUpdatedAt    *time.Time `json:"db_updated_at,omitempty"`

	// Counts 는 리포트를 읽었을 때만 있다. nil 은 "모름" 이다 —
	// 0 으로 채우면 "취약점 0건" 으로 읽힌다.
	Counts *SeverityCounts `json:"counts,omitempty"`

	GateResult GateResult `json:"gate_result"`
	ReportURI  string     `json:"report_uri,omitempty"`
	ScannedAt  time.Time  `json:"scanned_at"`

	// ReportRef 는 CI 리포트를 다시 읽을 위치다. 취약점 목록은 볼 때 리포트를 다시
	// 내려받아 만든다(원본은 DB 에 넣지 않는다, 설계 §8). 화면에는 내보내지 않는다.
	ReportRef *ScanReportRef `json:"-"`
}

type Pipeline struct {
	ID             string            `json:"id"`
	Name           string            `json:"name"`
	ExecutionMode  string            `json:"execution_mode,omitempty"`
	TemplateID     string            `json:"template_id"`
	OrgID          string            `json:"org_id"`
	ClusterID      string            `json:"cluster_id"`
	StackID        string            `json:"stack_id,omitempty"`
	Namespace      string            `json:"namespace"`
	AppType        AppType           `json:"app_type"`
	GitRepoURL     string            `json:"git_repo_url"`
	DockerfilePath string            `json:"dockerfile_path,omitempty"`
	DockerContext  string            `json:"docker_context,omitempty"`
	EnvVars        map[string]string `json:"env_vars,omitempty"`
	Status         PipelineStatus    `json:"status"`
	CreatedAt      time.Time         `json:"created_at"`
	// Stages 는 이 파이프라인이 실제로 가진 단계다 (예: Build · ImageScan · Deploy).
	//
	// 템플릿의 stages 와 따로 둔다 — 이미지 스캔 같은 선택 단계는 파이프라인
	// 단위로 켜고 끈다. 템플릿에만 두면 끈 파이프라인이 돌지도 않은 단계를
	// 보여준다(마이그레이션 000070). 비어 있으면 모른다는 뜻이고, 화면은
	// 템플릿으로 떨어진다 — 이 칸이 생기기 전에 만든 파이프라인이 그렇다.
	Stages []string `json:"stages,omitempty"`
	// Source 는 이 파이프라인의 저장소가 처음 가져온 원본이다. 원본을 가져오지 않았으면 nil 이다.
	//
	// 템플릿의 원본 커밋은 시간이 지나면 올라간다. 저장소가 어느 버전에서 시작했는지는
	// 여기에만 남는다.
	Source *TemplateSource `json:"source,omitempty"`
}

type PipelineSecurityList struct {
	Pipelines []*PipelineSecuritySnapshot
	// Truncated 는 상한에 닿아 최근 만든 것부터 잘랐다는 뜻이다.
	Truncated bool
}

type PipelineSecuritySnapshot struct {
	PipelineID string
	Name       string
	StackID    string
	ClusterID  string
	// Stages 는 파이프라인이 실제로 가진 단계다. 비어 있으면 모른다(단계 기록 전의 파이프라인).
	Stages []string
	// HasSecretScan · HasDependencyScan · HasSAST · HasImageScan 은 Stages 에 그 보안 단계가 있는지다.
	// CI 마다 다른 표기(ImageScan · image-scan)를 단계 키로 맞춰 본 것이다. Stages 가 비면 모두 거짓이다.
	HasSecretScan     bool
	HasDependencyScan bool
	HasSAST           bool
	HasImageScan      bool

	// LatestRun 은 최근 실행이다. 실행이 없으면 nil 이다.
	LatestRun *RunSummary

	SecretScan     *SecretScanResult
	DependencyScan *DependencyScanResult
	SAST           *SASTResult
	ImageScan      *ImageScanResult

	// RunVersions 는 결과 행이 가리키는 실행의 표시 번호(#42)다. 키는 deployment_id 다.
	RunVersions map[string]string

	// SecretDetection 은 스택 정책의 시크릿 탐지 동작이다(정책 행이 없으면 기본값 block). 스택에 묶이지
	// 않은 파이프라인은 빈 값이다 — 정책이 없어 단계 유무로만 본다.
	SecretDetection SecretDetectionAction
}

type PipelineStatus string

type PipelineTemplate struct {
	ID             string            `json:"id"`
	Name           string            `json:"name"`
	Description    string            `json:"description"`
	AppType        AppType           `json:"app_type"`
	Stages         []string          `json:"stages"`
	GitRepoURL     string            `json:"git_repo_url,omitempty"`
	DockerfilePath string            `json:"dockerfile_path,omitempty"`
	DockerContext  string            `json:"docker_context,omitempty"`
	EnvVars        map[string]string `json:"env_vars,omitempty"`
	CreatedBy      string            `json:"created_by,omitempty"`
	// Source 가 있으면 파이프라인을 만들 때 이 원본을 새 저장소로 가져온다.
	// 없으면 예전처럼 app_type 에 맞춘 스캐폴딩만 커밋한다.
	Source *TemplateSource `json:"source,omitempty"`
}

type QualityGateStatus string

type RunSummary struct {
	DeploymentID string
	Version      string
	Status       DeploymentStatus
	StartedAt    time.Time
}

type SASTCondition struct {
	Metric     string `json:"metric"`
	Comparator string `json:"comparator,omitempty"`
	Threshold  string `json:"threshold,omitempty"`
	Actual     string `json:"actual,omitempty"`
	// Status 는 OK 또는 ERROR 다.
	Status string `json:"status"`
}

type SASTGateAction string

type SASTMetrics struct {
	Bugs                   *int     `json:"bugs,omitempty"`
	Vulnerabilities        *int     `json:"vulnerabilities,omitempty"`
	CodeSmells             *int     `json:"code_smells,omitempty"`
	SecurityHotspots       *int     `json:"security_hotspots,omitempty"`
	Coverage               *float64 `json:"coverage,omitempty"`
	DuplicatedLinesDensity *float64 `json:"duplicated_lines_density,omitempty"`
	Ncloc                  *int     `json:"ncloc,omitempty"`
}

type SASTReport struct {
	// ScannerExitCode 는 sonar-scanner 의 종료 코드다. 0 통과, 3 엔진 단계 실패(Quality Gate 실패
	// 또는 분석 실패), 그 밖은 엔진을 띄우지도 못한 실패(서버 장애·인증 실패)다(실측).
	ScannerExitCode int
	// CETaskID 는 분석을 서버에 올렸을 때 생기는 작업 ID 다. 3 이 Quality Gate 실패인지 분석 실패인지는
	// 이것으로 가른다 — 게이트 판정은 올린 분석에만 있다.
	CETaskID          string
	ProjectKey        string
	AnalysisID        string
	DashboardURL      string
	QualityGateStatus QualityGateStatus
	Conditions        []SASTCondition
	Metrics           *SASTMetrics
}

type SASTResult struct {
	ID           string `json:"id"`
	PipelineID   string `json:"pipeline_id"`
	DeploymentID string `json:"deployment_id,omitempty"`

	ProjectKey string `json:"project_key,omitempty"`
	AnalysisID string `json:"analysis_id,omitempty"`

	// QualityGateStatus 는 SonarQube 의 판정이다. 분석하지 못했으면 비어 있다.
	QualityGateStatus QualityGateStatus `json:"quality_gate_status,omitempty"`
	// GateResult 는 파이프라인 관점의 판정이다 — 같은 Quality Gate 실패도 스택 정책에 따라
	// 차단·경고로 갈린다.
	GateResult GateResult      `json:"gate_result"`
	Conditions []SASTCondition `json:"conditions,omitempty"`
	// Metrics 는 분석했을 때만 있다. nil 은 "모름" 이다 — 0 으로 채우면 "문제 0건" 으로 읽힌다.
	Metrics *SASTMetrics `json:"metrics,omitempty"`

	DashboardURL string    `json:"dashboard_url,omitempty"`
	AnalyzedAt   time.Time `json:"analyzed_at"`
}

type ScanPolicy struct {
	// BlockSeverity 이상의 취약점이 있으면 차단한다. 바로 아래 등급은 경고로 남긴다.
	BlockSeverity Severity `json:"block_severity"`
	// IgnoreUnfixed 가 참이면 수정본이 없는 취약점은 판정에서 뺀다.
	IgnoreUnfixed bool `json:"ignore_unfixed"`
	// OnScannerUnreachable 은 스캔을 수행하지 못했을 때의 동작이다. 소스 정적 분석을
	// 수행하지 못했을 때(SonarQube 장애·인증 실패)도 이 값을 따른다.
	OnScannerUnreachable UnreachableAction `json:"on_scanner_unreachable"`
	// SASTOnGateFailure 는 소스 정적 분석의 Quality Gate 가 실패했을 때의 동작이다.
	// 비어 있으면 차단이다(이 필드를 모르는 옛 클라이언트·저장 행).
	SASTOnGateFailure SASTGateAction `json:"sast_on_gate_failure"`
	// SecretDetection 은 시크릿 탐지 단계가 시크릿을 찾았을 때의 동작이다(block·warn·off).
	// 비어 있으면 차단이다.
	SecretDetection SecretDetectionAction `json:"secret_detection"`
}

type ScanReportRef struct {
	JobName     string `json:"job_name"`
	Branch      string `json:"branch,omitempty"`
	BuildID     string `json:"build_id,omitempty"`
	BuildNumber int    `json:"build_number"`
	StageID     string `json:"stage_id,omitempty"`
	StageName   string `json:"stage_name,omitempty"`
	Artifact    string `json:"artifact,omitempty"`
	Path        string `json:"path"`
}

type SecretDetectionAction string

type SecretFinding struct {
	RuleID    string `json:"rule_id"`
	File      string `json:"file"`
	StartLine int    `json:"start_line"`
	// Commit 은 이력 검사(gitleaks git)일 때만 있다. 작업 트리 검사(gitleaks dir)는 커밋을 모른다.
	Commit      string `json:"commit,omitempty"`
	Fingerprint string `json:"fingerprint"`
}

type SecretRuleCount struct {
	RuleID string `json:"rule_id"`
	Count  int    `json:"count"`
}

type SecretScanReport struct {
	// Count 는 전체 탐지 건수다.
	Count int
	// Rules 는 규칙별 건수다 — 건수가 많은 규칙부터, 같으면 규칙 이름 순.
	Rules []SecretRuleCount
	// Findings 는 리포트 순서대로 앞의 MaxStoredSecretFindings 건이다.
	Findings []SecretFinding
	// Skipped 는 정책 off 로 스캔하지 않은 실행의 리포트(SecretScanSkippedReport)라는 뜻이다. 기록하지 않는다.
	Skipped bool
}

type SecretScanResult struct {
	ID           string `json:"id"`
	PipelineID   string `json:"pipeline_id"`
	DeploymentID string `json:"deployment_id"`

	Scanner        string `json:"scanner"`
	ScannerVersion string `json:"scanner_version,omitempty"`

	// FindingsCount 는 리포트를 읽었을 때만 있다. nil 은 "모름" 이다 — 0 으로 채우면 "탐지 없음" 으로 읽힌다.
	FindingsCount *int `json:"findings_count,omitempty"`
	// Rules 는 규칙별 탐지 건수다(잘리지 않는다). Findings 는 앞의 MaxStoredSecretFindings 건만이다.
	Rules    []SecretRuleCount `json:"rules"`
	Findings []SecretFinding   `json:"findings"`

	GateResult GateResult `json:"gate_result"`
	ReportURI  string     `json:"report_uri,omitempty"`
	ScannedAt  time.Time  `json:"scanned_at"`

	// ReportRef 는 CI 리포트를 다시 읽을 위치다. 화면에는 내보내지 않는다.
	ReportRef *ScanReportRef `json:"-"`
}

type Severity string

type SeverityCounts = shareddomain.SeverityCounts

type TemplateSource struct {
	// RepoURL 은 원본 저장소 주소다(https).
	RepoURL string `json:"repo_url"`
	// Commit 은 가져올 커밋의 전체 SHA 다. 태그·브랜치는 받지 않는다 — 태그도 다시
	// 찍힌다(eGov 웹 샘플의 v4.3.0 은 2025-03 릴리스인데 2026-05 커밋을 가리킨다).
	Commit string `json:"commit"`
	// Label 은 화면에 보일 버전 이름이다(예: v5.0.0). 가져올 대상을 정하지 않는다.
	Label string `json:"label,omitempty"`
	// BuildProfile 은 가져온 원본을 어떻게 빌드하고 띄울지다.
	BuildProfile BuildProfile `json:"build_profile,omitempty"`
}

type TrivyReportSummary = shareddomain.TrivyReportSummary

type UnreachableAction string