核心数据实体

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

简介

本文件面向承兑平台的数据建模与实体设计，聚焦于订单实体（入金/出金）、用户实体（商户、交易员、管理员）、汇率实体、风控规则实体等核心业务实体。通过对“决策变更清单”“产品方案文档”“综合审查报告”“待确认决策清单”的系统性梳理，给出字段定义、数据类型、约束条件、业务含义、实体间关联关系、主键外键设计、索引策略、业务规则与验证逻辑、默认值设置、生命周期与状态转换、版本控制机制等完整说明，帮助研发、测试与运维人员建立一致的认知基线。

项目结构

围绕核心数据实体，仓库中与之最相关的知识来源包括：

产品方案文档：定义了平台总体目标、角色职责、关键流程与风险控制思路
决策变更清单：记录了已确认的实体与字段变更，是建模的权威依据
综合审查报告：从资金安全、并发一致性、风控与卡生命周期、API与三方对账安全等维度提出设计建议
待确认决策清单：列出仍需进一步明确的业务细节，为后续迭代建模提供指引

mermaid

graph TB
A["产品方案文档<br/>定义角色与流程"] --> C["决策变更清单<br/>实体与字段变更"]
B["综合审查报告<br/>安全与一致性要求"] --> C
C --> D["核心数据实体建模<br/>订单/用户/汇率/风控规则"]
E["待确认决策清单<br/>待明确的业务细节"] --> D

章节来源

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

核心组件

本节从“实体-字段-约束-关系-生命周期”的角度，系统化描述核心业务实体。

订单实体（入金/出金）

实体定位
- 承兑平台的核心交易载体，承载入金与出金两条主线流程，贯穿“创建-支付确认-结算-完成/取消/异常”的全生命周期。
字段与类型（示例性描述，以“决策变更清单”为准）
- 订单号：字符串，唯一标识；主键
- 类型：枚举（入金/出金）
- 金额：数值（货币单位），必填
- 币种：字符串，必填
- 汇率：数值，可空（出金时按需计算）
- 用户ID：字符串，外键指向用户表
- 商户ID：字符串，可空（入金场景可能为空或与用户绑定）
- 交易员ID：字符串，可空（接单/分单场景）
- 收款账户/付款账户：JSON对象（含银行名称、卡号、户名等），视业务启用
- 状态：枚举（待支付/已支付/已确认/已完成/已取消/异常）
- 创建时间/更新时间：时间戳
- 版本号：整数，乐观锁
约束与校验
- 金额与币种必须匹配；汇率在出金时非空且有效
- 状态转换遵循有限状态机；禁止非法跳转
- 金额与手续费、实际到账金额满足数学一致性
关系
- 多个订单对应一个用户（多对一）
- 订单可归属多个商户/交易员（多对多通过中间表或字段组合实现）
索引策略
- 主键：订单号
- 查询索引：用户ID、商户ID、交易员ID、状态、创建时间
- 聚合索引：币种+状态+创建时间
生命周期与状态转换
- 入金：创建→待支付→已支付→已确认→已完成
- 出金：创建→待支付→已支付→已确认→已完成或异常/取消
- 异常分支：超时、风控拦截、支付失败等触发异常态
版本控制
- 使用版本号字段实现乐观锁，防止并发覆盖
业务规则与默认值
- 默认状态：创建时为“待支付”
- 默认币种：按商户/交易员配置的默认币种
- 汇率默认：按实时汇率或固定点差策略计算

章节来源

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

用户实体（商户、交易员、管理员）

实体定位
- 平台三类角色：商户（发起入金/维护收款卡）、交易员（接单/执行）、管理员（风控/运营）
字段与类型（示例性描述，以“决策变更清单”为准）
- 用户ID：字符串，主键
- 角色：枚举（商户/交易员/管理员）
- 昵称/姓名：字符串
- 账号/手机号/邮箱：字符串，唯一
- 密码哈希：字符串
- 状态：枚举（正常/冻结/注销）
- 创建时间/更新时间：时间戳
- 版本号：整数，乐观锁
约束与校验
- 账号/手机号/邮箱唯一性
- 密码采用不可逆哈希存储
- 交易员需具备接单权限与风控额度
关系
- 用户与订单：一对多（创建/归属）
- 用户与卡信息：一对多（收款卡/出金卡）
索引策略
- 主键：用户ID
- 唯一索引：账号/手机号/邮箱
- 查询索引：角色、状态
生命周期与状态转换
- 正常→冻结（违规/风控）→解冻/注销
版本控制
- 乐观锁版本号
业务规则与默认值
- 默认状态：正常
- 交易员默认接单权限与风控限额由管理员配置

章节来源

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

汇率实体

