ariadne/agent-roadmap/phase/error-intelligence/milestones/analysis-target-selection.md

# Milestone: 분석 대상 결정과 실행 스냅샷

## 위치

- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
- Phase: [PHASE.md](../PHASE.md)

## 목표

오류 입력 출처와 source 필드를 등록된 우선순위 규칙에 대조해 분석할 저장소와 읽기 전용 운영 환경을 결정한다. 선택 결과와 기준 리비전을 수정 작업에 복사해 이후 설정 변경이 진행 중 실행의 의미를 바꾸지 않게 한다.

## 상태

[계획]

## 승격 조건

- 없음

## 구현 잠금

- 상태: 해제
- SDD: 필요
- SDD 문서: [SDD.md](../../../sdd/error-intelligence/analysis-target-selection/SDD.md)
- SDD 사유: 결정적 규칙 평가, revision 보존, 실패 처리와 수정 작업 DB lifecycle을 다룬다.
- 잠금 해제 조건:
  - [x] SDD 잠금이 해제되어 있다.
  - [x] SDD 사용자 리뷰가 없거나 해결되어 있다.
  - [x] Acceptance Scenario가 Milestone 기능 Task와 연결되어 있다.
  - [x] Evidence Map이 완료 시 검증 가능한 근거와 연결되어 있다.
- 결정 필요: 없음

## 범위

- 입력 출처와 source 필드의 정확 일치 및 빈 조건의 포괄 일치
- 낮은 숫자 우선순위부터 첫 일치 규칙 선택
- 대상 없음 또는 비활성 연결의 표준 실패 기록
- 저장소 기준 리비전 확인
- 저장소, 기준 리비전과 운영 환경 목록의 수정 작업 스냅샷

## 기능

### Epic: [selection] 결정적 대상 선택

같은 설정과 오류에 항상 같은 선택 결과를 낸다.

- [ ] [match-rule] 입력 출처와 source 필드를 활성 규칙에 대조하고 가장 낮은 우선순위의 첫 일치 규칙을 선택한다.
- [ ] [validate-target] 선택된 저장소와 운영 환경이 같은 조직·프로젝트에 속하고 활성 상태인지 확인한다.
- [ ] [no-target-failure] 일치 규칙이나 유효한 대상이 없으면 `target_selection` 단계의 표준 실패를 기록하고 분석을 시작하지 않는다.

### Epic: [snapshot] 실행 입력 고정

진행 중 설정 변경으로부터 수정 작업을 격리한다.

- [ ] [resolve-revision] 저장소 제공자 경계에서 기준 가지의 불변 리비전을 확인한다.
- [ ] [create-run] 선택된 저장소, 기준 리비전, 운영 환경 목록과 처리 방식을 수정 작업 및 하위 대상 이력에 원자적으로 저장한다.
- [ ] [selection-tests] 우선순위, 포괄 조건, 설정 변경 후 스냅샷 불변성과 교차 조직 참조 차단을 검증한다. 검증: 규칙 단위 검사와 PostgreSQL 통합 검사가 통과한다.

## 완료 리뷰

- 상태: 없음
- 요청일: 없음
- 완료 근거: 없음
- 검토 항목: 결정성, 리비전 보존과 표준 실패 근거
- agent-ui 상태 반영: 해당 없음
- 리뷰 코멘트: 없음

## 범위 제외

- LLM을 사용한 추론 기반 대상 선택
- 여러 저장소를 동시에 수정하는 작업
- 운영 환경 쓰기

## 작업 컨텍스트

- 관련 경로: `internal/platform/database/migrations/`, `internal/domain/remediation/`, `internal/integration/`
- 표준선: 규칙은 정확 일치와 명시 우선순위만 사용하고 선택 결과를 실행 이력에 복사한다.
- 선행 작업: [오류 수집과 중복 통합](error-ingestion-correlation.md)
- 후속 작업: [IOP 분석 실행 연동](../../remediation-automation/milestones/iop-analysis-orchestration.md)
- 확인 필요: 없음