承兑平台在线文档

Appearance

整体架构概览 ​

**本文引用的文件** - [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md) - [决策变更清单.md](file://决策变更清单.md) - [待确认决策清单.md](file://待确认决策清单.md) - [综合审查报告.md](file://综合审查报告.md)

目录 ​

  1. 简介
  2. 项目结构
  3. 核心组件
  4. 架构总览
  5. 详细组件分析
  6. 依赖分析
  7. 性能考量
  8. 故障排查指南
  9. 结论
  10. 附录

简介 ​

本文件面向承兑平台的整体架构与设计，聚焦“文档驱动架构”与“原型驱动开发”的双重设计模式，系统阐述平台如何支撑法币与USDT之间的流动性承兑、做市商模式与智能撮合机制，以及系统边界、核心组件与数据流。文档同时给出架构约束、设计原则与扩展性考虑，帮助技术与非技术读者快速理解平台的设计意图与实现路径。

项目结构 ​

承兑平台仓库以“产品方案 + 决策与评审 + 原型与测试”为主线组织，核心文档包括：

  • 产品方案文档：定义业务模型、角色职责、流程与模块设计
  • 决策变更清单：沉淀已确认的关键技术与运营决策
  • 待确认决策清单：梳理尚未最终确认的议题与权衡
  • 综合审查报告：从多角色视角对方案进行系统性审视与优化建议
  • Axure原型：早期交互与界面设计（用于原型驱动开发）
mermaid
graph TB
A["产品方案文档<br/>定义业务与模块"] --> B["决策变更清单<br/>固化关键决策"]
A --> C["待确认决策清单<br/>推进权衡与共识"]
A --> D["综合审查报告<br/>多角色审视与优化"]
A --> E["Axure原型<br/>界面与交互设计"]
B --> F["指导系统设计与实现"]
C --> F
D --> F
E --> F

图表来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)
  • [决策变更清单.md](file://决策变更清单.md)
  • [待确认决策清单.md](file://待确认决策清单.md)
  • [综合审查报告.md](file://综合审查报告.md)

章节来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)
  • [决策变更清单.md](file://决策变更清单.md)
  • [待确认决策清单.md](file://待确认决策清单.md)
  • [综合审查报告.md](file://综合审查报告.md)

核心组件 ​

平台采用“业务中台 + 多端应用”的分层设计，围绕订单中心、费率引擎、风控中心、钱包中心、通知中心与数据报表中心构建核心能力。

mermaid
graph TB
subgraph "前端层"
M["商户端<br/>(API/后台)"]
T["交易员端<br/>(App/H5)"]
A["运营后台<br/>(Web)"]
I["介绍人端<br/>(Web)"]
end
subgraph "业务中台"
OC["订单中心"]
FE["费率引擎"]
RC["风控中心"]
MC["营销中心"]
end
subgraph "基础设施"
AC["账户中心"]
WC["钱包中心"]
NC["通知中心"]
DC["数据报表中心"]
end
M --> OC
T --> OC
A --> OC
I --> MC
OC --> FE
OC --> RC
OC --> WC
FE --> AC
RC --> AC
WC --> AC
NC --> M
NC --> T
NC --> A
DC --> A

图表来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)

章节来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)

架构总览 ​

平台定位为“做市商 + 流动性撮合平台”，不直接持有法币，所有内部结算以USDT完成。系统通过基准报价、交易员偏移与商户加点三层配置，形成对外报价与交易员结算价的差异化，实现价差盈利与利润分配。

mermaid
flowchart TD
Start(["系统启动"]) --> Init["初始化基准报价<br/>手动设定 bid/ask"]
Init --> Config["配置交易员偏移与商户加点"]
Config --> Engine["费率引擎计算<br/>对外价/交易员价/手续费"]
Engine --> Order["订单中心接收请求<br/>入金/出金/批量"]
Order --> Dispatch["指派引擎匹配交易员<br/>冻结USDT/锁定资金"]
Dispatch --> Fund["钱包中心执行内部划转<br/>USDT冻结/释放/结算"]
Fund --> Notify["通知中心发送回调/站内信/短信"]
Notify --> Report["数据报表中心生成统计"]
Report --> End(["运营与风控决策"])

图表来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)

章节来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)

详细组件分析 ​

订单中心 ​

  • 职责：接收商户API请求，创建入金/出金订单，执行指派与状态流转，处理异常与申诉
  • 关键流程：入金锁定→法币线下转账→交易员确认收款→USDT内部划转；出金商户锁定→平台指派→交易员转账→风控审核→释放USDT
  • 状态机：待指派→已指派→待转账→待确认→已完成/已取消；支持批量出金的“部分完成”聚合状态
  • 异常处理：金额不符、超时、争议仲裁、申诉兜底
mermaid
sequenceDiagram
participant Merchant as "商户"
participant Platform as "订单中心"
participant Dispatcher as "指派引擎"
participant Trader as "交易员"
participant Wallet as "钱包中心"
Merchant->>Platform : 发起入金/出金订单
Platform->>Dispatcher : 匹配可用交易员
Dispatcher-->>Platform : 指派结果冻结USDT
Platform->>Trader : 推送订单详情
Trader->>Platform : 确认收款/转账凭证
Platform->>Wallet : 内部USDT划转/释放
Wallet-->>Platform : 到账确认
Platform-->>Merchant : Webhook回调/完成通知

图表来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)

