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 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
	// AppType 은 어떤 앱을 스캐폴딩할지다. web 이면 바로 도는 React 앱을 만든다.
	AppType domain.AppType
	// AccessDomain / GatewayName / GatewayNamespace 가 있으면
	// 외부 접근용 HTTPRoute 도 스캐폴딩에 포함한다.
	AccessDomain     string
	GatewayName      string
	GatewayNamespace string
	// StackID 는 배포 매니페스트에 스택 라벨로 실린다. 클러스터에서 워크로드가
	// 어느 스택 소속인지 판별하는 유일한 키다.
	StackID string
	// TemplateID 는 배포 매니페스트에 템플릿 라벨로 실린다.
	// 템플릿별 자원 사용 비교나 템플릿 단위 조회에 쓴다.
	TemplateID string
}

type ProvisionAppProjectOutput struct {
	Project     *port.SCMProject
	ImageTarget *port.ImageTarget
	// ArgoReadToken 은 Argo CD 가 저장소를 읽는 데 쓸 토큰이다.
	// 발급에 실패하면 비어 있고 Warnings 에 사유가 담긴다.
	ArgoReadToken string
	// MissingVariables 는 파이프라인이 돌기 전에 사람이 채워야 할 변수다.
	MissingVariables []string
	// Warnings 는 치명적이지 않지만 알려야 하는 문제다.
	Warnings []string
	// ScaffoldSkipped 는 이미 있던 저장소라 스캐폴딩을 쓰지 않았음을 알린다.
	ScaffoldSkipped bool
	// CIJobURL 은 만들어진 CI job 의 주소다. CI 가 SCM 과 분리된 플랫폼
	// (Jenkins)에서만 채워진다.
	CIJobURL string
	// CredentialManifests 는 파이프라인 자격증명 ExternalSecret 이다.
	//
	// 여기서 적용하지 않는다 — 클러스터 접근은 상위 유스케이스가 한곳에서
	// 맡는다(Argo CD 리소스와 같은 경로로 적용된다).
	CredentialManifests []string
}

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
}

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

	ArgoApplicationCreated bool
	MissingVariables       []string
	Warnings               []string
	// ScaffoldSkipped 는 이미 있던 저장소라 스캐폴딩을 쓰지 않았음을 알린다.
	ScaffoldSkipped bool
}

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

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

type SyncPipelineRunsInput struct {
	PipelineID string
	JobName    string
	Branch     string
	Limit      int
}