Task-핵심 위험 지표와 history 수집 구조 구현

[learncold]

Summary

DoorHistory, RoomHistory, MeasurementRegionSeries 수집과 연결된 핵심 위험 지표 구조를 구현해 run 단위 persisted 결과가 병목/정체/탈출 지연 분석으로 이어지게 한다.

Parent Issue

#3

Area

Domain

Target Sprint

Sprint 2

Why Needed

문서 기준 MVP 코어는 병목·정체·탈출 지연을 기본 위험 축으로 삼고, door/room/measurement history를 persisted artifact의 입력으로 사용한다. 단순 demo metric 확장으로는 current source-of-truth와 맞지 않는다.

Scope

• door throughput/queue, room density/congestion, measurement region sampled metrics 구조를 정의한다.
• 핵심 위험 지표를 run 단위 summary와 history reference로 연결한다.
• 병목/정체/탈출 지연 지표가 heatmap, comparison, export 경로에서 재사용될 수 있게 정리한다.

Out of Scope

• 낙상/역방향·교차류 hotspot 탐지
• Task-낙상/연속 낙상 hotspot 탐지 구현 #81, #82에서 다룸
• smoke/FED/FDS 결과
• application visualization 자체

Core Design Criteria

• RunResult는 raw samples와 MetricSummary를 함께 참조할 수 있어야 한다.
• door/room/measurement history는 screen-only cache가 아니라 persisted artifact 파이프라인의 입력이 된다.
• 위험 축은 docs/product/위험 정의.md의 4축 용어를 따른다.

Acceptance Criteria

• DoorHistory, RoomHistory, MeasurementRegionSeries로 이어지는 수집 구조가 정리된다.
• 병목/정체/탈출 지연 핵심 지표가 run summary와 연결된다.
• 후속 heatmap/comparison/export가 이 구조를 읽을 수 있다.

Related Docs

• docs/product/Product Backlog - Pathfinder 반영안.md
• docs/product/위험 정의.md
• uml/domain-result-artifacts.puml
• uml/engine-routing-and-connectors.puml

Dependencies / Blockers

• Task-ResultAggregator 기반 persisted 결과 아티팩트 생성 구조 정리 #27 ResultAggregator task와 연결된다.
• Task-heatmap 및 위험 레이어 결과 뷰 구현 #28, Task-persisted ScenarioComparison 기반 비교 workflow 구현 #29, #87이 이 결과 구조를 후속 소비한다.

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.