리서치 그룹 재설계 청사진

배경

virtual-insanity.net 웹앱 사이드바 "리서치" 그룹 5개 메뉴 중 섹터나침반을 제외한 4개(기업 리서치·증권사 리서치·채권·채권 트레이더)가 메롱 판정. 수리 이전에 각 페이지의 정의를 해리 투자 워크플로 관점에서 다시 잡는 작업을 먼저 수행.

해리 확정 사항

드릴다운 체인: 섹터나침반 → 기업 리서치 → (증권사 리포트 참고)로 연결, 각 페이지에 동선 녹임.
증권사 리서치: 보조 역할. 사이드바에서 완전 제거. 섹터/기업 맥락에서만 열리는 임베드·파라미터 필터 뷰로 전환.
채권 + 채권 트레이더: 하나로 합치고 내부 탭(실시간 / 브리핑 / 학습)으로 분리.
리포트 점수화: LLM 기반으로 바로 진입(규칙 기반 1단계 건너뜀).

최종 메뉴 구조

리서치 그룹 5개 → 3개로 축소.

메뉴	변화	정의
섹터 나침반	유지 + 드릴다운 링크	산업 국면 뷰 + 기업 점프 시작점
기업 리서치	재설계	기업별 테제 홈(워치리스트 + 8-Layer 카드)
채권	bond-trader 흡수	실시간·브리핑·학습 3탭 통합 뷰
~~증권사 리서치~~	사이드바 삭제	URL 유지, 파라미터 필터 임베드로만 호출
~~채권 트레이더~~	삭제	채권 페이지 실시간 탭으로 흡수

페이지별 정의 (확정)

1. 섹터 나침반 (`/market/sector-compass`)

역할: 산업 국면 파악. 변화 없음.
추가: 섹터 카드 각각에 "이 산업 기업 보기" 링크 → /research/?sector=<섹터명>
추가: 섹터 카드 하단 "관련 증권사 리포트 점수 상위 3건" 임베드 → 클릭 시 /analyst/research?sector=<섹터명> 전체 뷰

2. 기업 리서치 (`/research/`, 재설계)

역할: 개별 기업의 투자 테제 홈.
상단: 워치리스트 배지(활성 추적 기업 5~10개) + 신선도 bar(IR/공시/어닝콜 미열람 큐 카운트)
본문 1열: 기업 카드 그리드
각 카드: 로고·티커·섹터·현재 테제 한 줄·마지막 분석 일자·신선도 dot·진입/목표/손절가·IR/공시/리포트 카운트
섹터 필터 + 검색
본문 2열: 최근 업데이트 타임라인(어닝콜 도착·DART 공시·컨센서스 변경 등)
기업 상세 /research/<ticker>:
8-Layer 리서치 본문(company-research 스킬 산출물)
IR·공시·어닝콜 최신 섹션
관련 볼트 노트 링크
증권사 리포트 섹션(점수 높은 순 상위 5건 임베드 + 전체보기 링크)
데이터 모델: ticker, sector, company_name, watchlist_flag, thesis_summary, target/stop prices, last_updated
산출물 적재: company-research 스킬 실행 시 결과가 자동으로 기업별로 쌓이는 파이프라인 필요

3. 채권 (`/market/bond`, 통합)

역할: 채권 시장 실시간 모니터 + 일일 브리핑 아카이브 + 학습 자료.
탭 3개:
실시간: 국고 커브(2~30Y) / 커브 스프레드 / 크레딧 스프레드(레벨+변동) / IRS·Bond-Swap Basis / 글로벌 벤치마크(UST·JGB·Bund·Gilt) / 외평채 CDS / 오늘·다음 이벤트 — 기존 bond-trader 내용
브리핑: 황대진 일일 브리핑 날짜별 리스트 + 상세 — 기존 bond-study
학습: 강의노트 PDF — 기존 bond-study 강의노트
URL: /market/bond (구 /market/bond-study), /market/bond-trader는 301 리다이렉트로 ?tab=live
사이드바 "채권 트레이더" 제거

4. 증권사 리서치 (`/analyst/research`, 보조 뷰)

사이드바에서 제거. 독립 진입 포기.
파라미터 필수: ?sector=<섹터> 또는 ?company=<티커> 또는 ?watchlist=1
파라미터 없이 접근 시: "섹터 나침반 또는 기업 리서치에서 열어주세요" 안내 페이지
임베드용 partial template 제공: 섹터나침반·기업 리서치 내부에서 3~5건 카드 형태로 호출

드릴다운 체인 동선

섹터 나침반
  └ 섹터 카드 클릭
      └ 기업 리서치 (섹터 필터 적용)
          ├ 워치리스트 배지 + 기업 카드 그리드
          └ 기업 카드 클릭
              └ 기업 상세 /research/<ticker>
                  ├ 8-Layer 테제
                  ├ IR·공시·어닝콜
                  ├ 볼트 노트 연결
                  └ 증권사 리포트 섹션 (점수순 상위 5건)
                      └ "전체 보기" → /analyst/research?company=<ticker>

Breadcrumb: 섹터 나침반 › 반도체 › 엔비디아 각 페이지 상단 고정.

리포트 LLM 점수화

입력

