shuim
9fab4018d4
하네스 규칙 검사 전역 위반 117→0, 회차별 검증(code-verifier opus 4도메인)으로 Critical/High 해소. 주문·리스크 - MDD 강제축소 반복 매도(종목별 완료 집합·재시도 상한·날짜 롤오버·잔고 오류 보류·epoch·장외 미주문) - KIS 거부 FAILED 기록, 결과 불명(전송 후) 재전송 금지·PENDING, 미전송 실패만 재시도(msg_cd 분류) - 국내 전량·손실 매도 시장가, 부분 익절 직전 현재가, 지정가만 미체결 취소(cancel_order_v2: TR 0013U·조직번호) + 0체결 롤백 - 누적 4%·현금·레버리지(신규분 포함)·사이클 내 매수 누적, 수동매수 공용 가드(buy_guards), 수동매도 DT 차감·락 - 가드 우회 엔드포인트 차단(/recommendations/auto-trade 위임, US /execute 매수 410·매도 가드) - 매수 슬롯=성공 매수, 평가 상한·회전, 업무거부/계좌 쿨다운, 프로세스 내 in-flight 주문 중복 차단 데이트레이딩 - 진입·청산 shield, 청산 진행 중 표식(소유 토큰), 2단계 청산 체크, 결과 불명 → 보유 감소 판정·비DT 차감 상한 - 전일 포지션 재시도(일시 실패 미산정), 분할매도 영속, ORB 구간 손절, /cycle 락, 사이클 내 현금 차감, 체결 수량 보정 스윙 - 손절 공백(판정 예외 시 하드 바닥), 단일 손절 소스·범위 검증, 매도 직전 KIS 잔고 상한(min(주문가능,보유)−DT) - 결과 불명 체결 대조·장부 반영, 대체가(나이·진입 이후·ATR 캐시), 분할 단계 기록, 국면 실패 fail-closed - 듀얼 플레이북·서킷브레이커 게이트, 평균회귀 우선·듀얼 독립, 시간손절 거래일 - 거래 확대(사용자 결정, 백테스트 미검증): RSI 46/35 정본 경로, 모멘텀 v2 ON, SIDEWAYS ADX AND, 트레일링 1차 익절 후, 20일 시간손절 ON 인프라·보안 - 계좌·손익 GET 인증, 세션 is_active·관리자 경로, 서명키 파생, realip, WS 토큰 마스킹 - KIS 토큰 즉시 실패(sleep 제거)·무효 시 캐시 삭제, 주문 5xx+JSON 본문 반환 - db_worker 종료 drain(멱등 재실행·커밋 불명 격리·예산·밴 커밋), stop_grace 40s, Redis 타임아웃·volatile-lru, /health DLQ·캐시 - KRX 휴장일, py3.11 비호환 f-string 수정 + Jenkins 이미지 내 compileall·헬스 실패 시 빌드 실패 하네스: rules_check 에 PEP 701 f-string 검사, 마커(allow-*), deploy 스모크 401 기준 CLAUDE.md: 실제 동작·플래그·백로그(§8.5-27~38) 갱신 backend 1451 passed / hooks 112 passed / tsc ok / py3.9 compile 0 errors Co-Authored-By: Claude Opus 5.5 <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