..

backend/ReadMe.md

@@ -7,7 +7,11 @@
 ### 1.1 Headless Execution Engine
 1. **Batch Engine**: 매 1분마다 `auto_trade_configs`를 스캔하여 예약된 시각에 주문 실행.
 2. **Monitoring Engine**: WebSocket 시세를 수신하여 `reserved_orders` 조건 감시 및 자동 매매.
-3. **AI Proxy**: API 보안을 위해 AI 분석 및 뉴스 요청 중계.
+3. **Market Index Collector**: 
+   - **조회**: 매 5분마다 주요 시장 지수(KOSPI, KOSDAQ, NASDAQ, S&P500, USD/KRW) 수신.
+   - **기록**: 1시간마다 해당 시점의 최종 데이터를 `market_index_history` 테이블에 기록(Upsert).
+   - **프론트 연동**: 프론트엔드는 DB에 저장된 최신 데이터를 5분 단위로 폴링하여 대시보드 업데이트.
+4. **AI Proxy**: API 보안을 위해 AI 분석 및 뉴스 요청 중계.
 
 ## 2. 상세 명세 가이드
 - **DB 스키마**: [tables.md](./tables.md) 참조.

backend/tables.md

@@ -69,3 +69,11 @@
 - `foreignNetBuy`: INTEGER
 - `institutionalNetBuy`: INTEGER
 - **용도**: `StockItem` 테이블을 직접 확장하거나 별도 통계 테이블로 관리하여 발굴 데이터 조회 성능 최적화.
+## 9. market_index_history (시장 지수 이력)
+- `index_id`: TEXT (PK - KOSPI, KOSDAQ, NASDAQ, SP500, USDKRW 등)
+- `timestamp`: DATETIME (PK - 1시간 단위 정규화된 시각)
+- `value`: REAL
+- `change`: REAL
+- `change_percent`: REAL
+- `updated_at`: DATETIME (실제 마지막 갱신 시각)
+- **용도**: 트렌드 분석 및 대시보드 인덱스 카드 표시용. 백엔드가 5분 단위로 조회하되, DB에는 1시간 단위로 마지막 데이터를 Upsert 하여 누적.