mirror of
https://gitee.com/technical-laohu/mpay_v2_webman.git
synced 2026-05-09 02:14:53 +08:00
数据库总说明
这里放数据库相关的稳定说明和 DDL 入口。
当前 DDL
当前数据库事实源已经迁移到 payment-middle-ddl.sql。
它覆盖的核心表分组包括：
- 商户与登录主体
- 支付方式、支付插件、支付通道
- 轮询组、轮询组通道、轮询组绑定
- 商户策略与商户 API 凭证
- 支付单、退款单、转账单、清算单
- 商户资金账户与流水
- 通知日志、回调日志、日统计
- 文件资产、系统配置、后台用户
关键表分组
| 分组 | 代表表 |
|---|---|
| 基础字典 | ma_payment_type、ma_system_config |
| 商户主体 | ma_merchant、ma_merchant_group、ma_merchant_api_credential、ma_merchant_policy |
| 支付编排 | ma_payment_plugin、ma_payment_plugin_conf、ma_payment_channel、ma_payment_poll_group、ma_payment_poll_group_channel、ma_payment_poll_group_bind |
| 交易订单 | ma_biz_order、ma_pay_order、ma_refund_order、ma_transfer_order、ma_settlement_order、ma_settlement_item |
| 资金账户 | ma_merchant_account、ma_merchant_account_ledger |
| 运维日志 | ma_channel_notify_log、ma_pay_callback_log、ma_channel_daily_stat、ma_notify_task |
| 文件与后台 | ma_file_asset、ma_admin_user |
说明原则
- DDL 是事实源
- 表结构变化要先更新 DDL，再补说明
- 文档里不要重复贴大段 SQL，尽量只解释结构和用途
ma_merchant是商户主体，也是后台登录主体ma_merchant_api_credential只用于开放接口签名和兼容层，不参与后台登录ma_merchant_api_credential同时承载 V1 的 MD5 凭证值和 V2 的 RSA 公钥ma_transfer_order负责承接 V2 转账单据- 路由链路优先遵循“商户分组 -> 轮询组 -> 支付通道”
ext_json使用分区结构保存轻量运行上下文；_protocol_version这类强语义字段可放顶层，商户透传放merchant，支付载体放payment，收银台承接放presentation- 通知、回调、重试、原始报文进入
ma_pay_callback_log、ma_notify_task、ma_channel_notify_log，不要塞进订单扩展槽 ma_pay_order不再保留request_method这类 HTTP 快照字段
建议写法
以后每个表说明都按下面的结构写：
- 表用途
- 主键与索引
- 核心字段
- 状态值含义
- 与哪些业务链路相关