# 比特骆驼自动化对冲系统 — 商业化与授权方案（初步）

> **产品名**：比特骆驼自动化对冲系统 · **工程**：`eth_hedge_sim`  
> 状态：草案，指导后续开发，细节可迭代。  
> 商业模式结论：**客户侧部署 + 软件授权**（不做中心化多租户托管）。  
> 关联文档：[开发方案](./开发方案.md)、[代码结构](./代码结构.md)

---

## 1. 目标与边界

### 1.1 卖什么

| 项 | 约定 |
|----|------|
| 产品名 | **比特骆驼自动化对冲系统** |
| 产品形态 | 可独立部署的对冲交易系统（SIM + 可选实盘） |
| 交付方式 | 安装包 / 一键脚本 / Docker（后续择一为主） |
| 收费方式 | **授权（License）**：按实例、按期限、按功能档 |
| 不卖什么 | 不承诺收益；不做代客理财；不集中托管客户 API Key |

### 1.2 为什么不做 SaaS 托管

| 风险 | 说明 |
|------|------|
| 交易所限流 | REST/WS 按 IP、API Key 限流；多客户共机互相挤占 |
| 同 IP 风控 | 一公网 IP 对多交易所、多 Key 高频请求，易触发异常标记 |
| 密钥与责任 | 客户 Key 进你机房，合规与事故责任更重 |
| 运维成本 | 你要为所有客户的行情稳定性买单 |

**原则：一客户一实例一出口 IP（或客户自有网络）。**

### 1.3 产品定位一句话

> **比特骆驼自动化对冲系统**：客户在自己的服务器上部署；API Key 不出客户环境；你提供软件、更新与授权。

---

## 2. 交付与部署

### 2.1 目标交付形态（分阶段）

| 阶段 | 形态 | 说明 |
|------|------|------|
| 现在（内部） | Git + `deploy/manage.sh` + PM2 | 已具备，继续打磨成「可复制安装」 |
| 商用 v1 | **一键部署脚本** + 环境检查 + 健康检查 | 客户 **Ubuntu 22.04** 机器上跑通 |
| 商用 v2 | **Docker Compose**（可选） | 降低环境差异；与脚本二选一或并存 |
| 商用 v3 | 离线包 / 镜像导出 | 内网客户、无法拉 Git 的场景 |

### 2.2 客户侧必备条件

- 一台独立 **Ubuntu 22.04** 主机（建议独立 IP）
- 出网访问目标交易所 API（OKX 等）
- 域名或 IP + HTTPS（可用反代）
- 客户自备交易所 API Key（只读行情 / 实盘交易按档位要求）

### 2.3 部署流程（商用目标体验）

1. 客户拿到安装脚本或镜像 + **授权码**
2. 填写 `.env`（账号、交易所 Key、授权码）
3. 一键安装 → 健康检查通过
4. 浏览器登录 → SIM 可演示；实盘需对应授权档位 + 二次确认

### 2.4 更新策略

- 默认：客户机 `git pull` / 镜像升级 + 构建 + 仅 reload 本项目进程
- 破坏性升级：附带迁移说明（配置项、数据库/状态文件）
- 授权未过期才允许拉取正式版更新（可选；初期可人工发版）

---

## 3. 授权（License）设计

### 3.1 设计原则

- **正规客户好用，随手拷贝有门槛**（不做无法破解的完美 DRM）
- 校验失败时：允许登录看状态，但 **禁止启策略 / 禁止实盘下单**（策略可配置）
- 校验逻辑本地为主；可选短时在线激活（降低盗版批量复制）

### 3.2 授权字段（建议）

| 字段 | 用途 |
|------|------|
| `license_id` | 授权编号 |
| `customer_name` | 客户标识（展示/审计） |
| `expires_at` | 到期日 |
| `edition` | 档位：`sim` / `live` / `pro`（名称可调） |
| `instance_id` 或 `machine_fingerprint` | 绑定部署实例（主机指纹或安装时生成的 UUID） |
| `features` | 功能开关列表（可选） |
| `signature` | 对上述字段的签名（私钥在你方，公钥打进程序） |

### 3.3 档位建议（初稿）

| 档位 | 能力 |
|------|------|
| `sim` | 仅 SIM 撮合；实盘下单关闭 |
| `live` | SIM + 实盘下单（显式开关 + 二次确认） |
| `pro` | live + 多策略/高级报表/优先支持（后续） |

### 3.4 绑定策略（由松到紧，可演进）

1. **v1**：授权码 + 到期日 + 档位（不绑机，靠合同与信任）
2. **v2**：首次激活写入 `instance_id`，换机需重置授权
3. **v3**（可选）：定期在线心跳续期；断网宽限期 N 天

