first commit

2026-08-01 10:33:19 +08:00
commit d9a34d4f20
72 changed files with 5499 additions and 0 deletions
@@ -0,0 +1,92 @@
+# 比特骆驼行情采集分析（market_intel）
+
+独立仓库：**只做行情采集 → 落库 → 分析统计 → 只读展示 / API**。  
+与 `eth_hedge_sim`（策略 / 中控）无代码共用、无进程共用、无交易密钥共用。
+
+- 产品名：比特骆驼行情采集分析  
+- 安装目录：`/opt/market_intel`  
+- 默认端口：`5170`  
+- 时区：`Asia/Shanghai`  
+- 第一期：OKX ETH 只读行情  
+
+详细实现标准见 [开发方案.md](./开发方案.md)。
+
+## 快速开始（Docker）
+
+```bash
+cp .env.example .env
+docker compose up -d --build
+curl -fsS http://127.0.0.1:5170/health
+```
+
+## 一键部署（Ubuntu 22.04）
+
+```bash
+curl -fsSL https://git.bz121.com/dekun/market_intel/raw/branch/main/deploy/manage.sh | bash
+```
+
+已安装：
+
+```bash
+bash /opt/market_intel/deploy/manage.sh
+```
+
+## 本地开发
+
+```bash
+python -m venv .venv
+# Windows: .venv\Scripts\activate
+source .venv/bin/activate
+pip install -r requirements.txt
+cp .env.example .env
+# 本机 SQLite 路径
+# MI_DB_PATH=./data/market_intel.db
+
+set PYTHONPATH=.
+python -m apps.collector.main          # 终端 1
+uvicorn apps.api.main:app --reload --port 5170   # 终端 2
+```
+
+前端（可选）：
+
+```bash
+cd web && npm i && npm run build
+# 产物挂到 API 静态目录；开发可用 npm run dev（代理到 5170）
+```
+
+## 核心口径
+
+1. **期权杠杆** = 标的指数 ÷ 期权卖一（`ask`）  
+2. **波动点数** = 到期指数 − 时段代表指数（未到期标记 `pending_expiry=true`）  
+3. 统计按上海自然日切分；桶默认 1 小时  
+
+## API（第一期）
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/health` | 存活 + 采集延迟（公开） |
+| GET | `/api/auth/status` | 是否需要登录 |
+| POST | `/api/auth/login` | 密码换 token（Cookie + JSON） |
+| GET | `/api/meta/latest` | 最新 Call/Put 杠杆（需鉴权） |
+| GET | `/api/stats/leverage` | 日/周/月时段杠杆聚合 |
+| GET | `/api/stats/move_points` | 时段→到期波动（signed/abs；未到期 pending） |
+| GET | `/api/stats/ops-map` | 作战地图主接口（杠杆 + 波动） |
+| GET | `/api/notify/wecom/status` | 企微配置状态 |
+| POST | `/api/notify/wecom/test` | 企微测试推送 |
+
+鉴权：`AUTH_SECRET=disabled` 关闭；否则 `Authorization: Bearer <token>` / Cookie `mi_token`。  
+企微：`WECOM_ENABLED=1` + `WECOM_WEBHOOK_URL`；连续失败 ≥ `ALERT_FAIL_THRESHOLD`（默认 5）推送。
+
+## 分期
+
+| 阶段 | 交付 |
+|------|------|
+| P0 | 骨架、Compose、manage.sh、健康检查 |
+| P1 | OKX 指数 + ATM Call/Put 采样落库 |
+| P2 | 杠杆日周月统计 + Web 图 |
+| P3 | 到期回填 + 波动点数 |
+| P4 | 鉴权加固、企微告警 |
+
+## 许可
+
+内部项目。