Stop tracking runtime and generated files

uploads/learning/종합기획서_단타자동매매_6a041d60084271.93225085.txt

@@ -1,536 +0,0 @@
-# 단타 자동매매 시스템 종합 기획서
-
-> 버전: v1.0  
-> 기준: 한국 주식 (코스피/코스닥) / KIS Open API / Synology NAS Docker  
-> 원칙: 규칙 기반 완전 자동화, 인간 판단 개입 0
-
----
-
-## 0. 설계 원칙 (절대 불변)
-
-1. **감정 0** — 모든 진입/청산은 코드가 결정. 예외 없음
-2. **손절 우선** — 수익 극대화보다 손실 제한이 먼저
-3. **단순함 우선** — 복잡한 전략보다 단순하고 견고한 전략
-4. **검증 후 실거래** — 백테스트 → 모의투자 3개월 → 소액 실거래 순서 필수
-5. **14:50 전량 청산** — 오버나이트는 절대 없음. 하드코딩
-
----
-
-## 1. 시스템 전체 구조
-
-```
-┌─────────────────────────────────────────────────────────┐
-│                  Synology NAS (Docker)                   │
-│                                                          │
-│  ┌──────────────┐    ┌──────────────┐                   │
-│  │  stockbot    │    │  kill-switch │  ← 별도 컨테이너   │
-│  │  (메인)      │    │  (긴급중단)  │                   │
-│  └──────┬───────┘    └──────────────┘                   │
-│         │                                                │
-│  ┌──────▼───────────────────────────────────┐           │
-│  │           asyncio Event Loop              │           │
-│  │  ┌─────────┐ ┌─────────┐ ┌───────────┐  │           │
-│  │  │Universe │ │Strategy │ │  Risk     │  │           │
-│  │  │Scanner  │ │Engine   │ │  Manager  │  │           │
-│  │  └─────────┘ └─────────┘ └───────────┘  │           │
-│  │  ┌─────────┐ ┌─────────┐ ┌───────────┐  │           │
-│  │  │  Data   │ │  Order  │ │ Notifier  │  │           │
-│  │  │Collector│ │Executor │ │(Telegram) │  │           │
-│  │  └─────────┘ └─────────┘ └───────────┘  │           │
-│  └───────────────────────┬──────────────────┘           │
-│                          │                               │
-│  ┌───────────────────────▼──────────────────┐           │
-│  │  SQLite (체결/포지션/로그)                 │           │
-│  │  Redis  (실시간 시세 캐시)                 │           │
-│  └──────────────────────────────────────────┘           │
-│                                                          │
-│  ┌──────────────────────────────────────────┐           │
-│  │  Streamlit Dashboard (포트 8501)          │           │
-│  └──────────────────────────────────────────┘           │
-└─────────────────────────────────────────────────────────┘
-         │                        │
-    KIS WebSocket             KIS REST API
-    (실시간 시세)              (주문/잔고)
-```
-
----
-
-## 2. 기술 스택 (확정)
-
-| 항목 | 선택 | 이유 |
-|------|------|------|
-| 언어 | Python 3.11 | 생태계, KIS 예제 코드 모두 Python |
-| 비동기 | asyncio + aiohttp | 초당 20건 rate limit 정밀 제어 |
-| DB | SQLite | NAS 메모리 절약, 단일 파일 백업 용이 |
-| 캐시 | Redis 7 (Docker) | 실시간 시세 캐시, TTL 관리 |
-| 스케줄러 | APScheduler 3.x (AsyncIOScheduler) | 장 시작/마감 이벤트 트리거 |
-| 알림 | python-telegram-bot | 단일 채널, 신뢰성 높음 |
-| 대시보드 | Streamlit | 설치 단순, NAS 내부망 접근 |
-| 컨테이너 | Docker Compose | Synology Container Manager 호환 |
-| 백테스트 | vectorbt | pandas 기반, 분봉 데이터 처리 빠름 |
-| 데이터 수집 | pykrx + KIS REST | 과거 분봉 백필 |
-
----
-
-## 3. 디렉토리 구조
-
-```
-/volume1/docker/stockbot/
-│
-├── docker-compose.yml
-├── .env                          ← API 키 전용 (Git 제외)
-│
-├── app/
-│   ├── main.py                   ← 진입점, asyncio 루프
-│   ├── config.py                 ← 전략 파라미터 전용
-│   │
-│   ├── data/
-│   │   ├── collector.py          ← KIS WebSocket 시세 수신
-│   │   ├── universe.py           ← 종목 풀 갱신 (08:30)
-│   │   └── backfill.py           ← 과거 분봉 백필 스크립트
-│   │
-│   ├── strategy/
-│   │   ├── base.py               ← 전략 추상 클래스
-│   │   └── volatility_breakout.py ← 전략 A (유일한 실전 전략)
-│   │
-│   ├── risk/
-│   │   └── manager.py            ← 손절/일일한도/강제청산
-│   │
-│   ├── execution/
-│   │   ├── kis_client.py         ← KIS REST/WebSocket 래퍼
-│   │   └── order_executor.py     ← 주문 전송, 재시도, 슬리피지
-│   │
-│   ├── monitor/
-│   │   ├── notifier.py           ← 텔레그램 알림
-│   │   └── dashboard.py          ← Streamlit 대시보드
-│   │
-│   └── db/
-│       ├── models.py             ← SQLite 스키마
-│       └── repository.py        ← DB 접근 레이어
-│
-├── kill_switch/
-│   └── kill.py                   ← 긴급 전량 청산 단독 실행
-│
-├── backtest/
-│   ├── run_backtest.py           ← vectorbt 백테스트 실행
-│   └── results/                  ← 백테스트 결과 저장
-│
-├── data/
-│   ├── stockbot.db               ← SQLite DB
-│   └── universe_cache.json       ← 당일 종목 풀 캐시
-│
-└── logs/
-    └── trades.log                ← 영구 보관 (세금 신고용)
-```
-
----
-
-## 4. 전략 (확정: 전략 A 단독)
-
-### 변동성 돌파 전략 (Volatility Breakout)
-
-**선정 이유:**
-- 래리 윌리엄스 실전 검증, 30년 이상 데이터 기반
-- 룰이 단순 → 과적합 위험 최소
-- 분봉 적용 시 한국 장 오전 변동성과 궁합 최적
-- 진입 조건이 명확 → 자동화 구현 난이도 낮음
-
-**핵심 파라미터 (config.py에서 관리)**
-```python
-STRATEGY_K = 0.5          # 변동성 계수 (0.4~0.6 안정 구간)
-ENTRY_START = "09:00"     # 진입 허용 시작
-ENTRY_END   = "14:30"     # 진입 허용 마감
-FORCE_EXIT  = "14:50"     # 강제 청산 시각 (하드코딩)
-TP1_PCT     = 0.02        # 1차 익절 +2% (50% 매도)
-TP2_PCT     = 0.03        # 2차 익절 +3% (전량)
-SL_PCT      = 0.015       # 손절 -1.5% (즉시 시장가)
-MAX_HOLD_MIN = 120        # 최대 보유시간 120분 (무수익 시 청산)
-```
-
-**진입 로직**
-```
-목표가 = 당일 시가 + (전일 고가 - 전일 저가) × K
-
-진입 조건 (전부 충족 시):
-  1. 현재가 >= 목표가
-  2. 현재 시각 ENTRY_START ~ ENTRY_END
-  3. 당일 KOSPI 등락률 > -1.0%         ← 시장 약세 차단
-  4. 전일 거래대금 >= 100억
-  5. 시가총액 1,000억 ~ 3조
-  6. VI 미발동 종목
-  7. 당일 보유 종목 수 < 2             ← 동시 최대 2종목
-  8. 일일 누적 손실 < -3%             ← 손실 한도 미도달
-```
-
-**청산 로직 (우선순위 순)**
-```
-1순위: 강제 청산  → 14:50 시장가 전량
-2순위: 손절       → 현재가 <= 매수가 × (1 - SL_PCT) → 시장가
-3순위: 1차 익절   → 현재가 >= 매수가 × (1 + TP1_PCT) → 50% 지정가
-4순위: 2차 익절   → 현재가 >= 매수가 × (1 + TP2_PCT) → 전량 지정가
-5순위: 시간 청산  → 보유 후 MAX_HOLD_MIN 경과, 수익 없을 시 시장가
-```
-
----
-
-## 5. 종목 유니버스 선정 (Universe)
-
-매일 08:30 자동 갱신.
-
-**1차 필터 (정적)**
-| 조건 | 기준 |
-|------|------|
-| 시장 | 코스피 + 코스닥 |
-| 시가총액 | 1,000억 ~ 3조 |
-| 상장 기간 | 6개월 이상 |
-| 제외 | 관리종목, 거래정지, 우선주, 스팩, ETF, ETN |
-
-**2차 필터 (동적, 전일 기준)**
-| 조건 | 기준 |
-|------|------|
-| 전일 거래대금 | 100억 이상 |
-| 5일 평균 거래대금 | 50억 이상 |
-| 전일 등락률 | -3% ~ +15% |
-| 일봉 60일 이평선 | 현재가 위 |
-
-**결과: 최대 30종목** (KIS WebSocket 안정성 기준으로 50 → 30 축소)
-
----
-
-## 6. 리스크 관리
-
-### 포지션 규칙
-| 항목 | 값 |
-|------|-----|
-| 1종목 최대 비중 | 총자산 × 20% |
-| 동시 보유 최대 | 2종목 |
-| 분할매수 | 1차 10%, 신호 유지 시 2차 10% |
-
-### 손실 한도 (계층별 자동 중단)
-| 레벨 | 조건 | 동작 |
-|------|------|------|
-| L1 | 1회 매매 -1.5% | 즉시 손절 |
-| L2 | 일일 누적 -3% | 당일 신규 진입 중단 |
-| L3 | 3연속 손절 | 당일 매매 중단 |
-| L4 | 주간 누적 -7% | 주말까지 중단 + 텔레그램 경고 |
-| L5 | 월간 누적 -15% | 자동 전략 폐기 + 백테스트 재요청 |
-
-### 안전장치
-- VI(변동성완화장치) 발동 → 즉시 해당 종목 청산
-- 호가 스프레드 > 0.5% → 진입 금지
-- 매수 후 5분 미체결 → 주문 취소
-- WebSocket 끊김 → 보유 포지션 즉시 시장가 청산
-- API 오류 10건/분 → kill-switch 컨테이너 자동 실행
-
----
-
-## 7. KIS API 운용
-
-### 초당 20건 제한 대응 전략
-```
-WebSocket (실시간 시세)  : 30종목 구독 → REST 호출 없음
-REST (주문/잔고)        : 주문 시에만 호출
-REST (분봉 조회)        : 신호 확인용, 1초 간격 제한
-
-asyncio Semaphore(20) 로 초당 20건 보장
-배치 처리: 30종목 ÷ 20건 = 1.5초/1회전
-```
-
-### WebSocket 구독 항목
-- 실시간 체결가 (H0STCNT0)
-- 실시간 호가 (H0STASP0)
-- VI 발동/해제 (H0STVI0)
-
-### 주문 타입 결정
-| 상황 | 주문 타입 |
-|------|----------|
-| 진입 | 시장가 (빠른 체결 우선) |
-| 1차 익절 | 지정가 (목표가 미리 걸기) |
-| 2차 익절 | 지정가 |
-| 손절 | 시장가 (슬리피지 감수) |
-| 강제청산 | 시장가 |
-
----
-
-## 8. 스케줄 타임라인
-
-```
-08:00  │ 시스템 기동, DB 연결 확인
-08:30  │ Universe 갱신 (pykrx 전일 데이터)
-08:50  │ WebSocket 연결, 30종목 구독 시작
-       │ 당일 시가 기반 목표가 계산
-09:00  │ ─────────── 진입 허용 시작 ───────────
-       │ 1분봉 루프 시작 (asyncio, 1초 단위)
-11:30  │ 신규 진입 일시 중단 (점심)
-13:00  │ 신규 진입 재개
-14:30  │ 신규 진입 마감
-14:50  │ ─────────── 강제 청산 ───────────────
-       │ 보유 포지션 전량 시장가 매도
-15:00  │ WebSocket 연결 종료
-15:10  │ 당일 결산 로그 생성
-15:20  │ 텔레그램 일일 결산 알림 발송
-15:30  │ 시스템 대기 (다음 날 08:00까지)
-```
-
----
-
-## 9. DB 스키마 (SQLite)
-
-```sql
--- 체결 내역
-CREATE TABLE trades (
-    id          INTEGER PRIMARY KEY AUTOINCREMENT,
-    date        TEXT NOT NULL,           -- YYYY-MM-DD
-    ticker      TEXT NOT NULL,
-    entry_time  TEXT NOT NULL,           -- HH:MM:SS
-    exit_time   TEXT,
-    entry_price REAL NOT NULL,
-    exit_price  REAL,
-    quantity    INTEGER NOT NULL,
-    side        TEXT NOT NULL,           -- BUY / SELL
-    exit_reason TEXT,                    -- TP1/TP2/SL/FORCE/TIME
-    pnl         REAL,
-    fee         REAL,
-    slippage    REAL,
-    strategy    TEXT DEFAULT 'VB'
-);
-
--- 일일 요약
-CREATE TABLE daily_summary (
-    date            TEXT PRIMARY KEY,
-    total_trades    INTEGER,
-    win_trades      INTEGER,
-    lose_trades     INTEGER,
-    gross_pnl       REAL,
-    total_fee       REAL,
-    net_pnl         REAL,
-    max_drawdown    REAL,
-    trading_stopped INTEGER DEFAULT 0   -- L2 발동 여부
-);
-
--- 포지션 (장중 현황)
-CREATE TABLE positions (
-    ticker      TEXT PRIMARY KEY,
-    entry_time  TEXT,
-    entry_price REAL,
-    quantity    INTEGER,
-    tp1_done    INTEGER DEFAULT 0,
-    target_price REAL,
-    stop_price   REAL
-);
-```
-
----
-
-## 10. 알림 설계 (텔레그램)
-
-| 이벤트 | 메시지 형식 |
-|--------|-----------|
-| 진입 | `[매수] 삼성전자 74,000원 / 목표 75,480 / 손절 72,890` |
-| 1차 익절 | `[익절1] 삼성전자 +2.1% / 잔여 50%` |
-| 손절 | `[손절] 삼성전자 -1.5% / 즉시 청산` |
-| 강제 청산 | `[14:50 강제청산] 전 포지션 청산 완료` |
-| L2 발동 | `[경고] 일일 손실 -3% 도달. 오늘 매매 중단.` |
-| 일일 결산 | `[결산] 매매 5회 / 승 3 패 2 / 순손익 +1.2%` |
-| 장애 | `[긴급] WebSocket 끊김. kill-switch 실행.` |
-
----
-
-## 11. 백테스트 계획
-
-### 데이터 준비
-```
-수집 대상: 코스피200 + 코스닥150 편입 종목
-기간: 2021-01-01 ~ 2024-12-31 (4년치)
-봉: 1분봉
-도구: pykrx (무료, 과거 분봉 제공)
-생존편향: 상장폐지 종목 별도 수집 포함
-```
-
-### 수수료 시뮬레이션
-```
-매수 수수료: 0.015%
-매도 수수료: 0.015%
-거래세:      0.18% (매도 시)
-슬리피지:    시장가 0.10%, 지정가 0.03%
-총 1회전 비용 추정: 약 0.21%
-```
-
-### 합격 기준 (out-of-sample 1년 기준)
-| 지표 | 통과 기준 | 목표 |
-|------|----------|------|
-| 샤프지수 | > 1.0 | > 1.5 |
-| MDD | < 15% | < 10% |
-| 승률 | > 45% | > 55% |
-| 손익비 | > 1.3 | > 1.8 |
-| 일평균 매매 | 1~5회 | 2~3회 |
-
-### K값 최적화 방법
-```
-1. K = 0.3 ~ 0.8 구간 0.05 단위 그리드 서치
-2. 인샘플(2021~2023) 에서 상위 3개 K값 선별
-3. 아웃샘플(2024) 에서 재검증
-4. 피크 K값 배제 → 샤프지수 안정 구간 채택
-5. 최종 채택: K = 0.5 (사전 기본값, 백테스트로 재확인)
-```
-
----
-
-## 12. 인프라 (Synology Docker)
-
-### docker-compose.yml
-```yaml
-version: "3.9"
-
-services:
-  redis:
-    image: redis:7-alpine
-    container_name: stockbot-redis
-    restart: unless-stopped
-    volumes:
-      - ./data/redis:/data
-
-  stockbot:
-    build: ./app
-    container_name: stockbot-main
-    restart: unless-stopped
-    depends_on:
-      - redis
-    env_file: .env
-    volumes:
-      - ./data:/app/data
-      - ./logs:/app/logs
-    environment:
-      - TZ=Asia/Seoul
-    logging:
-      driver: "json-file"
-      options:
-        max-size: "10m"
-        max-file: "5"
-
-  kill-switch:
-    build: ./kill_switch
-    container_name: stockbot-killswitch
-    restart: "no"              # 수동 또는 자동 트리거 시에만 실행
-    env_file: .env
-    profiles: ["emergency"]    # docker compose --profile emergency up
-
-  dashboard:
-    build: ./monitor
-    container_name: stockbot-dashboard
-    restart: unless-stopped
-    ports:
-      - "8501:8501"
-    volumes:
-      - ./data:/app/data
-    environment:
-      - TZ=Asia/Seoul
-```
-
-### .env 구조
-```
-# KIS API
-KIS_APP_KEY=...
-KIS_APP_SECRET=...
-KIS_ACCOUNT_NO=...
-KIS_MOCK=true             # 모의투자: true / 실거래: false
-
-# 텔레그램
-TELEGRAM_TOKEN=...
-TELEGRAM_CHAT_ID=...
-
-# Redis
-REDIS_HOST=stockbot-redis
-REDIS_PORT=6379
-
-# 운영 모드
-DRY_RUN=true              # 주문 실제 전송 여부
-LOG_LEVEL=INFO
-```
-
----
-
-## 13. 개발 로드맵
-
-### Phase 1 — 데이터 기반 구축 (2주)
-- [ ] KIS Open API 신청 + 모의투자 계좌 개설
-- [ ] pykrx로 2021~2024 분봉 데이터 백필
-- [ ] SQLite 스키마 생성
-- [ ] Universe 스캐너 구현 (08:30 갱신)
-- [ ] Docker Compose 기동 확인 (NAS)
-
-### Phase 2 — 백테스트 (3주)
-- [ ] vectorbt 환경 구성
-- [ ] 변동성 돌파 전략 백테스트 코드 작성
-- [ ] 수수료/슬리피지 반영
-- [ ] K값 그리드 서치
-- [ ] out-of-sample 검증 → 합격 기준 통과 확인
-
-### Phase 3 — KIS 연동 + dry-run (2주)
-- [ ] KIS REST 클라이언트 구현 (인증/토큰 갱신)
-- [ ] KIS WebSocket 클라이언트 구현 (시세 수신)
-- [ ] OrderExecutor 구현 (시장가/지정가/IOC)
-- [ ] DRY_RUN=true 상태에서 신호 발생 확인
-
-### Phase 4 — 리스크 + 알림 + 대시보드 (2주)
-- [ ] RiskManager 전 계층 구현 (L1~L5)
-- [ ] kill-switch 컨테이너 구현
-- [ ] 텔레그램 Notifier 구현
-- [ ] Streamlit 대시보드 구현 (실시간 PnL)
-
-### Phase 5 — 모의투자 실운영 (최소 3개월)
-- [ ] KIS_MOCK=true, DRY_RUN=false
-- [ ] 매일 결산 로그 검토
-- [ ] 주간 샤프지수/MDD 추적
-- [ ] 이상 거동 발생 시 전략 파라미터 재검토 (코드 수정, K값 조정)
-- [ ] 3개월 연속 샤프 > 1.0, MDD < 15% 달성 시 Phase 6 진입
-
-### Phase 6 — 소액 실거래 (무기한)
-- [ ] KIS_MOCK=false
-- [ ] 총자산의 5% 한도로 시작
-- [ ] 1개월 단위 성과 검토, 한도 점진 확대
-
----
-
-## 14. 보안 체크리스트
-
-- [ ] .env → .gitignore 등록 필수
-- [ ] KIS API 키 → GitHub 절대 커밋 금지
-- [ ] Synology 방화벽: 8501 포트 내부망만 허용
-- [ ] 텔레그램 봇: 특정 chat_id만 허용 (화이트리스트)
-- [ ] 모든 주문 로그 SQLite + logs/ 이중 보관
-- [ ] 월 1회 .env 파일 암호화 백업
-
----
-
-## 15. 절대 금지 항목 (하드코딩)
-
-```python
-# 이 리스트는 코드에서 상수로 관리, 절대 런타임 수정 불가
-BLACKLIST_REASONS = [
-    "신규상장 6개월 미만",
-    "관리종목",
-    "투자경고",
-    "거래정지",
-    "우선주",
-    "스팩",
-    "ETF/ETN",
-]
-
-TRADING_BLACKOUT = [
-    ("11:30", "13:00"),   # 점심 휴식
-    ("14:50", "15:30"),   # 장 마감 전
-    ("08:00", "09:00"),   # 동시호가
-]
-
-HARD_EXIT_TIME = "14:50"  # 절대 변경 불가
-```
-
----
-
-## 16. 면책 조항
-
-> 본 기획서는 시스템 설계 문서이며, 투자 수익을 보장하지 않는다.  
-> 단타는 통계적으로 개인투자자의 90% 이상이 손실을 보는 영역이다.  
-> 백테스트 결과는 미래 수익을 보장하지 않으며, 반드시 모의투자 3개월 이상 검증 후 실거래로 전환할 것.  
-> 시스템 장애, API 오류, 네트워크 단절로 인한 손실에 대해 어떠한 책임도 지지 않는다.

