# school_member_account_log 表文档

## 表概述
**表名**: school_member_account_log  
**功能**: 会员账户日志表，负责记录会员账户的所有变动操作，包括积分、余额等账户数据的增减记录和审计追踪

## 字段说明

```
Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int unsigned	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	
member_id	int	NULL	NO		0		select,insert,update,references	用户id
account_type	varchar(255)	utf8mb4_general_ci	NO		point		select,insert,update,references	账户类型
account_data	decimal(10,2)	NULL	NO		0.00		select,insert,update,references	账户数据
account_sum	decimal(10,2)	NULL	NO		0.00		select,insert,update,references	变动后的账户余额
from_type	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	来源类型
related_id	varchar(50)	utf8mb4_general_ci	NO				select,insert,update,references	关联Id
create_time	int	NULL	NO		0		select,insert,update,references	创建时间
memo	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	备注信息
```

## 功能用途

### 主要功能
1. **账户变动记录**: 记录会员账户的所有变动操作
2. **账户类型管理**: 支持多种账户类型（积分、余额等）
3. **变动金额跟踪**: 记录每次变动的具体金额
4. **余额计算**: 记录变动后的账户余额
5. **来源追踪**: 记录账户变动的来源类型
6. **关联业务**: 通过关联ID关联具体的业务操作
7. **操作备注**: 记录详细的操作说明和备注信息
8. **时间记录**: 记录操作的准确时间
9. **审计支持**: 提供完整的账户操作审计轨迹

### 业务场景
- 会员充值时增加账户余额
- 会员消费时扣减账户余额
- 积分获得和消费记录
- 会员退款时账户余额变动
- 系统调账和账户纠错
- 促销活动赠送积分或余额
- 会员等级升级奖励
- 推荐奖励和返利记录
- 账户冻结和解冻操作
- 财务对账和审计检查

## 关联关系

### 主要关联表
1. **school_member**: 通过member_id关联会员信息
2. **school_pay**: 通过related_id关联支付记录
3. **school_order_table**: 通过related_id关联订单信息
4. **school_contract**: 通过related_id关联合同记录
5. **school_member_level**: 会员等级变动关联
6. **school_member_sign**: 签到奖励关联
7. **school_sys_user**: 操作人员关联
8. **school_campus**: 校区操作关联

### 关联说明
- **会员关联**: member_id关联会员基本信息和账户状态
- **支付关联**: 充值、退款等操作关联支付记录
- **订单关联**: 消费扣款关联具体订单
- **合同关联**: 合同相关的账户操作
- **等级关联**: 会员等级变动产生的奖励记录
- **签到关联**: 签到获得的积分奖励
- **操作关联**: 记录具体的操作人员
- **校区关联**: 区分不同校区的账户操作

## 索引建议
- **主键索引**: id（已存在）
- **外键索引**: member_id（会员账户查询）
- **业务索引**: 
  - account_type（账户类型查询）
  - from_type（来源类型查询）
  - related_id（关联业务查询）
- **复合索引**: 
  - (member_id, account_type)（会员特定账户查询）
  - (member_id, create_time)（会员时间序列查询）
  - (from_type, related_id)（来源业务查询）
  - (account_type, create_time)（类型时间查询）
- **时间索引**: 
  - create_time（时间范围查询）
- **金额索引**: 
  - account_data（金额范围查询）

## 注意事项
1. **数据完整性**: 所有字段都不能为空，确保日志完整性
2. **余额一致性**: account_sum必须与实际账户余额保持一致
3. **账户类型**: account_type需要严格控制枚举值
4. **金额精度**: 使用decimal(10,2)确保金额计算精度
5. **时间戳**: create_time使用时间戳格式记录
6. **只增不改**: 日志记录原则上只能新增，不能修改删除
7. **关联有效性**: related_id必须关联有效的业务记录
8. **来源追踪**: from_type必须明确标识变动来源
9. **并发控制**: 账户操作需要防止并发冲突
10. **备注规范**: memo字段应记录详细的操作说明
11. **审计要求**: 满足财务审计的相关要求
12. **数据备份**: 账户日志需要定期备份
13. **性能优化**: 大量日志数据需要考虑查询性能
14. **数据归档**: 历史日志数据需要定期归档
15. **监控告警**: 异常账户变动需要及时告警