종합부동산웹앱 5단계 목표가·급매 플래그 구현

질의 원문

다음 단계 차례로 진행해줘.

항목	등급	설명
플래그 계산	로컬 파생 지표	저장된 목표가·현재가·metric source만 사용
현재가	입력값 또는 수집값 등급 승계	`metric_sources.current_price.data_grade`와 함께 해석
출처 신뢰도	메타데이터 기반	`collected_at`, `original_verified`를 사용

action_flags_for_item()을 추가해 워치리스트 후보의 행동 플래그를 계산한다.
현재가가 목표가 이하이면 target_hit, 목표가보다 5% 이상 낮으면 bargain, 목표가보다 높지만 3% 이내이면 near_target을 표시한다.
현재가 출처 수집시점이 7일을 초과하면 stale_source를 표시한다.
현재가 출처가 있고 원본 확인이 아니면 needs_original_check를 표시한다.
/api/watchlist와 워치리스트 페이지 응답에 action_flags를 추가했다.
후보 카드에 플래그 뱃지와 data-watch-flag-target-hit, data-watch-flag-bargain, data-watch-flag-near-target 속성을 렌더링했다.
플래그는 JSON 저장소에 쓰지 않고 매 응답 시 파생한다.

RED: action_flags_for_item import 실패로 신규 플래그 테스트가 실패하는 것을 확인했다.
GREEN: python -m pytest tests/test_webapp_watchlist.py::test_watchlist_action_flags_identify_target_hit_bargain_and_near_target tests/test_webapp_watchlist.py::test_watchlist_action_flags_identify_stale_and_unverified_sources tests/test_webapp_watchlist.py::test_watchlist_api_includes_action_flags tests/test_webapp_watchlist.py::test_watchlist_page_renders_action_flags -q -> 4 passed
REVIEW: 코드 리뷰에서 실행계획 문서의 pytest node id 불일치를 지적받아 docs/plans/2026-08-11-watchlist-action-flags.md 명령을 실제 테스트명으로 수정했다.
focused: python -m pytest tests/test_webapp_watchlist.py tests/test_webapp_static_js.py -q -> 48 passed
focused+E2E+현황판: python -m pytest tests/test_webapp_watchlist.py tests/test_webapp_static_js.py tests/test_investment_board.py tests/test_webapp_watchlist_e2e.py -q -> 57 passed, 2 warnings
Node: node --test tests/webapp_watchlist_logic.test.js -> 6 passed
JS 문법: node --check src/realestate/webapp/static/app.js -> 통과
JS 문법: node --check src/realestate/webapp/static/watchlist_logic.js -> 통과
전체 테스트: python -m pytest -q -> 261 passed, 2 warnings
whitespace: git diff --check -> whitespace error 없음(CRLF 경고만 출력)
투자 현황판: python -m realestate.cli invest-board -> reports/investment_board.html 재생성