Skip to content

数据库设计文档

版本号修改修改时间备注
v1.0.0王小琱2024.12.20初次修订

1. 简介

本文档描述了 exchange-notabene-bridge-backend 项目中数据库的结构设计,包括核心表的定义、字段说明及表关系,旨在为开发、测试和运维人员提供参考。

2. 数据库概览

  • 数据库名称:exchange_notabene_bridge
  • 数据库类型:MySQL
  • 编码格式:utf8mb4
  • 存储引擎:InnoDB
  • 排序集:utf8mb4_0900_ai_ci

3. 命名规范

  • 表名使用小写字母+下划线风格,例如:travel_rule
  • 字段名使用小写字母+下划线风格,例如:created_at
  • 主键统一使用 id
  • 时间字段统一使用:created_atupdated_at
  • 逻辑删除字段:如有软删可用 deleted_at

4. 表结构设计

4.1 表:travel_rule(旅行规则表)

字段名类型长度是否为NULL是否自增是否主键默认值说明
idBIGINT64-主键
transaction_refVARCHAR255-交易参考
transaction_idVARCHAR255-交易ID
transaction_typeVARCHAR255-交易类型
requestJSON--请求数据
responseJSON--响应数据
created_atDATETIME--创建时间
updated_atDATETIME--更新时间

travel_rule 表用于记录与 Notabene 旅行规则相关的交易信息,包括请求和响应的原始数据,便于合规追溯和数据分析。

5. 表关系设计(ER 图)

6. 安全与审计字段

建议每张表都增加以下字段(如适用):

  • created_atupdated_at:记录操作时间
  • deleted_at:逻辑删除字段

🚀 构建现代化数字资产交易平台