STK10-10 ml 예측이 KRX 팩터를 입력으로 반영

작업 내용

ml 예측 함수가 KRX 수급 팩터를 입력 파라미터로 수용해 스코어에 반영한다. ml은 BE를 직접 호출하지 않는다 — worker가 BE read API로 팩터를 읽어 ml 호출 시 전달한다 (ml stateless 유지). 추천을 우선 적용하고, 포트폴리오·관심종목 예측도 팩터를 받도록 시그니처를 확장한다.

• 예측 입력에 수급 팩터 추가 (요청 바디 파라미터)
• 가중 반영: 외국인·기관 연속 순매수(+), 외국인 보유율 추세(+), 저PER·저PBR(+), 공매도 잔고비중 과다(−), 신용잔고 과열(−)
• 팩터 결측(null) 시 해당 가중을 제외하고 graceful 산정
• 기존 기술 모멘텀·뉴스 감성 가중과 합성

다이어그램

처리 흐름

sequenceDiagram
    participant Worker as worker
    participant ML as ml compute
    Worker->>ML: compute(inputs + factors)
    alt 팩터 존재
        ML->>ML: 수급 가중 합산
    else 결측
        ML->>ML: 해당 가중 제외 graceful
    end
    ML-->>Worker: predictions

클래스 의존

flowchart LR
    Worker[worker Refresh UseCase] --> ML[ml compute endpoint]
    ML --> Factor[factor 가중 로직]

테스트 케이스

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