| Method | Path | Request / notes | Status |
|---|
| GET | /v3/teacher/schools | tư cách thành viên và vai trò của người dùng hiện tại | existing |
| GET | /v3/teacher/viewer/rollup-teachers | KPI giáo viên dùng cho cột bên của hồ sơ | existing |
| GET | /v3/school/staff | q, branch_id, job_title_id, employment_type, status, unlinked=true, page, limit | new |
| POST | /v3/school/staff | {full_name, code?, job_title_id, employment_type, branch_ids, start_date, phone, email?, ..., account?: {role_id, branch_ids, is_teacher}} | new |
| GET / PATCH | /v3/school/staff/{id} | chi tiết bao gồm hợp đồng, cách tính lương hiện tại, trạng thái tài khoản | new |
| POST | /v3/school/staff/{id}/account | {role_id, branch_ids, is_teacher} tạo lời mời người dùng + tư cách thành viên + TeacherProfile | new |
| POST | /v3/school/staff/{id}/link | {user_id | teacher_profile_id | sale_profile_id} | new |
| POST | /v3/school/staff/{id}/terminate | {end_date, reason} | new |
| GET / POST | /v3/school/staff/{id}/contracts | {type, start_date, end_date?, pay_rule_id, document_file_id?} | new |
| PATCH | /v3/school/staff/contracts/{id} | | new |
| GET / POST / PATCH | /v3/school/pay-rules[/{id}] | kèm overrides[] | new |
| POST | /v3/school/timesheets/generate | {year, month, branch_id?, staff_ids?} idempotent: chỉ tạo lại các bản nháp | new |
| GET | /v3/school/timesheets | year, month, branch_id, status, staff_id | new |
| GET | /v3/school/timesheets/{id} | các dòng, điều chỉnh, cờ | new |
| POST | /v3/school/timesheets/{id}/submit | confirm | approve | recalculate | chuyển trạng thái; trả 409 khi chuyển trạng thái không hợp lệ | new |
| POST | /v3/school/timesheets/{id}/lines/{line_id}/flag | {comment}; xử lý qua PATCH flag_status | new |
| POST | /v3/school/timesheets/{id}/adjustments | {amount, reason} | new |
| GET | /v3/school/timesheets/export | year, month, branch_id, format=xlsx | new |
| GET / POST | /v3/school/evaluation-templates | | new |
| GET / POST | /v3/school/staff/{id}/evaluations | {template_id, period_start, period_end, scores, comment, share} | new |
| GET / POST / DELETE | /v3/school/staff/{id}/documents | {type, file_id, expires_on} | new |
