📑 [EPIC] 로또 분석 시스템 (mkLottoAnalysisInsight) 요구사항 및 설계서¶

🔗 Gitea Wiki (Mermaid 다이어그램 보기): https://gitea.mkaidevops.xyz/mkpark/mkLottoAnalysisInsight/wiki
🌐 서비스 URL: https://lotto.mkaidevops.xyz

🎯 1. 프로젝트 목표 & 개요¶

• 🎰 1회차부터 최신 회차까지의 당첨 데이터를 자동 수집
• 📊 회차별 당첨 번호 추출 직후 40여 가지 지표(Feature)를 일련번호 행(Row) 기반으로 즉시 생성/저장
• 🤖 학습 데이터셋(Dataset)을 자동화하여 AI/ML 기반 번호 예측 및 필터링 엔진 구축
• 🌐 대시보드 시각화 및 조건부 조합 생성 웹 서비스 제공

🔄 2. 데이터 처리 파이프라인 흐름¶

1. [수집] 동행복권 API / 크롤러 (매주 토요일 20:45)
   └── 🗄️ lotto_draws (원천 당첨 번호 DB)
2. [분석값 추출] Feature Extractor Engine
   ├── 일반/상세 (홀짝, 고저, AC, 소수, 배수, 이웃수)
   ├── 합계/분할 (총합, 단수합, 3/5/9/15분법, 전멸대)
   └── 출현/패턴 (Hot/Cold, 궁합수, 용지 가로/세로)
3. [저장] 📊 lotto_analysis_features (일련번호 기반 Feature DB)
4. [활용] 🔮 AI/ML 모델 학습 & 🖥️ REST API / 대시보드 (lotto.mkaidevops.xyz)

🗄️ 3. DB 테이블 설계 요약¶

A. lotto_draws (기본 당첨 정보)¶

B. lotto_analysis_features (회차별 분석 데이터셋)¶

📌 4. Redmine 서브 일감 (Sub-Tasks) 목록¶

• [TASK-01] 📡 동행복권 당첨 데이터 수집 크롤러 개발
  • 1회차 ~ 최신 회차 당첨 번호 API/Scraper 구현
  • 매주 토요일 추첨 직후 실행될 Scheduler (APScheduler/Cron) 구성
• [TASK-02] ⚙️ Feature Extractor (분석값 생성기) 개발
  • 회차 데이터 입력 시 40+가지 지표 자동 계산 알고리즘 작성
  • 과거 전 회차 대상 Batch 수집 및 DB Insert 스크립트 작성
• [TASK-03] 🤖 ML/AI 시계열 예측 모델 구현
  • lotto_analysis_features 테이블 기반 Feature Matrix 추출
  • XGBoost / LSTM 기반 출현 확률 및 패턴 이상치 Score 계산 모델 개발
• [TASK-04] 🎲 조건부 번호 생성기 엔진 구현
  • 고정수/제외수, 홀짝/합계/AC값 조건 필터링 기능
• [TASK-05] 🚀 RESTful API 개발
  • 회차별 통계 조회, 차트용 통계 집계, 번호 추천 API
• [TASK-06] 📊 대시보드 UI 구현
  • 9궁도, 종이패턴, 출현빈도, AC/합계 차트 시각화
• [TASK-07] 🐳 Dockerization & Nginx SSL 설정
  • Docker Compose 구성 (lotto.mkaidevops.xyz 도메인 포워딩)
• [TASK-08] 🔄 Gitea Webhook / CI/CD 연동
  • main 브랜치 푸시 시 자동 배포 파이프라인 작성