usecase

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

type CreatePipelineInput struct {
	Name           string
	ExecutionMode  string
	TemplateID     string
	OrgID          string
	ClusterID      string
	StackID        string // optional — links pipeline to a stack
	Namespace      string
	AppType        domain.AppType
	GitRepoURL     string
	DockerfilePath string
	DockerContext  string
	EnvVars        map[string]string
	// ProvisionRepository 가 true 면 앱 저장소를 만들고 스캐폴딩을 커밋한 뒤
	// Argo CD Application 까지 연결한다. StackID 가 필요하다.
	ProvisionRepository bool
	// RequestedByEmail 은 요청한 사람의 이메일이다. 저장소가 든 조직의 멤버로
	// 넣는 데 쓴다 — 넣지 않으면 자기 저장소를 보지도 못한다.
	RequestedByEmail string
	// Port / Replicas 는 스캐폴딩 매니페스트에 반영된다.
	Port     int32
	Replicas int32
	// RegistryCredentials 는 외부 레지스트리 자격증명이다.
	RegistryCredentials map[string]string
}

type CreatePipelineOutput struct {
	Pipeline     *domain.Pipeline
	StackWarning string `json:"stack_warning,omitempty"` // non-empty when stack exists but is not completed

	// 아래는 저장소 프로비저닝을 수행했을 때만 채워진다.
	RepositoryPath         string   `json:"repository_path,omitempty"`
	ArgoApplicationCreated bool     `json:"argo_application_created,omitempty"`
	MissingVariables       []string `json:"missing_variables,omitempty"`
	Warnings               []string `json:"warnings,omitempty"`
	// ScaffoldSkipped 는 이미 있던 저장소라 스캐폴딩을 쓰지 않았음을 알린다.
	// 사용자가 파일이 갱신됐다고 오해하면 배포되지 않는 원인을 엉뚱한 데서 찾는다.
	ScaffoldSkipped bool `json:"scaffold_skipped,omitempty"`
}

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

type DeletePipelineInput struct {
	PipelineID string
	// DeleteClusterResources 는 Argo CD Application 과 그것이 배포한 워크로드를 지운다.
	DeleteClusterResources bool
	// DeleteRepository 는 소스 저장소를 지운다. 되돌릴 수 없다.
	DeleteRepository bool
	// DeleteImages 는 레지스트리의 이미지 저장소를 지운다.
	DeleteImages bool
}

type DeletePipelineOutput struct {
	ClusterResourcesDeleted bool
	RepositoryDeleted       bool
	ImagesDeleted           bool
	Warnings                []string
}

type DeployOption func(*DeployPipeline)

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

type DeployPipelineInput struct {
	PipelineID    string
	Version       string
	DeployedBy    string
	ManifestTypes []string
}

type DeployPipelineOutput struct {
	Deployment *domain.Deployment
}

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

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

type ListPipelinesInput struct {
	OrgID   string
	StackID string // optional — filters to pipelines linked to this stack
}

type ListPipelinesOutput struct {
	Pipelines []*domain.Pipeline
}

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

