From eeb843781178a255db32666d366f2f79f6ea10e6 Mon Sep 17 00:00:00 2001
From: KumPong
Date: Sun, 22 Nov 2026 00:53:12 +0700
Subject: [PATCH] web: advisor approval, evaluation and problem report pages
Co-Authored-By: Claude Opus 5.5
---
.../src/app/(site)/advisor/approvals/page.tsx | 15 ++
.../app/(site)/advisor/evaluations/page.tsx | 15 ++
.../(site)/advisor/problem-reports/page.tsx | 15 ++
.../components/advisor/advisor-approvals.tsx | 140 +++++++++++
.../advisor/advisor-evaluations.tsx | 223 ++++++++++++++++++
.../advisor/advisor-problem-reports.tsx | 161 +++++++++++++
.../web/src/components/advisor/advisor-ui.tsx | 84 +++++++
apps/web/src/components/layout/site-nav.ts | 7 +-
8 files changed, 659 insertions(+), 1 deletion(-)
create mode 100644 apps/web/src/app/(site)/advisor/approvals/page.tsx
create mode 100644 apps/web/src/app/(site)/advisor/evaluations/page.tsx
create mode 100644 apps/web/src/app/(site)/advisor/problem-reports/page.tsx
create mode 100644 apps/web/src/components/advisor/advisor-approvals.tsx
create mode 100644 apps/web/src/components/advisor/advisor-evaluations.tsx
create mode 100644 apps/web/src/components/advisor/advisor-problem-reports.tsx
create mode 100644 apps/web/src/components/advisor/advisor-ui.tsx
diff --git a/apps/web/src/app/(site)/advisor/approvals/page.tsx b/apps/web/src/app/(site)/advisor/approvals/page.tsx
new file mode 100644
index 0000000..9d380bc
--- /dev/null
+++ b/apps/web/src/app/(site)/advisor/approvals/page.tsx
@@ -0,0 +1,15 @@
+'use client';
+
+import { Suspense } from 'react';
+import { AdvisorApprovals } from '@/components/advisor/advisor-approvals';
+import { RequireAuth } from '@/components/layout/require-auth';
+
+export default function AdvisorApprovalsPage() {
+ return (
+
+ กำลังโหลด…
}>
+
+
+
+ );
+}
diff --git a/apps/web/src/app/(site)/advisor/evaluations/page.tsx b/apps/web/src/app/(site)/advisor/evaluations/page.tsx
new file mode 100644
index 0000000..97dceea
--- /dev/null
+++ b/apps/web/src/app/(site)/advisor/evaluations/page.tsx
@@ -0,0 +1,15 @@
+'use client';
+
+import { Suspense } from 'react';
+import { AdvisorEvaluations } from '@/components/advisor/advisor-evaluations';
+import { RequireAuth } from '@/components/layout/require-auth';
+
+export default function AdvisorEvaluationsPage() {
+ return (
+
+ กำลังโหลด…}>
+
+
+
+ );
+}
diff --git a/apps/web/src/app/(site)/advisor/problem-reports/page.tsx b/apps/web/src/app/(site)/advisor/problem-reports/page.tsx
new file mode 100644
index 0000000..c3feb40
--- /dev/null
+++ b/apps/web/src/app/(site)/advisor/problem-reports/page.tsx
@@ -0,0 +1,15 @@
+'use client';
+
+import { Suspense } from 'react';
+import { AdvisorProblemReports } from '@/components/advisor/advisor-problem-reports';
+import { RequireAuth } from '@/components/layout/require-auth';
+
+export default function AdvisorProblemReportsPage() {
+ return (
+
+ กำลังโหลด…}>
+
+
+
+ );
+}
diff --git a/apps/web/src/components/advisor/advisor-approvals.tsx b/apps/web/src/components/advisor/advisor-approvals.tsx
new file mode 100644
index 0000000..6e8797b
--- /dev/null
+++ b/apps/web/src/components/advisor/advisor-approvals.tsx
@@ -0,0 +1,140 @@
+'use client';
+
+import { useCallback, useEffect, useState } from 'react';
+import type { FormEvent } from 'react';
+import type { AdvisorApplicationItem, ApplicationStatus, Paginated } from '@internpath/contracts';
+import { useAuth } from '@/auth/session';
+import { FilterSelect, Notice } from '@/components/admin/filter-fields';
+import {
+ ApplicationSummary, type Message, PAGE_SIZE, Pager, REASON_MAX, ResumeButton, failure, inputClass, primaryButton, secondaryButton,
+} from '@/components/advisor/advisor-ui';
+
+const STATUS_OPTIONS: Array<[ApplicationStatus, string]> = [
+ ['ADVISOR_PENDING', 'รออนุมัติ'],
+ ['ADVISOR_APPROVED', 'อนุมัติแล้ว รอเริ่มงาน'],
+ ['IN_PROGRESS', 'กำลังฝึกงาน'],
+ ['ADVISOR_REJECTED', 'ไม่อนุมัติ'],
+];
+
+/**
+ * หน้าอาจารย์อนุมัติคำขอออกฝึกงาน (README §8 Advisor Approval Dashboard, UAT-15/16)
+ * - รายการ `GET /advisor/applications?status=` (ค่าเริ่มต้น `ADVISOR_PENDING`)
+ * - อนุมัติ `POST /advisor/applications/{id}/actions/approve`
+ * - ไม่อนุมัติ `POST .../actions/reject` — **บังคับเหตุผล** (เซิร์ฟเวอร์ตอบ `400 REASON_REQUIRED` ถ้าว่าง)
+ * สถานะจริงมาจากเซิร์ฟเวอร์เสมอ: ทำรายการเสร็จหรือชนกัน (409) ⇒ โหลดรายการใหม่
+ */
+export function AdvisorApprovals() {
+ const { request } = useAuth();
+ const [status, setStatus] = useState('ADVISOR_PENDING');
+ const [page, setPage] = useState(1);
+ const [list, setList] = useState | null>(null);
+ const [loading, setLoading] = useState(true);
+ const [message, setMessage] = useState(null);
+ const [busyId, setBusyId] = useState(null);
+ const [rejecting, setRejecting] = useState(null);
+ const [reason, setReason] = useState('');
+
+ const load = useCallback(async () => {
+ setLoading(true);
+ try {
+ const query = new URLSearchParams({ status, page: String(page), page_size: String(PAGE_SIZE) });
+ setList(await request>(`/advisor/applications?${query.toString()}`));
+ } catch (cause) {
+ setList(null);
+ setMessage({ tone: 'error', text: failure(cause) });
+ } finally { setLoading(false); }
+ }, [request, status, page]);
+
+ useEffect(() => { void load(); }, [load]);
+
+ async function act(app: AdvisorApplicationItem, action: 'approve' | 'reject', body?: { reason: string }) {
+ setBusyId(app.id);
+ setMessage(null);
+ try {
+ await request(`/advisor/applications/${encodeURIComponent(app.id)}/actions/${action}`, { method: 'POST', body });
+ setRejecting(null);
+ setReason('');
+ setMessage({
+ tone: 'success',
+ text: action === 'approve'
+ ? `อนุมัติให้ ${app.student_name} ออกฝึกงานที่ ${app.company_name} แล้ว รอ HR ยืนยันวันเริ่มงาน`
+ : `ไม่อนุมัติคำขอของ ${app.student_name} แล้ว ระบบแจ้งนักศึกษาและคืนโควตาให้บริษัท`,
+ });
+ } catch (cause) {
+ setMessage({ tone: 'error', text: failure(cause) });
+ } finally {
+ setBusyId(null);
+ await load();
+ }
+ }
+
+ function approve(app: AdvisorApplicationItem) {
+ const warning = app.major_mismatch ? '\nสาขาของนักศึกษาไม่ตรงกับที่ประกาศระบุ' : '';
+ if (window.confirm(`อนุมัติให้ ${app.student_name} ออกฝึกงานที่ ${app.company_name}?${warning}`)) void act(app, 'approve');
+ }
+
+ function submitReject(event: FormEvent, app: AdvisorApplicationItem) {
+ event.preventDefault();
+ const value = reason.trim();
+ if (!value) { setMessage({ tone: 'error', text: 'การไม่อนุมัติต้องระบุเหตุผล' }); return; }
+ if (value.length > REASON_MAX) { setMessage({ tone: 'error', text: `เหตุผลต้องไม่เกิน ${REASON_MAX} ตัวอักษร` }); return; }
+ void act(app, 'reject', { reason: value });
+ }
+
+ return (
+
+ อนุมัติการออกฝึกงาน
+
+ ตรวจคำขอออกฝึกงานของนักศึกษาในความดูแล และความตรงสายก่อนเริ่มฝึก การไม่อนุมัติต้องระบุเหตุผลเสมอ
+
+
+
+ { setStatus(value as ApplicationStatus); setPage(1); setRejecting(null); }}
+ options={STATUS_OPTIONS} />
+
+
+ {message && {message.text}
}
+
+ {loading && !list && กำลังโหลด…
}
+ {list && list.data.length === 0 && (
+
+ {status === 'ADVISOR_PENDING' ? 'ไม่มีคำขอที่รออนุมัติ' : 'ไม่มีรายการในสถานะนี้'}
+
+ )}
+
+
+
+ {list && }
+
+ );
+}
diff --git a/apps/web/src/components/advisor/advisor-evaluations.tsx b/apps/web/src/components/advisor/advisor-evaluations.tsx
new file mode 100644
index 0000000..5c74a9a
--- /dev/null
+++ b/apps/web/src/components/advisor/advisor-evaluations.tsx
@@ -0,0 +1,223 @@
+'use client';
+
+import { useCallback, useEffect, useState } from 'react';
+import type { FormEvent } from 'react';
+import type {
+ AcademicResult, AcademicResultRequest, AdvisorApplicationItem, AdvisorDisputeAction, AdvisorDisputeItem, ApplicationStatus, Paginated,
+} from '@internpath/contracts';
+import { useAuth } from '@/auth/session';
+import { FilterSelect, Notice } from '@/components/admin/filter-fields';
+import {
+ ApplicationSummary, type Message, NOTE_MAX, PAGE_SIZE, Pager, failure, inputClass, primaryButton, secondaryButton,
+} from '@/components/advisor/advisor-ui';
+import { formatDate } from '@/components/student/application-ui';
+
+/** สถานะที่อาจารย์บันทึกผลวิชาได้ (Lifecycle `allowedAcademicResults`) */
+const RECORDABLE: Array<[ApplicationStatus, string]> = [
+ ['EVALUATED_PASS', 'บริษัทประเมินผ่าน'],
+ ['EVALUATED_FAIL', 'บริษัทประเมินไม่ผ่าน'],
+ ['TERMINATED', 'ยุติกลางคัน'],
+ ['NO_EVALUATION', 'บริษัทไม่ประเมิน'],
+];
+
+const ACADEMIC_LABEL: Record = {
+ ACADEMIC_PASS: 'ผ่านรายวิชา',
+ ACADEMIC_FAIL: 'ไม่ผ่านรายวิชา',
+ REPEAT_REQUIRED: 'ต้องฝึกซ้ำ',
+};
+
+/** ห้ามเปลี่ยน FAIL ของบริษัทเป็น PASS (README 5.2, UAT-21) — ตรงกับ Guard ฝั่งเซิร์ฟเวอร์ */
+function allowedResults(status: ApplicationStatus): AcademicResult[] {
+ if (status === 'EVALUATED_FAIL') return ['ACADEMIC_FAIL', 'REPEAT_REQUIRED'];
+ return ['ACADEMIC_PASS', 'ACADEMIC_FAIL', 'REPEAT_REQUIRED'];
+}
+
+/**
+ * หน้าอาจารย์ประเมินผล (README §5.2 / §8 Advisor Dashboard)
+ * 1. คิวคำโต้แย้งผล `FAIL` — `GET /advisor/disputes` → `request-reevaluation` (ให้บริษัทประเมินซ้ำ 1 รอบ) หรือ `uphold-fail`
+ * 2. บันทึกผลทางวิชาการ — `GET /advisor/applications?status=` → `POST /advisor/applications/{id}/academic-result`
+ */
+export function AdvisorEvaluations() {
+ return (
+
+ ประเมินผลการฝึกงาน
+ ตัดสินคำโต้แย้งผลประเมินของนักศึกษา และบันทึกผลทางวิชาการเมื่อการฝึกงานสิ้นสุด
+
+
+
+ );
+}
+
+function DisputeQueue() {
+ const { request } = useAuth();
+ const [page, setPage] = useState(1);
+ const [list, setList] = useState | null>(null);
+ const [message, setMessage] = useState(null);
+ const [busyId, setBusyId] = useState(null);
+ const [notes, setNotes] = useState>({});
+
+ const load = useCallback(async () => {
+ try {
+ const query = new URLSearchParams({ page: String(page), page_size: String(PAGE_SIZE) });
+ setList(await request>(`/advisor/disputes?${query.toString()}`));
+ } catch (cause) {
+ setList(null);
+ setMessage({ tone: 'error', text: failure(cause) });
+ }
+ }, [request, page]);
+
+ useEffect(() => { void load(); }, [load]);
+
+ async function decide(item: AdvisorDisputeItem, action: AdvisorDisputeAction) {
+ const question = action === 'request-reevaluation'
+ ? `ให้บริษัทประเมิน ${item.student_name} ใหม่? (ประเมินซ้ำได้ 1 รอบ)`
+ : `ยืนยันผลไม่ผ่านของ ${item.student_name}?`;
+ if (!window.confirm(question)) return;
+ const note = (notes[item.id] ?? '').trim();
+ if (note.length > NOTE_MAX) { setMessage({ tone: 'error', text: `หมายเหตุต้องไม่เกิน ${NOTE_MAX} ตัวอักษร` }); return; }
+ setBusyId(item.id);
+ setMessage(null);
+ try {
+ await request(`/advisor/applications/${encodeURIComponent(item.id)}/actions/${action}`, { method: 'POST', body: note ? { note } : {} });
+ setMessage({
+ tone: 'success',
+ text: action === 'request-reevaluation' ? `ส่งให้บริษัทประเมิน ${item.student_name} ใหม่แล้ว` : `ยืนยันผลไม่ผ่านของ ${item.student_name} แล้ว บันทึกผลวิชาได้ในส่วนด้านล่าง`,
+ });
+ } catch (cause) {
+ setMessage({ tone: 'error', text: failure(cause) });
+ } finally {
+ setBusyId(null);
+ await load();
+ }
+ }
+
+ return (
+
+ คำโต้แย้งผลประเมิน
+ {message && {message.text}
}
+ {list && list.data.length === 0 && ไม่มีคำโต้แย้งที่รอตัดสิน
}
+
+ {list && }
+
+ );
+}
+
+function AcademicResults() {
+ const { request } = useAuth();
+ const [status, setStatus] = useState('EVALUATED_PASS');
+ const [page, setPage] = useState(1);
+ const [list, setList] = useState | null>(null);
+ const [message, setMessage] = useState(null);
+ const [editing, setEditing] = useState(null);
+ const [result, setResult] = useState('ACADEMIC_PASS');
+ const [note, setNote] = useState('');
+ const [busy, setBusy] = useState(false);
+
+ const load = useCallback(async () => {
+ try {
+ const query = new URLSearchParams({ status, page: String(page), page_size: String(PAGE_SIZE) });
+ setList(await request>(`/advisor/applications?${query.toString()}`));
+ } catch (cause) {
+ setList(null);
+ setMessage({ tone: 'error', text: failure(cause) });
+ }
+ }, [request, status, page]);
+
+ useEffect(() => { void load(); }, [load]);
+
+ function open(app: AdvisorApplicationItem) {
+ setEditing(app.id);
+ setResult(allowedResults(app.status)[0]);
+ setNote('');
+ setMessage(null);
+ }
+
+ async function submit(event: FormEvent, app: AdvisorApplicationItem) {
+ event.preventDefault();
+ const value = note.trim();
+ if (value.length > NOTE_MAX) { setMessage({ tone: 'error', text: `หมายเหตุต้องไม่เกิน ${NOTE_MAX} ตัวอักษร` }); return; }
+ if (!window.confirm(`บันทึกผล "${ACADEMIC_LABEL[result]}" ให้ ${app.student_name}? บันทึกแล้วแก้ไม่ได้`)) return;
+ setBusy(true);
+ setMessage(null);
+ try {
+ const body: AcademicResultRequest = { academic_result: result, ...(value ? { note: value } : {}) };
+ await request(`/advisor/applications/${encodeURIComponent(app.id)}/academic-result`, { method: 'POST', body });
+ setEditing(null);
+ setMessage({ tone: 'success', text: `บันทึกผล "${ACADEMIC_LABEL[result]}" ของ ${app.student_name} แล้ว การฝึกงานนี้เสร็จสิ้น` });
+ } catch (cause) {
+ setMessage({ tone: 'error', text: failure(cause) });
+ } finally {
+ setBusy(false);
+ await load();
+ }
+ }
+
+ return (
+
+ บันทึกผลทางวิชาการ
+ ถ้าบริษัทประเมินไม่ผ่าน บันทึกได้เฉพาะ "ไม่ผ่านรายวิชา" หรือ "ต้องฝึกซ้ำ"
+
+ { setStatus(value as ApplicationStatus); setPage(1); setEditing(null); }} options={RECORDABLE} />
+
+ {message && {message.text}
}
+ {list && list.data.length === 0 && ไม่มีรายการที่รอบันทึกผล
}
+
+ {list && }
+
+ );
+}
diff --git a/apps/web/src/components/advisor/advisor-problem-reports.tsx b/apps/web/src/components/advisor/advisor-problem-reports.tsx
new file mode 100644
index 0000000..d4e29b9
--- /dev/null
+++ b/apps/web/src/components/advisor/advisor-problem-reports.tsx
@@ -0,0 +1,161 @@
+'use client';
+
+import { CircleCheck, Clock5, ScanSearch } from 'lucide-react';
+import { useCallback, useEffect, useState } from 'react';
+import type { FormEvent } from 'react';
+import type { Paginated, ProblemReportCategory, ProblemReportItem, ProblemReportStatus, ResolveProblemReportRequest } from '@internpath/contracts';
+import { useAuth } from '@/auth/session';
+import { FilterSelect, Notice } from '@/components/admin/filter-fields';
+import { type Message, NOTE_MAX, PAGE_SIZE, Pager, failure, inputClass, primaryButton, secondaryButton } from '@/components/advisor/advisor-ui';
+import { StatusBadge, type StatusTone } from '@/components/ui/status-badge';
+import { formatDateTime } from '@/components/student/application-ui';
+
+const CATEGORY_LABEL: Record = {
+ WORKLOAD_OR_HOURS: 'ปริมาณงานหรือชั่วโมงทำงาน',
+ NO_ALLOWANCE_AS_PROMISED: 'ไม่ได้รับค่าตอบแทนตามที่ระบุ',
+ UNSAFE_OR_HARASSMENT: 'ความไม่ปลอดภัยหรือการคุกคาม',
+ DIFFERENT_FROM_JOB_POST: 'งานไม่ตรงกับประกาศ',
+ OTHER: 'อื่น ๆ',
+};
+
+const STATUS_VIEW: Record = {
+ OPEN: { label: 'รอรับเรื่อง', tone: 'warning', icon: Clock5 },
+ ACKNOWLEDGED: { label: 'รับเรื่องแล้ว', tone: 'info', icon: ScanSearch },
+ RESOLVED: { label: 'ปิดเรื่องแล้ว', tone: 'success', icon: CircleCheck },
+};
+
+type FollowUp = NonNullable;
+const FOLLOW_UP_LABEL: Record = {
+ MONITOR_COMPANY: 'ติดตามบริษัท',
+ TERMINATE: 'ยุติการฝึก',
+ ESCALATE_COMPANY_REVIEW: 'ส่งต่อให้ตรวจบัญชีบริษัท',
+};
+
+/**
+ * รายงานปัญหาระหว่างฝึกงานของนักศึกษาในความดูแล (README §5.2.2, UAT-39) — บริษัทมองไม่เห็นรายงาน
+ * - รายการ `GET /advisor/problem-reports?status=`
+ * - `OPEN` → `POST /problem-reports/{id}/actions/acknowledge` → `ACKNOWLEDGED` → `.../resolve` `{note, follow_up_action?}`
+ * การรายงานและการปิดเรื่องไม่เปลี่ยนสถานะใบสมัคร — ถ้าต้องยุติการฝึกจริง ให้ยุติจากใบสมัครแยกต่างหาก
+ */
+export function AdvisorProblemReports() {
+ const { request } = useAuth();
+ const [status, setStatus] = useState<'' | ProblemReportStatus>('');
+ const [page, setPage] = useState(1);
+ const [list, setList] = useState | null>(null);
+ const [message, setMessage] = useState(null);
+ const [busyId, setBusyId] = useState(null);
+ const [resolving, setResolving] = useState(null);
+ const [note, setNote] = useState('');
+ const [followUp, setFollowUp] = useState<'' | FollowUp>('');
+
+ const load = useCallback(async () => {
+ try {
+ const query = new URLSearchParams({ page: String(page), page_size: String(PAGE_SIZE) });
+ if (status) query.set('status', status);
+ setList(await request>(`/advisor/problem-reports?${query.toString()}`));
+ } catch (cause) {
+ setList(null);
+ setMessage({ tone: 'error', text: failure(cause) });
+ }
+ }, [request, status, page]);
+
+ useEffect(() => { void load(); }, [load]);
+
+ async function act(report: ProblemReportItem, action: 'acknowledge' | 'resolve', body?: ResolveProblemReportRequest) {
+ setBusyId(report.id);
+ setMessage(null);
+ try {
+ await request(`/problem-reports/${encodeURIComponent(report.id)}/actions/${action}`, { method: 'POST', body });
+ setResolving(null);
+ setMessage({ tone: 'success', text: action === 'acknowledge' ? 'รับเรื่องแล้ว' : 'ปิดเรื่องแล้ว' });
+ } catch (cause) {
+ setMessage({ tone: 'error', text: failure(cause) });
+ } finally {
+ setBusyId(null);
+ await load();
+ }
+ }
+
+ function submitResolve(event: FormEvent, report: ProblemReportItem) {
+ event.preventDefault();
+ const value = note.trim();
+ if (!value) { setMessage({ tone: 'error', text: 'กรุณาสรุปผลการดำเนินการก่อนปิดเรื่อง' }); return; }
+ if (value.length > NOTE_MAX) { setMessage({ tone: 'error', text: `ข้อความต้องไม่เกิน ${NOTE_MAX} ตัวอักษร` }); return; }
+ void act(report, 'resolve', { note: value, ...(followUp ? { follow_up_action: followUp } : {}) });
+ }
+
+ return (
+
+ รายงานปัญหาระหว่างฝึกงาน
+
+ รายงานจากนักศึกษาในความดูแล ส่งถึงอาจารย์และผู้ดูแลระบบพร้อมกัน บริษัทมองไม่เห็นรายงานเหล่านี้
+
+
+
+ { setStatus(value as '' | ProblemReportStatus); setPage(1); setResolving(null); }}
+ options={[['', 'ทั้งหมด'], ['OPEN', 'รอรับเรื่อง'], ['ACKNOWLEDGED', 'รับเรื่องแล้ว'], ['RESOLVED', 'ปิดเรื่องแล้ว']]} />
+
+
+ {message && {message.text}
}
+ {list && list.data.length === 0 && ไม่มีรายงานในสถานะนี้
}
+
+
+ {list?.data.map((report) => {
+ const view = STATUS_VIEW[report.status];
+ return (
+ -
+
+
+
{CATEGORY_LABEL[report.category]}
+
รายงานเมื่อ {formatDateTime(report.created_at)} · กำหนดดำเนินการ {formatDateTime(report.due_at)}
+
+
+ {report.overdue && OVERDUE}
+ {view.label}
+
+
+ {report.detail}
+ {report.resolution_note && (
+
+ ผลการดำเนินการ: {report.resolution_note}
+ {report.follow_up_action && ({FOLLOW_UP_LABEL[report.follow_up_action]})}
+
+ )}
+
+ {report.status === 'OPEN' && (
+
+ )}
+ {report.status !== 'RESOLVED' && resolving !== report.id && (
+
+ )}
+
+ {resolving === report.id && (
+
+ )}
+
+ );
+ })}
+
+
+ {list && }
+
+ );
+}
diff --git a/apps/web/src/components/advisor/advisor-ui.tsx b/apps/web/src/components/advisor/advisor-ui.tsx
new file mode 100644
index 0000000..6cd22cf
--- /dev/null
+++ b/apps/web/src/components/advisor/advisor-ui.tsx
@@ -0,0 +1,84 @@
+'use client';
+
+import { AlertTriangle, FileText } from 'lucide-react';
+import { useState } from 'react';
+import type { AdvisorApplicationItem, ResumeUrlResponse } from '@internpath/contracts';
+import { useAuth } from '@/auth/session';
+import { StatusBadge } from '@/components/ui/status-badge';
+import { ApplicationStatusBadge, formatDate } from '@/components/student/application-ui';
+import { ApiError } from '@/lib/api';
+
+export const PAGE_SIZE = 20;
+/** เหตุผลของ reject / หมายเหตุของคำโต้แย้งและผลวิชา (api-contract §7.4 — Lifecycle `APPLICATION_LIMITS`) */
+export const REASON_MAX = 2000;
+export const NOTE_MAX = 5000;
+
+export const inputClass = 'mt-1 w-full rounded-lg border border-border bg-surface px-3 py-2 text-base font-normal outline-none focus:border-primary focus:ring-2 focus:ring-primary-soft';
+export const primaryButton = 'rounded-full bg-primary px-5 py-2 text-sm font-semibold text-white hover:bg-primary-hover active:scale-[0.97] disabled:opacity-60';
+export const secondaryButton = 'rounded-full border border-border px-5 py-2 text-sm font-semibold hover:bg-surface-muted active:scale-[0.97] disabled:opacity-60';
+
+export type Message = { tone: 'error' | 'success'; text: string };
+
+export function failure(cause: unknown): string {
+ if (!(cause instanceof ApiError)) return 'ดำเนินการไม่สำเร็จ กรุณาลองใหม่';
+ if (cause.code === 'REASON_REQUIRED') return 'กรุณาระบุเหตุผล';
+ if (cause.issues.includes('ACADEMIC_RESULT_ALREADY_RECORDED')) return 'บันทึกผลวิชาของใบสมัครนี้ไว้แล้ว';
+ if (cause.issues.includes('DISPUTE_WINDOW_OPEN')) return 'ยังอยู่ในช่วง 7 วันที่นักศึกษาโต้แย้งผลได้ บันทึกผลวิชาได้หลังพ้นช่วงนี้';
+ if (cause.code === 'STATE_CONFLICT') return 'สถานะของรายการนี้เปลี่ยนไปแล้ว โหลดรายการใหม่ให้แล้ว';
+ if (cause.issues.includes('COMPANY_FAIL_CANNOT_BECOME_PASS')) return 'บริษัทประเมินไม่ผ่าน จึงบันทึกผลวิชาเป็น "ผ่าน" ไม่ได้';
+ return cause.message;
+}
+
+/** หัวรายการใบสมัครของนักศึกษา (ชื่อ ตำแหน่ง บริษัท ช่วงฝึก ป้ายเตือน) ใช้ร่วมกันทุกหน้าของอาจารย์ */
+export function ApplicationSummary({ app }: { app: AdvisorApplicationItem }) {
+ return (
+
+
+
{app.student_name}
+
{app.job_title} · {app.company_name}
+
+ {app.start_date && app.end_date ? `ช่วงฝึก ${formatDate(app.start_date)} – ${formatDate(app.end_date)}` : `สมัครเมื่อ ${formatDate(app.created_at)}`}
+
+
+ {app.major_mismatch && สาขาไม่ตรงกับประกาศ}
+ {app.flagged_for_advisor && ประกาศถูกตีกลับหรือบริษัทถูกระงับ}
+ {app.frozen && ประกาศถูกระงับชั่วคราว}
+
+
+
+
+ );
+}
+
+/** เปิดเรซูเม่ที่นักศึกษาส่ง (`GET /advisor/applications/{id}/resume` — URL อายุสั้น) */
+export function ResumeButton({ applicationId, onError }: { applicationId: string; onError: (text: string) => void }) {
+ const { request } = useAuth();
+ const [busy, setBusy] = useState(false);
+ async function open() {
+ setBusy(true);
+ try {
+ const { url } = await request(`/advisor/applications/${encodeURIComponent(applicationId)}/resume`);
+ window.open(url, '_blank', 'noopener,noreferrer');
+ } catch (cause) { onError(failure(cause)); }
+ finally { setBusy(false); }
+ }
+ return (
+
+ );
+}
+
+export function Pager({ page, total, onPage }: { page: number; total: number; onPage: (page: number) => void }) {
+ const last = Math.max(1, Math.ceil(total / PAGE_SIZE));
+ if (total === 0) return null;
+ return (
+
+ ทั้งหมด {total} รายการ · หน้า {page} จาก {last}
+
+
+
+
+
+ );
+}
diff --git a/apps/web/src/components/layout/site-nav.ts b/apps/web/src/components/layout/site-nav.ts
index 22c11ab..300914e 100644
--- a/apps/web/src/components/layout/site-nav.ts
+++ b/apps/web/src/components/layout/site-nav.ts
@@ -24,7 +24,12 @@ export const ROLE_NAV: Record = {
{ label: 'บริษัทของฉัน', href: '/hr/company', ready: true },
{ label: 'ทีม HR', href: '/hr/team', ready: true },
],
- ADVISOR: [{ label: 'นักศึกษาของฉัน', href: '/advisor/students', ready: true }],
+ ADVISOR: [
+ { label: 'นักศึกษาของฉัน', href: '/advisor/students', ready: true },
+ { label: 'อนุมัติฝึกงาน', href: '/advisor/approvals', ready: true },
+ { label: 'ประเมินผล', href: '/advisor/evaluations', ready: true },
+ { label: 'รายงานปัญหา', href: '/advisor/problem-reports', ready: true },
+ ],
PLATFORM_ADMIN: [{ label: 'หลังบ้าน', href: '/admin/queue', ready: true }],
};