feat: implement ML filter with LightGBM for trading signal validation

- Added MLFilter class to load and evaluate LightGBM model for trading signals.
- Introduced retraining mechanism to update the model daily based on new data.
- Created feature engineering and label building utilities for model training.
- Updated bot logic to incorporate ML filter for signal validation.
- Added scripts for data fetching and model training.

Made-with: Cursor

docs/plans/2026-03-01-fix-pandas-ta-python312.md

@@ -0,0 +1,275 @@
+# pandas-ta Python 버전 호환성 수정 계획
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** Jenkins CI에서 `pandas-ta==0.4.71b0`이 Python 3.11에서 설치 실패하는 문제를 해결한다.
+
+**Architecture:** `pandas-ta==0.4.71b0`은 Python >=3.12를 요구하므로, Dockerfile의 베이스 이미지를 `python:3.11-slim`에서 `python:3.12-slim`으로 업그레이드한다. `requirements.txt`의 의존 패키지 버전도 Python 3.12와 호환되는 버전으로 정리한다.
+
+**Tech Stack:** Docker, Python 3.12-slim, pandas-ta 0.4.71b0, python-binance 1.0.19
+
+---
+
+## 문제 분석
+
+Jenkins 빌드 로그 오류:
+```
+ERROR: Ignored the following versions that require a different python version:
+  0.4.67b0 Requires-Python >=3.12; 0.4.71b0 Requires-Python >=3.12
+ERROR: Could not find a version that satisfies the requirement pandas-ta==0.4.71b0
+```
+
+**원인:** `requirements.txt`에 `pandas-ta==0.4.71b0`이 명시되어 있으나, Dockerfile 베이스 이미지가 `python:3.11-slim`이라 Python 3.12 이상을 요구하는 `pandas-ta`를 설치할 수 없다.
+
+**해결 방향:** Dockerfile 베이스 이미지를 `python:3.12-slim`으로 변경한다.
+
+---
+
+## Task 1: Dockerfile 베이스 이미지 업그레이드
+
+**Files:**
+- Modify: `Dockerfile:1`
+
+**Step 1: Dockerfile 수정**
+
+`Dockerfile` 1번째 줄을 다음과 같이 변경한다:
+
+변경 전:
+```dockerfile
+FROM python:3.11-slim
+```
+
+변경 후:
+```dockerfile
+FROM python:3.12-slim
+```
+
+**Step 2: 변경 내용 확인**
+
+```bash
+head -1 /Users/gihyeon/github/cointrader/Dockerfile
+```
+
+Expected:
+```
+FROM python:3.12-slim
+```
+
+---
+
+## Task 2: requirements.txt 의존성 호환성 검토 및 수정
+
+**Files:**
+- Modify: `requirements.txt`
+
+**Step 1: 현재 requirements.txt 내용 확인**
+
+```bash
+cat /Users/gihyeon/github/cointrader/requirements.txt
+```
+
+Expected (현재 내용):
+```
+python-binance==1.0.19
+pandas>=2.2.0
+pandas-ta==0.4.71b0
+python-dotenv==1.0.0
+httpx>=0.27.0
+pytest>=8.1.0
+pytest-asyncio>=0.24.0
+aiohttp==3.9.3
+websockets==12.0
+loguru==0.7.2
+```
+
+**Step 2: pandas-ta 0.4.71b0의 의존성 확인**
+
+PyPI 정보에 따르면 `pandas-ta==0.4.71b0`은 다음을 요구한다:
+- `numba==0.61.2`
+- `numpy>=2.2.6`
+- `pandas>=2.3.2`
+
+`requirements.txt`의 `pandas>=2.2.0`은 `pandas>=2.3.2`를 만족하므로 문제없다.  
+단, `numba`가 명시되어 있지 않아 pandas-ta 설치 시 자동으로 설치된다.
+
+**Step 3: requirements.txt 수정 (pandas 최소 버전 상향)**
+
+`pandas>=2.2.0`을 `pandas>=2.3.2`로 변경하여 pandas-ta의 요구사항을 명시적으로 반영한다:
+
+변경 전:
+```
+pandas>=2.2.0
+```
+
+변경 후:
+```
+pandas>=2.3.2
+```
+
+**Step 4: 변경 내용 확인**
+
+```bash
+grep "pandas" /Users/gihyeon/github/cointrader/requirements.txt
+```
+
+Expected:
+```
+pandas>=2.3.2
+pandas-ta==0.4.71b0
+```
+
+---
+
+## Task 3: 로컬 Docker 빌드 테스트
+
+> Docker가 설치된 환경에서만 실행한다.
+
+**Step 1: Docker 빌드**
+
+```bash
+cd /Users/gihyeon/github/cointrader
+docker build -t cointrader:test .
+```
+
+Expected: 빌드 성공 (`Successfully tagged cointrader:test` 또는 `#N DONE`)
+
+**Step 2: 빌드된 이미지의 Python 버전 확인**
+
+```bash
+docker run --rm cointrader:test python --version
+```
+
+Expected:
+```
+Python 3.12.x
+```
+
+**Step 3: pandas-ta import 확인**
+
+```bash
+docker run --rm cointrader:test python -c "import pandas_ta; print(pandas_ta.__version__)"
+```
+
+Expected:
+```
+0.4.71b0
+```
+
+**Step 4: 테스트 이미지 정리**
+
+```bash
+docker rmi cointrader:test
+```
+
+---
+
+## Task 4: git 커밋 및 Gitea push
+
+**Files:**
+- Modify: `Dockerfile`
+- Modify: `requirements.txt`
+
+**Step 1: git 상태 확인**
+
+```bash
+cd /Users/gihyeon/github/cointrader
+git status
+```
+
+Expected:
+```
+modified:   Dockerfile
+modified:   requirements.txt
+```
+
+**Step 2: 변경 내용 검토**
+
+```bash
+git diff Dockerfile requirements.txt
+```
+
+Expected:
+- `Dockerfile`: `-FROM python:3.11-slim` → `+FROM python:3.12-slim`
+- `requirements.txt`: `-pandas>=2.2.0` → `+pandas>=2.3.2`
+
+**Step 3: 스테이징**
+
+```bash
+git add Dockerfile requirements.txt
+```
+
+**Step 4: 커밋**
+
+```bash
+git commit -m "fix: upgrade to Python 3.12 to support pandas-ta>=0.4.67b0"
+```
+
+Expected: 커밋 성공
+
+**Step 5: Gitea push**
+
+```bash
+git push origin main
+```
+
+Expected: push 성공 후 Jenkins가 자동으로 새 빌드를 트리거함
+
+**Step 6: 커밋 확인**
+
+```bash
+git log --oneline -3
+```
+
+Expected: 방금 만든 커밋이 최상단에 표시됨
+
+---
+
+## Task 5: Jenkins 빌드 재실행 및 결과 확인
+
+**Step 1: Jenkins 빌드 트리거**
+
+Gitea push 후 Jenkins Webhook이 설정되어 있다면 자동으로 빌드가 트리거된다.  
+수동으로 트리거하려면 Jenkins 웹 UI에서 `cointrader` 파이프라인 → `Build Now` 클릭.
+
+**Step 2: 빌드 로그에서 성공 확인**
+
+Jenkins 빌드 로그에서 다음 내용이 나타나야 한다:
+
+```
+#9 [5/7] RUN pip install --no-cache-dir -r requirements.txt
+...
+Successfully installed pandas-ta-0.4.71b0 ...
+#9 DONE xx.xs
+```
+
+오류 없이 `[Build Docker Image]` 스테이지가 완료되어야 한다.
+
+**Step 3: 전체 파이프라인 성공 확인**
+
+Jenkins 빌드 결과가 `SUCCESS`로 표시되어야 한다:
+```
+Finished: SUCCESS
+```
+
+---
+
+## 트러블슈팅
+
+| 문제 | 원인 | 해결 |
+|------|------|------|
+| `python-binance==1.0.19` 설치 실패 | Python 3.12 비호환 | `python-binance>=1.0.19`로 변경하거나 최신 버전 확인 |
+| `aiohttp==3.9.3` 설치 실패 | Python 3.12 비호환 | `aiohttp>=3.9.3`으로 완화하거나 최신 버전으로 업그레이드 |
+| `numba` 설치 시간 초과 | numba 컴파일 시간 | 빌드 타임아웃 설정 증가 또는 `--timeout=300` 추가 |
+| Jenkins Webhook 미동작 | Gitea Webhook 미설정 | Gitea 저장소 설정 → Webhooks → Jenkins URL 추가 |
+
+---
+
+## 참고: Python 3.12 호환성 체크리스트
+
+Python 3.11 → 3.12 주요 변경사항 중 이 프로젝트에 영향 가능한 항목:
+
+- `asyncio` 동작 변경: `asyncio.get_event_loop()` deprecated → `asyncio.get_running_loop()` 권장
+- `typing` 모듈 일부 변경: `Union[X, Y]` → `X | Y` 문법 지원 강화
+- `datetime.utcnow()` deprecated → `datetime.now(timezone.utc)` 권장
+
+현재 코드베이스(`src/`, `tests/`)에서 위 패턴 사용 여부를 확인하고 필요 시 수정한다.