99 lines
4.5 KiB
Markdown
99 lines
4.5 KiB
Markdown
# SDD: 분석 대상 결정과 실행 스냅샷
|
|
|
|
## 위치
|
|
|
|
- Milestone: [Milestone 문서](../../../phase/error-intelligence/milestones/analysis-target-selection.md)
|
|
- Phase: [PHASE.md](../../../phase/error-intelligence/PHASE.md)
|
|
|
|
## 상태
|
|
|
|
[승인됨]
|
|
|
|
## SDD 잠금
|
|
|
|
- 상태: 해제
|
|
- 사용자 리뷰: 없음
|
|
- 잠금 항목:
|
|
- 없음
|
|
|
|
## 문제 / 비목표
|
|
|
|
- 문제: 설정 변경과 동시 실행 중에도 어떤 저장소·운영 환경을 왜 선택했는지 재현 가능해야 한다.
|
|
- 비목표:
|
|
- 추론 기반 대상 탐색
|
|
- 다중 저장소 수정
|
|
- 운영 환경 쓰기
|
|
|
|
## Source of Truth
|
|
|
|
| 영역 | 기준 | 메모 |
|
|
|------|------|------|
|
|
| Roadmap | [Milestone 문서](../../../phase/error-intelligence/milestones/analysis-target-selection.md) | 선택·스냅샷 기능 범위 |
|
|
| Code | `internal/platform/database/migrations/`, `internal/domain/remediation/` | 규칙과 실행 스냅샷 |
|
|
| External Provider | 저장소 기준 리비전 조회 경계 | 리비전 값만 스냅샷에 보존 |
|
|
| User Decision | 없음 | 일치·우선순위·실패 기준이 확정됨 |
|
|
|
|
## State Machine
|
|
|
|
| 상태 | 진입 조건 | 다음 상태 | 근거 |
|
|
|------|-----------|-----------|------|
|
|
| 선택 대기 | 오류 묶음이 분석 후보가 됨 | 대상 선택됨 | 첫 일치 활성 규칙과 유효한 연결 |
|
|
| 선택 대기 | 일치 규칙 또는 유효 대상이 없음 | 선택 실패 | `target_selection` 표준 실패 |
|
|
| 대상 선택됨 | 기준 리비전 확인 성공 | 실행 스냅샷 생성 | 수정 작업과 대상 이력 트랜잭션 |
|
|
| 대상 선택됨 | 기준 리비전 확인 실패 | 선택 실패 | 저장소 조회 실패 원인 |
|
|
|
|
## Interface Contract
|
|
|
|
- 계약 원문: 없음
|
|
- 입력:
|
|
- 조직·프로젝트·입력 출처와 오류 source 필드
|
|
- 활성 분석 대상 규칙
|
|
- 출력:
|
|
- 저장소 ID, 기준 리비전과 읽기 전용 운영 환경 ID 목록
|
|
- 선택 규칙 ID 또는 표준 실패
|
|
- 금지:
|
|
- LLM으로 규칙 순서 변경
|
|
- 실행 생성 뒤 대상 스냅샷 덮어쓰기
|
|
- 다른 조직·프로젝트 대상 연결
|
|
|
|
## Acceptance Scenarios
|
|
|
|
| ID | Milestone Task | Given | When | Then |
|
|
|----|----------------|-------|------|------|
|
|
| S01 | `match-rule` | 여러 활성 규칙이 일치함 | 대상을 선택함 | 숫자가 가장 낮은 우선순위의 첫 규칙이 선택됨 |
|
|
| S02 | `validate-target` | 규칙 대상이 비활성 또는 다른 프로젝트임 | 대상을 검증함 | 선택이 거부되고 분석이 시작되지 않음 |
|
|
| S03 | `no-target-failure` | 일치 규칙이 없음 | 선택을 수행함 | `target_selection` 실패가 사용자에게 보고 가능하게 저장됨 |
|
|
| S04 | `resolve-revision` | 저장소 기준 가지가 존재함 | 리비전을 조회함 | 불변 리비전 식별자가 반환됨 |
|
|
| S05 | `create-run` | 대상과 리비전이 유효함 | 수정 작업을 생성함 | 저장소·리비전·운영 환경 스냅샷이 한 번 저장됨 |
|
|
| S06 | `selection-tests` | 실행 생성 후 규칙이 변경됨 | 기존 실행을 조회함 | 원래 스냅샷이 유지되고 새 설정 영향이 없음 |
|
|
|
|
## Evidence Map
|
|
|
|
| Scenario | Required Evidence | `agent-task` 연결 | 완료 Evidence 기대 |
|
|
|----------|-------------------|------------------|---------------------------|
|
|
| S01 | 규칙 우선순위 단위 검사 | `agent-task/m-analysis-target-selection/...` | `match-rule` 완료 근거 |
|
|
| S02 | 조직·프로젝트 FK 및 상태 검사 | `agent-task/m-analysis-target-selection/...` | `validate-target` 완료 근거 |
|
|
| S03 | 표준 실패 저장 통합 검사 | `agent-task/m-analysis-target-selection/...` | `no-target-failure` 완료 근거 |
|
|
| S04 | 저장소 경계 리비전 검사 | `agent-task/m-analysis-target-selection/...` | `resolve-revision` 완료 근거 |
|
|
| S05 | 수정 작업 원자성 DB 검사 | `agent-task/m-analysis-target-selection/...` | `create-run` 완료 근거 |
|
|
| S06 | 스냅샷 불변성 통합 검사 | `agent-task/m-analysis-target-selection/...` | `selection-tests` 최종 검증 |
|
|
|
|
## Cross-repo Dependencies
|
|
|
|
- 없음
|
|
|
|
## Drift Check
|
|
|
|
- [x] Milestone 기능 Task와 Acceptance Scenario가 일치한다.
|
|
- [x] Evidence Map이 code-review와 `complete.log`에서 검증 가능하다.
|
|
- [x] 외부 계약 원문을 SDD에 복제하지 않았다.
|
|
- [x] 사용자 리뷰가 필요한 항목이 없다.
|
|
|
|
## 사용자 리뷰 이력
|
|
|
|
- 없음
|
|
|
|
## 작업 컨텍스트
|
|
|
|
- 표준선: 명시 규칙의 결정성과 실행 입력 revision 보존을 우선한다.
|
|
- 후속 SDD: [IOP 분석 실행 연동](../../remediation-automation/iop-analysis-orchestration/SDD.md)
|