STK10-10 ml 추천 스코어링에 KRX 팩터 반영

작업 내용

ml 추천 스코어링이 STK10-09 read API의 수급 팩터를 입력으로 반영한다. ml은 stateless 유지(자체 저장 없음).

• BE /market-flow 호출 client 추가
• 스코어링에 가중 반영: 외국인·기관 연속 순매수(+), 외국인 보유율 추세(+), 저PER·저PBR(+), 공매도 잔고비중 과다(−), 신용잔고 과열(−)
• 팩터 결측 시 해당 가중을 제외하고 graceful 산정 (BE 미수집·조회 실패 모두 포함)
• 기존 기술 모멘텀·뉴스 감성 가중과 합성

다이어그램

처리 흐름

sequenceDiagram
    participant Score as scoring
    participant BE as MarketFlow API
    Score->>BE: GET /market-flow?symbol&baseDate
    BE-->>Score: factors (null 허용)
    alt 팩터 존재
        Score->>Score: 수급 가중 합산
    else 결측
        Score->>Score: 해당 가중 제외 graceful
    end

클래스 의존

flowchart LR
    Scoring[recommendation scoring] --> Client[market_flow client]
    Client --> BE[BE /market-flow]

테스트 케이스

• 수급 팩터가 있으면 스코어에 가중 반영된다
• 외국인·기관 연속 순매수가 점수를 가산한다
• 공매도 잔고비중 과다·신용 과열이 점수를 감산한다
• BE 조회 실패·팩터 결측 시 해당 가중을 제외하고 산정한다 (예외 전파 없음)
• 기술 모멘텀·뉴스 감성 가중과 합성된 최종 점수를 산출한다