| Method | Path | Mục đích | Trạng thái |
|---|
| GET | /v3/crm/dashboard/manager-summary | period → conversions, revenue_signed (trung tâm, chi nhánh) | existing |
| GET | /v3/crm/dashboard/top-sales | period → conversions, revenue_signed theo tư vấn viên | existing |
| GET | /v3/crm/dashboard/funnel | period → leads_new; thêm school_id, assignee_id | extend |
| GET | /v3/crm/dashboard/won-lost-trend · /sale-summary | đường tốc độ theo tuần; thẻ hiện có cạnh ô Chỉ tiêu của tôi | existing |
| GET | /v3/teacher/school-finance/tuitions/stats | revenue_collected; thêm overdue_collected_amount, tham số from, to, school_id | extend |
| GET | /v3/crm/sale-profiles/lightweight · /v3/crm/me/accessible-schools | danh sách cá nhân và chi nhánh khi phân bổ | existing |
| GET · POST | /v3/crm/targets | GET period_type, period_key, status → Target[]; POST {period_type, period_key, working_days?, grace_days?, lines: [{metric_key, goal}]} → Target (draft); 409 PERIOD_EXISTS | new |
| GET | /v3/crm/targets/{id} | → Target kèm cây dòng và ảnh chụp gần nhất; as_of để xem tại một ngày | new |
| PATCH | /v3/crm/targets/{id} | {working_days?, grace_days?, ranking_visibility?, version}; 409 STALE_VERSION | new |
| PUT | /v3/crm/targets/{id}/lines | {lines: [{id?, metric_key, scope, school_id?, owner_type?, owner_id?, goal, parent_line_id?}], override?: {reason}, reason?} → dòng đã lưu; 422 SUM_MISMATCH kèm chênh lệch theo dòng cha; reason bắt buộc sau xuất bản | new |
| POST | /v3/crm/targets/{id}/allocate | {line_id, method: even | last_period_share, children: [{school_id | owner_id}]} → đề xuất phân bổ, không lưu | new |
| POST | /v3/crm/targets/{id}/publish · /close · /reopen | reopen cần {reason}; publish trả 422 SUM_MISMATCH khi còn chênh lệch chưa ghi đè | new |
| GET · POST | /v3/crm/targets/{id}/snapshots · /revisions · /snapshot | → TargetSnapshot[] (line_id, from, to); TargetRevision[]; POST /snapshot chạy ảnh chụp tay, 429 khi vượt 6 lần một giờ | new |
| GET | /v3/crm/targets/board | period_type, period_key, scope, school_id?, metric_key? → dòng kèm ảnh chụp gần nhất, lọc theo quyền; format=xlsx | new |
| GET | /v3/crm/targets/ranking | period_type, period_key, metric_key, school_id? → [{rank, rank_delta, owner, school, goal, actual, pct, pace}] | new |
| GET | /v3/crm/targets/me | → dòng cá nhân của người dùng hiện tại kèm thứ hạng | new |
| GET/POST/PATCH | /v3/crm/targets/bonus-rules · /{id} | {name, role, metric_key, bonus_type, tiers, effective_from, active}; 422 TIER_OVERLAP; GET /targets/{id}/bonus-estimates → BonusEstimate[] sau chốt kỳ, PRD 06 đọc | new |
| GET/PUT | /v3/school/digest-settings | thêm khối targets: {enabled, metrics[]} cho bản tổng hợp hằng tuần (PRD 09) | extend |
