# school_order_table 表文档

## 表概述
**表名**: school_order_table  
**功能**: 订单信息管理表，负责管理教务系统中的所有订单信息，包括新订单、续费订单、转校订单等各种类型的订单处理

## 字段说明

```
Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	订单编号
payment_id	varchar(255)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	支付编号
order_type	varchar(255)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	订单类型1新订单2续费订单3内部员工订单4 转校 5 客户内转课订单
order_status	enum('pending','paid','signed','completed','transfer')	utf8mb4_general_ci	YES		pending		select,insert,update,references	订单状态: pending-待支付, paid-已支付,signed待签约，completed已完成，transfer转学
payment_type	enum('cash','scan_code','subscription','wxpay_online')	utf8mb4_general_ci	NO		NULL		select,insert,update,references	付款类型: cash-现金支付, scan_code-扫码支付, subscription-订阅支付, wxpay_online-微信在线代付
order_amount	decimal(10,2)	NULL	NO		NULL		select,insert,update,references	订单金额
course_id	int	NULL	NO		NULL		select,insert,update,references	课程ID
class_id	int	NULL	YES		NULL		select,insert,update,references	班级ID
staff_id	int	NULL	NO		NULL		select,insert,update,references	人员ID|员工表school_personnel.id
resource_id	int	NULL	NO		NULL		select,insert,update,references	资源ID|客户资源表school_customer_resources.id
after_sales_status	varchar(50)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	售后状态
after_sales_reason	text	utf8mb4_general_ci	YES		NULL		select,insert,update,references	售后原因
after_sales_time	timestamp	NULL	YES		NULL		select,insert,update,references	售后时间
created_at	timestamp	NULL	YES		CURRENT_TIMESTAMP	DEFAULT_GENERATED	select,insert,update,references	创建时间
updated_at	timestamp	NULL	YES		CURRENT_TIMESTAMP	DEFAULT_GENERATED on update CURRENT_TIMESTAMP	select,insert,update,references	修改时间
payment_time	timestamp	NULL	YES		NULL		select,insert,update,references	支付时间
subscription_payment_time	timestamp	NULL	YES		NULL		select,insert,update,references	订阅支付生成时间
ipv3	varchar(255)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	
accounting_time	timestamp	NULL	YES		NULL		select,insert,update,references	核算时间
campus_id	int	NULL	NO		NULL		select,insert,update,references	校区ID
gift_id	int	NULL	YES		NULL		select,insert,update,references	赠品 id
discount_amount	decimal(10,2)	NULL	YES		NULL		select,insert,update,references	优惠金额
course_plan_id	int	NULL	YES		NULL		select,insert,update,references	课程计划 id
student_id	int	NULL	NO		NULL		select,insert,update,references	学员 id
remark	varchar(512)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	订单备注
contract_id	int	NULL	YES		NULL		select,insert,update,references	合同 id
gift_type	tinyint	NULL	YES		NULL		select,insert,update,references	赠品使用类型 1 减现2 赠课
```

## 功能用途

### 主要功能
- **订单生命周期管理**: 管理从订单创建到完成的全流程状态跟踪
- **多类型订单支持**: 支持新订单、续费订单、内部员工订单、转校订单、客户内转课订单
- **支付管理**: 关联支付信息，支持多种支付方式（现金、扫码、订阅、微信在线代付）
- **课程订单关联**: 建立订单与课程、班级的关联关系
- **售后服务管理**: 处理订单售后状态、原因和时间记录
- **财务核算**: 订单金额、优惠金额、核算时间等财务相关信息管理
- **赠品管理**: 支持赠品关联和赠品类型管理（减现、赠课）
- **合同关联**: 订单与合同的关联管理

### 业务场景
- **订单创建**: 学员报名时创建新订单，记录课程、金额、支付方式等信息
- **续费管理**: 处理学员续费订单，延续学习服务
- **转校业务**: 处理学员转校相关的订单和费用结算
- **内部订单**: 处理员工内部订单，可能享受特殊优惠政策
- **支付处理**: 跟踪订单支付状态，从待支付到已支付的状态流转
- **售后服务**: 处理退费、换课等售后需求
- **财务结算**: 进行订单核算，生成财务报表
- **营销活动**: 通过赠品和优惠金额支持各种营销活动

## 关联关系

### 主要关联表
- `school_course`: 课程信息表 (course_id)
- `school_class`: 班级信息表 (class_id)
- `school_personnel`: 人员信息表 (staff_id)
- `school_customer_resources`: 客户资源表 (resource_id)
- `school_campus`: 校区信息表 (campus_id)
- `school_member`: 学员信息表 (student_id)
- `school_contract`: 合同信息表 (contract_id)
- `school_pay`: 支付信息表 (payment_id)
- `school_course_plan`: 课程计划表 (course_plan_id)
- `school_gift`: 赠品信息表 (gift_id)

### 关联说明
- **课程关联**: 通过course_id关联具体课程，class_id关联具体班级
- **人员关联**: staff_id关联处理订单的员工，student_id关联购买的学员
- **支付关联**: payment_id关联支付记录，跟踪支付状态和支付方式
- **合同关联**: contract_id关联生成的合同，建立订单与合同的对应关系
- **校区关联**: campus_id确定订单所属校区，用于区域化管理
- **资源关联**: resource_id关联客户资源，跟踪订单来源
- **赠品关联**: gift_id关联赠品信息，支持营销活动

## 索引建议
- **主键索引**: id (已存在)
- **外键索引**: 
  - course_id (课程查询)
  - class_id (班级查询)
  - staff_id (员工订单查询)
  - student_id (学员订单查询)
  - campus_id (校区订单查询)
  - contract_id (合同关联查询)
- **状态索引**: order_status (订单状态查询)
- **时间索引**: 
  - created_at (创建时间查询)
  - payment_time (支付时间查询)
  - accounting_time (核算时间查询)
- **复合索引**: 
  - (student_id, order_status) (学员订单状态查询)
  - (campus_id, created_at) (校区订单时间查询)
  - (order_type, order_status) (订单类型状态查询)
  - (payment_type, order_status) (支付方式状态查询)

## 注意事项
- **金额精度**: order_amount和discount_amount使用decimal(10,2)，确保财务计算精度
- **状态流转**: 订单状态有严格的流转规则，不能随意跳跃状态
- **支付关联**: payment_id可能为空，表示未关联支付记录的订单
- **订单类型**: order_type决定了订单的处理流程和业务逻辑
- **售后处理**: 售后状态、原因、时间需要同步更新，保持数据一致性
- **时间逻辑**: 支付时间不能早于创建时间，核算时间不能早于支付时间
- **校区归属**: 订单必须归属于特定校区，不能为空
- **学员关联**: student_id不能为空，每个订单必须有明确的学员
- **合同生成**: 订单状态为signed时，应该有对应的contract_id
- **赠品逻辑**: gift_type和gift_id需要配套使用，确保赠品逻辑正确
- **优惠计算**: 实际支付金额 = order_amount - discount_amount
- **数据完整性**: 删除订单时需要考虑关联数据的处理
- **权限控制**: 不同角色对订单的操作权限需要严格控制