| Method | Path | Request / response | Status |
|---|
| GET/POST/PUT/DELETE | /v3/teacher/school-finance/course/courses[/{id}] | như hiện tại + các trường mở rộng | extend |
| GET | /v3/teacher/classes | như hiện tại; response bổ sung tổng hợp profile | extend |
| POST | /v3/school/classes | {school_id, course_id, name, code?, level_code, main_staff_id?, assistant_staff_id?, room_id, capacity, trial_seats, start_date, end_by: {sessions: n} | {date}, pattern[], holidays[], program?: CreateClassScheduleRequest fields} → {class, sessions[], conflicts[]}; dry_run=true chỉ trả về bản xem trước | new (tạo Class + ClassSchedule ở nội bộ) |
| GET/PATCH | /v3/school/classes/{id} | chi tiết kèm profile, số lượng trong danh sách lớp, buổi học kế tiếp | new |
| POST | /v3/school/classes/{id}/regenerate | {pattern, holidays, from_date} chỉ áp dụng cho các buổi học ở trạng thái planned | new |
| POST | /v3/school/classes/{id}/close | /cancel | {reason} | new |
| GET | /v3/school/sessions | school_id, from, to, class_id, room_id, staff_id, status → Session[] with class, room, teacher, counts | new |
| POST | /v3/school/classes/{id}/sessions | {date, start, end, room_id, staff_id, is_makeup} phát sinh riêng lẻ | new |
| PATCH | /v3/school/sessions/{id} | {date?, start?, end?, room_id?, main_staff_id?, substitute_staff_id?, note?, apply_to_following?: bool, override_conflict?: bool} → 409 CONFLICT {conflicts[]} | new |
| POST | /v3/school/sessions/{id}/cancel | {reason, add_makeup: bool, notify: bool} | new |
| GET/POST | /v3/school/classes/{id}/enrollments | {student_id, start_date, fee_plan_id?} → 409 CLASS_FULL (đề xuất đưa vào danh sách chờ) | new |
| PATCH | /v3/school/enrollments/{id} | {end_date, end_reason} hoặc {transfer_to_class_id, effective_date} | new |
| GET | /v3/school/sessions/{id}/roster | học viên đã ghi danh + học thử + học bù kèm cờ đánh dấu và số dư | new |
| POST | /v3/school/makeups | {student_id, source_session_id, target_session_id | new_session: {...}, consumes_package} | new |
| GET/POST/PATCH | /v3/school/rooms | | new |
| GET/POST/DELETE | /v3/school/holidays | | new |
| GET/POST/PATCH | /v3/school/levels | danh mục trình độ kèm khoảng điểm | new |
| GET | /v3/school/timetable | school_id, week, view=room|teacher|class → các buổi học được nhóm lại | new |
| GET | /v3/school/staff/{id}/timetable.ics | đường liên kết có chữ ký | new |
| POST/GET/PUT | /v3/teacher/class-schedules[...] | Các bài học chương trình FLYER; không thay đổi | existing |
