로고스/루트 레거시를 제거하고 deepcoin 패키지·scripts 01~05 CLI·docs/reference로 데이터·GT·분석·매칭·운영 단계를 정리했다. config와 .env 기반 설정, trade_anaysis.html 동기화 포함. Co-authored-by: Cursor <cursoragent@cursor.com>
2.3 KiB
2.3 KiB
DeepCoin 프로젝트 구조
단계별 PM 기준으로 디렉터리·진입점을 정리합니다. 실행은 scripts/만 사용합니다.
문서·산출물은 docs/ 한 곳에서 관리합니다.
docs/reference/— 사람이 읽는 가이드·명세 (Git 추적)docs/02_*~docs/charts/— 스크립트가 만든 HTML·CSV (로컬 재생성)
단계 ↔ 실행 ↔ 산출물
| 단계 | 목적 | 스크립트 | 패키지 | 산출물 |
|---|---|---|---|---|
| 01 | 1년치 봉 적재 | scripts/01_download.py |
deepcoin/data/ |
data/coins.db |
| 02 | Ground Truth 타점 | scripts/02_ground_truth.py |
deepcoin/ground_truth/ |
data/ground_truth/*.json, docs/02_ground_truth/ |
| 03 | 8TF 지표 enrich | scripts/03_analyze_enrich.py |
deepcoin/analysis/ |
docs/03_analysis/latest/ |
| 03b | GT 타점 MTF 스냅샷 | scripts/03_analyze_trades.py |
deepcoin/analysis/ |
docs/03_analysis/general_analysis_trades.csv |
| 04 | GT 근접 규칙 선택 | scripts/04_match_rules.py |
deepcoin/matching/ |
docs/04_matching/ (예정) |
| 05 | 차트·1분 모니터 | scripts/05_chart_*.py, 05_run_monitor.py |
deepcoin/ops/ |
docs/charts/, docs/05_ops/ |
디렉터리 트리
DeepCoin/
├── .env, config.py
├── scripts/ # 단계별 CLI
├── deepcoin/ # 로직 패키지
├── data/ # DB, GT JSON, ops 상태
└── docs/
├── README.md
├── reference/ # 가이드 (Git)
│ ├── ROADMAP.md
│ ├── STRUCTURE.md
│ ├── GROUND_TRUTH.md
│ └── trade_anaysis.html
├── 02_ground_truth/ # 산출물
├── 03_analysis/
├── 04_matching/
├── 05_ops/
└── charts/
deepcoin/analysis/ 모듈 역할
| 파일 | 역할 |
|---|---|
general_analysis_enrich_runner.py |
03 enrich |
general_analysis_runner.py |
03b GT 스냅샷 |
general_analysis_pipeline.py |
타점별 MTF 조립 |
general_analysis_* (기타) |
지표·패턴·리포트 |
구 reports/ 폴더는 docs/로 통합되었습니다. 코드의 REPORTS_* 이름은 paths.py에서 docs/*로 연결되는 별칭입니다.