first vibe coding

README.md

@@ -0,0 +1,49 @@
+# 단타 자동매매 시스템 v3.0
+
+기획서 v3.0 기준 / KIS Open API / Synology NAS Docker
+AI: Claude Code headless (장 전 분석 + 장 후 피드백)
+
+## 운영 모드
+
+| KIS_MOCK | DRY_RUN | 동작 |
+|----------|---------|------|
+| true | true | 신호 확인만 (주문 없음) ← 처음 시작 |
+| true | false | 모의투자 실제 주문 ← 3개월 검증 |
+| false | false | 실거래 ← 조건 충족 후 |
+
+## 빠른 시작
+
+```bash
+# 1. .env 설정
+cp .env.example .env
+# .env 열어서 KIS 키, Discord Webhook URL 입력
+
+# 2. KIS 연결 테스트
+pip install aiohttp python-dotenv
+python test_connection.py
+
+# 3. 신호 확인 (DRY_RUN=true)
+python app/main.py
+
+# 4. Docker 실행 (NAS)
+docker-compose up -d
+```
+
+## 컨테이너 구성
+
+| 컨테이너 | 역할 | 실행 시간 |
+|---------|------|---------|
+| stockbot-main | 매매 프로그램 | 상시 (09:00~15:00 활성) |
+| stockbot-redis | 시세 캐시 | 상시 |
+| stockbot-dashboard | Streamlit 모니터링 | 상시 (포트 8501) |
+| claude-morning | 장 전 AI 분석 | 08:30 (실행 후 종료) |
+| claude-evening | 장 후 AI 피드백 | 15:30 (실행 후 종료) |
+| stockbot-killswitch | 긴급 청산 | 수동 트리거 |
+
+## 긴급 청산
+
+```bash
+docker-compose --profile emergency up kill-switch
+# 또는
+python kill_switch/kill.py
+```