shuim
7abbb3411c
## 재기동 내구성 - scheduler: 복원 직후 reset_if_new_day()가 복원분을 전부 폐기하던 버그 (begin_restore()로 날짜 경계를 선확정. 복원 성공 로그는 뜨는데 실제로는 지워졌다) - 일일 안전장치(daily_pnl/loss_streak_today/closed_today) Redis 영속화 날짜를 키와 페이로드 양쪽에 실어 이중 게이트, 복원은 보수적 병합 (손익 min/연패 max/청산목록 합집합 — 복원이 안전장치를 약화시킬 수 없다) - db_worker 종료 drain이 insert_trade_history만 커밋하고 포지션 추적 행은 DLQ로 버리던 비대칭 제거 + DLQ 재처리 경로 신설(쓰기 전용이었다) - 장중 기동 시 ORB 소급 수집(backfill), 전일 캔들 혼입 차단 - swing/exit_service "보유 종목 없음" debug→info, 10회 연속 warning ## DT 진입 복구 - 워밍업 회귀 복구: 1b9257c(2026-09-28)가 조회 계층에 당일 필터를 넣어 5분봉 RSI(14)/BB(20) 워밍업이 죽고 VWAP/RSI_BB가 10:15/10:40 이전 발화 불가가 됐다. 필터를 삭제하지 않고 용도별로 분리 (get_minute_chart_full_day_v2 신설, 기존 메서드·3개 호출부 동작 무변경) - 거래량 게이트 비교 대상 교정: 형성 중 봉 → 완성봉 (5분봉·ORB 1분봉 양쪽) 임계값(1.3/1.5)은 불변, 고친 것은 비교 대상뿐 - 세션 경계 차단: _last_session_candles()로 거래량 비교가 전일 봉을 잡아 개장 직후 게이트가 자동 통과하는 것을 방지 - 스캔 선조회(동시성 4)·종목 타임아웃·시간예산·라운드로빈 + 잘린 종목 수 로그 - watchlist 30분 갱신 시 ORB 보유 종목 우선 유지 ## 유입 잔고 격리 - sync_portfolio()가 시스템 매수 근거 없는 KIS 잔고를 자기 스윙 포지션으로 편입해 자동 손절로 처분하던 문제 → strategy_type='external' 격리 (승격만 허용, 강등 없음. 기존 행은 수동 SQL 필요) - 격리분 손절선 이탈은 집행 없이 warning + summary 노출 - 수동 청산 경로에 record_trade_result 누락 보강, 전략 간 당일 쿨다운 ## 4% 상한 - market_data 표시 경로 클램프 누락 + confidence 배율 후 재클램프 - 회귀 방지 테스트(AST로 가드가 try 밖에 있는지 검증) ## 프론트 - 총자산 보정 가드(3%·종목수·가격결손·국내분 한정), 원인 미규명 명시 - cumulative_realized_pl이 /portfolio/combined에 없어 항상 0이던 문제 테스트 579 → 677 passed / 0 failed (소켓 차단 하 통과, 실호출 없음) 전략 임계값 변경 0건 ⚠️ 워밍업 복구의 효과 크기는 미확정 — KIS 분봉 API에 날짜 파라미터가 없어 미래 ref_time에 전일 데이터를 주는지가 미검증 전제다. 배포 후 "[분봉] 워밍업 5분봉 N봉 (당일 a + 전일 b)" 로그의 b로 확정할 것. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Auto Stock Trading System with MCP
Claude AI와 MCP(Model Context Protocol)를 활용한 한국 주식 자동매매 시스템
시스템 아키텍처
- Frontend: React + TypeScript + Vite
- Backend: Python FastAPI + WebSocket
- MCP Server: Claude AI 통합
- Database: PostgreSQL
- Cache: Redis
- Message Queue: RabbitMQ
- API: 한국투자증권 API
주요 기능
- 실시간 시장 데이터 수집
- Claude AI 기반 규칙 검증
- 자동 매매 실행
- 포트폴리오 관리
- 실시간 모니터링
프로젝트 구조
auto-stock/
├── frontend/ # React 프론트엔드
├── backend/ # FastAPI 백엔드
├── mcp-server/ # MCP 서버
├── docker/ # Docker 설정
├── deploy/ # NAS 배포
├── docs/ # 문서 (아래 목록)
└── scripts/ # 배포 스크립트
문서
작업 규칙과 전략 명세는 CLAUDE.md 가 정본이다. 파라미터 값을 확인할 때는 §0(파라미터 우선순위)을 먼저 읽을 것.
| 문서 | 내용 |
|---|---|
| CLAUDE.md | 작업 규칙·전략 명세·미해결 항목 (정본) |
| docs/INSTALLATION.md | 설치 |
| docs/USER_GUIDE.md | 사용법 |
| docs/PROJECT_STRUCTURE.md | 코드 구조 |
| docs/backend_guide.md | 백엔드 가이드 |
| docs/API_DOCS.md | API 명세 |
| docs/API_SAFE_OPERATION.md | API 안전 운영 |
| docs/RISK_MANAGEMENT_API.md | 리스크 API |
| docs/BATCH_GUIDE.md | 배치 분석 (cron 3개 잡) |
| deploy/NAS-SETUP-GUIDE.md | NAS 배포 |
| docs/multi_tenant_design.md | 멀티테넌트 설계 |
| docs/multi_tenant_phase1_review.md | 멀티테넌트 1단계 검수 |
이력 참고용(현행 아님): docs/REFACTORING_PLAN.md(폐기), docs/AUTOTRADE_DIAGNOSIS.md, docs/SPEED_OPTIMIZATION.md
빠른 시작
# 환경 변수 설정
cp .env.example .env
# 기본값
# - `DATABASE_URL`은 `.env.example`에 이미 도커 컨테이너(127.0.0.1:5432)를
# 가리키도록 설정되어 있습니다. 로컬 개발 시 별도 수정이 필요 없습니다.
# 원격 DB를 사용하려면 여기에 URL을 덮어쓰십시오.
# Docker로 전체 시스템 시작
./scripts/deploy.sh
# 개발 모드
./scripts/dev.sh
환경 변수
.env 파일에 다음 설정 필요:
KOREA_INVESTMENT_APP_KEY: 한국투자증권 앱키KOREA_INVESTMENT_APP_SECRET: 한국투자증권 시크릿ANTHROPIC_API_KEY: Claude API 키DATABASE_URL: PostgreSQL 연결 URL (기본값은 도커 컨테이너)REDIS_URL: Redis 연결 URL
라이센스
MIT