scaffold

type ImportedSource struct {
	// Origin 은 어디서 무엇을 가져왔는지다. 안내 문서와 빌드 프로필 판단에 쓴다.
	Origin domain.TemplateSource
	// Files 는 그 커밋의 파일이다(port.SourceArchive). 경로는 저장소 루트 기준이다.
	Files []port.CommitFile
}

type Input struct {
	AppName string
	// AppType 은 어떤 앱을 만들지다. web 이면 바로 도는 React 앱을 스캐폴딩한다.
	// 비면 예전처럼 자리만 잡는 nginx Dockerfile 을 만든다.
	AppType   domain.AppType
	Namespace string
	Port      int32
	Replicas  int32
	// Platform 은 소스 저장소 플랫폼이다. 비면 GitLab 으로 본다.
	Platform port.SCMPlatform
	// CIPlatform 은 파이프라인 정의를 어느 형식으로 쓸지 정한다.
	//
	// SCM 과 별개의 축이다 — Gitea 는 소스만 담당하고 빌드는 Jenkins 가 한다.
	// 비면 Platform 이 함의하는 기본 CI 를 쓴다.
	CIPlatform port.CIPlatform
	// ImageTarget 은 resolver 가 정한 이미지 저장 위치다.
	ImageTarget *port.ImageTarget
	// AccessDomain / GatewayName / GatewayNamespace 가 모두 있으면
	// 외부 접근용 HTTPRoute 를 함께 만든다. 없으면 클러스터 내부에서만
	// 접근 가능한 Service 까지만 만든다.
	AccessDomain     string
	GatewayName      string
	GatewayNamespace string
	// StackID 는 배포된 워크로드가 어느 스택 소속인지 클러스터에서 알아보게 한다.
	// 네임스페이스로는 판별할 수 없다 — 파이프라인이 default 에 깔 수도 있고
	// 여러 스택이 한 네임스페이스를 공유할 수도 있다. 비면 라벨을 붙이지 않는다.
	StackID string
	// TemplateID 는 어느 CI/CD 템플릿에서 나온 앱인지 알아보게 한다.
	// 템플릿별 자원 사용 비교나 템플릿 단위 조회에 쓴다. 비면 라벨을 붙이지 않는다.
	TemplateID string
	// ImageScannerEndpoint 는 스택 Trivy 서버의 클러스터 내 주소다.
	//
	// 비면 이미지 스캔 단계를 만들지 않는다. 돌지도 않을 단계를 선언하면
	// 화면이 그것을 성공으로 보여준다(마이그레이션 000070).
	ImageScannerEndpoint string
	// ImageScannerJavaDBRepository 는 에어갭 설치에서 CI 잡의 trivy client 가 Java DB 를
	// 받을 내부 미러다. client 는 Maven 메타데이터가 없는 JAR 을 만나면 Java DB 를 스스로
	// 받는데 기본 주소(mirror.gcr.io)는 에어갭에서 닿지 않는다. 비면 업스트림 기본값을 쓴다.
	ImageScannerJavaDBRepository string
	// SASTServerEndpoint 는 스택 SonarQube 의 클러스터 내 주소다.
	//
	// 비면 소스 정적 분석 단계를 만들지 않는다 — 이미지 스캔과 같은 이유다.
	SASTServerEndpoint string
	// DependencyScanEndpoint 는 의존성 스캔(SCA)이 붙을 스택 Trivy 서버 주소다(#79).
	//
	// 비면 의존성 스캔 단계를 만들지 않는다 — 이미지 스캔·SAST 와 같은 이유다.
	DependencyScanEndpoint string
	// Source 는 템플릿이 가져온 원본이다. 있으면 앱 자리(React·자리표시자 Dockerfile·README)를
	// 만들지 않고 원본 파일 위에 플랫폼 소유 파일만 얹는다(imported_source.go).
	Source *ImportedSource
}

type StageOptions struct {
	ImageScan bool
	// SAST 는 스택 SonarQube 로 소스를 분석하는 단계다(#64).
	SAST bool
	// SecretScan 은 gitleaks 로 시크릿 유출을 찾는 단계다(#80). 스택 의존이 없어 언제나 켜진다 —
	// 끄는 것은 정책(NULLUS_SECRET_DETECTION=off)이다.
	SecretScan bool
	// DependencyScan 은 락파일로 서드파티 의존성 취약점을 찾는 단계다(#79). 스택에서 의존성 스캔을
	// 골랐을 때만 — 스택 Trivy 서버가 있어야 한다.
	DependencyScan bool
}