init

README.md

@@ -27,17 +27,42 @@
    - 단/중/장기 이동평균선(MA5/20/60)  
    - 거래량 MA5
 4. **매수 후보 판정** (`check_buy_signals`)  
-   - 볼린저 하단 근접도 < `BOLLINGER_THRESHOLD` (기본 0.10)  
-   - RSI < 30 (과매도)  
-   - MACD 골든크로스  
-   - MA5가 MA20 상향 돌파  
-   - 거래량 급증(현재 > MA5 × 1.5)  
-   위 조건 중 ① Bollinger & RSI 동시 충족 **또는** ② 최소 2개 이상(+Bollinger 또는 RSI 포함) 만족 시 `buy=True`.
+- *아래 새로운 “매수 후보 전략” 섹션 참조*
 5. **알림 발송** (`send_*_telegram_message`)  
    multiprocessing Pool을 이용해 다중 메시지를 병렬로 전송합니다.
 
 ---
 
+## 매수 후보 전략
+
+| 신호 | 변수명 | 조건 | 의미 |
+|------|--------|------|------|
+| 볼린저 하단 근접 | `bb_signal` | `(현재가 - LowerBand) / (UpperBand - LowerBand) < BOLLINGER_THRESHOLD` | 밴드 하단(과매도 영역) 접근 |
+| RSI 과매도 | `rsi_signal` | `RSI < 30` | 추세 과매도 |
+| MACD 골든크로스 | `macd_signal` | `이전 MACD < 이전 Signal` **AND** `현재 MACD > 현재 Signal` | 모멘텀 전환 |
+| 이동평균 골든크로스 | `ma_signal` | `이전 MA5 < 이전 MA20` **AND** `현재 MA5 ≥ 현재 MA20` | 단기 추세 ↗ 전환 |
+| 거래량 급증 | `volume_signal` | `현재 거래량 > MA5 Volume × 1.5` | 수급 증가 |
+| **U자 반등 돌파** | `breakout_signal` | ① 최근 `BREAKOUT_LOOKBACK`(30)개 캔들 동안 최고·최저가 차이가 `BUY_THRESHOLD`(15 %) 이상 하락 → ② **현재가가 그 최고가 돌파** | 하락 후 반등의 추세 전환 확인 |
+
+### 최종 매수 후보 결정 로직
+```text
+if breakout_signal:
+    buy = True               # U자 반등 돌파 단독으로도 매수 후보
+else:
+    # ① 볼린저 + RSI 동시, 또는 ② (신호 ≥ 2개) & (볼린저 또는 RSI 포함)
+    buy = (bb_signal and rsi_signal) or (signal_count >= 2 and (bb_signal or rsi_signal))
+```
+*`signal_count` = 위 6개 신호 중 True 개수*
+
+### 메시지 구성
+- `🛒` : 최종 `buy=True`일 때 메시지 맨 앞에 부착
+- `📊신호(n):` 뒤에 활성화된 신호 목록
+  - 볼린저/RSI/MACD/MA/거래량/Breakout 각각 표시
+
+해당 전략으로 **과매도 바닥근처 매수 기회 + 상승 추세 전환 브레이크아웃** 두 영역을 모두 포착할 수 있습니다.
+
+---
+
 ## 스케줄 테이블 (기본값)
 | 대상 | 실행 시각(서버 기준) | 호출 함수 |
 |------|----------------------|-----------|