实体定位
- 用于入金/出金的汇率计算与审计，支持多币种对基准币种的牌价
字段与类型（示例性描述，以“决策变更清单”为准）
- 汇率ID：字符串，主键
- 基准币种：字符串
- 目标币种：字符串
- 汇率值：数值（含点数精度）
- 生效时间：时间戳
- 创建时间/更新时间：时间戳
- 版本号：整数，乐观锁
约束与校验
- 基准币种+目标币种唯一
- 汇率值非负，点数精度符合业务规则
关系
- 汇率与订单：多对一（订单按生效时间取最近有效汇率）
索引策略
- 主键：汇率ID
- 唯一索引：基准币种+目标币种+生效时间
- 查询索引：生效时间
生命周期与状态转换
- 新增→失效（被新版本替代）
版本控制
- 通过生效时间与版本号实现版本演进
业务规则与默认值
- 默认点数精度：由产品方案文档定义
- 汇率来源：内部维护或外部接口回写

章节来源

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

风控规则实体

实体定位
- 描述平台风控策略与阈值，覆盖用户、订单、卡等维度
字段与类型（示例性描述，以“决策变更清单”为准）
- 规则ID：字符串，主键
- 规则类型：枚举（用户/订单/卡/全局）
- 规则名称：字符串
- 阈值/策略：JSON对象（如金额区间、时间窗口、白名单/黑名单）
- 状态：枚举（启用/停用）
- 创建时间/更新时间：时间戳
- 版本号：整数，乐观锁
约束与校验
- 规则互斥与优先级顺序
- 阈值边界合理
关系
- 规则与订单：多对一（订单触发时匹配规则）
索引策略
- 主键：规则ID
- 查询索引：规则类型、状态
生命周期与状态转换
- 启用→停用（灰度/紧急）
版本控制
- 通过版本号与生效时间控制策略演进
业务规则与默认值
- 默认停用或灰度发布
- 规则优先级：按配置顺序与时间窗口判定

章节来源

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

架构总览

下图展示核心实体在平台中的交互关系与数据流向，体现“用户-订单-汇率-风控规则”的协同：

mermaid

erDiagram
USER {
string 用户ID PK
enum 角色
string 账号 UK
string 状态
timestamp 创建时间
int 版本号
}
ORDER {
string 订单号 PK
enum 类型
decimal 金额
string 币种
decimal 汇率
string 用户ID FK
string 商户ID
string 交易员ID
json 收款/付款账户
enum 状态
timestamp 创建时间
timestamp 更新时间
int 版本号
}
EXCHANGE_RATE {
string 汇率ID PK
string 基准币种
string 目标币种
decimal 汇率值
timestamp 生效时间
timestamp 创建时间
int 版本号
}
RISK_RULE {
string 规则ID PK
enum 规则类型
string 规则名称
json 阈值/策略
enum 状态
timestamp 创建时间
int 版本号
}
USER ||--o{ ORDER : "创建/归属"
ORDER }o--|| EXCHANGE_RATE : "按生效时间取值"
ORDER }o--|| RISK_RULE : "触发匹配"

图表来源

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

详细组件分析

订单实体（入金/出金）分析

设计要点
- 订单号唯一且可追踪；类型区分入金/出金；金额与币种强一致
- 汇率可空，便于入金场景快速落单；出金时强制校验
- 用户ID外键确保归属清晰；商户/交易员ID支持多角色协作
- 状态机严格限制非法转换，异常分支纳入统一处理
关键流程（序列图）

mermaid

sequenceDiagram
participant U as "用户"
participant O as "订单服务"
participant R as "风控服务"
participant X as "汇率服务"
participant P as "支付网关"
U->>O : "创建入金/出金订单"
O->>R : "触发风控校验"
R-->>O : "通过/拦截"
O->>X : "查询/锁定汇率"
X-->>O : "返回汇率"
O->>P : "发起支付/打款"
P-->>O : "支付结果"
O->>O : "状态更新待支付→已支付→已确认→完成"
O-->>U : "推送状态与流水"

图表来源

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

章节来源

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

用户实体（商户、交易员、管理员）分析

设计要点
- 角色分离与最小权限原则；交易员接单权限与风控限额独立配置
- 身份凭证唯一性与不可逆存储；状态变化需审计
- 与订单、卡信息的关联保证业务闭环
类图

mermaid

classDiagram
class 用户 {
+用户ID
+角色
+账号
+状态
+创建时间
+版本号
}
class 订单 {
+订单号
+类型
+金额
+币种
+用户ID
+商户ID
+交易员ID
+状态
+版本号
}
用户 "1" o-- "n" 订单 : "创建/归属"

图表来源

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

章节来源

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

汇率实体分析