type ProvisionAppProjectInput struct {
	AppName   string
	GroupPath string
	GroupID   string
	// Namespace 는 배포 대상 쿠버네티스 네임스페이스다.
	Namespace string
	Port      int32
	Replicas  int32
	// RepoAccessToken 은 저장소 쓰기에 쓸 토큰이다.
	//
	// 플랫폼이 프로젝트 범위 토큰을 지원하지 않을 때 채워진다(Gitea·GitHub).
	// deploy 단계가 매니페스트 태그를 되쓰려면 필요하다.
	RepoAccessToken string
	// RegistryCredentials 는 외부 레지스트리 자격증명이다.
	// SCM 프로젝트 레지스트리를 쓰는 구성에서는 필요 없다.
	RegistryCredentials map[string]string
	// Platform 은 파이프라인 파일 형식과 토큰 확보 경로를 정한다.
	// 비면 GitLab 으로 본다.
	Platform port.SCMPlatform
	// SharedAccessToken 은 리포 범위 토큰을 발급할 수 없는 플랫폼에서
	// Argo CD 인증에 재사용할 토큰이다 (GitHub 의 조직 PAT).
	SharedAccessToken string
	// ImageScannerEndpoint 는 스택 Trivy 서버 주소다. 비면 스캔 단계를
	// 만들지 않는다 — 돌지도 않을 단계를 선언하면 화면이 그것을 성공으로
	// 보여준다(마이그레이션 000070).
	ImageScannerEndpoint string
	// ImageScannerJavaDBRepository 는 에어갭 CI 잡이 Java DB 를 받을 내부 미러다. 비면 업스트림.
	ImageScannerJavaDBRepository string
	// DependencyScanEndpoint 는 의존성 스캔(SCA)이 붙을 스택 Trivy 서버 주소다. 비면 단계를 만들지 않는다.
	DependencyScanEndpoint string
	// SASTServerEndpoint 는 스택 SonarQube 주소다. 비면 소스 정적 분석 단계를 만들지 않는다.
	SASTServerEndpoint string
	// SASTToken 은 CI 가 분석에 쓸 토큰이다. 스택 설치가 발급해 OpenBao 에 둔 값이다.
	// 비어 있으면 단계는 만들되 사람이 채울 변수로 알린다.
	SASTToken string
	// AppType 은 어떤 앱을 스캐폴딩할지다. web 이면 바로 도는 React 앱을 만든다.
	AppType domain.AppType
	// AccessDomain / GatewayName / GatewayNamespace 가 있으면
	// 외부 접근용 HTTPRoute 도 스캐폴딩에 포함한다.
	AccessDomain     string
	GatewayName      string
	GatewayNamespace string
	// StackID 는 배포 매니페스트에 스택 라벨로 실린다. 클러스터에서 워크로드가
	// 어느 스택 소속인지 판별하는 유일한 키다.
	StackID string
	// TemplateID 는 배포 매니페스트에 템플릿 라벨로 실린다.
	// 템플릿별 자원 사용 비교나 템플릿 단위 조회에 쓴다.
	TemplateID string
	// RefreshDefinitionOnly 는 이미 있는 저장소에 파이프라인 정의 파일(.gitlab-ci.yml ·
	// 워크플로 · Jenkinsfile)만 다시 쓴다. 앱 코드·Dockerfile·배포 매니페스트는 건드리지
	// 않는다. SAST 리포트 같은 새 단계가 옛 파이프라인에 붙게 하는 길이다 — 전에는
	// 파이프라인을 다시 만드는 것 말고 방법이 없었다.
	RefreshDefinitionOnly bool
	// Source 가 있으면 새 저장소의 첫 커밋으로 이 원본을 가져온다(템플릿의 원본).
	// 이미 있던 저장소에는 쓰지 않는다 — 스캐폴딩과 같은 규칙이다.
	Source *domain.TemplateSource
}

type ProvisionAppProjectOutput struct {
	Project     *port.SCMProject
	ImageTarget *port.ImageTarget
	// ArgoReadToken 은 Argo CD 가 저장소를 읽는 데 쓸 토큰이다.
	// 발급에 실패하면 비어 있고 Warnings 에 사유가 담긴다.
	ArgoReadToken string
	// MissingVariables 는 파이프라인이 돌기 전에 사람이 채워야 할 변수다.
	MissingVariables []string
	// Warnings 는 치명적이지 않지만 알려야 하는 문제다.
	Warnings []string
	// ScaffoldSkipped 는 이미 있던 저장소라 스캐폴딩을 쓰지 않았음을 알린다.
	ScaffoldSkipped bool
	// DefinitionRefreshed 는 파이프라인 정의 파일을 플랫폼 기본으로 다시 썼음을 알린다.
	DefinitionRefreshed bool
	// RepositoryRecreated 는 정의를 갱신하려던 저장소가 없어 새로 만들고 전체 스캐폴딩을
	// 썼음을 알린다 — 앱 코드는 사용자가 다시 밀어야 한다.
	RepositoryRecreated bool
	// CIJobURL 은 만들어진 CI job 의 주소다. CI 가 SCM 과 분리된 플랫폼
	// (Jenkins)에서만 채워진다.
	CIJobURL string
	// Stages 는 스캐폴딩이 실제로 만든 파이프라인 단계다.
	//
	// 이미 있던 저장소라 스캐폴딩을 건너뛰었으면 비어 있다 — 그 안의 파이프라인
	// 파일은 우리가 만든 것이 아니므로 단계를 안다고 말하면 안 된다.
	Stages []string
	// CredentialManifests 는 파이프라인 자격증명 ExternalSecret 이다.
	//
	// 여기서 적용하지 않는다 — 클러스터 접근은 상위 유스케이스가 한곳에서
	// 맡는다(Argo CD 리소스와 같은 경로로 적용된다).
	CredentialManifests []string
	// ImportedSource 는 이번에 새 저장소로 가져온 원본이다. 가져오지 않았으면 nil 이다.
	ImportedSource *domain.TemplateSource
}

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

type ProvisionCommonProjectInput struct {
	// GroupPath 는 조직 그룹 경로다 (예: "acme").
	GroupPath string
	// GroupName 은 그룹 표시 이름이다. 비면 GroupPath 를 쓴다.
	GroupName string
	// ProjectPath 는 공용 프로젝트 경로다. 비면 DefaultCommonProjectPath.
	ProjectPath string
	// Platform 은 안내 문서에 적을 패키지 레지스트리 주소 형식을 정한다.
	// 비면 GitLab 으로 본다.
	Platform port.SCMPlatform
}

type ProvisionCommonProjectOutput struct {
	Group   *port.SCMGroup
	Project *port.SCMProject
	// DocsSkipped 는 이미 있던 프로젝트라 README 를 쓰지 않았음을 알린다.
	DocsSkipped bool
}

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

