# 🔍 자동매매 점검 리포트

## 📋 체크리스트

### 1. ⏰ 장 운영 시간
**현재 상황:**
- 오늘: 2026년 2월 5일 (수요일)
- 한국 주식시장 정규 장시간: 09:00 ~ 15:30
- **문제:** 현재 시각이 장 마감 이후라면 자동매매가 중단됩니다

**확인 방법:**
```python
# 코드에서 확인
from app.core.market_schedule import is_market_open
print(is_market_open())  # False이면 장 마감
```

**해결책:**
- 장 시간(09:00~15:30) 내에 다시 확인
- 테스트 목적이라면 `market_schedule.py`에서 시간 체크 임시 비활성화

---

### 2. ⚙️ AUTO_TRADE_ENABLED 설정
**현재 설정:** `config.py`에 `AUTO_TRADE_ENABLED = True`로 설정되어 있음

**확인 필요:**
- `.env` 파일에서 `AUTO_TRADE_ENABLED=False`로 덮어쓰고 있는지 확인
- 환경 변수가 코드 기본값을 오버라이드할 수 있음

**확인 방법:**
```bash
docker exec autostock-backend env | grep AUTO_TRADE
```

**해결책:**
- `.env` 파일 확인 및 수정
- 또는 config.py에서 명시적으로 True 설정

---

### 3. 🔑 KIS API 인증 정보
**필수 설정:**
- `KIS_APP_KEY` (앱 키)
- `KIS_APP_SECRET` (앱 시크릿)
- `KIS_ACCOUNT_NO` (계좌번호)

**확인 방법:**
```bash
docker exec autostock-backend env | grep KIS_
```

**문제:**
- API 키가 없으면 주문 실행 불가
- 모의투자와 실투자 URL이 다름

**해결책:**
- `.env` 파일에 올바른 KIS API 정보 입력
- 모의투자: `https://openapivts.koreainvestment.com:29443`
- 실투자: `https://openapi.koreainvestment.com:9443`

---

### 4. 📊 추천 종목 존재 여부
**자동매매 실행 조건:**
1. 장이 열려 있어야 함
2. AUTO_TRADE_ENABLED = True
3. **추천 종목 리스트에 매수 신호가 있어야 함**

**코드 로직:**
```python
rec = await get_rule_based_recommendations_realtime()
if rec and rec.get("recommendations_by_rule"):
    # 자동매매 실행
else:
    logger.info("⏭️ Auto-trade skipped: no recommendations matched rules")
```

**확인 방법:**
```bash
curl http://localhost:8090/api/v1/recommendations/rule-based
```

**문제 가능성:**
- RSI, 스토캐스틱 등 기술적 지표가 매수 조건을 만족하는 종목이 없음
- TREND_FILTER_ENABLED=True인 경우 상승 추세 종목만 선택 (현재는 False)

---

### 5. 💾 데이터베이스 연결
**확인 항목:**
- PostgreSQL 컨테이너 실행 중
- 테이블 생성 완료 (portfolio, trade_history 등)

**확인 방법:**
```bash
docker ps | grep postgres
docker exec autostock-postgres psql -U autostock -d autostock_db -c "SELECT COUNT(*) FROM portfolio;"
```

---

### 6. 🔄 스케줄러 동작 여부
**백엔드 로그 확인:**
```bash
docker logs autostock-backend 2>&1 | grep "Auto-trade scheduler"
docker logs autostock-backend 2>&1 | grep "Market is closed"
docker logs autostock-backend 2>&1 | grep "Starting real-time analysis"
```

**기대 로그:**
- 장 중: "⏱️ Auto-trade scheduler started (every 60s)"
- 장 중: "🔄 Starting real-time analysis cycle..."
- 장 마감: "💤 Market is closed. Skipping auto-trade cycle. Next check in 30 minutes."

---

## 🎯 가장 가능성 높은 원인

### 1순위: 장 마감 시간
- **증상:** 15:30 이후에는 자동매매가 중단됨
- **해결:** 다음 거래일 09:00~15:30에 다시 확인

### 2순위: 매수 조건 미충족
- **증상:** 추천 종목 리스트가 비어있음
- **원인:** 
  - 현재 시장 상황에서 RSI < 40 또는 Stochastic < 30 조건을 만족하는 종목 없음
  - 모든 종목이 과매수 상태이거나 중립 구간
- **해결:** 
  - 매수 조건 완화 (RSI < 50, Stochastic < 40 등)
  - 또는 시장이 조정 받을 때까지 대기

### 3순위: KIS API 인증 문제
- **증상:** API 호출 시 401/403 에러
- **해결:** .env 파일에 올바른 API 키 설정

---

## ✅ 즉시 확인할 사항

1. **현재 시각 확인**
   ```bash
   TZ='Asia/Seoul' date '+%H:%M'
   ```
   - 09:00 ~ 15:30 범위 내인가?

2. **백엔드 컨테이너 상태**
   ```bash
   docker ps | grep backend
   ```
   - "Up" 상태인가?

3. **최근 로그 확인**
   ```bash
   docker logs autostock-backend --tail 50
   ```
   - 에러 메시지가 있는가?
   - "Market is closed" 메시지가 있는가?

4. **추천 종목 API 테스트**
   ```bash
   curl http://localhost:8090/api/v1/recommendations/rule-based
   ```
   - 종목 리스트가 반환되는가?

---

## 🔧 임시 테스트 방법 (개발 환경)

장 시간 체크를 임시로 비활성화하여 테스트:

```python
# backend/app/core/market_schedule.py 수정
def is_market_open() -> bool:
    return True  # 임시로 항상 True 반환 (테스트용)
```

**주의:** 실제 운영 환경에서는 절대 사용 금지!