리포트 메타(발행일·브로커·대상 종목·섹터·페이지수)
리포트 본문(PDF 텍스트 추출 또는 요약)
해리 볼트 활성 가설(~/knowledge-agent/ 하위 hypothesis 계열)
해리 관심 축: 밸류에이션·성장·모멘텀·배당·순환(섹터나침반 국면) 등

점수 기준 (LLM 프롬프트 설계)

가설 정합성(40%): 해리 볼트의 활성 가설과 방향성 일치/반박 여부
분석 깊이(25%): 재무모델 유무·데이터 풍부도·시나리오 분석 여부
차별성(20%): 컨센서스 대비 비대칭 뷰(상향/하향 강도, 언더커버드 종목 발굴)
신선도(15%): 발행일 가중(7일 이내 1.0, 30일 이내 0.7, 그 이상 0.4)

점수 표현

0~100 스케일
🟢 80+ / 🟡 60~79 / 🔴 60 미만
카드 우상단 배지. 클릭 시 점수 근거 bullet 3개(LLM이 생성)

적재 위치

기존 ~/.hermes/workspace/memory/cu-research/ 구조 확장
신규 필드: llm_score, score_breakdown (4개 항목별), score_reasons (bullet 리스트)
파이프라인: 기존 수집기(kr_research_collector.py, fnguide_snapshot.py) 이후 후처리 단계로 LLM 스코어링 스크립트 추가
배치 주기: 신규 리포트 발견 시 당일 내 1회 채점

구현 우선순위 (추후 태스크 분할용)

Phase 0 (긴급, 오늘 내)

[P0-1] bond-trader 500 긴급 수리: 템플릿 a.rate None 가드 한 줄 추가 (bond_trader.html:232)

Phase 1 (구조 정리, 1~2일)

[P1-1] 사이드바에서 "증권사 리서치"·"채권 트레이더" 제거 (base.html)
[P1-2] 채권 통합: /market/bond 신설 + 3탭 레이아웃, 구 /market/bond-study·/market/bond-trader 리다이렉트
[P1-3] 증권사 리서치 파라미터 필터 동작 + 파라미터 없을 시 안내 페이지
[P1-4] 증권사 리서치 임베드용 partial template 생성
[P1-5] naver/consensus 수집기 복구(4일 묵은 상태 해소)

Phase 2 (LLM 점수화, 2~3일)

[P2-1] 리포트 데이터 스키마에 llm_score·score_breakdown·score_reasons 필드 추가
[P2-2] LLM 스코어링 스크립트 작성(프롬프트 설계 + Claude/Codex 호출)
[P2-3] 수집 파이프라인에 스코어링 단계 훅
[P2-4] 증권사 리서치 템플릿에 점수 배지·근거 툴팁 UI 적용

Phase 3 (기업 리서치 재설계, 3~5일)

[P3-1] 기업 도메인 모델 설계 + 저장소(~/.hermes/workspace/memory/companies/ 또는 DB)
[P3-2] 워치리스트 관리 로직 + UI(추가/제거/순서)
[P3-3] 기업 카드 그리드 + 섹터 필터 + 검색
[P3-4] 기업 상세 페이지(8-Layer + IR/공시 + 볼트 노트 + 증권사 리포트 임베드)
[P3-5] company-research 스킬 산출물을 ~/.hermes/workspace/memory/companies/<ticker>/ 자동 적재 파이프라인
[P3-6] 최근 업데이트 타임라인 생성 로직

Phase 4 (드릴다운 체인, 1~2일)

[P4-1] 섹터 나침반 카드에 "기업 보기" 링크 추가
[P4-2] 섹터 나침반에 증권사 리포트 임베드 카드
[P4-3] 기업 상세에 증권사 리포트 임베드 섹션 배치
[P4-4] Breadcrumb 컴포넌트 + 각 페이지 적용

Phase 5 (채권 페이지 본격 확장, 2~3일)

[P5-1] bond-trader 빈 섹션 채우기: UST·JGB·Bund·Gilt 수집기 신설
[P5-2] 20Y/30Y 국고 커브 수집 추가
[P5-3] IRS·Bond-Swap Basis·외평채 CDS 수집기 신설
[P5-4] Gmail 브리핑 수집 안정화(14일 중 9일 누락 문제)
[P5-5] 크레딧 스프레드 레벨 표시 추가(현재는 전일비 bp만)

리스크 및 결정 필요 지점

기업 리서치 데이터 모델: JSON 파일 vs SQLite. Phase 3-1에서 결정. 해리 시스템은 기존에 대부분 JSON이므로 기본 JSON 채택, 워치리스트·검색 성능 이슈 시 SQLite 고려.
워치리스트 정의: 해리가 "활성 추적"을 어떻게 표시하는가? 별도 UI로 추가/제거할지, 최근 분석 빈도 기준 자동 산출할지 → Phase 3-2 착수 전 해리 확인 필요.

다음 액션

Phase 0 긴급 수리 바로 배분 (codex cmux, 5~10분)
Phase 1 병렬 배분 (cmux 3~4 세션)
Phase 1 완료 확인 후 Phase 2·3 병렬 진행(서로 독립)
각 Phase 완료 시 교차검증(Claude↔Codex) 후 다음 Phase

생성: 2026-04-24 Claude Opus 4.7 확정 대화: 해리와의 대화 3턴 (정의 초안 → 해리 결정 → 최종 확정)

리서치 그룹 재설계 청사진 (섹터-기업-채권 드릴다운 + 증권사 리포트 LLM 점수화)