refactor: GT·시뮬·운영 3축 정리 및 hybrid 실거래 정합
Phase C/dry-run·미사용 모듈·재생성 HTML을 제거하고, 운영 체결을 sim_causal_hybrid와 동일한 hybrid 로직으로 통합한다. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
@@ -1,52 +1,44 @@
|
||||
# DeepCoin 프로젝트 구조
|
||||
|
||||
단계별 PM 기준으로 디렉터리·진입점을 정리합니다. **실행은 `scripts/`만 사용**합니다.
|
||||
실행은 **`scripts/`** 만 사용합니다. 설계는 **Ground Truth · Simulation · Operations** 세 축입니다.
|
||||
[ARCHITECTURE.md](ARCHITECTURE.md)
|
||||
|
||||
**문서·산출물은 `docs/` 한 곳**에서 관리합니다.
|
||||
## 축별 매핑
|
||||
|
||||
- `docs/reference/` — 사람이 읽는 가이드·명세 (Git 추적)
|
||||
- `docs/02_*` ~ `docs/charts/` — 스크립트가 만든 HTML·CSV (로컬 재생성)
|
||||
| 축 | 패키지 | 스크립트 | 산출물 |
|
||||
|----|--------|----------|--------|
|
||||
| **데이터** | `deepcoin/data/` | `01_download`, `00_sync_ops` | `data/coins.db` |
|
||||
| **Ground Truth** | `ground_truth/`, `analysis/` | `02`, `03_*`, `05_chart_truth` | `ground_truth_trades.json`, `docs/02_ground_truth/` |
|
||||
| **Simulation** | `matching/` | `04_match_rules`, `04_simulation_report` | `docs/04_matching/` |
|
||||
| **Operations** | `ops/` | `06_verify_live`, `06_execute_live` | `data/ops/live_trades.jsonl` |
|
||||
|
||||
## 단계 ↔ 실행 ↔ 산출물
|
||||
|
||||
| 단계 | 목적 | 스크립트 | 패키지 | 산출물 |
|
||||
|------|------|----------|--------|--------|
|
||||
| 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/` |
|
||||
보조: `05_run_monitor` (알림), `verify_env`, `test_buy_sell_rehearsal`
|
||||
|
||||
## 디렉터리 트리
|
||||
|
||||
```text
|
||||
DeepCoin/
|
||||
├── .env, config.py
|
||||
├── scripts/ # 단계별 CLI
|
||||
├── deepcoin/ # 로직 패키지
|
||||
├── data/ # DB, GT JSON, ops 상태
|
||||
├── deepcoin/
|
||||
│ ├── api/
|
||||
│ ├── data/
|
||||
│ ├── ground_truth/
|
||||
│ ├── analysis/
|
||||
│ ├── matching/
|
||||
│ └── ops/
|
||||
├── scripts/
|
||||
├── data/
|
||||
└── docs/
|
||||
├── README.md
|
||||
├── reference/ # 가이드 (Git)
|
||||
│ ├── ROADMAP.md
|
||||
│ ├── STRUCTURE.md
|
||||
│ ├── GROUND_TRUTH.md
|
||||
│ └── trade_anaysis.html
|
||||
├── 02_ground_truth/ # 산출물
|
||||
├── reference/ # ARCHITECTURE, GROUND_TRUTH, SIMULATION …
|
||||
├── 02_ground_truth/
|
||||
├── 03_analysis/
|
||||
├── 04_matching/
|
||||
├── 05_ops/
|
||||
└── charts/
|
||||
└── 05_ops/
|
||||
```
|
||||
|
||||
## `deepcoin/analysis/` 모듈 역할
|
||||
## `docs/` 규칙
|
||||
|
||||
| 파일 | 역할 |
|
||||
|------|------|
|
||||
| `general_analysis_enrich_runner.py` | 03 enrich |
|
||||
| `general_analysis_runner.py` | 03b GT 스냅샷 |
|
||||
| `general_analysis_pipeline.py` | 타점별 MTF 조립 |
|
||||
| `general_analysis_*` (기타) | 지표·패턴·리포트 |
|
||||
- `docs/reference/` — 가이드 (Git)
|
||||
- `docs/02_*` ~ `docs/05_ops/` — 스크립트 재생성 산출물
|
||||
|
||||
구 `reports/` 폴더는 `docs/`로 통합되었습니다. 코드의 `REPORTS_*` 이름은 `paths.py`에서 `docs/*`로 연결되는 별칭입니다.
|
||||
코드의 `REPORTS_*` 별칭은 `deepcoin/paths.py`에서 `docs/*`로 연결됩니다.
|
||||
|
||||
Reference in New Issue
Block a user