make-quant-py/README.md

# 콴트 매니저 (Quant Manager)

한국 주식 시장을 위한 퀀트 투자 도구입니다.

## 기능
- 데이터 수집 및 관리
- 멀티 팩터 전략
- 슈퍼 퀄리티 전략
- 슈퍼 밸류 모멘텀 전략

## 설치 및 실행 방법

### 로컬 개발 환경
```bash
# 의존성 설치
pip install -r requirements.txt

# 애플리케이션 실행
streamlit run src/app.py
```

### Docker 배포
Docker를 사용하여 애플리케이션을 쉽게 배포할 수 있습니다.

1. 환경 변수 설정
```bash
# .env.example 파일을 복사하여 .env 파일 생성
cp .env.example .env

# .env 파일 편집 - Gitea 레지스트리 정보 입력
```

2. 배포 스크립트 실행
```bash
./deploy.sh
```

자세한 배포 방법은 [DEPLOYMENT.md](DEPLOYMENT.md) 문서를 참조하세요.

## Docker 이미지 빌드 (수동)
```bash
docker build -t quant-manager .
```

## 개발 환경 설정

애플리케이션 실행 전에 인증 설정이 필요합니다.

```bash
# 인증 설정 파일 생성 (최초 1회)
python src/config/generate_credentials.py

# 사용자 비밀번호 변경
python src/config/update_password.py
```