章节来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)

费率引擎（两套报价体系 + 三层配置） ​

  • 报价体系：对外报价（商户/终端用户看到）与交易员结算价（交易员实际结算）
  • 三层配置：平台基准（全局唯一）→交易员偏移（等级/独立）→商户加点（独立配置）
  • 价格关系：对外ask > 交易员ask > 交易员bid > 对外bid，确保交易员不亏损
  • 自动计算：基准价 + 偏移 + 加点，返回最终汇率；平台利润=USDT数量差
mermaid
flowchart TD
Base["基准 bid/ask"] --> Offset["交易员偏移<br/>等级/独立"]
Offset --> Merchant["商户加点<br/>入金加点/出金减点"]
Merchant --> Final["最终汇率/价格"]
Final --> Profit["平台USDT利润计算"]

图表来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)

章节来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)

钱包中心 ​

  • 地址管理：为交易员/商户分配独立地址（HD Wallet），TRC20/ERC20/BEP20
  • 充值/提现：链上充值确认后更新余额；提现经审核后热钱包链上转账
  • 冷热钱包：热钱包用于日常周转，冷钱包用于大额储备与多签管理
  • 内部划转：USDT在数据库层面完成冻结/释放/结算，零Gas成本
mermaid
flowchart TD
Recharge["链上充值"] --> Confirm["链上确认"]
Confirm --> Update["更新账户余额"]
Update --> Internal["内部冻结/释放/结算"]
Internal --> Withdraw["提现审核"]
Withdraw --> Chain["热钱包链上转账"]

图表来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)

章节来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)

风控中心 ​

  • KYC/限额/反欺诈：交易员/商户准入与风险评级
  • 审计与准备金：交易记录留痕，合规与风险准备金机制（V1暂不设）
  • 异常处置：争议仲裁、申诉兜底、超时自动释放与改派
mermaid
flowchart TD
Alert["风控告警/偏离保护"] --> Review["人工/系统审核"]
Review --> Action["处置：限制/暂停/冻结/改派"]
Action --> Report["审计与报表"]

图表来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)

章节来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)

营销中心（返佣与补助） ​

  • 商户介绍人返佣：按交易量比例结算
  • 补助机制：小额/夜间补助，支持固定金额/百分比与分级策略
  • 防套利：随机化触发+次数上限

章节来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)

通知中心与数据报表中心 ​

  • 通知：Webhook回调、站内信、短信/邮件
  • 报表：实时交易数据、财务统计、交易员绩效、商户分析

