Task-persisted 결과 아티팩트 기반 운영 대안 후보 추천 구현

[learncold]

Summary

ResultAggregator가 남긴 persisted 결과 아티팩트를 바탕으로 운영 대안 후보를 생성하고, 위험 근거와 우선순위를 함께 제시하는 recommendation 경로를 구현한다.

Parent Issue

#5

Area

Analysis

Target Sprint

Sprint 3

Why Needed

source of truth는 recommendation을 결과 아티팩트 이후 단계로 두고, ResultAggregator를 즉석 계산기가 아니라 persisted artifact 생성 책임으로 본다. 따라서 recommendation도 ScenarioComparison과 CumulativeArtifact를 입력으로 사용해야 한다.

Scope

• ScenarioComparison과 CumulativeArtifact를 읽어 운영 대안 후보를 생성한다.
• 출구 추가 개방, 순차 퇴장, 일방통행, ControlZone 조정 같은 후보를 우선순위와 근거와 함께 정리한다.
• 추천 불가 사유를 persisted 결과 부족 여부와 연결해 설명한다.

Child Tasks

• Task-대안추천 data contract 추가 #243 대안추천 data contract 추가
• Task-대안추천 위험상황 감지 구현 #244 대안추천 위험상황 감지 구현
• Task-대안추천 추천 규칙 엔진 구현 #245 대안추천 추천 규칙 엔진 구현
• Task-대안추천 결과 UI 추가 #246 대안추천 결과 UI 추가
• Task-대안추천 회귀 테스트 정리 #247 대안추천 회귀 테스트 정리

Out of Scope

• 추천안을 ScenarioVariation으로 생성하는 UI workflow
• #85에서 다룸
• 추천 최적화 탐색 연구
• #107에서 조사

Core Design Criteria

• 입력은 persisted ScenarioComparison / CumulativeArtifact다.
• ResultAggregator는 recommendation 이전 단계에서 artifact를 생성/갱신한다.
• 추천 규칙은 application 표시가 아니라 분석 계층 책임으로 둔다.

Acceptance Criteria

• persisted artifact 기반으로 운영 대안 후보가 생성된다.
• 위험 근거와 우선순위가 함께 남는다.
• 결과가 부족하면 recommendation 불가 사유가 표시된다.

Related Docs

• docs/product/Product Backlog - Pathfinder 반영안.md
• docs/product/위험 정의.md
• docs/alternative-recommendation-plan.md
• docs/alternative-recommendation-evidence.md
• uml/domain-result-artifacts.puml
• uml/application-run-results-workflow.puml

Dependencies / Blockers

• Task-ResultAggregator 기반 persisted 결과 아티팩트 생성 구조 정리 #27 ResultAggregator 기반 persisted artifact가 hard dependency다.
• Task-추천안을 ScenarioVariation으로 생성하고 근거 비교 지원 구현 #85 scenarioize workflow가 후속 소비자다.
• #243부터 #247까지의 하위 Task로 구현 범위를 세분화한다.

Repository Checks

• I checked for an existing related issue or epic before creating or updating this task.
• I will keep the issue title aligned with the repository naming convention.