[Task] Agent MVP L1: 1개 종목 수동 데모 경로 (DART → Solar → 6항목 리포트)

[GoBeromsu]

배경

데이터 연결 레이어(PR #58/#60/#61)가 안정화되어 데모 fixture 위에서 워치리스트·대시보드가 동작한다. 다음 단계는 실제 agent 가치를 1개 종목 끝까지 보여주는 수동 데모 경로다.

Acceptance criteria (L1 = manual demo path)

사용자가 다음 시퀀스를 막힘 없이 완주할 수 있다:

1. 워치리스트에 종목 1개 추가 (예: 카카오)
2. AI 분석 버튼 클릭 (또는 manual check trigger)
3. Backend가 실제 DART API로 해당 종목의 최근 공시·재무를 가져온다
4. Backend가 Solar Pro 실호출로 STEP1(정량) + STEP2(정성) 분석
5. Frontend가 실제 6항목 체크리스트 + 단기/장기 리포트를 표시
6. 리스크 점수·레벨이 실제 분석 결과 기반

스케줄러 자동 트리거·다종목 배치·이메일/푸시 알림은 out of scope (L2 이상).

알려진 선행 작업 / 의존 이슈

• [Task] dev seed를 실제 DART 공시·KRX 주가 조회 결과 스냅샷으로 생성 #55 dev seed → 실데이터 스냅샷
• [Task] DART·KRX 실데이터 수집 integration 테스트 추가 #56 DART·KRX 실데이터 integration test
• [Task] KRX_API_KEY 기반 KRX 공공데이터포털 직접 수집 클라이언트 구현 #57 KRX 공공데이터 직접 수집 클라이언트

작업 분해 (체크리스트로 갱신)

• 현재 agent_report_runtime 경로가 데모 fixture vs 실호출 분기 어디까지 되어 있는지 확인
• UPSTAGE_API_KEY/DART_API_KEY 실키로 backend agent 동작 검증 (로컬)
• POST /api/v1/dev/reports/{corp_code} (또는 동급 엔드포인트) 실호출 모드 게이트 정리
• Frontend AI 분석 CTA → backend 실분석 결과 렌더 경로 e2e 확인
• 실패 시 fallback 메시지(예: rate-limited / missing key) UX 정리
• L1 데모 시나리오 1개 ("카카오로 보여드립니다") 스크립트화

관련 docs

• docs/03-interface-schema.md — A→B→C 스키마
• docs/05-feature-spec.md §5.3 — 6항목 판정 로직