feat: 实现单价分离、班级转课、消课筛选和手动录入功能

Coze-Commit-Type: user
Coze-User-ID: 3722323274763196
Coze-Conversation-ID: 5260473

xuexiao/AGENTS.md

@@ -64,7 +64,38 @@
     └── log_list.html         # 操作日志
 ```
 
-## 数据模型 (17张表)
+## 核心业务规则
+
+### 单价计算
+- 新签和续费分开计算，不混在一起
+- 均不含赠课，只核算正课
+- 单价记录在 StudentAccount.unit_price 和 original_price_per_lesson 字段
+
+### 学员归属
+- 学员按班级分配，关联授课老师
+- 班级—学员—老师一一对应关系
+- 通过 ClassStudent 表维护班级与学员关系
+- StudentAccount 记录学员所属班级(from_class_id)和授课老师(from_teacher_id)
+
+### 消课记录表
+- 表格格式展示消课记录
+- 支持按日期、班级、老师、学员姓名筛选
+- 课时汇总数量手动录入
+- API: /api/class_students/<class_id> 获取班级学员列表
+
+### 转课管理
+支持两种转课类型：
+
+**1. 班级转课**
+- 无单价变更转课：仅调整学员所属班级与授课老师，原缴费单价、剩余课时保持不变
+- 有单价变更转课：调整班级与老师的同时，同步更新对应计费单价，需备注变更原因及生效时间
+
+**2. 课程转课**
+- 转赠：学员之间课时转移（仅正课）
+- 升阶：课程升级，100%正课全额结转
+- 换课：不同课程间的课时转换
+
+## 数据模型 (17+张表)
 
 | 表名 | 说明 |
 |------|------|
@@ -75,12 +106,12 @@
 | courses | 课程表(含total_hours/material_fee/type/remark) |
 | classes | 班级表 |
 | class_students | 班级学员关联表 |
-| student_accounts | 学员课时账户表(正课/赠课/消耗/累计) |
+| student_accounts | 学员课时账户表(含from_class_id/from_teacher_id关联) |
 | recharge_activities | 充值优惠活动表(累计/期限/团报/老带新) |
 | recharge_records | 充值记录表 |
 | consumption_records | 消课记录表(普通/混合/试听) |
 | refund_records | 退费记录表(材料费/已消核算) |
-| transfer_records | 转课/转赠记录表 |
+| transfer_records | 转课/转赠记录表(含班级转课/单价变更字段) |
 | stop_records | 停课保号记录表 |
 | attendance_records | 考勤记录表 |
 | operation_logs | 操作日志表 |