System overview
Alpha-Prime 전체 구조
Alpha-Prime은 입력 수집, 신호 계산, 원본 상태 관리, 리포트 생성, 대시보드 표시, 예측 피드백을 연결합니다. 초보자는 “어떤 화면을 누르나”보다 먼저 무엇이 원본이고 무엇이 파생 결과인지를 알아야 합니다.
정신 모델
| 층 | 역할 | 사용자가 볼 점 |
|---|---|---|
| 수집 | 외부 데이터와 내부 파일을 만든다 | 날짜, 실패 여부, stale/fallback |
| 시그널 | market_top/FTD/macro_regime/theme 판단을 만든다 | 신호 간 충돌과 시장별 분리 |
| 원본 상태 | portfolio.json/watchlist.json/predictions JSON | 보유/관심/예측의 진실 원본 |
| 리포트 | 사람이 읽는 판단 문서 | 근거와 실행 경계 |
| 대시보드 | 원본과 리포트를 읽기 쉽게 보여준다 | freshness/source_dates와 시장 스코프 |
| 피드백 | 예측과 실제 결과를 비교한다 | 오류 원인과 다음 기준 |
사용자가 실제로 따라갈 읽기 순서
- 오늘 시장 스코프 확인: KR인지 US인지, public인지 local인지 먼저 봅니다.
- 데이터 신선도 확인: source_dates, generated_at, 파일 날짜를 확인합니다.
- 시장 온도 확인: macro_regime과 market_top을 함께 봅니다.
- 테마/섹터 확인: 주도 테마가 살아있는지, 과열인지, 냉각인지 봅니다.
- 보유/관심 분리: portfolio와 watchlist를 구분합니다.
- 실행 언어 확인: BUY_NOW, STARTER_ONLY, WATCH, AVOID 같은 label을 주문이 아니라 판단 상태로 읽습니다.
- 사후 피드백: 실제 결과가 나오면 예측 오류를 남깁니다.
범위 밖
이 매뉴얼은 실거래 API 연결, 브로커 주문, 투자 자문, 개별 종목 매수 권유를 다루지 않습니다. 또한 Alpha-Prime 원본 소스나 설정을 변경하지 않습니다.