[이슈 #35 자동] 모듈 B/C: ai 레포 서빙 API 연동 (/forecasts, /supply-risk, /external-indicators)

[choigod1023]

Description

ai 레포 서빙 API가 아직 배포되지 않은 상태를 확인하고(로컬 실행만 존재, 배포 설정 없음), /forecasts·/supply-risk를 그동안 완전히 가공된 시드값([MOCK]) 대신 backend Neon Postgres에 이미 적재된 실 AI 산출물(inventory.mu_forecast/supply_risk_level)을 폴백으로 소비하도록 전환했습니다. /external-indicators는 원자재 시세·뉴스 등 제3자 소스가 원천이라 내부 DB로 대체할 실데이터가 없어, [MOCK] 유지로 폴백 정책을 확정했습니다.
Related #35

Type

• 새로운 기능
• 버그 수정
• UI/UX 변경
• 리팩토링
• 의존성 추가/수정

Screenshots

Before	After

To Reviewer

이슈 #35 자동 구현 초안입니다 — 검토 후 머지해주세요.

• ai 서빙 배포 확인: 현재 ai 레포는 로컬 uvicorn/배치 실행만 있고 배포 설정이 없어(모듈 B/C: ai 레포 서빙 API 연동 (/forecasts, /supply-risk, /external-indicators) #35 본문과 동일하게 재확인), 진짜 프록시 호출은 이번 범위에서 불가능합니다.
• /forecasts, /forecasts/{institution_id}/{standard_code}: db/queries.py에 forecasts_from_inventory()/forecast_one_from_inventory()를 추가해 inventory.mu_forecast(ai#24/사용자 관리 API 추가 (GET/POST/PATCH /users) — 관리자 콘솔에서 계정 생성/역할변경 가능하게 #25 산출물, 소진예측용 일수요율)·mu_corrected·demand_class·demand_pattern을 그대로 노출합니다. 응답에 "source": "backend-mu-forecast"로 소비 경로를 명시했습니다. 기존 [MOCK] 표시는 제거했습니다(완전 가상 데이터가 아니라 실제 AI 산출물이므로).
• /supply-risk, /supply-risk/{item_group_id}: supply_risk_by_group()/supply_risk_group_detail()을 추가해 inventory.supply_risk_level(메타코드 기반 실데이터, scripts/fix_inventory_stats.py)을 품목군 단위로 집계합니다. 레벨은 그룹 내 최고 심각도, riskScore는 심각도 가중 비율로 계산했습니다. 원본 MOCK의 뉴스·원자재 근거(evidenceNews/topContributors)는 ai/data 소유 산출물이라 이 폴백에는 없고, 대신 실제 고위험(CRITICAL/WARNING) 기관 목록(topInstitutions)을 근거로 제공합니다.
• /external-indicators(폴백 정책 결정): 원자재 시세(PETRONET)·뉴스 위험지수는 backend DB에 대체 가능한 실데이터가 전혀 없어(재고/기관 데이터와 무관), ai 서빙 배포 전까지 시드 유지로 정책을 확정했습니다. [MOCK] 표시는 그대로 뒀습니다.
• 범위 밖(후속 권장): GraphQL 병행(graphql_schema.py)은 PR #48과 동일한 판단으로 REST 우선 구현, 이번 초안 범위 밖입니다. item_groups 25개 공식분류 체계와 ai 응답 스키마 조율은 ai 레포와의 협의가 필요해 코드 변경 범위 밖입니다.

py_compile로 전체 모듈 문법 검증했으며, 실제 DB 응답은 프리뷰 배포에서 확인 부탁드립니다.

PR Checklist

• Commit Message Convention을 준수했습니다.
• Code Convention을 준수했습니다.
• 변경한 기능이 잘 동작하는지 테스트했습니다.

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
backend	Ready	Preview	Aug 7, 2026 2:44am