设计要点
- 基准币种+目标币种+生效时间唯一，避免并发覆盖
- 汇率值与点数精度受业务规则约束
- 订单按生效时间取最近有效汇率，保障一致性
流程图（汇率生效与订单取值）

mermaid

flowchart TD
Start(["开始"]) --> Insert["新增/更新汇率记录"]
Insert --> Unique["唯一性校验<br/>基准币种+目标币种+生效时间"]
Unique --> Save["保存并生成版本号"]
Save --> Order["订单创建/更新"]
Order --> Query["按生效时间查询最近有效汇率"]
Query --> Apply["应用汇率并校验精度"]
Apply --> Done(["结束"])

图表来源

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

章节来源

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

风控规则实体分析

设计要点
- 规则类型与阈值配置化；状态启停支持灰度
- 规则匹配需考虑时间窗口与优先级
流程图（风控规则匹配）

mermaid

flowchart TD
S(["订单触发"]) --> Load["加载生效规则"]
Load --> Match{"按类型匹配"}
Match --> |用户| U["用户维度阈值检查"]
Match --> |订单| O["订单维度阈值检查"]
Match --> |卡| K["卡维度阈值检查"]
Match --> |全局| G["全局阈值检查"]
U --> Decide{"通过/拦截"}
O --> Decide
K --> Decide
G --> Decide
Decide --> |通过| Next["放行并记录日志"]
Decide --> |拦截| Block["阻断并记录日志"]

图表来源

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

章节来源

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

依赖分析

组件耦合
- 订单对用户、汇率、风控规则存在直接依赖；应通过服务层解耦
- 汇率与风控规则作为共享资源，需版本化与缓存策略
外部依赖
- 支付网关/清算系统接口；第三方风控/反洗钱系统
潜在循环依赖
- 避免订单→风控→订单的环路；通过异步事件或幂等接口规避

mermaid

graph LR
ORDER["订单实体"] --> USER["用户实体"]
ORDER --> RATE["汇率实体"]
ORDER --> RULE["风控规则实体"]
RULE --> ORDER
RATE --> ORDER

图表来源

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

章节来源

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

性能考虑

索引优化
- 订单：按用户ID/商户ID/交易员ID/状态/创建时间建立复合索引，支撑高频查询
- 汇率：按基准币种+目标币种+生效时间建立唯一索引，保障并发安全
- 用户：唯一索引覆盖账号/手机号/邮箱
缓存策略
- 热门币种汇率与风控规则缓存；版本号驱动失效
并发控制
- 订单与汇率更新采用乐观锁；风控规则灰度发布
数据分区
- 按日期对订单与流水进行分表/分库，降低热点

故障排除指南

常见问题
- 订单状态异常：检查风控拦截日志与汇率版本
- 汇率不一致：核对生效时间与版本号
- 用户状态冻结：核查风控规则与人工操作记录
排查步骤
- 回溯订单链路日志
- 对照风控规则与汇率版本
- 核对用户状态与权限
修复建议
- 通过版本化规则与幂等接口恢复
- 临时调整风控阈值或暂停相关规则

章节来源

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

结论

通过对“决策变更清单”“产品方案文档”“综合审查报告”“待确认决策清单”的系统梳理，本文给出了订单、用户、汇率、风控规则四类核心实体的建模规范与实施建议。建议在研发落地时严格遵循字段定义、约束条件、索引策略与版本控制机制，持续完善待确认事项，确保平台在资金安全、并发一致性与风控合规方面达到设计目标。

附录

术语表
- 入金：用户向平台充值，形成平台负债
- 出金：用户从平台提现，形成平台资产流出
- 汇率：基准币种对目标币种的兑换比例
- 风控规则：用于识别与阻断高风险行为的策略集合
参考文件
- [决策变更清单.md](file://决策变更清单.md)
- [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md)
- [综合审查报告.md](file://综合审查报告.md)
- [待确认决策清单.md](file://待确认决策清单.md)

核心数据实体 ​

目录 ​

简介 ​

项目结构 ​

核心组件 ​

订单实体（入金/出金） ​

用户实体（商户、交易员、管理员） ​

汇率实体 ​

风控规则实体 ​

架构总览 ​

详细组件分析 ​

订单实体（入金/出金）分析 ​

用户实体（商户、交易员、管理员）分析 ​

汇率实体分析 ​

风控规则实体分析 ​

依赖分析 ​

性能考虑 ​

故障排除指南 ​

结论 ​

附录 ​

核心数据实体

目录

简介

项目结构

核心组件

订单实体（入金/出金）

用户实体（商户、交易员、管理员）

汇率实体

风控规则实体

架构总览

详细组件分析

订单实体（入金/出金）分析

用户实体（商户、交易员、管理员）分析

汇率实体分析

风控规则实体分析

依赖分析

性能考虑

故障排除指南

结论

附录