| Method | Path | Mục đích | Trạng thái |
|---|
| GET/POST · GET/PATCH/DELETE | /v3/crm/curricula · /v3/crm/curricula/{id} | danh sách lọc level_code, school_id, status; tạo kèm phiên bản 1 draft; chi tiết kèm phiên bản; DELETE = lưu trữ, chặn khi còn lớp hoạt động | new |
| POST | /v3/crm/curricula/{id}/versions | tạo draft mới sao chép từ phiên bản chỉ định; 409 nếu đã có draft | new |
| GET · POST · PUT | /v3/crm/curriculum-versions/{id}/tree · /publish · /import · /order | toàn bộ cây (lọc audience theo vai trò); draft → published; nhập xlsx theo wizard PRD 11; {units: [{id, lessons: [id]}]} sắp xếp lại cả cây | new |
| POST/PATCH/DELETE | /v3/crm/curriculum-units/{id} · /v3/crm/lessons/{id} | thêm, sửa, xoá đơn vị và bài học (chỉ trên draft); PATCH bài học nhận toàn bộ blocks theo thứ tự | new |
| GET | /v3/teacher/classes/{class_id}/assign-tests | nguồn chọn bài tập về nhà gợi ý và bài tập đã giao trong sổ đầu bài | existing |
| DELETE | /v3/teacher/class-schedules/{id}/lessons/{lesson_id} | gỡ bài học FLYER khỏi lịch lớp khi trung tâm chuyển sang giáo trình riêng; không thay đổi | existing |
| GET/PUT | /v3/crm/classes/{class_id}/syllabus | {curriculum_version_id, strategy: sequential | manual} → class_syllabus + session_lesson_map[]; dry_run=true trả xem trước và cảnh báo lệch số buổi | new |
| PATCH · POST | /v3/crm/classes/{class_id}/syllabus/map · /shift · /rebind | {changes: [{session_id, lesson_ids[]}], skips: [{lesson_id, reason}]}; {from_session_id} dồn bài; {curriculum_version_id} đổi phiên bản, đối chiếu theo lesson_code, trả bài không khớp | new |
| GET/PUT | /v3/crm/sessions/{id}/teaching-log | đọc và ghi sổ đầu bài; PUT idempotent theo version; 409 STALE_VERSION; reason bắt buộc sau cửa sổ sửa | new |
| GET | /v3/crm/teaching-logs?school_id&from&to&missing=true | buổi chưa ghi sổ theo giáo viên | new |
| GET | /v3/crm/curriculum/progress | school_id, curriculum_id, staff_id → tiến độ theo lớp; format=xlsx | new |
| GET/POST · DELETE | /v3/crm/customer-files · /v3/crm/customer-files/{id} | mẫu tải tệp hai bước (file_id từ dịch vụ tệp, rồi tạo bản ghi) được tái sử dụng cho resource-files; không thay đổi | existing |
| GET/POST/PATCH/DELETE | /v3/crm/resource-folders · /v3/crm/resource-folders/{id} | cây thư mục; quyền theo thư mục qua PATCH {permissions[]} | new |
| GET/POST · PATCH/DELETE | /v3/crm/resource-files · /v3/crm/resource-files/{id} | danh sách theo folder_id, tìm kiếm q; tạo {folder_id, flyer_file_id, file_name, mime_type, size_bytes, tags}, 413 STORAGE_QUOTA_EXCEEDED; đổi tên, di chuyển, xoá vào thùng rác, restore=true; GET .../download-url trả URL có chữ ký 15 phút | new |
| GET | /v3/crm/storage-usage | used_bytes, quota_bytes, phân bổ theo thư mục | new |
| GET | /v3/parent/learner/{id}/sessions/{session_id}/lesson | nội dung bài cho phụ huynh: chỉ khối audience all hoặc student, chỉ khi parent_visible và đã dạy | new |
| GET/PUT | /v3/teacher/school-config | thêm khối curriculum_policy | extend |