章节来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)

依赖分析 ​

  • 外部依赖：区块链节点（QuickNode/Alchemy/自建）、短信/邮件服务（Twilio/SendGrid）、合规与反洗钱（Chainalysis/Elliptic/TRM Labs）
  • 内部耦合：订单中心高度依赖费率引擎、风控中心与钱包中心；通知中心贯穿各模块；数据报表中心依赖账户与订单数据
mermaid
graph LR
Order["订单中心"] --> Rate["费率引擎"]
Order --> Risk["风控中心"]
Order --> Wallet["钱包中心"]
Notify["通知中心"] --> Order
Notify --> Wallet
Report["数据报表中心"] --> Order
Report --> Wallet

图表来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)

章节来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)

性能考量 ​

  • 交易速度：内部USDT划转毫秒级，链上充值/提现受区块确认影响
  • 并发控制：指派引擎需分布式锁与原子更新，避免交易员超限
  • 结算幂等：批次号+数据库事务+乐观锁，确保T+1批量结算不重复
  • 链上成本：归集与转账Gas成本纳入运营预算，考虑合并归集降低频率

章节来源

  • [综合审查报告.md](file://综合审查报告.md)
  • [决策变更清单.md](file://决策变更清单.md)

故障排查指南 ​

  • Webhook回调失败：指数退避重试+手动重发兜底；HMAC-SHA256签名验证
  • 资金异常：资金操作日志+对账重试；挂起超时自动释放
  • 争议仲裁：三选二证据标准+举证责任明确；SLA入金2h/出金30min+超时兜底
  • 链上监控单点：备用RPC节点（自建/Infura）作为Failover

章节来源

  • [决策变更清单.md](file://决策变更清单.md)
  • [综合审查报告.md](file://综合审查报告.md)

结论 ​

承兑平台以“文档驱动架构”确保业务规则与技术实现一致，“原型驱动开发”加速界面与交互验证。通过做市商+撮合的双轮驱动，平台在USDT与法币之间提供高效流动性通道，以基准报价、交易员偏移与商户加点形成稳健的价差模型。在合规与风控方面，平台采用分层混合托管、多签管理与分级KYC策略，结合自动化与人工仲裁机制，构建安全、透明、可扩展的系统。

附录 ​

系统上下文图 ​

mermaid
graph TB
Customer["终端用户"] --> Merchant["商户外汇平台"]
Merchant --> API["商户API/后台"]
API --> Platform["承兑平台"]
Platform --> Trader["交易员App/H5"]
Platform --> Admin["运营后台"]
Platform --> Wallet["钱包中心"]
Platform --> Notify["通知中心"]
Platform --> Report["数据报表中心"]

图表来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)

数据流向图（入金/出金） ​

mermaid
flowchart TD
A["终端用户"] --> B["商户外汇平台"]
B --> C["订单中心"]
C --> D["指派引擎"]
D --> E["交易员"]
E --> F["法币线下转账"]
F --> G["钱包中心冻结/释放"]
G --> H["USDT内部划转"]
H --> I["通知中心回调/站内信"]

图表来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)

架构约束与设计原则 ​

  • 架构约束
    • 不持有法币，所有内部结算以USDT完成
    • 分层混合托管：日常中心化+大额多签
    • Webhook回调采用HMAC-SHA256签名与指数退避重试
    • T+1结算时区与跨日订单归属明确
  • 设计原则
    • 价差模型不可逆：对外ask > 交易员ask > 交易员bid > 对外bid
    • 交易员准入与风控：KYC/限额/反欺诈
    • 争议处理：证据标准+举证责任+SLA+超时兜底
    • 可扩展性：模块化设计、API版本演进、链支持分阶段扩展

章节来源

  • [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)
  • [决策变更清单.md](file://决策变更清单.md)
  • [待确认决策清单.md](file://待确认决策清单.md)
  • [综合审查报告.md](file://综合审查报告.md)