diff --git a/docs/api-contract.md b/docs/api-contract.md index bd60d26..479b3d0 100644 --- a/docs/api-contract.md +++ b/docs/api-contract.md @@ -294,7 +294,7 @@ Tag = ป้ายทักษะ/เทคโนโลยีของประ ### 7.4 อาจารย์ | Method | Path | Role | คำอธิบาย | | :--- | :--- | :---: | :--- | -| GET | `/advisor/applications` | A | `?status=ADVISOR_PENDING` เฉพาะนักศึกษาในความดูแล + ธง `flagged_for_advisor`, `major_mismatch` | +| GET | `/advisor/applications` | A | `?status=ADVISOR_PENDING` เฉพาะนักศึกษาในความดูแล + ธง `flagged_for_advisor`, `major_mismatch` • มี `academic_result` (`ACADEMIC_PASS`/`ACADEMIC_FAIL`/`REPEAT_REQUIRED`) เมื่ออาจารย์บันทึกผลแล้ว ยังไม่บันทึก ⇒ ไม่มีฟิลด์ (เหมือน `GET /me/applications`; PM ตัดสิน 2026-11-22) — ใช้รูปเดียวกันใน response ของ action ฝั่งอาจารย์ (`AdvisorApplicationItem`) | | POST | `/advisor/applications/{id}/actions/approve` | A | `ADVISOR_PENDING`→`ADVISOR_APPROVED` | | POST | `/advisor/applications/{id}/actions/reject` | A | `{reason}` บังคับ | | GET | `/advisor/disputes` | A | คิว `FAIL_DISPUTED` | diff --git a/libs/contracts/src/dto/lifecycle-responses.ts b/libs/contracts/src/dto/lifecycle-responses.ts index 9a2543b..2586af7 100644 --- a/libs/contracts/src/dto/lifecycle-responses.ts +++ b/libs/contracts/src/dto/lifecycle-responses.ts @@ -123,11 +123,15 @@ export interface HrApplicationDetail extends HrApplicationItem { accept_blocked_reason?: string; } -/** รายการ GET /advisor/applications */ +/** + * รายการ GET /advisor/applications (และ response ของ action ฝั่งอาจารย์) + * `academic_result` = ผลวิชาที่อาจารย์บันทึกแล้ว (ไม่มีเมื่อยังไม่บันทึก) — หน้าบันทึกผลใช้แยกรายการที่บันทึกแล้ว (PM ตัดสิน 2026-11-22) + */ export interface AdvisorApplicationItem extends ApplicationBase { student_user_id: string; student_name: string; flagged_for_advisor: boolean; + academic_result?: AcademicResult; } /**