type ProvisionPipelineRepositoryInput struct {
	AppName string
	StackID string
	// TemplateID 는 배포 매니페스트에 템플릿 라벨로 실린다. 비면 라벨을 붙이지 않는다.
	TemplateID string
	// AppType 은 어떤 앱을 스캐폴딩할지다. web 이면 React 앱을 만든다.
	AppType domain.AppType
	// RequestedByEmail 은 파이프라인을 만든 사람의 이메일이다.
	// 저장소를 담은 조직의 멤버로 넣는 데 쓴다. 비면 건너뛴다.
	RequestedByEmail string
	// Namespace 는 배포 대상 쿠버네티스 네임스페이스다.
	Namespace string
	Port      int32
	Replicas  int32
	// CommonProjectPath 는 공용 프로젝트 경로다. 비면 기본값.
	CommonProjectPath string
	// RegistryCredentials 는 외부 레지스트리 자격증명이다.
	RegistryCredentials map[string]string
	// RefreshDefinitionOnly 는 이미 있는 저장소의 파이프라인 정의 파일만 다시 쓰고 CI 변수를
	// 다시 등록한다. Argo CD Application 은 건드리지 않는다.
	RefreshDefinitionOnly bool
	// Source 는 템플릿의 원본이다. 있으면 새 저장소의 첫 커밋으로 가져온다.
	Source *domain.TemplateSource
}

type ProvisionPipelineRepositoryOutput struct {
	CommonProject *port.SCMProject
	Project       *port.SCMProject
	// RepoURL / ImageRepository 는 파이프라인 레코드에 남길 값이다.
	RepoURL         string
	ImageRepository string

	ArgoApplicationCreated bool
	MissingVariables       []string
	Warnings               []string
	// ScaffoldSkipped 는 이미 있던 저장소라 스캐폴딩을 쓰지 않았음을 알린다.
	ScaffoldSkipped bool
	// DefinitionRefreshed / RepositoryRecreated 는 정의 갱신의 결과다(ProvisionAppProjectOutput).
	DefinitionRefreshed bool
	RepositoryRecreated bool
	// Stages 는 파이프라인 레코드에 남길 실효 단계다. 스캐폴딩을 건너뛰었으면 비어 있다.
	Stages []string
	// ImportedSource 는 새 저장소로 가져온 원본이다. 파이프라인 레코드에 남긴다.
	ImportedSource *domain.TemplateSource
}

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

type RefreshPipelineDefinitionOutput struct {
	Pipeline *domain.Pipeline
	// Stages 는 다시 쓴 정의의 단계다. 비면 번들이 알려 주지 않은 것이다.
	Stages           []string
	Warnings         []string
	MissingVariables []string
	// RepositoryRecreated 는 저장소가 없어 다시 만들고 전체 스캐폴딩을 썼음을 알린다.
	RepositoryRecreated bool
}

type RepositoryProvisioner interface {
	Execute(ctx context.Context, input ProvisionPipelineRepositoryInput) (*ProvisionPipelineRepositoryOutput, error)
}

type ScanPolicyPipelinePublisher interface {
	PublishToPipeline(ctx context.Context, pipeline *domain.Pipeline) *ScanPolicyPush
}

type ScanPolicyPush struct {
	PipelineID   string               `json:"pipeline_id"`
	PipelineName string               `json:"pipeline_name"`
	Status       ScanPolicyPushStatus `json:"status"`
	Error        string               `json:"error,omitempty"`
}

type ScanPolicyPushStatus string

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

type ScanPolicyView struct {
	StackID string            `json:"stack_id"`
	Policy  domain.ScanPolicy `json:"policy"`
	// IsDefault 는 저장한 적이 없어 기본 정책을 쓰고 있다는 뜻이다.
	IsDefault bool `json:"is_default"`
}

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

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

type SyncPipelineRunsInput struct {
	PipelineID string
	JobName    string
	Branch     string
	Limit      int
	// SASTWebURL 은 스택 SonarQube 의 공개 주소다. 분석 결과의 링크를 만든다.
	SASTWebURL string
	// Policy 는 판정에 쓸 스택 정책이다. nil 이면 기본 정책이다 — CI 는 푸시된 정책으로
	// 막으므로, 동기화도 같은 정책으로 읽어야 차단과 스캔 오류를 바르게 가른다.
	Policy *domain.ScanPolicy
	// PolicyUnavailable 은 스택 정책을 읽지 못했다는 뜻이다(nil Policy 와 다르다 — 그것은 저장한 적 없음).
	// 시크릿 탐지는 정책이 off 인지 모르면 기록하지 않는다. 다른 판정은 지금처럼 기본 정책으로 한다.
	PolicyUnavailable bool
}

type UpdateScanPolicyResult struct {
	ScanPolicyView
	Pushes []ScanPolicyPush `json:"pushes"`
}