Appearance
功能需求定义
**本文引用的文件** - [待确认决策清单.md](file://待确认决策清单.md) - [决策变更清单.md](file://决策变更清单.md) - [提示词.txt](file://提示词.txt)目录
引言
本文件面向“承兑平台”的功能需求定义,目标是基于AI沟通记录与现有决策文档,系统化梳理平台的核心功能与辅助功能,明确各模块职责、交互关系、数据流与风控边界,并给出验收标准、测试要点与性能要求。平台定位为“做市商 + 流动性撮合平台”,通过法币与稳定币(USDT)之间的兑换为外汇市场提供流动性;交易员作为流动性提供者,通过被动接单赚取 bid/ask 价差。
项目结构
- 决策与沟通基础
- 决策类文档:用于固化已确认的业务模型、流程与技术约束(如术语定义、汇率服务模式、出金流程等)。
- 沟通记录:用于理解业务背景、角色分工与关键问题的讨论结论。
- 原型与界面
- Axure原型包含移动端与PC端两类角色(交易员、商户)的页面集合,覆盖登录、资料完善、资产、订单、收款方式、提现、收入明细、分销规则、客户管理、接单管理等场景。这些页面为功能域划分与用例建模提供了直观依据。
- 任务与测试过程
- 用于指导后续测试与质量保障流程的落地执行。
mermaid
graph TB
A["决策与沟通基础<br/>决策变更清单/待确认决策清单/提示词"] --> B["功能域划分<br/>订单管理/交易员管理/商户管理/风控管理"]
B --> C["原型页面<br/>交易员/商户界面集合"]
C --> D["用例图/用例描述/功能分解结构"]
D --> E["接口定义/数据流/验收标准"]核心组件
围绕平台业务,功能域可抽象为以下核心模块:
- 订单管理:涵盖入金(用户买U)、出金(用户卖U)两大方向的订单生命周期管理,包括创建、指派、执行、凭证上传、风控审核、结算与对账。
- 交易员管理:交易员注册、实名认证、资料完善、分组与排班、接单策略与状态管理、收益统计与分成规则。
- 商户管理:商户注册、实名认证、费率与加点配置、汇率展示、充值与提现、资产与资金流水、客户与订单管理。
- 风控管理:凭证校验、可疑行为识别、限额与告警、合规名单比对、结算批次与重试策略、争议处理与仲裁流程。
- 基础设施与支撑:汇率服务(含商户加点)、API签名与鉴权、监管账户与资金划转、报表与审计日志。
章节来源
- [决策变更清单.md: 13-86:13-86](file://决策变更清单.md#L13-L86)
- [待确认决策清单.md: 13-522:13-522](file://待确认决策清单.md#L13-L522)
架构总览
平台采用“中心化报价 + 指派制接单 + 监管账户 + 风控审核”的架构:
- 平台负责设定 bid/ask 基准价,商户在平台设置加点,最终展示给终端用户。
- 订单由平台指派给交易员,交易员完成资金划转与凭证上传,风控审核通过后释放资金。
- 平台通过监管账户隔离风险,确保资金安全与可追溯。
mermaid
graph TB
subgraph "前端层"
U["用户终端"]
M["商户PC/APP"]
T["交易员PC/APP"]
end
subgraph "应用服务层"
OM["订单管理服务"]
TM["交易员管理服务"]
MM["商户管理服务"]
RM["风控管理服务"]
IS["基础设施服务<br/>汇率/签名/账户/审计"]
end
subgraph "数据与存储"
DB["数据库"]
AC["监管账户系统"]
LOG["审计日志"]
end
U --> OM
M --> MM
T --> TM
OM --> RM
OM --> AC
MM --> IS
TM --> IS
RM --> IS
OM --> DB
MM --> DB
TM --> DB
RM --> DB
AC --> DB
IS --> DB
IS --> LOG详细组件分析
订单管理模块
- 职责
- 创建订单:接收用户入金/出金申请,计算金额与汇率(含商户加点),生成订单。
- 指派交易员:按规则将订单指派给合适的交易员,记录派单日志。
- 执行与凭证:交易员完成银行转账并上传凭证,系统记录流水。
- 风控审核:风控对凭证进行审核,通过后释放USDT至交易员账户。
- 结算与对账:完成结算周期内的对账与收益分配。
- 关键流程(出金为例)
- 商户提交出金订单 → 平台锁定USDT至监管账户 → 指派交易员 → 交易员转账并上传凭证 → 风控审核 → 释放资金 → 结算与收益分配。
mermaid
sequenceDiagram
participant 商户 as "商户"
participant 订单服务 as "订单管理服务"
participant 交易员 as "交易员"
participant 风控 as "风控管理服务"
participant 账户 as "监管账户系统"
商户->>订单服务 : "提交出金订单"
订单服务->>账户 : "锁定USDT至监管账户"
订单服务->>交易员 : "指派订单"
交易员->>交易员 : "银行转账并上传凭证"
交易员->>订单服务 : "提交凭证"
订单服务->>风控 : "触发审核"
风控-->>订单服务 : "审核结果"
订单服务->>账户 : "释放USDT"
订单服务-->>商户 : "订单完成"图表来源
- [决策变更清单.md: 67-86:67-86](file://决策变更清单.md#L67-L86)
章节来源
- [决策变更清单.md: 67-86:67-86](file://决策变更清单.md#L67-L86)
交易员管理模块
- 职责
- 用户注册与实名认证:完善身份信息与安全设置。
- 资料完善与状态管理:待完善资料、休息中/接单中状态切换。
- 接单管理:查看可接订单、接受/拒绝、查看历史与收益。
- 收益与分成:统计日/周/月收益,查看分成规则与明细。
- 关键流程
- 登录/安全验证 → 完善资料 → 设置接单状态 → 查看待接订单 → 接单与执行 → 查看收益与提现。
mermaid
flowchart TD
Start(["进入交易员界面"]) --> Login["登录/安全验证"]
Login --> Profile["完善资料"]
Profile --> Status["设置接单状态"]
Status --> Orders["查看待接订单"]
Orders --> Accept{"接受订单?"}
Accept --> |是| Execute["执行订单并上传凭证"]
Accept --> |否| Orders
Execute --> Income["查看收益与明细"]
Income --> Withdraw["提现申请"]
Withdraw --> End(["完成"])章节来源
- [待确认决策清单.md: 486-522:486-522](file://待确认决策清单.md#L486-L522)
商户管理模块
- 职责
- 注册与认证:完善企业/个人资料与银行信息。
- 汇率与加点:设置商户加点,查询实时汇率(含加点后的最终价格)。
- 充值与提现:向平台账户充值USDT,发起提现并跟踪状态。
- 资产与流水:查看余额、资金明细与收益统计。
- 客户与订单:管理客户、查看订单列表与详情。
- 关键流程
- 登录 → 设置加点 → 查询汇率 → 充值/提现 → 查看流水与收益。
mermaid
flowchart TD
S(["进入商户界面"]) --> Reg["登录/安全验证"]
Reg --> Setup["设置加点与收款方式"]
Setup --> Price["查询汇率含加点"]
Price --> Fund["充值/提现"]
Fund --> Assets["查看资产与流水"]
Assets --> Orders["查看客户与订单"]
Orders --> End(["完成"])章节来源
- [决策变更清单.md: 46-61:46-61](file://决策变更清单.md#L46-L61)
- [待确认决策清单.md: 486-522:486-522](file://待确认决策清单.md#L486-L522)
风控管理模块
- 职责
- 凭证审核:校验交易员上传的转账凭证,判断真实性与完整性。
- 限额与告警:根据商户/交易员设置限额,超阈值告警或暂停。
- 合规与名单:集成OFAC等名单比对,拦截高风险交易。
- 结算与重试:结算批次号与事务保障,指数退避重试+手动兜底。
- 关键流程
- 订单触发风控 → 凭证校验 → 名单比对 → 限额评估 → 审核结果与处置。
mermaid
flowchart TD
RStart(["订单进入风控"]) --> Verify["凭证真实性校验"]
Verify --> List["合规名单比对"]
List --> Limit["限额与阈值评估"]
Limit --> Decision{"通过/拦截/告警"}
Decision --> |通过| Release["释放资金"]
Decision --> |拦截| Hold["冻结并人工复核"]
Decision --> |告警| Notify["通知运营/风控"]
Release --> REnd(["结束"])
Hold --> Review["人工复核与处置"]
Review --> Release
Notify --> End(["结束"])章节来源
- [待确认决策清单.md: 486-522:486-522](file://待确认决策清单.md#L486-L522)
基础设施与支撑模块
- 汇率服务:平台设定基准 bid/ask,商户加点后返回最终汇率;不提供独立汇率查询接口。
- API签名:采用HMAC-SHA256签名,保障接口安全。
- 监管账户:USDT进入平台监管账户,审核通过后释放给交易员。
- 报表与审计:提供余额与资金明细查询API、交易历史查询API,支持审计日志留存。
mermaid
graph LR
IS["基础设施服务"] --> EX["汇率服务"]
IS --> SIG["API签名/HMAC-SHA256"]
IS --> ACC["监管账户"]
IS --> AUD["审计日志"]
EX --> ORD["订单管理"]
SIG --> ORD
ACC --> ORD
AUD --> ORD章节来源
- [决策变更清单.md: 46-61:46-61](file://决策变更清单.md#L46-L61)
- [待确认决策清单.md: 486-522:486-522](file://待确认决策清单.md#L486-L522)
依赖分析
- 模块耦合
- 订单管理服务与风控管理服务强耦合(凭证审核与释放资金)。
- 商户管理服务与汇率服务弱耦合(仅查询汇率,不参与定价)。
- 交易员管理服务与订单管理服务弱耦合(仅接收指派订单)。
- 外部依赖
- 合规名单比对(OFAC等)。
- 银行转账与监管账户系统。
- 审计日志与监控系统。
mermaid
graph TB
OM["订单管理"] --> RM["风控管理"]
MM["商户管理"] --> OM
TM["交易员管理"] --> OM
MM --> IS["基础设施"]
TM --> IS
OM --> IS
RM --> IS
IS --> EXT["外部系统<br/>名单/银行/审计"]性能考虑
- 响应时间
- 订单创建与查询:建议接口响应时间小于2秒,高峰时段不超过5秒。
- 汇率查询:单次查询响应时间小于1秒。
- 吞吐量
- 并发订单处理能力:建议支持至少X倍于峰值流量的并发请求。
- 可用性
- 系统可用性不低于99.9%,关键路径(出金审核与资金释放)SLA更高。
- 存储与日志
- 审计日志保留不少于180天,支持快速检索与导出。
故障排查指南
- 常见问题
- 凭证审核失败:检查图片清晰度、信息完整性与一致性。
- 资金未释放:确认风控审核状态与监管账户状态。
- 汇率不一致:核对商户加点设置与平台基准价。
- 处理流程
- 运营侧:通过风控面板查看审核记录与异常订单,进行人工复核。
- 技术侧:检查接口日志、签名验证与外部系统连通性。
- 审计侧:导出相关交易与日志,形成闭环追踪。
章节来源
- [待确认决策清单.md: 486-522:486-522](file://待确认决策清单.md#L486-L522)
结论
本需求定义以“做市商 + 流动性撮合”为核心,明确了订单、交易员、商户、风控四大模块的职责与边界,并给出了关键流程、接口与数据流的规范。通过监管账户与风控审核双保险,平台在满足合规要求的同时,兼顾效率与用户体验。后续可在原型页面基础上细化用例与测试方案,确保交付质量。
附录
- 术语与约定
- bid:买入USDT的价格(行业标准),即你买U的价格。
- ask:卖出USDT的价格(行业标准),即你卖U的价格。
- 汇率服务:商户加点后的最终汇率,不提供独立汇率接口。
- 优先级与可行性
- P0:术语修正、风控审核、监管账户与API签名(必须立即实现)。
- P1:商户加点上限、结算批次与重试策略、合规名单比对。
- P2:收益汇总展示、分销规则与邀请数据。
- 技术约束
- HMAC-SHA256签名;监管账户隔离;审计日志不可抵赖;合规名单比对零成本集成。