# school_pay 表文档

## 表概述
**表名**: school_pay  
**功能**: 支付信息管理表，负责管理教务系统中的所有支付记录，包括支付流水、支付状态、支付方式等核心支付信息

## 字段说明

```
Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int unsigned	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	主键
main_id	int	NULL	NO		0		select,insert,update,references	支付会员id
from_main_id	int	NULL	NO		0		select,insert,update,references	发起支付会员id
out_trade_no	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	支付流水号
trade_type	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	业务类型
trade_id	int	NULL	NO		0		select,insert,update,references	业务id
trade_no	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	交易单号
body	varchar(1000)	utf8mb4_general_ci	NO				select,insert,update,references	支付主体
money	decimal(10,2)	NULL	NO		NULL		select,insert,update,references	支付金额
voucher	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	支付票据
status	int	NULL	NO		0		select,insert,update,references	支付状态（0.待支付 1. 支付中 2. 已支付 -1已取消）
json	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	支付扩展用支付信息
create_time	int	NULL	NO		0		select,insert,update,references	创建时间
pay_time	int	NULL	NO		0		select,insert,update,references	支付时间
cancel_time	int	NULL	NO		0		select,insert,update,references	关闭时间
type	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	支付方式
mch_id	varchar(50)	utf8mb4_general_ci	NO				select,insert,update,references	商户收款账号
main_type	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	
channel	varchar(50)	utf8mb4_general_ci	NO				select,insert,update,references	支付渠道
fail_reason	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	失败原因
```

## 功能用途

### 主要功能
- **支付流水管理**: 生成和管理唯一的支付流水号，确保支付记录可追溯
- **多业务类型支持**: 支持不同业务类型的支付处理（订单支付、充值等）
- **支付状态跟踪**: 实时跟踪支付状态（待支付、支付中、已支付、已取消）
- **多支付方式**: 支持多种支付渠道和支付方式
- **代付功能**: 支持发起支付会员和实际支付会员的分离管理
- **支付票据管理**: 管理支付凭证和票据信息
- **商户账号管理**: 管理不同的商户收款账号
- **支付时间记录**: 记录支付创建、完成、取消等关键时间节点
- **失败原因追踪**: 记录支付失败的具体原因，便于问题排查

### 业务场景
- **订单支付**: 学员购买课程时的支付处理
- **充值支付**: 学员账户余额充值
- **代付服务**: 家长为孩子支付学费等代付场景
- **退款处理**: 处理退费相关的支付记录
- **支付对账**: 与第三方支付平台进行对账
- **财务结算**: 生成财务报表和收入统计
- **支付监控**: 监控支付成功率和失败原因
- **风控管理**: 识别异常支付行为

## 关联关系

### 主要关联表
- `school_member`: 会员信息表 (main_id, from_main_id)
- `school_order_table`: 订单信息表 (通过trade_id关联)
- `school_contract`: 合同信息表 (通过trade_id关联)
- `school_refund`: 退款信息表 (通过trade_id关联)
- `school_recharge`: 充值记录表 (通过trade_id关联)
- `sys_pay_config`: 支付配置表 (通过type关联)

### 关联说明
- **会员关联**: main_id关联实际支付的会员，from_main_id关联发起支付的会员
- **业务关联**: 通过trade_type和trade_id关联具体的业务记录（订单、合同、充值等）
- **支付配置**: 通过type字段关联支付方式配置
- **商户关联**: mch_id关联具体的商户收款账号
- **渠道关联**: channel字段标识支付渠道来源

## 索引建议
- **主键索引**: id (已存在)
- **唯一索引**: out_trade_no (支付流水号唯一性)
- **外键索引**: 
  - main_id (支付会员查询)
  - from_main_id (发起支付会员查询)
- **业务索引**: 
  - trade_type (业务类型查询)
  - trade_id (业务ID查询)
  - trade_no (交易单号查询)
- **状态索引**: status (支付状态查询)
- **时间索引**: 
  - create_time (创建时间查询)
  - pay_time (支付时间查询)
- **复合索引**: 
  - (main_id, status) (会员支付状态查询)
  - (trade_type, trade_id) (业务关联查询)
  - (type, status) (支付方式状态查询)
  - (create_time, status) (时间状态查询)
  - (mch_id, status) (商户支付状态查询)

## 注意事项
- **流水号唯一性**: out_trade_no必须全局唯一，避免重复支付
- **金额精度**: money字段使用decimal(10,2)，确保财务计算精度
- **状态流转**: 支付状态有严格的流转规则（0→1→2或0→-1）
- **时间逻辑**: pay_time不能早于create_time，cancel_time只在取消时设置
- **代付逻辑**: from_main_id和main_id可以不同，支持代付场景
- **业务关联**: trade_type和trade_id必须配套使用，确保业务关联正确
- **支付方式**: type字段决定了支付的具体处理逻辑
- **商户配置**: mch_id必须与系统配置的商户账号匹配
- **支付渠道**: channel字段用于区分不同的支付来源
- **失败处理**: 支付失败时必须记录fail_reason，便于问题排查
- **数据安全**: 支付相关敏感信息需要加密存储
- **幂等性**: 同一笔支付请求多次提交应该返回相同结果
- **对账机制**: 定期与第三方支付平台进行对账，确保数据一致性
- **监控告警**: 支付失败率过高时需要及时告警