### 3.5 运行时行为

```
启动 → 读 license → 验签 / 查到期 / 查档位
  ├─ 有效 → 按档位开放功能
  └─ 无效/过期 → UI 提示；策略不可启动；实盘接口 403
```

本地文件建议：`data/license.json` 或环境变量 `LICENSE_KEY`（整段授权串）。

---

## 4. 技术架构约束（后续开发必须遵守）

### 4.1 多租户与网络

- **不做**「一个进程服务多个无关客户」
- **不做**「你方中心机房代跑客户实盘」作为主路径
- 每个商用部署 = 独立进程 + 独立配置 + 独立日志 + 独立出口网络

### 4.2 密钥与安全

- 交易所 API Key **仅存客户机**（加密或系统权限保护）
- 禁止把客户 Key 回传到你方（授权校验除外的元数据也不含密钥）
- HTTPS、登录鉴权、改密、审计日志（谁启停、谁改参数）逐步补齐

### 4.3 模式隔离

| 模式 | 要求 |
|------|------|
| SIM | 零交易类写接口；行情只读 |
| LIVE | 显式开关 + 二次确认 + 授权档位 dual-check |
| 数据 | SIM 与 LIVE 成交/绩效 **分库或分表/分前缀**，不可混报 |

### 4.4 可观测性（商用必需）

- `/health`：进程、行情连接、授权状态（不含密钥）
- 结构化日志：开平仓原因、费用、流动性等待、紧急平仓
- 绩效导出：按组 / 按日（收益、回撤、费用、胜率）— 客户自证与你售后都需要

---

## 5. 合规与产品话术（边界）

- 定位：**交易辅助工具 / 策略执行软件**，非保本理财
- 界面与合同：风险提示、用户自负盈亏、交易所账户属用户
- 对外演示默认走 **SIM**；实盘由客户自行承担 Key 与资金风险
- 法务文本后续单独立项；工程侧先把「免责展示位 + 二次确认」留好

---

## 6. 开发路线图

### Phase 0 — 现在（产品可用、可演示）

- [x] SIM 对冲主流程、设置、Plan 桌面布局
- [ ] 绩效与组维度报表可导出/可复盘
- [ ] 部署脚本文档化到「陌生人能装上」的程度
- [ ] SIM / 未来 LIVE 配置与文案边界清晰

### Phase 1 — 授权骨架（商用前提）

- [ ] License 数据结构 + 本地验签
- [ ] 到期 / 档位拦截（启策略、实盘 API）
- [ ] 设置页或启动页展示授权状态与到期日
- [ ] 内部发码工具（私钥离线，不进客户仓库）

### Phase 2 — 实盘与交付打磨

- [ ] LIVE 下单通路（已有规划则按开发方案推进）
- [ ] 安装向导：环境检查、端口、反向代理示例
- [ ] 升级与回滚说明；配置迁移
- [ ] 客户排障包：一键打包日志（脱敏）

### Phase 3 — 商业运营配套

- [ ] 授权台账（客户、到期、续费、换机）— 可先表格，后小后台
- [ ] 版本通道：stable / beta
- [ ] 支持档位与 SLA（人工即可）
- [ ] （可选）在线激活与换机工单

### 明确延后

- 中心化多租户 SaaS
- 复杂手机端优先设计
- 支付系统内嵌（可先对公转账 + 人工发码）
- 完美防破解

---

## 7. 与当前仓库的衔接

| 现有能力 | 商用含义 |
|----------|----------|
| `deploy/manage.sh`、远程 `deploy_remote.py` | 演进为客户侧一键安装/更新的基础 |
| PM2 `eth-hedge-api`、端口 5155 | 单实例模型已符合「一客户一进程」 |
| 登录 `AUTH_USERNAME` / `AUTH_PASSWORD` | 保留为实例管理员；与 License 分层 |
| SIM 撮合 + 只读行情 | 作为 `sim` 档与售前演示默认路径 |
| 与 `crypto_monitor` 隔离 | 商用交付物必须自包含，禁止捆绑现网 |

---

## 8. 待决事项（开发前拍板）

1. 主交付形态优先：**脚本 + PM2** 还是 **Docker Compose**？
2. 授权 v1 是否绑机？还是先「码 + 到期日」？
3. 过期策略：只禁实盘，还是 SIM 一并只读？
4. 首发交易所是否仅 OKX，多所是否进 `pro`？
5. 价格与续费周期（工程不阻塞，商务可并行）

---

## 9. 修订记录

| 日期 | 说明 |
|------|------|
| 2026-07-25 | 初稿：确定「部署 + 授权」、否决中心托管主路径、划定 Phase 0–3 |