uploads/learning/종합기획서_단타자동매매_v2_6a041d600dc6a8.01129668.txt

@@ -1,743 +0,0 @@
-# 단타 자동매매 시스템 종합 기획서 v2.0
-
-> 버전: v2.0 (AI 판단 레이어 통합)
-> 기준: 한국 주식 (코스피/코스닥) / KIS Open API / Synology NAS Docker
-> 핵심 변경: 규칙 기반 실행 + Claude AI 일일 시장 판단 레이어 추가
-
----
-
-## 0. 설계 원칙 (절대 불변)
-
-1. **감정 0** — 실행은 코드가 결정. 단, 판단은 AI가 보조
-2. **속도/판단 역할 분리** — AI는 느리지만 깊게(매일 1회), 실행은 빠르게(수식)
-3. **손절 우선** — AI가 긍정 판단해도 손절 룰은 무조건 우선
-4. **검증 후 실거래** — 백테스트 → 모의투자 3개월 → 소액 실거래
-5. **14:50 전량 청산** — 하드코딩, 어떤 상황에서도 예외 없음
-
----
-
-## 1. 시스템 전체 구조 (v2.0)
-
-```
-┌──────────────────────────────────────────────────────────────┐
-│                    Synology NAS (Docker)                      │
-│                                                               │
-│  ┌─────────────────────────────────────────────────────────┐ │
-│  │              [레이어 1] AI 판단 엔진 (08:00)             │ │
-│  │                                                         │ │
-│  │  데이터 수집                                            │ │
-│  │  ├─ 전일 뉴스 (네이버 금융 크롤링)                      │ │
-│  │  ├─ KOSPI/KOSDAQ 지수 흐름 (KIS REST)                  │ │
-│  │  ├─ 외국인/기관 순매수 상위 (KIS 순위분석 API)          │ │
-│  │  ├─ 거래량 급증 종목 (KIS 순위분석 API)                 │ │
-│  │  └─ 섹터별 등락률 (KIS 업종/기타 API)                  │ │
-│  │         ↓                                               │ │
-│  │  Claude API 호출 (하루 1회, 약 3,000 토큰)             │ │
-│  │         ↓                                               │ │
-│  │  daily_context.json 생성                               │ │
-│  └─────────────────────────────────────────────────────────┘ │
-│                          ↓ 읽기만 함                          │
-│  ┌─────────────────────────────────────────────────────────┐ │
-│  │           [레이어 2] 규칙 기반 실행 엔진 (09:00~)        │ │
-│  │                                                         │ │
-│  │  asyncio Event Loop                                     │ │
-│  │  ┌──────────┐ ┌──────────┐ ┌────────────┐             │ │
-│  │  │Universe  │ │Strategy  │ │  Risk      │             │ │
-│  │  │Scanner   │ │Engine    │ │  Manager   │             │ │
-│  │  └──────────┘ └──────────┘ └────────────┘             │ │
-│  │  ┌──────────┐ ┌──────────┐ ┌────────────┐             │ │
-│  │  │  Data    │ │  Order   │ │ Notifier   │             │ │
-│  │  │Collector │ │Executor  │ │(Telegram)  │             │ │
-│  │  └──────────┘ └──────────┘ └────────────┘             │ │
-│  └─────────────────────────────────────────────────────────┘ │
-│                          ↓                                    │
-│  ┌─────────────────────────────────────────────────────────┐ │
-│  │  SQLite (체결/포지션/로그)  │  Redis (실시간 시세 캐시)   │ │
-│  └─────────────────────────────────────────────────────────┘ │
-│  ┌─────────────────────────────────────────────────────────┐ │
-│  │  Streamlit Dashboard (포트 8501)                        │ │
-│  └─────────────────────────────────────────────────────────┘ │
-│  ┌─────────────────────────────────────────────────────────┐ │
-│  │  kill-switch (별도 컨테이너 / 긴급 청산)                 │ │
-│  └─────────────────────────────────────────────────────────┘ │
-└──────────────────────────────────────────────────────────────┘
-         │                          │
-    KIS WebSocket               KIS REST API
-    (실시간 시세/VI)             (주문/잔고/순위/수급)
-```
-
----
-
-## 2. 핵심 변경: AI 판단 레이어 상세
-
-### 2-1. 수집 데이터 소스
-
-| 데이터 | 소스 | 방법 | 수집 시각 |
-|--------|------|------|---------|
-| 전일 종목 뉴스 헤드라인 | 네이버 금융 | HTTP 크롤링 | 07:30 |
-| KOSPI/KOSDAQ 전일 종가·등락률 | KIS REST | API | 07:40 |
-| 외국인 순매수 상위 30종목 | KIS 순위분석 API | API | 07:40 |
-| 기관 순매수 상위 30종목 | KIS 순위분석 API | API | 07:40 |
-| 거래량 급증 상위 30종목 | KIS 순위분석 API | API | 07:40 |
-| 업종별 등락률 | KIS 업종/기타 API | API | 07:40 |
-| 당일 경제 일정 (FOMC 등) | 네이버 금융 크롤링 | HTTP 크롤링 | 07:30 |
-
-> KIS API만으로 수급·수치 데이터 대부분 커버 가능. 뉴스는 네이버 금융 크롤링으로 보완.
-
-### 2-2. Claude API 프롬프트 구조
-
-```python
-SYSTEM_PROMPT = """
-당신은 한국 주식 단타 전문 AI 분석가입니다.
-매일 장 시작 전, 제공된 데이터를 분석해 오늘 단타 매매 전략을 판단합니다.
-반드시 JSON 형식으로만 응답하며, 다른 텍스트는 포함하지 않습니다.
-"""
-
-USER_PROMPT = f"""
-[전일 시장 요약]
-- KOSPI: {kospi_change}% ({kospi_close}pt)
-- KOSDAQ: {kosdaq_change}% ({kosdaq_close}pt)
-
-[외국인 순매수 상위]
-{foreign_buy_top10}
-
-[기관 순매수 상위]
-{institution_buy_top10}
-
-[거래량 급증 상위]
-{volume_surge_top10}
-
-[업종별 등락률]
-{sector_changes}
-
-[주요 뉴스 헤드라인 (상위 20건)]
-{news_headlines}
-
-[오늘 경제 일정]
-{economic_calendar}
-
-위 데이터를 분석해 다음 JSON을 반환하세요:
-{{
-  "trade_allowed": true/false,
-  "market_sentiment": "강세/중립/약세",
-  "sentiment_score": 0~100,
-  "risk_level": "낮음/보통/높음",
-  "hot_sectors": ["섹터1", "섹터2"],
-  "avoid_sectors": ["섹터3"],
-  "boosted_tickers": ["005930", "000660"],
-  "blacklist_tickers": ["종목코드"],
-  "position_size_multiplier": 0.5~1.5,
-  "reason": "한 줄 판단 이유"
-}}
-"""
-```
-
-### 2-3. daily_context.json 구조
-
-```json
-{
-  "date": "2026-05-13",
-  "generated_at": "08:05:22",
-  "trade_allowed": true,
-  "market_sentiment": "중립",
-  "sentiment_score": 62,
-  "risk_level": "보통",
-  "hot_sectors": ["반도체", "2차전지"],
-  "avoid_sectors": ["금융", "건설"],
-  "boosted_tickers": ["005930", "000660", "373220"],
-  "blacklist_tickers": [],
-  "position_size_multiplier": 1.0,
-  "reason": "외국인 반도체 순매수 지속, KOSPI 박스권 상단 접근 중립 판단"
-}
-```
-
-### 2-4. 실행 엔진에서의 활용
-
-```python
-# 진입 조건에 AI 판단 필터 추가 (기존 조건 1~8 + 신규 9~11)
-진입 조건 (전부 충족 시):
-  1. 현재가 >= 목표가 (변동성 돌파)
-  2. 현재 시각 09:00 ~ 14:30
-  3. KOSPI 등락률 > -1.0%
-  4. 전일 거래대금 >= 100억
-  5. 시가총액 1,000억 ~ 3조
-  6. VI 미발동
-  7. 보유 종목 수 < 2
-  8. 일일 누적 손실 < -3%
-  ── AI 판단 필터 (신규) ──
-  9. daily_context["trade_allowed"] == true
-  10. 해당 종목 섹터가 avoid_sectors에 없음
-  11. 해당 종목이 blacklist_tickers에 없음
-
-# 포지션 사이즈 조정
-실제_투자비중 = 기본비중(20%) × position_size_multiplier
-# sentiment_score 높을수록 multiplier 증가 (0.5~1.5)
-
-# boosted_tickers 우선 진입
-boosted 종목은 동일 신호 시 다른 종목보다 먼저 진입 처리
-```
-
----
-
-## 3. 기술 스택 (v2.0 확정)
-
-| 항목 | 선택 | 이유 |
-|------|------|------|
-| 언어 | Python 3.11 | KIS 예제 코드 모두 Python |
-| 비동기 | asyncio + aiohttp | rate limit 정밀 제어 |
-| DB | SQLite | NAS 메모리 절약, 백업 단순 |
-| 캐시 | Redis 7 (Docker) | 실시간 시세 캐시 |
-| 스케줄러 | APScheduler (AsyncIOScheduler) | 장 이벤트 트리거 |
-| AI 판단 | Claude claude-sonnet-4-20250514 | 뉴스/수급 분석 |
-| 뉴스 수집 | aiohttp + BeautifulSoup4 | 네이버 금융 크롤링 |
-| 알림 | python-telegram-bot | 텔레그램 단일 채널 |
-| 대시보드 | Streamlit | NAS 내부망 접근 |
-| 컨테이너 | Docker Compose | Synology Container Manager |
-| 백테스트 | vectorbt | 분봉 데이터 고속 처리 |
-| 데이터 수집 | pykrx + KIS REST | 과거 분봉 백필 |
-
----
-
-## 4. 디렉토리 구조 (v2.0)
-
-```
-/volume1/docker/stockbot/
-│
-├── docker-compose.yml
-├── .env
-│
-├── app/
-│   ├── main.py                     ← 진입점, asyncio 루프
-│   ├── config.py                   ← 전략 파라미터
-│   │
-│   ├── ai/                         ← [신규] AI 판단 레이어
-│   │   ├── context_builder.py      ← 데이터 수집 + Claude API 호출
-│   │   ├── news_crawler.py         ← 네이버 금융 뉴스 크롤링
-│   │   └── prompts.py              ← 프롬프트 템플릿 관리
-│   │
-│   ├── data/
-│   │   ├── collector.py            ← KIS WebSocket 시세 수신
-│   │   ├── universe.py             ← 종목 풀 갱신 (08:30)
-│   │   └── backfill.py             ← 과거 분봉 백필
-│   │
-│   ├── strategy/
-│   │   ├── base.py                 ← 전략 추상 클래스
-│   │   └── volatility_breakout.py  ← 변동성 돌파 전략 (AI 필터 포함)
-│   │
-│   ├── risk/
-│   │   └── manager.py              ← 손절/일일한도/강제청산
-│   │
-│   ├── execution/
-│   │   ├── kis_client.py           ← KIS REST/WebSocket 래퍼
-│   │   └── order_executor.py       ← 주문 전송, 재시도
-│   │
-│   ├── monitor/
-│   │   ├── notifier.py             ← 텔레그램 알림
-│   │   └── dashboard.py            ← Streamlit 대시보드
-│   │
-│   └── db/
-│       ├── models.py               ← SQLite 스키마
-│       └── repository.py          ← DB 접근 레이어
-│
-├── kill_switch/
-│   └── kill.py
-│
-├── backtest/
-│   ├── run_backtest.py
-│   └── results/
-│
-├── data/
-│   ├── stockbot.db
-│   ├── universe_cache.json
-│   └── daily_context.json          ← [신규] AI 판단 결과 파일
-│
-└── logs/
-    ├── trades.log
-    └── ai_context.log              ← [신규] AI 판단 이력 보관
-```
-
----
-
-## 5. 전략 (확정: 변동성 돌파 + AI 필터)
-
-### 핵심 파라미터 (config.py)
-
-```python
-# 변동성 돌파 파라미터
-STRATEGY_K      = 0.5
-ENTRY_START     = "09:00"
-ENTRY_END       = "14:30"
-FORCE_EXIT      = "14:50"
-TP1_PCT         = 0.02
-TP2_PCT         = 0.03
-SL_PCT          = 0.015
-MAX_HOLD_MIN    = 120
-
-# AI 판단 파라미터 (신규)
-AI_CONTEXT_PATH = "/app/data/daily_context.json"
-AI_MIN_SCORE    = 40        # sentiment_score 40 미만 시 trade_allowed=false 강제
-AI_BOOST_MULTI  = 1.5       # boosted_tickers 진입 비중 배율
-AI_RISK_SL_MAP  = {         # risk_level별 손절 강화
-    "낮음": 0.015,
-    "보통": 0.015,
-    "높음": 0.010           # 고위험 장세엔 손절 타이트하게
-}
-```
-
-### 진입 로직 (AI 필터 통합)
-
-```
-목표가 = 당일 시가 + (전일 고가 - 전일 저가) × K
-
-진입 조건 (전부 충족):
-  [기술적 조건]
-  1. 현재가 >= 목표가
-  2. 09:00 ~ 14:30
-  3. KOSPI 등락률 > -1.0%
-  4. 전일 거래대금 >= 100억
-  5. 시가총액 1,000억 ~ 3조
-  6. VI 미발동
-  7. 보유 종목 수 < 2
-  8. 일일 누적 손실 < -3%
-
-  [AI 판단 조건]
-  9. trade_allowed == true
-  10. 종목 섹터 not in avoid_sectors
-  11. 종목 not in blacklist_tickers
-```
-
-### 청산 로직 (우선순위)
-
-```
-1순위: 14:50 강제 청산 (시장가)
-2순위: 손절 → 현재가 <= 매수가 × (1 - SL_PCT)  [risk_level에 따라 조정]
-3순위: 1차 익절 → +TP1_PCT 도달 → 50% 지정가
-4순위: 2차 익절 → +TP2_PCT 도달 → 전량 지정가
-5순위: 시간 청산 → MAX_HOLD_MIN 경과 + 무수익
-```
-
----
-
-## 6. 종목 유니버스 (Universe)
-
-매일 08:30 자동 갱신.
-
-**1차 필터 (정적)**
-| 조건 | 기준 |
-|------|------|
-| 시장 | 코스피 + 코스닥 |
-| 시가총액 | 1,000억 ~ 3조 |
-| 상장 기간 | 6개월 이상 |
-| 제외 | 관리종목, 거래정지, 우선주, 스팩, ETF, ETN |
-
-**2차 필터 (동적)**
-| 조건 | 기준 |
-|------|------|
-| 전일 거래대금 | 100억 이상 |
-| 5일 평균 거래대금 | 50억 이상 |
-| 전일 등락률 | -3% ~ +15% |
-| 60일 이평선 | 현재가 위 |
-
-**AI 보정**
-- boosted_tickers → 우선 감시 목록 상단 배치
-- blacklist_tickers → 당일 유니버스에서 즉시 제거
-- avoid_sectors → 해당 섹터 전체 진입 금지
-
-**최대 감시 종목: 30개** (WebSocket 안정성 기준)
-
----
-
-## 7. 리스크 관리
-
-### 포지션 규칙
-| 항목 | 기본값 | AI 조정 |
-|------|--------|--------|
-| 1종목 최대 비중 | 총자산 × 20% | × position_size_multiplier |
-| 동시 보유 최대 | 2종목 | risk_level=높음 시 1종목 |
-| 손절 기준 | -1.5% | risk_level=높음 시 -1.0% |
-
-### 손실 한도 (계층별)
-| 레벨 | 조건 | 동작 |
-|------|------|------|
-| L1 | 1회 매매 -1.5% | 즉시 손절 |
-| L2 | 일일 누적 -3% | 당일 신규 진입 중단 |
-| L3 | 3연속 손절 | 당일 매매 중단 |
-| L4 | 주간 누적 -7% | 주말까지 중단 + 텔레그램 경고 |
-| L5 | 월간 누적 -15% | 전략 폐기 + 백테스트 재실행 |
-
-### 안전장치
-- VI 발동 → 해당 종목 즉시 청산
-- 호가 스프레드 > 0.5% → 진입 금지
-- 매수 후 5분 미체결 → 주문 취소
-- WebSocket 끊김 → 보유 포지션 즉시 시장가 청산
-- API 오류 10건/분 → kill-switch 자동 실행
-- Claude API 오류 → daily_context 없을 시 보수적 기본값으로 fallback
-
-```python
-# Claude API 장애 시 fallback
-DEFAULT_CONTEXT = {
-    "trade_allowed": True,
-    "market_sentiment": "중립",
-    "sentiment_score": 50,
-    "risk_level": "보통",
-    "hot_sectors": [],
-    "avoid_sectors": [],
-    "boosted_tickers": [],
-    "blacklist_tickers": [],
-    "position_size_multiplier": 0.8,  # 보수적으로 축소
-    "reason": "AI 판단 실패 - 기본값 적용"
-}
-```
-
----
-
-## 8. KIS API 활용 전체 목록 (v2.0)
-
-### 기존 (실행 레이어)
-| API | 용도 | 방식 |
-|-----|------|------|
-| H0STCNT0 | 실시간 체결가 | WebSocket |
-| H0STASP0 | 실시간 호가 | WebSocket |
-| H0STVI0 | VI 발동/해제 | WebSocket |
-| TTTC0802U | 주식 매수 주문 | REST POST |
-| TTTC0801U | 주식 매도 주문 | REST POST |
-| TTTC8001R | 잔고 조회 | REST GET |
-
-### 신규 (AI 판단 레이어)
-| API | 용도 | 수집 시각 |
-|-----|------|---------|
-| FHKST01010100 | 종목 현재가 (KOSPI/KOSDAQ 지수) | 07:40 |
-| FHKST03010100 | 업종별 등락률 | 07:40 |
-| FHPST01710000 | 거래량 순위 상위 30 | 07:40 |
-| FHPST01700000 | 등락률 순위 상위 30 | 07:40 |
-| FHKST04430000 | 외국인/기관 순매수 가집계 | 07:40 |
-
-> 위 API 호출은 모두 장 시작 전 단 1회 → rate limit 부담 없음
-
----
-
-## 9. 스케줄 타임라인 (v2.0)
-
-```
-07:30  │ [AI] 네이버 금융 뉴스 크롤링 (전일 헤드라인 수집)
-07:40  │ [AI] KIS REST API → 수급/순위/업종 데이터 수집
-08:00  │ [AI] Claude API 호출 → daily_context.json 생성
-       │      텔레그램 알림: "[AI분석] 오늘 시장: 중립 / 반도체 주목"
-08:30  │ Universe 갱신 + AI 블랙리스트 적용
-08:50  │ WebSocket 연결, 30종목 구독
-       │ 목표가 계산 (변동성 돌파)
-09:00  │ ─────────── 진입 허용 시작 ───────────
-       │ 1초 단위 asyncio 루프 시작
-11:30  │ 신규 진입 중단 (점심)
-13:00  │ 신규 진입 재개
-14:30  │ 신규 진입 마감
-14:50  │ ─────────── 강제 청산 ───────────────
-15:00  │ WebSocket 종료
-15:10  │ 당일 결산 로그
-15:20  │ 텔레그램 일일 결산 알림
-15:30  │ 대기
-```
-
----
-
-## 10. DB 스키마 (SQLite, v2.0)
-
-```sql
--- 기존 체결 내역
-CREATE TABLE trades (
-    id          INTEGER PRIMARY KEY AUTOINCREMENT,
-    date        TEXT NOT NULL,
-    ticker      TEXT NOT NULL,
-    entry_time  TEXT NOT NULL,
-    exit_time   TEXT,
-    entry_price REAL NOT NULL,
-    exit_price  REAL,
-    quantity    INTEGER NOT NULL,
-    side        TEXT NOT NULL,
-    exit_reason TEXT,
-    pnl         REAL,
-    fee         REAL,
-    slippage    REAL,
-    strategy    TEXT DEFAULT 'VB',
-    ai_boosted  INTEGER DEFAULT 0    -- [신규] AI boosted 여부
-);
-
--- 기존 일일 요약
-CREATE TABLE daily_summary (
-    date            TEXT PRIMARY KEY,
-    total_trades    INTEGER,
-    win_trades      INTEGER,
-    lose_trades     INTEGER,
-    gross_pnl       REAL,
-    total_fee       REAL,
-    net_pnl         REAL,
-    max_drawdown    REAL,
-    trading_stopped INTEGER DEFAULT 0
-);
-
--- 포지션 (장중 현황)
-CREATE TABLE positions (
-    ticker       TEXT PRIMARY KEY,
-    entry_time   TEXT,
-    entry_price  REAL,
-    quantity     INTEGER,
-    tp1_done     INTEGER DEFAULT 0,
-    target_price REAL,
-    stop_price   REAL
-);
-
--- [신규] AI 판단 이력
-CREATE TABLE ai_context_log (
-    date                    TEXT PRIMARY KEY,
-    generated_at            TEXT,
-    trade_allowed           INTEGER,
-    market_sentiment        TEXT,
-    sentiment_score         INTEGER,
-    risk_level              TEXT,
-    hot_sectors             TEXT,   -- JSON 배열
-    avoid_sectors           TEXT,   -- JSON 배열
-    boosted_tickers         TEXT,   -- JSON 배열
-    blacklist_tickers       TEXT,   -- JSON 배열
-    position_size_mult      REAL,
-    reason                  TEXT,
-    claude_tokens_used      INTEGER,
-    api_call_success        INTEGER DEFAULT 1
-);
-```
-
----
-
-## 11. 알림 설계 (텔레그램, v2.0)
-
-| 이벤트 | 메시지 형식 |
-|--------|-----------|
-| AI 분석 완료 | `[AI분석] 시장: 중립(62점) / 주목: 반도체,2차전지 / 회피: 금융` |
-| AI 진입 차단 | `[AI차단] 삼성전자 진입 차단 - 금융 섹터 회피` |
-| 매수 (일반) | `[매수] 삼성전자 74,000원 / 목표 75,480 / 손절 72,890` |
-| 매수 (AI부스트) | `[매수★] 하이닉스 185,000원 / AI 추천 종목` |
-| 1차 익절 | `[익절1] 삼성전자 +2.1% / 잔여 50%` |
-| 손절 | `[손절] 삼성전자 -1.5% / 즉시 청산` |
-| 강제 청산 | `[14:50 강제청산] 전 포지션 청산 완료` |
-| L2 발동 | `[경고] 일일 손실 -3% 도달. 오늘 매매 중단.` |
-| 일일 결산 | `[결산] 매매 5회 / 승 3 패 2 / 순손익 +1.2% / AI 정확도: 3/5` |
-| 장애 | `[긴급] WebSocket 끊김. kill-switch 실행.` |
-| AI 실패 | `[경고] AI 판단 실패. 기본값 적용 (비중 80%).` |
-
----
-
-## 12. 비용 분석 (월간)
-
-### Claude API 토큰 사용량 추정
-| 작업 | 빈도 | 토큰/회 | 월간 토큰 |
-|------|------|---------|---------|
-| 일일 시장 판단 | 1회/일 × 22거래일 | ~3,000 | ~66,000 |
-| fallback 재시도 | 0~2회/월 | ~3,000 | ~6,000 |
-| **합계** | | | **~72,000 토큰/월** |
-
-**월 비용 (Claude Sonnet 4): 약 $2~3 (한화 약 3,000~4,000원)**
-
-### 전체 운영 비용
-| 항목 | 월 비용 |
-|------|--------|
-| KIS API | 무료 |
-| Claude API | ~$3 |
-| 네이버 크롤링 | 무료 |
-| Synology NAS 전기세 | 기존 운영 중이면 추가 없음 |
-| **합계** | **~$3/월** |
-
----
-
-## 13. 백테스트 계획 (v2.0)
-
-### AI 판단 레이어 검증 방법
-AI 판단은 백테스트에 직접 포함 불가 (과거 뉴스 재현 어려움).  
-따라서 2단계로 분리 검증:
-
-```
-1단계: 규칙 기반 백테스트 (기존)
-   - 변동성 돌파 전략 단독 성과 측정
-   - K값 최적화, 수수료/슬리피지 반영
-
-2단계: AI 필터 사후 분석 (모의투자 후)
-   - 3개월 모의투자 후 daily_context.json 이력 vs 실제 결과 대조
-   - AI가 "avoid" 판단한 날 손실률 vs "trade_allowed" 날 수익률 비교
-   - AI 판단 정확도 계산 → 임계값 재조정
-```
-
-### 합격 기준 (out-of-sample)
-| 지표 | 통과 기준 | 목표 |
-|------|----------|------|
-| 샤프지수 | > 1.0 | > 1.5 |
-| MDD | < 15% | < 10% |
-| 승률 | > 45% | > 55% |
-| 손익비 | > 1.3 | > 1.8 |
-| AI 차단 정확도 | > 55% | > 65% |
-
----
-
-## 14. 인프라 (docker-compose.yml)
-
-```yaml
-version: "3.9"
-
-services:
-  redis:
-    image: redis:7-alpine
-    container_name: stockbot-redis
-    restart: unless-stopped
-    volumes:
-      - ./data/redis:/data
-
-  stockbot:
-    build: ./app
-    container_name: stockbot-main
-    restart: unless-stopped
-    depends_on:
-      - redis
-    env_file: .env
-    volumes:
-      - ./data:/app/data
-      - ./logs:/app/logs
-    environment:
-      - TZ=Asia/Seoul
-    logging:
-      driver: "json-file"
-      options:
-        max-size: "10m"
-        max-file: "5"
-
-  kill-switch:
-    build: ./kill_switch
-    container_name: stockbot-killswitch
-    restart: "no"
-    env_file: .env
-    profiles: ["emergency"]
-
-  dashboard:
-    build: ./monitor
-    container_name: stockbot-dashboard
-    restart: unless-stopped
-    ports:
-      - "8501:8501"
-    volumes:
-      - ./data:/app/data
-    environment:
-      - TZ=Asia/Seoul
-```
-
-### .env 구조 (v2.0)
-
-```
-# KIS API
-KIS_APP_KEY=...
-KIS_APP_SECRET=...
-KIS_ACCOUNT_NO=...
-KIS_MOCK=true
-
-# Claude API (신규)
-ANTHROPIC_API_KEY=...
-CLAUDE_MODEL=claude-sonnet-4-20250514
-
-# 텔레그램
-TELEGRAM_TOKEN=...
-TELEGRAM_CHAT_ID=...
-
-# Redis
-REDIS_HOST=stockbot-redis
-REDIS_PORT=6379
-
-# 운영 모드
-DRY_RUN=true
-LOG_LEVEL=INFO
-AI_ENABLED=true       # false 시 AI 레이어 비활성화, 기본값 사용
-```
-
----
-
-## 15. 개발 로드맵 (v2.0)
-
-### Phase 1 — 데이터 기반 구축 (2주)
-- [ ] KIS Open API 신청 + 모의투자 계좌
-- [ ] pykrx 분봉 데이터 백필 (2021~2024)
-- [ ] SQLite 스키마 (v2.0 포함)
-- [ ] Universe 스캐너 구현
-- [ ] Docker Compose NAS 기동 확인
-
-### Phase 2 — 백테스트 (3주)
-- [ ] vectorbt 변동성 돌파 백테스트
-- [ ] 수수료/슬리피지 반영
-- [ ] K값 그리드 서치 + out-of-sample 검증
-
-### Phase 3 — KIS 연동 + dry-run (2주)
-- [ ] KIS REST/WebSocket 클라이언트
-- [ ] OrderExecutor (시장가/지정가/IOC)
-- [ ] DRY_RUN=true 신호 발생 확인
-
-### Phase 4 — AI 레이어 구현 (2주) ← 신규
-- [ ] 네이버 금융 뉴스 크롤러 구현
-- [ ] KIS 순위/수급 API 수집 모듈
-- [ ] Claude API 연동 + 프롬프트 튜닝
-- [ ] daily_context.json 생성 파이프라인
-- [ ] fallback 로직 구현
-- [ ] ai_context_log DB 저장
-
-### Phase 5 — 리스크 + 알림 + 대시보드 (2주)
-- [ ] RiskManager L1~L5 구현
-- [ ] kill-switch 컨테이너
-- [ ] 텔레그램 Notifier (AI 메시지 포함)
-- [ ] Streamlit 대시보드 (AI 판단 현황 패널 추가)
-
-### Phase 6 — 모의투자 실운영 (최소 3개월)
-- [ ] KIS_MOCK=true, DRY_RUN=false
-- [ ] 매일 결산 로그 + AI 정확도 추적
-- [ ] 3개월 후 AI 필터 임계값 재조정
-- [ ] 샤프 > 1.0, MDD < 15% 달성 시 Phase 7
-
-### Phase 7 — 소액 실거래 (무기한)
-- [ ] KIS_MOCK=false
-- [ ] 총자산 5% 한도로 시작
-- [ ] 1개월 단위 성과 검토
-
----
-
-## 16. 보안 체크리스트
-
-- [ ] .env → .gitignore 등록
-- [ ] KIS/Anthropic API 키 → GitHub 절대 금지
-- [ ] ANTHROPIC_API_KEY 월 1회 암호화 백업
-- [ ] Synology 방화벽: 8501 내부망만 허용
-- [ ] 텔레그램 봇: chat_id 화이트리스트
-- [ ] 주문 로그 SQLite + logs/ 이중 보관
-- [ ] AI 판단 이력 ai_context_log 영구 보관
-
----
-
-## 17. 절대 금지 (하드코딩)
-
-```python
-BLACKLIST_REASONS = [
-    "신규상장 6개월 미만", "관리종목", "투자경고",
-    "거래정지", "우선주", "스팩", "ETF/ETN",
-]
-
-TRADING_BLACKOUT = [
-    ("11:30", "13:00"),  # 점심
-    ("14:50", "15:30"),  # 마감
-    ("08:00", "09:00"),  # 동시호가
-]
-
-HARD_EXIT_TIME = "14:50"  # 절대 변경 불가
-
-# AI가 trade_allowed=false 반환해도 이미 보유 중인 포지션 청산은 진행
-# AI는 신규 진입만 차단, 청산 로직에는 관여하지 않음
-AI_SCOPE = "ENTRY_ONLY"   # 절대 변경 불가
-```
-
----
-
-## 18. 면책 조항
-
-> 본 기획서는 시스템 설계 문서이며, 투자 수익을 보장하지 않는다.
-> AI 판단 레이어는 보조 필터일 뿐, 수익을 보장하지 않는다.
-> 단타는 개인투자자의 90% 이상이 손실을 보는 영역이다.
-> 반드시 모의투자 3개월 이상 검증 후 실거래 전환할 것.