承兑平台在线文档

Appearance

数据字典 ​

**本文档引用的文件** - [决策变更清单.md](file://决策变更清单.md) - [待确认决策清单.md](file://待确认决策清单.md) - [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md) - [综合审查报告.md](file://综合审查报告.md) - [2026-06-03-Chat.md](file://AI沟通记录/2026-06-03-Chat.md) - [2026-06-05-Chat.md](file://AI沟通记录/2026-06-05-Chat.md) - [2026-06-06_沟通记录.md](file://AI沟通记录/2026-06-06_沟通记录.md) - [2026-06-08_沟通记录.md](file://AI沟通记录/2026-06-08_沟通记录.md)

目录 ​

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

简介 ​

本数据字典基于承兑平台的产品方案与决策变更，系统梳理平台涉及的业务实体与字段，明确字段的数据类型、长度限制、取值范围、默认值、是否允许为空、业务含义、取值约束、枚举值定义、索引策略、唯一性约束、检查约束、业务规则、验证逻辑、数据质量标准、国际化支持与本地化规则、格式化要求等。文档旨在为开发、测试、运维与合规团队提供一致、可执行的数据规范。

项目结构 ​

  • 仓库包含产品方案文档、决策变更与待确认清单、Axure原型、AI沟通记录等材料。
  • 数据字典以产品方案与决策清单为权威来源，Axure原型用于理解界面字段与业务流程映射。
mermaid
graph TB
A["产品方案文档<br/>业务流程、费率体系、资金托管"]
B["决策变更清单<br/>已确认的业务规则与参数"]
C["待确认决策清单<br/>待评估与最终确认"]
D["综合审查报告<br/>架构、合规、运营风险"]
E["Axure原型<br/>界面字段与交互"]
A --> B
B --> C
A --> D
E --> A
E --> B

图表来源

  • [承兑平台产品方案文档.md:1-800](file://承兑平台产品方案文档.md#L1-L800)
  • [决策变更清单.md:1-235](file://决策变更清单.md#L1-L235)
  • [待确认决策清单.md:1-523](file://待确认决策清单.md#L1-L523)
  • [综合审查报告.md:1-800](file://综合审查报告.md#L1-L800)

章节来源

  • [承兑平台产品方案文档.md:1-800](file://承兑平台产品方案文档.md#L1-L800)
  • [决策变更清单.md:1-235](file://决策变更清单.md#L1-L235)
  • [待确认决策清单.md:1-523](file://待确认决策清单.md#L1-L523)
  • [综合审查报告.md:1-800](file://综合审查报告.md#L1-L800)

核心组件 ​

  • 平台角色与职责边界：平台 Admin、商户（外汇平台）、交易员、承兑-代理、终端用户。
  • 核心业务流程：入金（法币→USDT）、出金（USDT→法币）、争议仲裁、批量出金、费率与点差体系、营销与返佣、钱包与资金托管。
  • 技术参数：充值地址方案（独立地址）、结算时区（UTC+8）、Webhook 签名与重试、冷钱包多签、合规与风控策略。

章节来源

  • [承兑平台产品方案文档.md:43-153](file://承兑平台产品方案文档.md#L43-L153)
  • [决策变更清单.md:9-126](file://决策变更清单.md#L9-L126)
  • [待确认决策清单.md:27-122](file://待确认决策清单.md#L27-L122)

架构概览 ​

平台采用“做市商 + 流动性撮合”架构，核心模块包括订单中心、费率引擎、钱包中心、风控中心、通知中心、数据报表中心等。资金以 USDT 内部划转完成，不涉及法币资金流动。

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

图表来源

  • [承兑平台产品方案文档.md:295-331](file://承兑平台产品方案文档.md#L295-L331)

章节来源

  • [承兑平台产品方案文档.md:295-331](file://承兑平台产品方案文档.md#L295-L331)

详细组件分析 ​

1. 用户与账户相关字段 ​

  • 用户类型：商户、交易员、运营管理员、介绍人。

  • 关键字段（示例，字段命名以“业务含义+类型”形式呈现，具体命名以系统实现为准）：

    • 用户ID（字符串，唯一标识）
    • 用户类型（枚举：商户/交易员/运营/介绍人）
    • 实名信息（姓名、身份证号、出生日期、国籍）
    • 联系方式（邮箱、手机号、国家/地区）
    • 账户状态（启用/停用/冻结）
    • 风控等级（低/中/高）
    • KYC/KYB 状态（待审核/通过/拒绝）
    • 创建/更新时间戳

  • 业务规则与约束：

    • 交易员需完成 KYC 并绑定有效法币收款账户。
    • 商户需完成 KYB 并开通账号。
    • 账户状态异常需触发风控与人工审核。

  • 数据质量标准：

    • 实名信息与证件照片一致性校验。
    • 邮箱/手机号唯一性与格式校验。
    • 国际化：支持多语言展示与本地化格式。

章节来源

  • [承兑平台产品方案文档.md:69-143](file://承兑平台产品方案文档.md#L69-L143)
  • [决策变更清单.md:142-164](file://决策变更清单.md#L142-L164)

2. 账户与资金字段 ​

  • 账户类型：商户账户、交易员账户、平台监管账户。

  • 关键字段：

    • 账户ID（字符串，唯一）
    • 账户类型（枚举：商户/交易员/监管）
    • 可用余额（数值，精度到最小单位）
    • 冻结余额（数值，精度到最小单位）
    • 冻结明细（JSON/数组，包含订单ID、金额、原因、到期时间）
    • 资金流水（流水号、订单ID、交易类型、金额、手续费、余额变化、时间）

  • 业务规则与约束：

    • 冻结金额需与订单状态一致，释放时机遵循风控与结算规则。
    • 平台内部划转不产生链上费用，但需记录流水与对账。

  • 数据质量标准：

    • 余额与流水逐笔对账，支持审计追踪。
    • 冻结与释放需事务性保证，防止重复或遗漏。

章节来源

  • [承兑平台产品方案文档.md:485-495](file://承兑平台产品方案文档.md#L485-L495)
  • [决策变更清单.md:107-126](file://决策变更清单.md#L107-L126)

3. 订单与交易字段 ​

  • 订单类型：入金订单、出金订单、批量出金。

  • 关键字段：

    • 订单ID（字符串，唯一）
    • 订单类型（枚举：入金/出金/批量出金）
    • 状态（待指派/已指派/待转账/待确认/已完成/已取消/已挂起）
    • 交易员ID（字符串）
    • 商户ID（字符串）
    • 金额（数值，USDT）
    • 汇率（数值，含商户加点后的最终汇率）
    • 手续费（数值，按商户/交易员分别配置）
    • 点差利润（数值，平台内部记账）
    • 创建/更新/完成时间
    • 备注（JSON，包含附件链接、争议信息等）

  • 业务规则与约束：

    • 入金：锁定交易员USDT，交易员确认收款后释放并划转至商户。
    • 出金：商户USDT先入平台监管账户，交易员转账后风控审核通过释放。
    • 批量出金：支持Excel模板导入，释放节奏受银行风控友好策略约束。

  • 数据质量标准：

    • 订单状态机严格遵循业务流程，异常订单需自动或人工介入。
    • 汇率与手续费计算需可追溯，支持对账与审计。

章节来源

  • [承兑平台产品方案文档.md:156-294](file://承兑平台产品方案文档.md#L156-L294)
  • [决策变更清单.md:65-126](file://决策变更清单.md#L65-L126)

4. 费率与点差字段 ​

  • 基准报价：基准bid、基准ask（数值，含小数点后位数约定）

  • 交易员偏移：bid偏移、ask偏移（数值，正负表示）

  • 商户加点：入金加点、出金减点（数值，百分比，上限配置）

  • 点差利润：平台内部记账差额（数值）

  • 手续费：入金手续费、出金手续费、充值/提现手续费（数值或比例）

  • 业务规则与约束：

    • 对外报价 = 基准报价 ± 商户加点
    • 交易员结算价 = 基准价 + 交易员偏移
    • 价格关系：对外ask > 交易员ask > 交易员bid > 对外bid
    • 商户加点上限默认1%，超0.5%提醒

  • 数据质量标准：

    • 报价偏离超阈值仅告警，不自动干预。
    • 手续费与点差需在下单时透明展示。

章节来源

  • [承兑平台产品方案文档.md:346-461](file://承兑平台产品方案文档.md#L346-L461)
  • [决策变更清单.md:46-62](file://决策变更清单.md#L46-L62)

5. 钱包与地址字段 ​

  • 地址类型：TRC20、ERC20、BEP20

  • 关键字段：

    • 地址ID（字符串，唯一）
    • 用户ID（字符串）
    • 链类型（枚举：TRC20/ERC20/BEP20）
    • 地址（字符串，链上格式）
    • 状态（启用/停用）
    • 创建时间

  • 业务规则与约束：

    • V1优先支持TRC20，后续扩展ERC20/BEP20
    • 独立地址（HD Wallet）方案，无需Memo
    • 热钱包监控与限额，冷钱包多签

  • 数据质量标准：

    • 地址格式校验与链上监听一致性。
    • 多签签名人数与备份人员配置。

章节来源

  • [承兑平台产品方案文档.md:485-495](file://承兑平台产品方案文档.md#L485-L495)
  • [决策变更清单.md:109-118](file://决策变更清单.md#L109-L118)
  • [待确认决策清单.md:266-277](file://待确认决策清单.md#L266-L277)

6. 通知与回调字段 ​

  • Webhook回调字段：

    • 回调ID（字符串，唯一）
    • 订单ID（字符串）
    • 回调类型（枚举：出金完成/入金完成/状态变更）
    • 回调时间、重试次数、签名
    • 回调结果（成功/失败）、失败原因

  • 业务规则与约束：

    • 指数退避重试（1s→5s→30s→5min→30min，最多5次）
    • HMAC-SHA256签名算法
    • 支持商户手动重发

  • 数据质量标准：

    • 回调日志可查询，失败自动重试与兜底。

章节来源

  • [决策变更清单.md:127-139](file://决策变更清单.md#L127-L139)
  • [待确认决策清单.md:183-221](file://待确认决策清单.md#L183-L221)

7. 营销与返佣字段 ​

  • 返佣规则：商户介绍人返佣比例（数值，百分比）

  • 补助规则：小额补助、夜间补助、品牌/时段/金额分级

  • 防套利：随机化触发 + 次数上限

  • 业务规则与约束：

    • 补助由平台或商户承担，需明确分摊规则
    • 防套利策略需可配置与监控

  • 数据质量标准：

    • 补助计算可审计，支持报表统计

章节来源

  • [承兑平台产品方案文档.md:462-484](file://承兑平台产品方案文档.md#L462-L484)
  • [决策变更清单.md:167-198](file://决策变更清单.md#L167-L198)

8. 合规与风控字段 ​

  • KYC/KYB：实名信息、活体检测、制裁名单筛查

  • 风控：报价偏离告警、U池锁定安全边际、挂起超时告警、单卡风控

  • 合规：VASP路径、Travel Rule、税务合规

  • 业务规则与约束：

    • 报价偏离仅告警，不自动暂停
    • U池锁定105%，锁定期间冻结商户提现
    • 挂起超4h告警运营主管
    • 单卡24h收款人上限 + 可配置释放间隔 + 同地区优先

  • 数据质量标准：

    • 风控日志可追溯，异常自动拦截与人工处理

章节来源

  • [综合审查报告.md:173-248](file://综合审查报告.md#L173-L248)
  • [决策变更清单.md:142-164](file://决策变更清单.md#L142-L164)
  • [待确认决策清单.md:125-166](file://待确认决策清单.md#L125-L166)

依赖分析 ​

  • 模块耦合：
    • 订单中心依赖费率引擎、钱包中心、风控中心、通知中心
    • 费率引擎依赖基准报价与商户配置
    • 钱包中心依赖链上节点与多签服务
  • 外部依赖：
    • 链上节点（QuickNode/Alchemy/自建）
    • KYC/AML服务（SumSub/Jumio/Chainalysis等）
    • 短信/邮件服务（Twilio/SendGrid）
mermaid
graph LR
OC["订单中心"] --> FE["费率引擎"]
OC --> WC["钱包中心"]
OC --> RC["风控中心"]
OC --> NC["通知中心"]
WC --> LN["链上节点"]
RC --> KYC["KYC/AML服务"]
NC --> MSG["短信/邮件"]

图表来源

  • [承兑平台产品方案文档.md:656-695](file://承兑平台产品方案文档.md#L656-L695)

章节来源

  • [承兑平台产品方案文档.md:656-695](file://承兑平台产品方案文档.md#L656-L695)

性能考虑 ​

  • 数据库层面：
    • 订单与资金流水高频写入，需合理分区与索引
    • 冻结/释放操作需事务性保证，避免重复或遗漏
  • 链上交互：
    • 充值/提现上链，需考虑Gas成本与确认时间
    • 热钱包归集策略需平衡成本与安全
  • 接口与缓存：
    • 汇率与手续费查询可缓存，设置合理TTL
    • Webhook回调重试与幂等性设计

[本节为通用指导，无需特定文件引用]

故障排查指南 ​

  • 常见问题与处理：
    • 出金审核不通过：联系交易员补充证据，无法提供则USDT退还商户
    • 交易员超时未转账：改派其他交易员，直至完成或最终退还
    • 订单挂起超时：超时自动释放并告警运营主管
    • Webhook失败：指数退避重试 + 手动重发兜底
  • 证据标准：
    • 三选二证据（银行截图/电子回执/录屏）+ 明确举证责任

章节来源

  • [承兑平台产品方案文档.md:227-294](file://承兑平台产品方案文档.md#L227-L294)
  • [决策变更清单.md:88-104](file://决策变更清单.md#L88-L104)
  • [待确认决策清单.md:409-448](file://待确认决策清单.md#L409-L448)

结论 ​

本数据字典基于已确认的业务规则与技术参数，建立了覆盖用户、账户、订单、费率、钱包、通知、营销、合规与风控的字段清单与规范。建议在系统实现中：

  • 严格遵循字段类型、长度、取值范围与约束
  • 建立索引与唯一性约束，保障查询与一致性
  • 完善业务规则与验证逻辑，确保数据质量
  • 明确国际化与本地化策略，提升用户体验
  • 强化风控与合规字段设计，满足监管要求

[本节为总结性内容，无需特定文件引用]

附录 ​

A. 字段命名与类型对照（示例） ​

  • 用户ID：字符串（唯一）
  • 用户类型：枚举（商户/交易员/运营/介绍人）
  • 金额：数值（USDT，精度到最小单位）
  • 汇率：数值（含小数点后位数约定）
  • 时间戳：时间型（UTC+8）
  • 状态：枚举（多种业务状态）
  • JSON/数组：用于复杂字段（冻结明细、备注等）

章节来源

  • [承兑平台产品方案文档.md:485-495](file://承兑平台产品方案文档.md#L485-L495)
  • [决策变更清单.md:107-126](file://决策变更清单.md#L107-L126)

B. 索引与约束建议 ​

  • 唯一性：
    • 用户ID、订单ID、地址ID
  • 索引：
    • 订单状态、用户ID、时间范围
  • 检查约束：
    • 金额≥0、汇率>0、状态枚举值合法
    • 商户加点≤上限、交易员偏移满足价格关系

章节来源

  • [决策变更清单.md:107-126](file://决策变更清单.md#L107-L126)
  • [待确认决策清单.md:28-52](file://待确认决策清单.md#L28-L52)

C. 国际化与本地化 ​

  • 多语言支持：交易员App与商户后台需支持英文、中文、泰文、越南文等
  • 本地化规则：日期/时间（UTC+8）、金额格式、汇率展示
  • 格式化要求：金额显示保留最小精度，汇率展示保留合理小数位

章节来源

  • [综合审查报告.md:350-353](file://综合审查报告.md#L350-L353)
  • [决策变更清单.md:107-126](file://决策变更清单.md#L107-L126)