수정본

docs/USER_GUIDE.md

@@ -0,0 +1,211 @@
+# Auto Stock Trading System - 사용 가이드
+
+## 기능 소개
+
+### 1. 대시보드
+- 실시간 포트폴리오 현황
+- 총 자산 및 수익률 모니터링
+- 보유 종목 상세 정보
+
+### 2. 전략 룰 설정
+- 자동 매매 규칙 생성/수정/삭제
+- 규칙 활성화/비활성화
+- 조건 및 액션 설정
+
+### 3. 매매 로그
+- 모든 거래 내역 조회
+- 실행 상태 확인
+- 거래 통계
+
+### 4. MCP 상태 모니터
+- MCP 서버 연결 상태
+- 사용 가능한 도구 목록
+- 실시간 MCP 로그
+
+## 트레이딩 규칙 생성 가이드
+
+### 규칙 구조
+
+```json
+{
+  "name": "규칙 이름",
+  "description": "규칙 설명",
+  "rule_type": "BUY" | "SELL",
+  "conditions": {
+    // 실행 조건
+  },
+  "actions": {
+    // 실행할 액션
+  }
+}
+```
+
+### 조건 예시
+
+#### RSI 기반 매수
+```json
+{
+  "conditions": {
+    "rsi_below": 30,
+    "volume_above_average": 1.5
+  }
+}
+```
+
+#### 손절매
+```json
+{
+  "conditions": {
+    "loss_rate_below": -5
+  }
+}
+```
+
+#### 익절
+```json
+{
+  "conditions": {
+    "profit_rate_above": 15
+  }
+}
+```
+
+### 액션 예시
+
+#### 매수 액션
+```json
+{
+  "actions": {
+    "order_type": "BUY",
+    "quantity_percent": 10,
+    "max_amount": 1000000
+  }
+}
+```
+
+#### 매도 액션
+```json
+{
+  "actions": {
+    "order_type": "SELL",
+    "quantity_percent": 100
+  }
+}
+```
+
+## Claude AI 분석 활용
+
+### 1. 규칙 검증
+시장 상황에 맞게 규칙이 적절한지 Claude AI가 분석합니다.
+
+### 2. 시장 분석
+기술적 지표와 뉴스를 종합하여 시장 트렌드를 분석합니다.
+
+### 3. 리스크 평가
+포트폴리오와 거래 계획을 분석하여 리스크를 평가합니다.
+
+## MCP 도구
+
+### get_market_data
+시장 데이터를 조회합니다.
+
+```json
+{
+  "tool_name": "get_market_data",
+  "parameters": {
+    "stock_code": "005930",
+    "period": "D"
+  }
+}
+```
+
+### calculate_indicators
+기술적 지표를 계산합니다.
+
+```json
+{
+  "tool_name": "calculate_indicators",
+  "parameters": {
+    "price_data": [...],
+    "indicators": ["RSI", "MACD", "BB"]
+  }
+}
+```
+
+### check_portfolio
+현재 포트폴리오를 확인합니다.
+
+```json
+{
+  "tool_name": "check_portfolio",
+  "parameters": {}
+}
+```
+
+### execute_order
+주문을 실행합니다.
+
+```json
+{
+  "tool_name": "execute_order",
+  "parameters": {
+    "stock_code": "005930",
+    "order_type": "BUY",
+    "quantity": 10,
+    "price": 71000
+  }
+}
+```
+
+## 모범 사례
+
+### 1. 리스크 관리
+- 한 종목에 총 자산의 10% 이상 투자하지 않기
+- 손절매 규칙 반드시 설정
+- 일일 최대 거래 횟수 제한
+
+### 2. 규칙 우선순위
+- 손절매: 최고 우선순위 (100)
+- 익절: 높은 우선순위 (90)
+- 일반 매매: 중간 우선순위 (10-50)
+
+### 3. 백테스팅
+새로운 규칙은 과거 데이터로 먼저 테스트하세요.
+
+### 4. 모니터링
+- 실시간 로그 확인
+- 규칙 성과 정기 검토
+- MCP 서버 연결 상태 체크
+
+## 주의사항
+
+⚠️ **중요**: 이 시스템은 자동 매매를 수행합니다.
+- 실제 계좌로 사용하기 전에 충분히 테스트하세요
+- 시장 상황을 항상 모니터링하세요
+- 규칙을 신중하게 설정하세요
+- 손실 위험을 항상 고려하세요
+
+## 문제 해결
+
+### Q: 거래가 실행되지 않아요
+A: 
+1. 규칙이 활성화되어 있는지 확인
+2. 조건이 충족되었는지 확인
+3. 계좌 잔액 확인
+4. API 연결 상태 확인
+
+### Q: MCP 서버가 연결되지 않아요
+A:
+1. MCP 서버가 실행 중인지 확인
+2. Claude API 키가 올바른지 확인
+3. 네트워크 연결 확인
+
+### Q: 포트폴리오가 동기화되지 않아요
+A:
+1. "포트폴리오 동기화" 버튼 클릭
+2. API 키와 계좌번호 확인
+3. 한국투자증권 API 상태 확인
+
+## 지원
+
+문제가 발생하거나 도움이 필요하시면 GitHub Issues에 문의해주세요.