Files
Bithumb/docs/reference/STRUCTURE.md
dsyoon b52d61b777 WLD DeepCoin 단계별 구조 재편 및 설정·문서 통합
로고스/루트 레거시를 제거하고 deepcoin 패키지·scripts 01~05 CLI·docs/reference로
데이터·GT·분석·매칭·운영 단계를 정리했다. config와 .env 기반 설정, trade_anaysis.html 동기화 포함.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-30 22:58:25 +09:00

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/*로 연결되는 별칭입니다.