| Method | Path | Request / response | Status |
|---|
| GET | /v3/crm/me/today-plan | → bổ sung mảng tasks (quá hạn, hôm nay, chờ xác nhận) bên cạnh cuộc gọi và cuộc hẹn hiện có | existing |
| GET · POST | /v3/crm/me/notifications · /unread-count · /{id}/read · /read-all · /{id}/archive | không đổi hợp đồng; thêm tham số lọc type? | existing |
| POST | /v3/teacher/class-schedules/{id}/remind · /preview-remind-time | nhắc lịch cho phụ huynh, thuộc PRD 07; chỉ tham chiếu | existing |
| GET | /v3/crm/customers/{id}/interactions | trả thêm công việc gắn khách hàng dưới dạng mục timeline kind = task (chỉ đọc); tạo công việc dùng /v3/crm/tasks | extend |
| GET / POST | /v3/crm/tasks | view=my|team, school_id, assignee_id, status[], priority[], source, linked_type, linked_id, overdue, due_from, due_to, q; POST {title, description?, assignees: [{staff_id} | {role_code, school_id}], due_at?, priority?, require_review?, require_all?, linked?: {type, id}, checklist?, reminders?, attachments?} | new |
| GET / PATCH | /v3/crm/tasks/{id} | chi tiết gồm checklist, attachments, reminders, comments, history; PATCH kèm version, 409 STALE_VERSION | new |
| POST | /v3/crm/tasks/{id}/transition · /reassign · /v3/crm/tasks/bulk | {to, reason?} kiểm tra theo mục 5; {assignees[], note?}; bulk {ids[], action: reassign|reschedule|cancel, payload} | new |
| PUT · GET/POST · POST/DELETE | /v3/crm/tasks/{id}/checklist · /comments · /reminders | checklist thay toàn bộ; comment {body, mentions?} thông báo người được nhắc tên; reminder {kind, offset_minutes | fire_at} | new |
| GET / POST / PATCH / DELETE | /v3/crm/task-routines · /{id} | các trường ở mục 6; PATCH {is_paused}; POST /{id}/run-now sinh ngay một kỳ | new |
| GET / PUT | /v3/crm/me/notification-preferences | [{type, push, email}] | new |
| GET / POST | /v3/crm/leave-requests | view=mine|to_approve|all, school_id, staff_id, status[], from, to; POST {type, date_from, date_to, part_of_day, session_id?, swap_with_staff_id?, reason, attachment_file_id?} → kèm affected_sessions[]; POST /preview-impact trả affected_sessions[] trước khi gửi | new |
| POST | /v3/crm/leave-requests/{id}/decide · /cancel · /revoke | decide {decision: approved|rejected, note?} (note bắt buộc khi rejected) gắn cờ buổi học và sinh công việc dạy thay; cancel bởi người gửi khi pending; revoke bởi người duyệt trước ngày bắt đầu {reason} | new |
| GET / POST | /v3/crm/incidents | school_id, status[], severity[], type[], from, to; POST {type, severity, title, description, room_id?, session_id?, class_id?, attachments[], client_created_at?} idempotent theo (reported_by, client_created_at) | new |
| GET / PATCH | /v3/crm/incidents/{id} | chi tiết kèm task; PATCH {status, severity?, note?}; POST /{id}/confirm-resolved bởi người báo cáo | new |
| GET / PUT | /v3/teacher/school-config | thêm khối task_policy | extend |
| GET | /v3/crm/tasks/report | school_id, from, to, group_by=assignee|source|trigger → số tạo, hoàn thành, đúng hạn, thời gian hoàn thành trung vị; dùng cho PRD 09 | new |
