# school_member_cash_out 表文档

## 表概述
**表名**: school_member_cash_out  
**功能**: 会员提现管理表，用于管理会员的资金提现申请和处理流程，包括提现申请、审核、转账、状态跟踪等完整的提现业务流程，支持多种提现方式和账户类型，为会员资金管理和财务结算提供完整的提现服务

## 字段说明

```
Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	
cash_out_no	varchar(50)	utf8mb4_general_ci	NO				select,insert,update,references	提现交易号
member_id	int	NULL	NO		0		select,insert,update,references	会员id
account_type	varchar(255)	utf8mb4_general_ci	NO		money		select,insert,update,references	提现账户类型
transfer_type	varchar(20)	utf8mb4_general_ci	NO		0		select,insert,update,references	转账提现类型
transfer_realname	varchar(50)	utf8mb4_general_ci	NO				select,insert,update,references	联系人名称
transfer_mobile	varchar(11)	utf8mb4_general_ci	NO				select,insert,update,references	手机号
transfer_bank	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	银行名称
transfer_account	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	收款账号
transfer_payee	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	转账收款方(json),主要用于对接在线的打款方式
transfer_payment_code	varchar(500)	utf8mb4_general_ci	NO				select,insert,update,references	收款码图片
transfer_fail_reason	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	失败原因
transfer_status	varchar(20)	utf8mb4_general_ci	NO				select,insert,update,references	转账状态
transfer_time	int	NULL	NO		0		select,insert,update,references	转账时间
apply_money	decimal(10,2)	NULL	NO		0.00		select,insert,update,references	提现申请金额
rate	decimal(10,2)	NULL	NO		0.00		select,insert,update,references	提现手续费比率
service_money	decimal(10,2)	NULL	NO		0.00		select,insert,update,references	提现手续费
money	decimal(10,2)	NULL	NO		0.00		select,insert,update,references	提现到账金额
audit_time	int	NULL	NO		0		select,insert,update,references	审核时间
status	int	NULL	NO		0		select,insert,update,references	状态1待审核2.待转账3已转账 -1拒绝 -2 已取消
remark	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	备注
create_time	int	NULL	NO		0		select,insert,update,references	申请时间
refuse_reason	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	拒绝理由
update_time	int	NULL	NO		0		select,insert,update,references	
transfer_no	varchar(50)	utf8mb4_general_ci	NO				select,insert,update,references	转账单号
cancel_time	int	NULL	NO		0		select,insert,update,references	取消时间
final_transfer_type	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	转账方式
```

## 功能用途

### 主要功能
- **会员提现申请管理**: 处理会员的提现申请，包括申请金额、手续费计算等
- **提现账户信息管理**: 管理提现的收款账户信息（银行卡、支付宝、微信等）
- **提现流程控制**: 管理提现的完整流程（申请→审核→转账→完成）
- **提现状态跟踪**: 实时跟踪提现状态变化和处理进度
- **手续费计算**: 根据提现金额和费率计算手续费，确定实际到账金额
- **转账记录管理**: 记录转账操作的详细信息和结果
- **审核机制**: 支持人工审核，防范风险和异常提现
- **失败处理**: 记录提现失败原因，支持重新处理
- **取消机制**: 支持用户主动取消提现申请

### 业务场景
- **会员余额提现**: 会员将账户余额提现到银行卡或第三方支付账户
- **佣金提现**: 推广员或代理商提现佣金收入
- **退费提现**: 课程退费后的资金提现
- **批量提现处理**: 财务人员批量处理提现申请
- **提现审核**: 风控人员审核大额或异常提现申请
- **自动转账**: 系统自动处理符合条件的提现申请
- **提现对账**: 与银行或第三方支付平台进行提现对账
- **提现统计**: 生成提现相关的财务报表和统计数据

## 关联关系

### 主要关联表
- `school_member`: 会员信息表 (member_id)
- `school_member_cash_out_account`: 提现账户表 (通过member_id和账户信息关联)
- `school_member_account`: 会员账户表 (member_id)
- `school_pay`: 支付记录表 (通过业务关联)
- `school_sys_user`: 系统用户表 (审核人员信息)
- `school_member_account_log`: 账户流水表 (资金变动记录)

### 关联说明
- **会员关联**: member_id关联会员基本信息，确定提现申请人
- **账户关联**: 与会员账户表关联，验证可提现余额
- **收款账户**: 通过账户类型和账户信息关联具体的收款方式
- **资金流水**: 提现成功后在账户流水表中记录资金变动
- **审核关联**: 审核操作可能关联系统用户信息
- **支付关联**: 提现可能涉及原始支付记录的关联

## 索引建议
- **主键索引**: id (已存在)
- **唯一索引**: cash_out_no (提现交易号唯一性)
- **外键索引**: member_id (会员查询)
- **状态索引**: status (状态查询)
- **时间索引**: 
  - create_time (申请时间查询)
  - audit_time (审核时间查询)
  - transfer_time (转账时间查询)
- **复合索引**: 
  - (member_id, status) (会员提现状态查询)
  - (status, create_time) (状态时间查询)
  - (transfer_status, transfer_time) (转账状态时间查询)
  - (account_type, status) (账户类型状态查询)

## 注意事项
- **金额精度**: 所有金额字段使用decimal(10,2)，确保财务计算精度
- **状态流转**: 提现状态有严格的流转规则，不能随意跳跃
- **余额验证**: 提现前必须验证会员账户余额是否充足
- **手续费计算**: 手续费计算必须准确，避免财务差错
- **账户安全**: 收款账户信息需要验证真实性和有效性
- **审核机制**: 大额提现或异常提现必须人工审核
- **时间逻辑**: 各个时间字段的逻辑关系必须正确
- **失败处理**: 提现失败时必须记录详细原因，便于问题排查
- **取消限制**: 已审核或已转账的提现不能取消
- **重复申请**: 防止同一笔资金重复申请提现
- **数据一致性**: 提现成功后必须同步更新会员账户余额
- **日志记录**: 所有提现操作都应该有详细的日志记录
- **风控规则**: 建立完善的风控规则，防范异常提现
- **对账机制**: 定期与银行或第三方支付平台进行对账