系统架构

VenueHub、Gateway BFF、跟单执行、签名面与双通道在总体架构中的位置

3 min read2026-08-08

architecturevenue-hubgatewaysigner

一句话

Sharpside 是 Venue 一等公民 的跟单系统：数据采集与绩效在 venue-hub，用户与鉴权在 account，跟随关系在 follow，执行编排在 copier，通道 A 签单在独立 signer，LLM 冷路径在 services/ai，对外聚合经 gateway BFF；用户端 / 运营台为 Next.js（web-ui / admin-ui）。AI Trader / Agent 下单统一汇入 TradeIntent（见 AI Trader 架构）。

服务拓扑

┌──────────────────┐     ┌──────────────┐     ┌─────────────┐
│  apps/web-ui     │────▶│   gateway    │────▶│  account    │
│  apps/admin-ui   │     │   (BFF)      │     │  follow     │
│  apps/tg-bot     │     └──────────────┘     │  copier ────┼──▶ signer
└──────────────────┘                          │  venue-hub  │
                                              │  admin API  │
         ┌────────────────┐                   └─────────────┘
         │ sharpside-daemon│                          │
         │ (通道 B · 本机) │◀── pull / report ────────┘
         └────────────────┘                    Postgres

关键模块职责

模块	职责
`crates/venues/*`	Venue trait、Polymarket adapter
`services/venue-hub`	ingest、mapping、identity、perf、hot worker
`services/account`	用户、JWT、TG auth、订阅、凭证、DW 预配；AI Trader API / cycle worker / risk_gate
`services/ai`	LLM complete（平台 Key / BYOK）；不直连 signer
`services/follow`	跟随 CRUD、信号门控（默认未启动）
`services/copier`	信号消费、风控、通道 A/B 执行与回传、`trade_order` / `TradeIntent`
`services/signer`	通道 A 签单 / 提交 / 提现（业务机不持用户钥）

设计原则（摘录）

主路径不自建链上索引 — 尽量用 Venue 官方 / 第三方数据源。
Venue 可插拔 — 新平台实现 trait 并注册，不改跟单核心。
执行与发现分离 — 排行榜/绩效可独立演进；跟单链路可 dry_run。
密钥边界 — 通道 A 只在 signer；通道 B 只在用户本机。

更细的 Venue 设计见 Venue 设计；签名面见签名面；AI 执行面见 AI Trader 架构。源码级说明见仓库 docs/ARCHITECTURE.md、docs/AI_TRADER_EXECUTION_PLAN.md。

产品操作（用户任务）：产品手册 · 能做什么。

环境搭建

Venue 设计