Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

University Internship Platform (InternPath)

  1. หลักการและเหตุผล (Rationale)
  2. วัตถุประสงค์ของโครงงาน (Objectives)
  3. โมเดลธุรกิจและการสร้างรายได้ (Business Model)
  4. ขอบเขตของระบบและประเภทงาน (System Scope & Job Categories)
  5. กลไกการตรวจสอบงานและลำดับการอนุมัติฝึกงาน (Verification & Approval Pipeline)
  6. แนวทางการพัฒนาตาม SDLC
  7. กลุ่มผู้ใช้งานเป้าหมาย (User Personas)
  8. การออกแบบ UI/UX (โทนสว่าง - Light Theme)
  9. แผนการดำเนินงาน 4 สัปดาห์ (Work Plan: 4 Weeks)
  10. การทดสอบการยอมรับของผู้ใช้งาน (UAT)
  11. สมาชิกในทีมและการแบ่งความรับผิดชอบ (Team Members)
  12. เอกสารเทคนิค (Technical Docs)

1. หลักการและเหตุผล (Rationale)

ในปัจจุบัน นักศึกษามหาวิทยาลัยจำนวนมากต้องเผชิญกับความเสี่ยงในการหาสถานที่ฝึกงานผ่านช่องทางออนไลน์ทั่วไป เช่น ประกาศงานที่ไม่มีการคัดกรอง งานหลอกลวงเรียกเก็บค่ามัดจำ หรือรายละเอียดงานไม่ตรงปก (Job Scam & Misrepresentation) ในขณะที่การประสานงานระหว่างนักศึกษา อาจารย์ที่ปรึกษา และสถานประกอบการมักกระจัดกระจายและขาดระบบติดตามสถานะที่เป็นมาตรฐานเดียวกัน

เพื่อแก้ปัญหานี้ คณะผู้จัดทำจึงพัฒนา University Internship Platform (InternPath) ในฐานะ แพลตฟอร์มตัวกลาง (University–Industry Internship Hub) ด้วยสถาปัตยกรรม Microservices ที่เชื่อมโยงระหว่าง นักศึกษา อาจารย์จากมหาวิทยาลัย และบริษัท เข้าด้วยกัน โดยให้ อาจารย์เป็นผู้นำนักศึกษาในความดูแลเข้าสู่ระบบ และมี Platform Admin คอยตรวจสอบและอนุมัติบัญชีบริษัทที่สมัครเข้ามา ควบคู่ไปกับระบบ Tag ทักษะ ที่บอกความต้องการของแต่ละตำแหน่ง ระบบรายงานประกาศงานและรีวิวที่น่าสงสัย (Report & Auto-Suspend) ระบบกำหนดเวลาตอบกลับและแจ้งเตือน (SLA & Notification) เพื่อไม่ให้กระบวนการค้าง ระบบบันทึกประวัติการเปลี่ยนสถานะที่ตรวจสอบย้อนหลังได้ (Audit Trail) และระบบการออกใบรับรองการฝึกงานแบบดิจิทัล (E-Certificate) ที่มี QR Code ให้บุคคลภายนอกตรวจสอบความถูกต้องได้ด้วยตนเอง


2. วัตถุประสงค์ของโครงงาน (Objectives)

  1. เพื่อออกแบบและพัฒนาแพลตฟอร์มตัวกลางเชื่อมโยงการฝึกงาน (Internship Hub) ด้วยสถาปัตยกรรม Microservices ที่แยกส่วนการทำงานชัดเจน (แต่ละ Service มีฐานข้อมูลของตนเอง) รองรับการประมวลผลแบบ Asynchronous ผ่าน Message Broker โดยไม่กระทบต่อประสิทธิภาพหน้าเว็บหลัก
  2. เพื่อสร้างระบบควบคุมความน่าเชื่อถือของบริษัทและประกาศงาน ผ่านการอนุมัติบัญชีองค์กรโดย Platform Admin ควบคู่กับระบบรายงานประกาศงานและรีวิว ธงตรวจสอบบริษัท และ Audit Log พร้อมกลไกป้องกันการรายงานเท็จ
  3. เพื่อพัฒนากระบวนการอนุมัติและติดตามผลฝึกงานแบบครบวงจร (End-to-End Internship Lifecycle) เชื่อมโยงตั้งแต่ HR ตอบรับใบสมัคร → นักศึกษายืนยันข้อเสนอ → อาจารย์อนุมัติการออกฝึกงาน → บริษัทประเมินผลและออก E-Certificate (PDF + QR ตรวจสอบได้) → จนถึงระบบรีวิวบริษัทจากผู้ฝึกงานจริง (Closed-Loop Review)
  4. เพื่อออกแบบกระบวนการให้ครอบคลุมเส้นทางที่ไม่ปกติ เช่น การถอนใบสมัครและการถอนข้อเสนอ การไม่ตอบสนองของแต่ละฝ่าย (SLA/Timeout) การยุติการฝึกกลางคัน การโต้แย้งผลประเมิน การรายงานปัญหาระหว่างฝึกงาน และการที่บริษัทถูกระงับระหว่างฝึก เพื่อไม่ให้ใบสมัครหรือโควตาตำแหน่งค้างอยู่ในระบบ
  5. เพื่อให้ระบบมีความปลอดภัยและตรวจสอบย้อนหลังได้ ด้วยการยืนยันตัวตนผ่านอีเมล การควบคุมสิทธิ์ตาม Role การบันทึกประวัติการเปลี่ยนสถานะและการกระทำของ Admin (Audit Log) และการคุ้มครองข้อมูลส่วนบุคคล (PDPA)

3. โมเดลธุรกิจและการสร้างรายได้ (Business Model)

  • Featured / Boosted Job Post: บริการดันการ์ดประกาศงานขึ้นแสดงผลลำดับบนสุดของหน้าค้นหา พร้อมป้ายกำกับพิเศษ (Urgent / Featured) สำหรับบริษัทที่ต้องการรับนักศึกษาฝึกงานเร่งด่วน (ใช้ได้เฉพาะประกาศที่เป็น PUBLISHED แล้ว)
  • Fast-Track Account Review: บริการตรวจสอบบัญชีบริษัทและตรวจเคสที่ติดคิวของ Admin แบบเร่งด่วนพิเศษ (Priority Queue, SLA 12 ชั่วโมง เทียบกับ 48 ชั่วโมงของคิวปกติ) Fast-Track เปลี่ยนเฉพาะลำดับในคิว ไม่ลดเกณฑ์การตรวจ- HR Pro Subscription (Future Phase): แพ็กเกจสมาชิกรายเดือนสำหรับองค์กรขนาดใหญ่ เพื่อปลดล็อกโควตาการโพสต์งานไม่จำกัดและการค้นหาเรซูเม่นักศึกษาเชิงรุก (Talent Pool Search)

หมายเหตุสำหรับการสาธิต: โครงงานนี้ไม่เชื่อมต่อ Payment Gateway จริง การซื้อบริการ Featured / Fast-Track จำลองโดยให้ Platform Admin เป็นผู้เปิดสิทธิ์ให้บริษัท แทนขั้นตอนการชำระเงิน โดยสิทธิ์ถูกเก็บเป็นฟิลด์ของบริษัท (featured_enabled, fast_track_enabled) ที่ Identity & Organization Service และ Service อื่นอ่านผ่าน Event CompanyEntitlementChanged


4. ขอบเขตของระบบและประเภทงาน (System Scope & Job Categories)

4.1 ผู้ใช้งานระบบ (Actors)

  • **นักศึกษา (Student):**ไม่ต้องสมัครสมาชิกเอง — อาจารย์ที่ปรึกษาสร้างบัญชีให้ผ่านฟอร์มเพิ่มนักศึกษา (ระบบส่งอีเมลคำเชิญให้นักศึกษาตั้งรหัสผ่าน และผูกกับอาจารย์ผู้สร้างเป็น LINKED ทันที ไม่มีขั้นเลือกอาจารย์), สร้างโปรไฟล์/เรซูเม่ (ให้ความยินยอมก่อนส่งให้บริษัทแต่ละแห่ง), ค้นหาบริษัทและสมัครงาน (กรองตาม Tag ทักษะได้), ยืนยันรับข้อเสนอจากบริษัท (ได้ทีละ 1 ที่) หรือปฏิเสธ/ถอนใบสมัคร (ถอนได้จนถึงสถานะ ADVISOR_APPROVED), ขอยุติการฝึกกลางคัน, รายงานปัญหาระหว่างฝึกงานถึงอาจารย์และ Admin (บริษัทมองไม่เห็น), โต้แย้งผลประเมิน FAIL ภายใน 7 วัน, กด Report ประกาศงานหรือรีวิวที่น่าสงสัย, เขียนรีวิวบริษัทเมื่อสิ้นสุดการฝึกจริง และดาวน์โหลด E-Certificate (PDF) ที่บริษัทออกให้ (หลังฝึกจบด้วยผล ACADEMIC_PASS แล้วสมัครฝึกงานใหม่ไม่ได้ เว้นแต่ Admin ปลดล็อก)
  • ตัวแทนบริษัท / ฝ่ายบุคคล (Company / HR): ลงทะเบียนองค์กร (ใช้อีเมลโดเมนองค์กรและยืนยันอีเมล คนแรกเป็น Owner เชิญ HR Member ได้ กำหนดสายงาน (Tech & IT / Business & Marketing / Corporate Services) ให้สมาชิกแต่ละคน และโอนสิทธิ์ Owner ได้), สร้าง/แก้ไขประกาศรับนักศึกษาฝึกงาน (กรอกข้อมูลบังคับให้ครบ เลือก Tag ทักษะ ประกาศเผยแพร่ทันที) สมาชิกจัดการได้เฉพาะประกาศและผู้สมัครของสายงานที่ได้รับ ส่วน Owner จัดการได้ทุกสายงาน, คัดเลือกผู้สมัครและส่งข้อเสนอ (HR_ACCEPTED) พร้อมระบุวันเริ่ม-สิ้นสุด, ถอนข้อเสนอก่อนเริ่มฝึกได้พร้อมเหตุผล (OFFER_RESCINDED), กดยืนยันว่านักศึกษาเริ่มงานจริง (ปรับวันเริ่ม-สิ้นสุดได้), ยุติการฝึกกลางคันพร้อมเหตุผล, ประเมินผลการฝึกงาน (PASS / FAIL โดย FAIL ต้องระบุเหตุผล) และกดออก/เพิกถอน E-Certificate (PDF) ในนามบริษัท, ตอบกลับรีวิวสาธารณะได้ 1 ครั้งต่อรีวิว
  • อาจารย์จากมหาวิทยาลัย (Advisor): สมัครด้วย @ac.th (ยืนยันอีเมล) และรอ Admin อนุมัติบัญชี, ยืนยันการผูกนักศึกษาในความดูแล, ตรวจสอบและกดอนุมัติคำขอออกฝึกงาน (เช็กความตรงสายก่อนเริ่มฝึก; การไม่อนุมัติต้องระบุเหตุผล), ติดตามสถานะการฝึกงาน, รับแจ้ง รายงานปัญหาระหว่างฝึกงาน ของนักศึกษาในความดูแล, ตัดสินคำโต้แย้งผลประเมิน FAIL (สั่งให้บริษัทประเมินซ้ำได้ 1 รอบ), ตัดสินใจเมื่อบริษัทถูกระงับขณะนักศึกษากำลังฝึก และ บันทึกผลทางวิชาการ (academic_result) ของการฝึกงานแต่ละราย
  • ผู้ดูแลแพลตฟอร์ม (Platform Admin): ตรวจและอนุมัติบัญชีบริษัทและบัญชีอาจารย์ (Verified by Platform), ติดป้าย University Partner ให้บริษัทที่มีข้อตกลงกับมหาวิทยาลัย, จัดการรายการ Tag ทักษะกลาง (เพิ่ม/แก้ชื่อ/ปิดใช้งาน), ตรวจอนุมัติประกาศงานของบริษัทที่ถูกติดธง UNDER_REVIEW (Manual Review Queue), ดูแลเคสที่ถูก Report (ประกาศงานและรีวิว), พิจารณารายงานปัญหาระหว่างฝึกงาน, ตรวจบัญชีบริษัทที่ถูกติดธง UNDER_REVIEW, เพิกถอน E-Certificate, ย้ายอาจารย์ที่ปรึกษาให้นักศึกษา, แต่งตั้ง Owner ใหม่ให้บริษัทที่ไม่มี Owner, ปลดล็อกการสมัครซ้ำ, เปิดสิทธิ์ Featured/Fast-Track (จำลองการชำระเงิน) และยืนยันเคสที่บริษัทไม่ประเมินผลนักศึกษา โดยทุกการกระทำถูกบันทึกใน Audit Log

4.2 ขอบเขตประเภทงานบนแพลตฟอร์ม (Supported Job Categories)

  1. สายเทคโนโลยีและดิจิทัล (Tech & IT): เช่น Software Engineer Intern, QA/Tester, UI/UX Designer, Data Analyst
  2. สายธุรกิจ การตลาด และคอนเทนต์ (Business & Marketing): เช่น Digital Marketing, Content Creator, Graphic Designer, Business Development
  3. สายงานสนับสนุนองค์กร (Corporate & Professional Services): เช่น HR Intern, Administrative Intern, Corporate Finance Intern

4.3 ความสามารถหลักของระบบแบ่งตาม Microservices (Main Functions)

แต่ละ Service มี ฐานข้อมูลของตนเอง และ ห้ามอ่านตารางของ Service อื่นโดยตรง (ติดต่อกันผ่าน API หรือ Event เท่านั้น) ดูรายละเอียดเจ้าของข้อมูลใน 5.8 ส่วน API Gateway เป็นแอปบางๆ ที่ทำหน้าที่ Routing, ตรวจ Token และ Rate Limit (ไม่นับเป็น Business Service)

ลำดับ Microservice ความสามารถหลัก (Functional Requirements)
1 Identity & Organization Service - บัญชีและความปลอดภัย: แยกสิทธิ์ 4 Roles (STUDENT, COMPANY_HR, ADVISOR, PLATFORM_ADMIN), นักศึกษาไม่สมัครเอง: อาจารย์สร้างบัญชีนักศึกษาด้วยฟอร์ม (ส่งอีเมลคำเชิญตั้งรหัสผ่าน ผูก advisor_id เป็น LINKED อัตโนมัติ), ยืนยันอีเมลของอาจารย์/บริษัท, รีเซ็ตรหัสผ่าน, ออก JWT อายุสั้นพร้อม Refresh Token, Denylist สำหรับบัญชีที่ถูกระงับ (ดู 5.7), บันทึกความยินยอม PDPA และจัดการคำขอลบบัญชี
- อาจารย์: สมัครด้วย @ac.th และรอ Admin อนุมัติ; เพิ่มนักศึกษาในความดูแล, ดูรายชื่อนักศึกษาพร้อมตัวกรอง (ชั้นปี / กำลังฝึกงาน / ฝึกงานเสร็จแล้ว), ย้ายอาจารย์ที่ปรึกษาโดย Admin เท่านั้น (ดู 5.6)
- บริษัท: ลงทะเบียนและอนุมัติโดย Admin (PENDING / NEED_MORE_INFO / VERIFIED / REJECTED / SUSPENDED), ป้าย University Partner, HR Owner/Member พร้อมสายงานของสมาชิก และการโอนสิทธิ์ Owner, สิทธิ์ featured_enabled / fast_track_enabled, เอกสารยืนยันบริษัทและโลโก้
- Company Directory: หน้าสารบัญค้นหาบริษัท (D 07-A) พร้อมคะแนนรีวิวที่รับจาก Event ReviewPublished
- หน้า Admin ของงานข้างต้น และ Audit Log ของ Service นี้
- ส่ง Event: CompanyStatusChanged, CompanyEntitlementChanged, AdvisorLinkChanged, UserDeletionRequested
2 Job Management Service - จัดการงานฝั่ง HR: สร้าง/แก้ไข/ปิด การ์ดประกาศงาน (ข้อมูลบังคับตาม 5.1.5 และ target_majors) ประกาศเผยแพร่ทันที (เว้นแต่บริษัทถูกติดธง UNDER_REVIEW) สมาชิก HR จัดการได้เฉพาะสายงานที่ได้รับ
- Tag ทักษะ: เก็บรายการ Tag กลาง (Admin จัดการ), ติด Tag ให้ประกาศ 1-10 รายการ และกรองการค้นหาด้วย Tag (5.1.0)
- เป็นเจ้าของฟิลด์สถานะประกาศงานแต่เพียงผู้เดียว: เปลี่ยนสถานะเอง (เผยแพร่ทันที) หรือตามผลที่ Verification ส่งมา แล้วส่ง JobStatusChanged
- Job Search: ค้นหาตำแหน่งฝึกงาน (กรองตามสายงาน, รูปแบบ, สาขา, Tag) พร้อม Snapshot ชื่อ/โลโก้/ป้ายสถานะบริษัท (อัปเดตจาก CompanyStatusChanged) ส่วนคะแนนดาวดึงจาก Directory ผ่าน Gateway
- รองรับสถานะพิเศษ Featured Job (อ่านสิทธิ์จาก CompanyEntitlementChanged)
- จัดการโควตาตำแหน่งแบบ Atomic: จอง (reserve) → ยืนยัน (confirm) → คืน (release) ตามคำสั่งจาก Lifecycle Service (ใช้ UPDATE แบบมีเงื่อนไขในคำสั่งเดียว)
- การปิดประกาศหยุดเฉพาะผู้สมัครใหม่ ใบสมัครที่ค้างอยู่ดำเนินต่อ
- ไม่เก็บสถานะใบสมัคร (เจ้าของ State Machine ใบสมัครคือ Lifecycle Service)
- ส่ง Event: JobSubmitted (เฉพาะบริษัทที่ติดธง), JobStatusChanged
3 Verification & Trust Service
(Trust & Report)
- Admin Queue & SLA: คิวตรวจสอบ (ประกาศของบริษัทที่ติดธง, บัญชีบริษัท, รีวิวที่ถูกติดธง, คำร้อง Report) พร้อมป้าย OVERDUE เมื่อเกิน SLA และหน้า Admin ของคิวเหล่านี้
- Anti-Abuse: นับรายงานประกาศงานและส่ง ReportThresholdReached เมื่อครบเกณฑ์ พร้อมกลไกกันการรายงานเท็จ
- เป็นเจ้าของธง UNDER_REVIEW ของบริษัท (Admin ตั้ง/เคลียร์ธงผ่าน API ของ Service นี้)
- Review Moderation: รับรีวิวที่ส่งเข้ามา (ReviewSubmitted) แล้วส่งผลเผยแพร่ด้วย ReviewModerationResult ทันที (ไม่มีการสแกนคำต้องห้าม) และดูแลคิวรายงานรีวิว
- ไม่มี Automated Pre-Screening / Risk Score / Blacklist แล้ว (ปรับ Requirement 2026-11-21)
4 Student Experience & Internship Lifecycle Service - เจ้าของ Application State Machine ทั้งหมด (ดู 5.2): สมัคร → HR ตอบรับ → นักศึกษายืนยัน → อาจารย์อนุมัติ → HR ยืนยันเริ่มงาน → ฝึกงาน → ประเมิน → จบ รวมถึงเส้นทางถอน/ถอนข้อเสนอ/ปฏิเสธ/หมดเวลา/ยุติกลางคัน และกฎห้ามสมัครซ้ำหลัง ACADEMIC_PASS
- SLA Scheduler: ตั้งเวลาเตือนและหมดอายุตามตาราง 5.3 (เตือนครั้งเดียวต่อรายการ ใช้เขตเวลา Asia/Bangkok)
- Pre-Internship Approval (Advisor Portal): คิวให้อาจารย์อนุมัติ/ไม่อนุมัติ (พร้อมเหตุผล), ตัดสินคำโต้แย้งผล FAIL, บันทึก academic_result, ติดตามนักศึกษาในความดูแล
- HR Evaluation & E-Certificate: ประเมิน (Pass/Fail), ออก E-Certificate (PDF) พร้อม Certificate ID + QR + หน้าตรวจสอบสาธารณะ + เพิกถอนได้ และดักเงื่อนไขฝึกจริง ≥ 30 วัน (ตั้งค่าได้ใน config)
- รายงานปัญหาระหว่างฝึกงาน (problem_reports) และหน้า Admin ที่เกี่ยวข้อง (ยืนยัน NO_EVALUATION, เพิกถอนใบรับรอง, พิจารณารายงาน)
- Fair Review System & Student Profile: เก็บรีวิวและเผยแพร่เมื่อผ่านการตรวจจาก Verification (5.5), โปรไฟล์/เรซูเม่, Application Tracker (Timeline จาก status_history) และดาวน์โหลด E-Certificate
- ส่ง Event: ApplicationStatusChanged, ReviewSubmitted, ReviewPublished, CertificateIssued / CertificateRevoked, ReminderDue
5 Notification Service - รับ Event จาก Message Broker แล้วแจ้งเตือนผ่าน In-App และอีเมล (ใช้ Mailpit ใน Docker Compose สำหรับการสาธิต)
- Event พกเฉพาะ user_id แล้วดึงอีเมลปลายทางจาก Identity Service (ไม่ส่งข้อมูลส่วนบุคคลไปกับ Event)
- แจ้งเตือนทุกการเปลี่ยนสถานะสำคัญ, การเตือนตาม SLA, และการแจ้งอาจารย์เมื่อเกิดเคสผิดปกติ
- ไม่มี Business Logic ของโดเมนอื่น (ทำหน้าที่รับ Event จัดเทมเพลต และส่งข้อความเท่านั้น)

4.4 เทคโนโลยีที่ใช้ (Tech Stack)

ส่วน เทคโนโลยี หมายเหตุ
Frontend Next.js (TSX) + Tailwind CSS หน้าเว็บแยกตาม Role ในแอปเดียว (apps/web) ใช้ UI Kit กลางที่แปลงชุดสีในหัวข้อ 8 เป็นธีมของ Tailwind • ตอนสาธิตส่งออกเป็น static แล้วโฮสต์บน Cloudflare Workers (ดูแถว "การ Deploy ตอนสาธิต")
Backend NestJS (TypeScript) REST API + OpenAPI, Validation ด้วย class-validator, รูปแบบ Error เดียวกันทุก Service
Message Broker RabbitMQ ตอนพัฒนารันใน Docker ในเครื่อง ตอน Deploy ใช้ CloudAMQP (แผนฟรีมีเพดานข้อความ/จำนวน connection ดู 5.12)
Database PostgreSQL (Docker) รันใน Docker Compose ทั้งตอนพัฒนาและตอนสาธิต (ไม่ใช้ Neon) — 1 instance แต่แยกฐานข้อมูลต่อ Service (identity_db, job_db, …) ตาม docker/postgres/init.sql
ORM Prisma schema.prisma ต่อ 1 Service; ตั้งทั้ง <PREFIX>_DATABASE_URL และ <PREFIX>_DIRECT_URL เป็นค่าเดียวกัน (ไม่มี connection pooler) เผื่อย้ายไปฐานข้อมูลที่ต้องแยกสองแบบภายหลัง (ดูกติกาด้านล่าง)
File Storage Cloudflare R2 (สาธิต) / RustFS (พัฒนา) ใช้ผ่าน S3 API (@aws-sdk/client-s3) สลับกันได้ด้วยค่า config (ดู 5.9) • ตอนสาธิตต้องใช้ R2 เพราะ Signed URL ต้องเปิดได้จากเบราว์เซอร์ (RustFS ในเครื่องเปิดจากเครื่องอื่นไม่ได้)
Email Mailpit SMTP จำลองใน Docker Compose ใช้ได้ทั้งตอนพัฒนาและสาธิตบนเครื่องเดียว (อีเมลอยู่ใน Mailpit ของเครื่องนั้น) • ถ้าต้องให้คนอื่นรับอีเมลจริง ตั้ง SMTP_* ชี้ไปบริการ SMTP แทน (ไม่ต้องแก้โค้ด)
Repository Monorepo (pnpm workspaces) apps/ = web, gateway, และ 5 Services; libs/ = contracts (ชนิดข้อมูล Event/DTO) และ common (Guard, Logger, Correlation ID); เอกสารอยู่ใน docs/
Testing Mocha + Chai + Sinon + c8 Unit / Integration Test ของแต่ละ Service ใช้ Mocha เป็น Test Runner (เบาและรัน process เดียว เหมาะกับเครื่องของทีม), Chai เป็น Assertion, Sinon สำหรับ Mock/Stub, c8 วัด Coverage; ทดสอบ API ด้วย supertest กับ Test Database แยกต่างหาก (Docker) ไม่ใช้ฐานข้อมูลจริง; แต่ละ Service มี .mocharc และสคริปต์ pnpm test ของตนเอง (Nest CLI สร้างโปรเจกต์มาพร้อม Jest ต้องถอดออกและตั้งค่า Mocha + ts-node แทน); UAT ในหัวข้อ 10 ยังเป็นการทดสอบด้วยมือตามเดิม
Container / CI Docker Compose / GitHub Actions CI รัน Lint, Test, Build; ทำงานผ่าน Branch + Pull Request
การ Deploy ตอนสาธิต Cloudflare Workers (Front) + Docker Compose บนเครื่องทีม (Backend) Front เป็น static บน Cloudflare Workers; Worker ทำหน้าที่ proxy /api/* ไปยัง API_ORIGIN (ตัวแปรของ Worker) ซึ่งตอนนี้ชี้ไป Cloudflare quick tunnel ที่เปิดเฉพาะ gateway (3000) ของเครื่องที่รัน Docker • ที่ลง backend ถาวรยังไม่มี: เมื่อได้แล้วเปลี่ยนแค่ API_ORIGIN ไม่ต้อง build Front ใหม่ • รายละเอียดดู docs/architecture.md §8

กฎของ Monorepo (เพื่อให้ยังเป็น Microservices จริง)

  • ห้าม import โค้ดข้าม Service ที่แชร์ได้มีเพียง libs/contracts และ libs/common
  • แต่ละ Service มี package.json, Dockerfile และ Prisma Schema ของตนเอง Build และ Deploy แยกกันได้
  • ไม่มี Foreign Key ข้ามฐานข้อมูล อ้างอิงข้าม Service ด้วย ID เท่านั้น

กติกาการใช้ Prisma และ PostgreSQL

  • รูปแบบ "UPDATE แบบมีเงื่อนไขในคำสั่งเดียว" สำหรับงานที่หลายคนทำพร้อมกัน: การจองโควตา (UPDATE ... SET reserved = reserved + 1 WHERE id = ? AND reserved < quota แล้วตรวจจำนวนแถวที่เปลี่ยน) และการเปลี่ยนสถานะ (updateMany ที่ where สถานะเดิม; ถ้าจำนวนแถวเป็น 0 แปลว่ามีคนเปลี่ยนไปก่อน) เพื่อไม่ต้องล็อกแถว
  • Migration ใช้ <PREFIX>_DIRECT_URL ส่วนแอปที่รันจริงใช้ <PREFIX>_DATABASE_URL — ตอนนี้ทั้งสองชี้ Postgres ใน Docker ตัวเดียวกัน ไม่มี connection pooler
  • ไม่พึ่งฟีเจอร์ระดับ Session เช่น LISTEN/NOTIFY (ใช้ RabbitMQ แทน) เพื่อให้ย้ายไปใช้ตัวรวม connection หรือฐานข้อมูลแบบ Managed ภายหลังได้โดยไม่ต้องแก้โค้ด
  • ข้อมูลอยู่ใน Docker volume ของเครื่องเดียว ควร pg_dump สำรองเป็นระยะ และไม่เปิดพอร์ต Postgres ออกนอกเครื่อง

5. กลไกการตรวจสอบงานและลำดับการอนุมัติฝึกงาน (Verification & Approval Pipeline)

5.1 การเผยแพร่ประกาศงานและ Tag ทักษะ (Job Publishing & Skill Tags)

ปรับ Requirement 2026-11-21: ตัดระบบสแกนคำต้องห้าม (Blacklist), Risk Score, คิวเขียว/เหลือง/แดง, AUTO_REJECTED และการอุทธรณ์ออกทั้งหมด ประกาศงานเผยแพร่ทันที และใช้ Tag ทักษะ (เช่น NextJs, NestJs, Rust) แทน ส่วน การรายงาน (Report) ประกาศงาน/รีวิว และ ธงบริษัท UNDER_REVIEW ยังคงอยู่

[HR กดสร้าง/ส่งประกาศงาน (บัญชีบริษัทต้องเป็น VERIFIED และกรอกข้อมูลบังคับครบตาม 5.1.5)]
       │
       ├── บริษัทไม่ถูกติดธง UNDER_REVIEW ───────────────► [PUBLISHED] (Job Management เปลี่ยนสถานะเอง ขึ้นหน้าเว็บทันที)
       │
       └── บริษัทถูกติดธง UNDER_REVIEW (ดู 5.1.4)
              │  สถานะ VERIFYING ชั่วครู่ (ซ่อนจากหน้าค้นหา) + ส่ง JobSubmitted ให้ Verification
              ▼
           [PENDING_REVIEW] (เข้าคิว Platform Admin — ตอบกลับด้วย JobVerified)
              ├─ อนุมัติ ──► PUBLISHED
              └─ ปฏิเสธ ──► ADMIN_REJECTED
              (Verification ไม่ตอบใน 5 นาที ⇒ Job Management ตั้ง PENDING_REVIEW เอง: Fail-safe ไม่ Publish เอง)

หมายเหตุ:

  • Verification Service ไม่ตัดสินคุณภาพเนื้อหาประกาศอีกต่อไป หน้าที่ของ Service นี้เหลือ: คิวตรวจของ Admin (ประกาศของบริษัทที่ติดธง, รายงานประกาศ, รายงานรีวิว, ธงบริษัท), นับรายงานและส่ง ReportThresholdReached, และเป็นเจ้าของธง UNDER_REVIEW
  • Job Management Service เป็นเจ้าของฟิลด์สถานะประกาศงาน — เปลี่ยนสถานะเองเมื่อเผยแพร่ทันที และเปลี่ยนตาม Event JobVerified ในกรณีบริษัทติดธง แล้วส่ง JobStatusChanged ทุกครั้ง
  • ค่า enum AUTO_REJECTED ยังสงวนไว้ในระบบเพื่อความเข้ากันได้ของข้อมูลเดิม แต่ ไม่มีเส้นทางไปสถานะนี้อีก (ไม่มีคะแนนและไม่มีคำต้องห้ามให้ตีกลับ)

5.1.0 Tag ทักษะ (Skill Tags)

  • Tag คือป้ายทักษะ/เทคโนโลยีที่ประกาศงานต้องการ เช่น NextJs, NestJs, Rust, Figma, SQL ใช้บอกความยากง่ายและทักษะที่ต้องมีให้นักศึกษาและอาจารย์เห็นในการ์ดประกาศและหน้ารายละเอียด และใช้กรองในหน้าค้นหา (?tags= ตรงกับ Tag ใดก็ได้ที่ระบุ)
  • รายการ Tag กลางจัดการโดย Platform Admin (เพิ่ม / แก้ชื่อที่แสดง / ปิดใช้งาน) HR เลือกจากรายการกลางเท่านั้น ไม่พิมพ์เอง เพื่อไม่ให้เขียนต่างกัน (NextJs กับ Next.js) ชื่อ Tag ไม่ซ้ำกันโดยไม่สนตัวพิมพ์ใหญ่เล็ก
  • ประกาศงานหนึ่งฉบับมี Tag อย่างน้อย 1 และไม่เกิน 10 (ดู 5.1.5) Tag ที่ถูกปิดใช้งานจะไม่ขึ้นให้เลือกใหม่ แต่ประกาศเดิมที่ติด Tag นั้นไว้ยังแสดงตามเดิม
  • Tag เป็น ข้อมูลเชิงโครงสร้าง (ดู 5.1.2) แก้ไขได้โดยไม่กระทบสถานะประกาศ

5.1.1 สถานะของประกาศงาน (Job Status)

สถานะ ความหมาย แสดงในหน้าค้นหา
DRAFT HR กำลังร่าง ยังไม่ส่ง ไม่แสดง
VERIFYING (เฉพาะบริษัทที่ติดธง UNDER_REVIEW) รอ Verification ตอบกลับ ไม่แสดง
PUBLISHED เผยแพร่แล้ว เปิดรับสมัคร แสดง
PENDING_REVIEW รอ Admin ตัดสิน (บริษัทที่ติดธง UNDER_REVIEW / Fail-safe) ไม่แสดง
AUTO_REJECTED เลิกใช้ (สงวนค่าไว้ ไม่มีเส้นทางไปสถานะนี้) ไม่แสดง
ADMIN_REJECTED Admin ปฏิเสธประกาศที่รอตรวจ (ผลสิ้นสุดของการส่งครั้งนั้น; HR แก้ไขแล้วส่งใหม่ได้) ไม่แสดง
SUSPENDED ถูกระงับชั่วคราวจากการถูกรายงานครบเกณฑ์ รอ Admin ชี้ขาด ไม่แสดง
REMOVED Admin ยืนยันระงับถาวร ไม่แสดง
CLOSED HR ปิดรับหรือหมดเขตรับสมัคร ไม่แสดง

5.1.2 กติกาการแก้ไขประกาศงานและผลต่อใบสมัคร

ประเภทฟิลด์ที่แก้ไข ตัวอย่าง ผลที่เกิดขึ้น
ข้อความอิสระ job_title, description, หน้าที่รับผิดชอบ, เบี้ยเลี้ยง, คุณสมบัติ, ช่องทางติดต่อ งานยังคง PUBLISHED ไม่มีการตรวจซ้ำ ยกเว้น บริษัทที่ติดธง UNDER_REVIEW ต้องส่งผ่านขั้นตอนของธงอีกครั้ง (VERIFYING → PENDING_REVIEW)
ฟิลด์เชิงโครงสร้าง วันปิดรับ, quota, target_majors, Tag ทักษะ แก้ไขได้โดยงานยังคง PUBLISHED
สายงาน (category) TECH_IT, BUSINESS_MARKETING, CORPORATE_SERVICES แก้ได้เฉพาะตอนเป็น DRAFT หลังส่งครั้งแรกส่งค่าเดิมได้ แต่ส่งสายงานอื่น ⇒ 400 VALIDATION_FAILED (details[].issue = CATEGORY_LOCKED) ถ้าจะเปลี่ยนสายงานให้ปิดประกาศเดิมแล้วสร้างใหม่ — เพราะ Lifecycle ใช้สายงานของประกาศจำกัดสิทธิ์ HR Member และการแก้ที่ไม่เปลี่ยนสถานะไม่มี E03 ส่งไปอัปเดต (PM ตัดสิน 2026-11-22)

ผลต่อใบสมัครที่มีอยู่เมื่อประกาศถูกซ่อนหรือถูกปฏิเสธ

  • งานเป็น VERIFYING / PENDING_REVIEW / SUSPENDED: ใบสมัครที่ค้างอยู่ถูก Freeze (ไม่ถูกลบ ไม่เปลี่ยนสถานะ) และตัวนับเวลา SLA ของ HR หยุดชั่วคราว นักศึกษาใหม่สมัครไม่ได้
  • งานเป็น ADMIN_REJECTED / REMOVED: ใบสมัครที่ ยังไม่ถึง ADVISOR_APPROVED จะถูกยกเลิกเป็น CANCELLED (ระบุเหตุผลว่างานถูกตีกลับ/ระงับถาวร) พร้อมแจ้งนักศึกษาและอาจารย์ที่ปรึกษา และคืนโควตาที่จองไว้ ส่วนใบสมัครที่ผ่านขั้น ADVISOR_APPROVED แล้ว (รวม IN_PROGRESS) จะ ติดธงเตือนให้อาจารย์พิจารณา ไม่ถูกยกเลิกอัตโนมัติ
  • งานกลับเป็น PUBLISHED (เช่น Admin ยกคำร้อง/อนุมัติ): ใบสมัครที่ Freeze ไว้ดำเนินต่อและตัวนับ SLA กลับมาทำงาน
  • งานเป็น CLOSED (HR ปิดรับหรือหมดเขต): หยุดเฉพาะการรับผู้สมัครใหม่ ใบสมัครที่ค้างอยู่ไม่ถูกกระทบ และดำเนินต่อตามปกติ (HR ยังตอบรับผู้สมัครเดิมได้ตราบที่โควตายังเหลือ)

5.1.3 การรายงานประกาศงานและการระงับอัตโนมัติ (Report & Auto-Suspend)

  • นักศึกษา 1 คนรายงานประกาศเดียวกันได้ 1 ครั้ง (แม้หลังรีเซ็ตตัวนับ) และรายงานได้ไม่เกิน 5 ครั้งต่อวัน โดยต้องเลือกหมวดเหตุผลและเขียนรายละเอียด
  • เมื่อมี นักศึกษา 3 บัญชี รายงานประกาศเดียวกัน Verification ส่ง ReportThresholdReached ให้ Job Management เปลี่ยนงานเป็น SUSPENDED ทันที เข้าคิว Admin และแจ้งอาจารย์ที่ปรึกษาของนักศึกษาที่มีใบสมัครกับประกาศนั้น
  • กันการรายงานเท็จ: หากรายงานของนักศึกษาคนใดถูก Admin ยกคำร้อง 3 ครั้งติดต่อกัน รายงานถัดไปของคนนั้นจะไม่ถูกนับเข้าเกณฑ์ระงับอัตโนมัติ (แต่ยังเข้าคิว Admin ให้พิจารณา)
  • Admin ยกคำร้อง: งานกลับเป็น PUBLISHED ทันทีและตัวนับรายงานรีเซ็ต Admin ยืนยันระงับถาวร: งานเป็น REMOVED และใช้กติกาผลต่อใบสมัครตาม 5.1.2
  • เมื่อไม่มีการสแกนคำต้องห้าม การรายงานเป็นกลไกหลักในการจัดการประกาศที่ไม่เหมาะสม (รวมถึงประกาศที่แอบแฝงช่องทางติดต่อส่วนตัว)

5.1.4 การยกระดับไปสู่การตรวจบัญชีบริษัท

หากประกาศงานของบริษัทเดียวกันถูก ADMIN_REJECTED / SUSPENDED / REMOVED รวมกัน ครบ 3 ครั้งภายใน 30 วัน (ตั้งค่าได้ใน config) Verification Service จะติดธง UNDER_REVIEW ให้บริษัท (Verification เป็นเจ้าของธงนี้) และเข้าคิวให้ Admin ตรวจบัญชี ระหว่างนั้น ประกาศใหม่และการแก้ข้อความอิสระของบริษัทนั้นทุกครั้งต้องผ่าน Admin (ตามแผนผัง 5.1) จนกว่า Admin จะเคลียร์ธง หรือสั่ง SUSPENDED บัญชี (ซึ่งทำที่ Identity Service) Admin ตั้ง/เคลียร์ธงผ่านหน้า Admin ที่เรียก API ของ Verification

5.1.5 ข้อมูลบังคับของประกาศงาน

  • ข้อมูลที่ HR ต้องกรอกก่อนส่ง: ชื่อตำแหน่ง, สายงาน (Tech & IT / Business & Marketing / Corporate Services), Tag ทักษะ 1–10 รายการ, สถานที่ฝึกและรูปแบบ (On-site / Remote / Hybrid), ชั่วโมงฝึกต่อสัปดาห์, เบี้ยเลี้ยง (ระบุจำนวนเงิน หรือเลือก "ไม่มีเบี้ยเลี้ยง"), ช่วงเวลาฝึก, หน้าที่รับผิดชอบ, คุณสมบัติ, target_majors, quota และวันปิดรับ ระบบไม่ให้ส่งจนกว่าจะครบ
  • ช่องทางติดต่อ: ผู้สมัครติดต่อบริษัทผ่านแพลตฟอร์มเท่านั้น ห้ามใส่ช่องทางติดต่อส่วนตัวในประกาศ (ไม่มีการสแกนอัตโนมัติ ใช้การรายงานตาม 5.1.3)
  • สิทธิ์จัดการประกาศตามสายงาน: สมาชิก HR จัดการได้เฉพาะประกาศของ สายงานที่ Owner กำหนดให้ (ดู 5.6) Owner จัดการได้ทุกสายงาน

5.2 ลำดับขั้นตอนการอนุมัติฝึกงานและการออก E-Certificate (End-to-End Flow)

Lifecycle Service เป็นเจ้าของ State Machine ของใบสมัครแต่เพียงผู้เดียว (ส่วนโควตาตำแหน่งอยู่ที่ Job Management Service เรียกผ่าน API)

0. [อาจารย์] เพิ่มนักศึกษาด้วยฟอร์ม (นักศึกษาผูกกับอาจารย์เป็น LINKED ทันที) และ [นักศึกษา] ตั้งรหัสผ่านจากอีเมลคำเชิญ แล้วต้องไม่มีสิทธิ์ถูกบล็อกจากกฎสมัครซ้ำ (ดู 5.2.2)

1. [นักศึกษา] ส่งใบสมัคร ─────────────────────────────────► PENDING
       │   (HR ปฏิเสธ → HR_REJECTED | นักศึกษาถอน → WITHDRAWN | HR ไม่ตอบ 14 วัน → EXPIRED)
       │
2. [HR] ตอบรับพร้อมระบุ start_date / end_date (ห่างกัน ≥ 30 วัน)
       │   ───────────────────────────────────────────────► HR_ACCEPTED   (ระบบจองโควตา)
       │   (นักศึกษาปฏิเสธ → STUDENT_DECLINED | ไม่ยืนยันใน 5 วัน → EXPIRED | ทั้งสองกรณีคืนโควตา)
       │
3. [นักศึกษา] ยืนยันรับข้อเสนอ ───────────────────────────► ADVISOR_PENDING
       │   (ข้อเสนออื่นของนักศึกษาที่ยัง HR_ACCEPTED ถูกปฏิเสธอัตโนมัติ → STUDENT_DECLINED + คืนโควตา)
       │
4. [อาจารย์] ตรวจความตรงสายและอนุมัติ ───────────────────► ADVISOR_APPROVED
       │   (ไม่อนุมัติ + ระบุเหตุผล → ADVISOR_REJECTED + คืนโควตา)
       │   (เมื่ออนุมัติ ใบสมัครอื่นของนักศึกษาที่ยัง PENDING ถูกถอนอัตโนมัติ → WITHDRAWN)
       │   (HR ไม่ยืนยันเริ่มงานเกิน 14 วันหลัง start_date → EXPIRED + คืนโควตา)
       │
5. [HR] กดยืนยันว่านักศึกษาเริ่มงานจริง (บันทึก actual_start_date และปรับ start/end ได้)
       │   ───────────────────────────────────────────────► IN_PROGRESS   (ยืนยันโควตา)
       │   (ยุติกลางคัน โดย HR / นักศึกษา / อาจารย์ / Admin พร้อมเหตุผล → TERMINATED)
       │
6. [ถึง end_date] [HR] ประเมินผล ────────────────────────► EVALUATED_PASS  หรือ  EVALUATED_FAIL
       │   PASS: HR กดออก E-Certificate (PDF) ได้เมื่อฝึกจริง ≥ 30 วัน
       │   FAIL: ต้องระบุเหตุผล → นักศึกษาโต้แย้งได้ภายใน 7 วัน (ดู 5.2.2)
       │
7. [นักศึกษา] ดาวน์โหลด E-Certificate และเขียนรีวิวบริษัท
   [อาจารย์] บันทึกผลทางวิชาการ (academic_result) ───────► COMPLETED

5.2.1 สถานะของใบสมัคร (Application Status)

กลุ่ม สถานะ ความหมาย
ดำเนินอยู่ PENDING นักศึกษาส่งใบสมัคร รอ HR
HR_ACCEPTED HR ส่งข้อเสนอพร้อมวันเริ่ม-สิ้นสุด (จองโควตาแล้ว) รอนักศึกษายืนยัน
ADVISOR_PENDING นักศึกษายืนยันแล้ว รออาจารย์อนุมัติ
ADVISOR_APPROVED อาจารย์อนุมัติ รอ HR ยืนยันว่านักศึกษาเริ่มงานจริง
IN_PROGRESS กำลังฝึกงาน
EVALUATED_PASS / EVALUATED_FAIL HR ประเมินแล้ว
FAIL_DISPUTED นักศึกษาโต้แย้งผล FAIL รออาจารย์ตัดสิน
REEVALUATION_REQUESTED อาจารย์สั่งให้ HR ประเมินใหม่ (ได้ 1 รอบ)
ปลายทาง COMPLETED อาจารย์บันทึก academic_result แล้ว (ACADEMIC_PASS / ACADEMIC_FAIL / REPEAT_REQUIRED)
TERMINATED ยุติกลางคัน (เก็บ terminated_by = COMPANY / STUDENT / ADVISOR / ADMIN และเหตุผล)
NO_EVALUATION บริษัทไม่ประเมินและ Admin ยืนยันแล้วว่าติดตามบริษัทแล้ว
HR_REJECTED / STUDENT_DECLINED / ADVISOR_REJECTED ถูกปฏิเสธในแต่ละขั้น
OFFER_RESCINDED HR ถอนข้อเสนอก่อนนักศึกษาเริ่มฝึก พร้อมเหตุผล
WITHDRAWN นักศึกษาถอนใบสมัคร หรือถูกถอนอัตโนมัติเมื่ออาจารย์อนุมัติใบสมัครอื่น
EXPIRED หมดเวลาตอบตาม SLA
CANCELLED ประกาศงานถูกตีกลับ/ระงับถาวร (ดู 5.1.2)

5.2.2 กติกาสำคัญของ Flow

  • นักศึกษายืนยันได้ทีละ 1 ที่: ขณะนักศึกษามีใบสมัครที่ยืนยันแล้วและยังไม่สิ้นสุด (ADVISOR_PENDING, ADVISOR_APPROVED, IN_PROGRESS) ปุ่มตอบรับของ HR ที่อื่นจะถูกปิดและแสดงข้อความว่าผู้สมัครกำลังอยู่ในกระบวนการอนุมัติกับที่อื่น (HR ยังปฏิเสธได้) หากกระบวนการเดิมล้มเลิก (เช่น ADVISOR_REJECTED) ปุ่มจะกลับมาใช้ได้
  • นักศึกษาถอนใบสมัคร: ทำได้ในสถานะ PENDING, ADVISOR_PENDING และ ADVISOR_APPROVED → WITHDRAWN (ถ้ามีโควตาที่จองไว้ให้คืน และแจ้ง HR กับอาจารย์) ใน HR_ACCEPTED ใช้การปฏิเสธข้อเสนอ (STUDENT_DECLINED) เมื่อเข้าสู่ IN_PROGRESS แล้วต้องใช้การขอยุติกลางคัน (TERMINATED) แทน
  • HR ถอนข้อเสนอ (OFFER_RESCINDED): HR ถอนได้ในสถานะ HR_ACCEPTED, ADVISOR_PENDING และ ADVISOR_APPROVED (ก่อนกดยืนยันเริ่มงาน) ต้องระบุเหตุผล ระบบคืนโควตา แจ้งนักศึกษากับอาจารย์ที่ปรึกษา และนับเข้าสถิติของบริษัทที่ Admin เห็น (ถอนบ่อยผิดปกติใช้เป็นสัญญาณตรวจสอบ)
  • HR ปรับวันที่ตอนยืนยันเริ่มงาน: ตอนกด IN_PROGRESS HR บันทึก actual_start_date และปรับ start_date / end_date ได้ตามจริง ระบบแจ้งนักศึกษาและอาจารย์ที่ปรึกษา และยังตรวจว่า end_date − actual_start_date ≥ 30 วัน (ถ้าสั้นกว่านี้จะแจ้งว่าจะไม่มีสิทธิ์รับ E-Certificate)
  • ADVISOR_APPROVED ค้าง: ถ้า HR ไม่กดยืนยันเริ่มงานภายใน 14 วันหลัง start_date ใบสมัครเป็น EXPIRED และคืนโควตา ก่อนถึงจุดนั้นระบบเตือน HR และแจ้งอาจารย์/Admin ตามตาราง 5.3
  • ลดการปฏิเสธเปล่าของอาจารย์: ประกาศงานมี target_majors เมื่อสาขาของนักศึกษาไม่ตรง ระบบเตือนนักศึกษาและแสดงป้ายให้ HR/อาจารย์เห็นตั้งแต่ตอนสมัคร
  • โควตา: จองตอน HR_ACCEPTED → ยืนยันตอน IN_PROGRESS → คืนเมื่อสถานะหลุดไปเป็น STUDENT_DECLINED / ADVISOR_REJECTED / OFFER_RESCINDED / WITHDRAWN / EXPIRED / CANCELLED / TERMINATED (ก่อนเริ่มงาน) เมื่อโควตาเต็ม HR กดตอบรับเพิ่มไม่ได้ (นักศึกษายังสมัครได้จนปิดรับ) Lifecycle เรียก API ของ Job Management ซึ่งทำงานแบบ Atomic และรองรับการเรียกซ้ำด้วย application_id (ดู 5.8)
  • การประเมินและการออกใบรับรอง:
    • ปุ่มประเมินเปิดเมื่อถึง end_date (หรือเมื่อมีการยุติ) และตอนส่งข้อเสนอ ระบบตรวจว่า end_date − start_date ≥ 30 วัน (ตั้งค่าได้ใน config)
    • E-Certificate ออกได้เฉพาะกรณีระยะฝึกจริง (actual_start_date ถึงวันสิ้นสุดจริง) ≥ 30 วัน เพื่อกันการปั๊มใบเซอร์
  • เส้นทาง FAIL:
    1. HR ต้องระบุเหตุผลประกอบ FAIL
    2. นักศึกษาโต้แย้งได้ภายใน 7 วัน → FAIL_DISPUTED → อาจารย์พิจารณา และสั่งให้ HR ประเมินใหม่ได้ 1 รอบ (REEVALUATION_REQUESTED)
    3. หลังจบขั้นตอนข้างต้น (หรือไม่มีการโต้แย้งภายใน 7 วัน) อาจารย์บันทึก academic_result เป็น ACADEMIC_FAIL หรือ REPEAT_REQUIRED — อาจารย์เปลี่ยนผล FAIL ของบริษัทเป็น PASS เองไม่ได้
  • ยุติกลางคัน (TERMINATED): ต้องระบุเหตุผลและแจ้งอาจารย์ ผู้ยุติได้คือ HR, นักศึกษา, อาจารย์ และ Admin (เช่น พบว่าบริษัทหลอกลวง) หากฝึกจริงไม่ถึง 30 วัน จะ ไม่มี E-Certificate และอาจารย์ตัดสิน academic_result เอง; หากฝึกครบ ≥ 30 วันก่อนยุติ HR ยังประเมินและออกใบรับรองตามระยะฝึกจริงได้
  • รายงานปัญหาระหว่างฝึกงาน (Problem Report): นักศึกษาที่อยู่ในสถานะ IN_PROGRESS กดรายงานปัญหา (เช่น ถูกใช้งานนอกขอบเขต ไม่ปลอดภัย ถูกเรียกเก็บเงิน) ได้ ระบบส่งถึง อาจารย์ที่ปรึกษาและ Admin พร้อมกัน โดย บริษัทมองไม่เห็นรายงาน รายงานมีสถานะ OPEN → ACKNOWLEDGED → RESOLVED ผู้พิจารณาเลือกดำเนินการต่อได้ เช่น ติดตามบริษัท ยุติการฝึก (TERMINATED) หรือส่งต่อเป็นการตรวจบัญชีบริษัท การรายงานไม่เปลี่ยนสถานะใบสมัครเอง
  • ไม่ให้สมัครซ้ำหลังผ่านวิชา: นักศึกษาที่มี academic_result = ACADEMIC_PASS ถือว่าฝึกงานสำเร็จแล้ว สมัครงานใหม่ไม่ได้ (Admin ปลดล็อกเป็นรายกรณีได้) ส่วน ACADEMIC_FAIL / REPEAT_REQUIRED สมัครใหม่ได้ ปุ่มสมัครแสดงเหตุผลที่ถูกบล็อก
  • บริษัทไม่ประเมินผล: หลังเตือนและครบ 14 วัน ระบบแจ้งอาจารย์และ Admin เมื่อ Admin ยืนยันว่าติดตามบริษัทแล้ว สถานะเป็น NO_EVALUATION อาจารย์บันทึก academic_result ได้เอง (ไม่มี E-Certificate) ใช้ได้กับ 3 กรณี: IN_PROGRESS (นับจาก end_date), TERMINATED ที่ฝึกจริง ≥ 30 วัน (นับจาก actual_end_date) และ REEVALUATION_REQUESTED ที่ HR ไม่ประเมินใหม่ (นับจากวันที่อาจารย์สั่ง)
  • ผ่านแต่ยังไม่ออกใบรับรอง: ถ้า EVALUATED_PASS แล้ว HR ไม่กดออก E-Certificate (ทั้งที่ฝึกครบ ≥ 30 วัน) ระบบเตือน HR วันที่ 3 และแจ้ง Admin วันที่ 14
  • บริษัทถูกระงับขณะนักศึกษากำลังฝึก (IN_PROGRESS): ระบบไม่ตัดการฝึกอัตโนมัติ แต่ปิดประกาศงานและการสมัครใหม่ทันที แจ้งอาจารย์และนักศึกษา แล้วให้อาจารย์ตัดสินใจว่า ฝึกต่อ หรือ ยุติ (TERMINATED โดย ADVISOR) Lifecycle รับรู้จาก Event CompanyStatusChanged

5.3 กำหนดเวลาตอบกลับ (SLA & Timeout)

ค่าเริ่มต้นด้านล่างนับเป็นวันตามปฏิทิน เขตเวลา Asia/Bangkok และปรับได้ผ่าน config กลาง

จุดที่รอ เตือน เมื่อเกินกำหนด
HR ตอบใบสมัคร (PENDING) วันที่ 3 และ 7 EXPIRED วันที่ 14
นักศึกษายืนยันข้อเสนอ (HR_ACCEPTED) วันที่ 3 EXPIRED วันที่ 5 และคืนโควตา
อาจารย์อนุมัติ (ADVISOR_PENDING) วันที่ 3 แจ้ง Admin วันที่ 7 (ไม่อนุมัติอัตโนมัติ)
HR ยืนยันเริ่มงาน (ADVISOR_APPROVED) ในวัน start_date และอีก 3 วันถัดมา แจ้งอาจารย์และ Admin เมื่อเกิน 7 วันหลัง start_date; EXPIRED และคืนโควตาเมื่อเกิน 14 วัน
HR ประเมินผล (หลัง end_date) และการประเมินซ้ำ วันที่ 3 แจ้งอาจารย์และ Admin วันที่ 14 → เข้าเส้นทาง NO_EVALUATION
HR ออก E-Certificate (หลัง EVALUATED_PASS ที่ฝึกครบ ≥ 30 วัน) วันที่ 3 แจ้ง Admin วันที่ 14
นักศึกษาโต้แย้ง FAIL — หน้าต่างรับโต้แย้ง 7 วัน หลังจากนั้นไม่รับ
อาจารย์ตัดสินคำโต้แย้ง (FAIL_DISPUTED) วันที่ 3 แจ้ง Admin วันที่ 7
Admin Queue (ประกาศของบริษัทที่ติดธง, บัญชีบริษัท, คำร้อง Report ประกาศ/รีวิว, รายงานปัญหาระหว่างฝึกงาน) — คิวปกติ 48 ชั่วโมง / Fast-Track 12 ชั่วโมง เกินกำหนดขึ้นป้าย OVERDUE สีแดง
  • ตัวนับเวลาของ HR ถูกพักขณะประกาศงานอยู่ในสถานะที่ซ่อน (VERIFYING / SUSPENDED) ตาม 5.1.2
  • Scheduler ต้อง idempotent: ทุกการเตือนและการหมดอายุบันทึกลงตาราง reminder_log ที่มี Unique Key (entity_id, type, due_date) โดย เขียนแถวก่อนแล้วจึงส่ง จึงไม่เกิดการเตือนซ้ำแม้ Scheduler ทำงานซ้อนหรือรันใหม่หลังล่ม
  • Scheduler ตรวจทุก 15 นาที (ค่าตั้งได้ใน config)
  • ผลของการหมดเวลา (EXPIRED) เป็นการเปลี่ยนสถานะโดย Lifecycle เอง ส่วน "การเตือน" ส่งเป็น Event ReminderDue ให้ Notification Service

5.4 การตรวจสอบความถูกต้องของ E-Certificate

  • ใบรับรองทุกใบมี Certificate ID และ QR Code ชี้ไปหน้าตรวจสอบสาธารณะ (ไม่ต้องล็อกอิน) ซึ่งแสดง เฉพาะ สถานะ VALID / REVOKED, ชื่อนักศึกษา, บริษัท, ตำแหน่ง และช่วงเวลาฝึก โดย ไม่แสดงอีเมล เบอร์โทร รหัสนักศึกษา หรือข้อมูลติดต่อใดๆ และไม่ให้เครื่องมือค้นหา Index หน้านี้ (noindex) พร้อมจำกัดอัตราการเรียกต่อ IP เพื่อกันการไล่ค้น ID
  • ระบบเก็บ SHA-256 ของไฟล์ PDF ที่ออกไว้ เพื่อใช้ตรวจว่าไฟล์ไม่ถูกแก้ไข ไฟล์ PDF เก็บใน Private Bucket และดาวน์โหลดผ่าน Signed URL อายุสั้น (ดู 5.9)
  • เพิกถอน (Revoke): HR เพิกถอนใบที่บริษัทตนออกได้พร้อมระบุเหตุผล และ Admin เพิกถอนได้ทุกใบ (เช่น พบว่าบริษัทหลอกลวงหรือออกใบผิดพลาด) หน้าตรวจสอบจะแสดง REVOKED ทันที
  • เมื่อผู้ใช้ลบบัญชี ใบรับรองยังตรวจสอบได้ แต่ชื่อแสดงเป็น "ผู้ใช้ที่ลบบัญชีแล้ว" (ดู 5.11)

5.5 กติกาการรีวิวบริษัท

  • สิทธิ์เขียน: เขียนได้เมื่อ HR ประเมินผลแล้ว (EVALUATED_PASS / EVALUATED_FAIL เป็นต้นไป) หรือเมื่อการฝึกสิ้นสุดแบบ TERMINATED / NO_EVALUATION โดยจำกัด 1 รีวิวต่อ 1 การฝึกงาน
  • ป้ายกำกับ: แสดงผลการฝึกประกอบรีวิว (PASS / FAIL / ยุติก่อนกำหนด / บริษัทไม่ได้ประเมิน) เพื่อป้องกันการปิดปากนักศึกษา (Review Silencing)
  • Moderation: Lifecycle เก็บรีวิวสถานะ SUBMITTED แล้วส่ง ReviewSubmitted ให้ Verification ซึ่งตอบด้วย ReviewModerationResult ให้เผยแพร่ทันทีโดย ไม่สแกนเนื้อหา (ตัดระบบคำต้องห้ามออกแล้ว ปรับ Requirement 2026-11-21) รีวิวจึงเป็น PUBLISHED และส่ง ReviewPublished ให้ Directory อัปเดตคะแนนรวมของบริษัท ผู้ใช้กด Report รีวิวได้ และ Admin พิจารณาในคิวของ Verification (ลบรีวิวได้ด้วย ADMIN_REMOVE) สถานะ HELD เลิกใช้ (สงวนค่าไว้ ไม่มีเส้นทางไปสถานะนี้)
  • บริษัทตอบกลับ: HR ตอบกลับรีวิวสาธารณะได้ 1 ครั้งต่อรีวิว
  • ไม่ระบุชื่อ: นักศึกษาเลือกแสดงรีวิวแบบไม่ระบุชื่อได้ (แสดงเฉพาะสาขาและชั้นปี)

5.6 การจัดการบัญชี บริษัท และอาจารย์ที่ปรึกษา

ทั้งหมดอยู่ใน Identity & Organization Service

เกณฑ์ที่ Admin ใช้อนุมัติบัญชีบริษัท

  • เลขทะเบียนนิติบุคคลพร้อมเอกสารรับรอง
  • อีเมลโดเมนขององค์กร (ไม่รับอีเมลสาธารณะ เช่น Gmail/Hotmail) และต้องยืนยันอีเมลแล้ว
  • เว็บไซต์หรือเบอร์โทรติดต่อของบริษัท
  • ผลการพิจารณา: VERIFIED / NEED_MORE_INFO (ขอเอกสารเพิ่ม) / REJECTED พร้อมเหตุผลแจ้งกลับ
  • ทุกครั้งที่สถานะบริษัทเปลี่ยน Identity ส่ง CompanyStatusChanged พร้อม Snapshot ชื่อ โลโก้ และป้ายสถานะ เพื่อให้ Job Management ใช้แสดงผลโดยไม่ต้องเรียกข้าม Service ทุกครั้ง

ทีม HR ของบริษัทและการโอน Owner- ผู้ลงทะเบียนคนแรกเป็น Owner เชิญ HR Member เข้ามาได้ และ กำหนดสายงานให้สมาชิก (Tech & IT / Business & Marketing / Corporate Services เลือกได้ 1–3 สายต่อคน; Owner เปลี่ยนภายหลังได้) Owner เป็นผู้จัดการสมาชิกและเห็นข้อมูลระดับบริษัท

  • สิทธิ์ตามสายงาน: สมาชิกสร้าง/แก้ไข/ปิดประกาศและดูผู้สมัคร/ดำเนินการกับใบสมัครได้ เฉพาะประกาศที่อยู่ในสายงานของตน (รายการประกาศและผู้สมัครถูกกรองให้อัตโนมัติ; ถ้าไม่อยู่ในสาย ⇒ 403 FORBIDDEN_ROLE (details[].issue = FORBIDDEN_CATEGORY)) ส่วน Owner จัดการได้ทุกสายงาน สายงานของสมาชิกอยู่ใน JWT (company_categories) และมีผลหลัง refresh หรือล็อกอินใหม่เหมือน company_role
  • โอนสิทธิ์ Owner: Owner เลือกโอนให้ HR Member ในบริษัทเดียวกันได้ ผู้รับต้องกดยืนยัน เมื่อสำเร็จ Owner เดิมกลายเป็น Member
  • บริษัทไม่มี Owner (เช่น Owner ลาออกหรือลบบัญชี): Admin แต่งตั้ง Owner ใหม่ได้หลังตรวจสอบความเกี่ยวข้อง ระหว่างนั้นสมาชิกที่เหลือทำงานเดิมได้แต่จัดการสมาชิกไม่ได้
  • ทุกการโอนและแต่งตั้งบันทึกใน Audit Log (5.10)

ป้าย University Partner และสิทธิ์พิเศษ

  • Admin ติดป้าย University Partner ให้บริษัทที่มีข้อตกลง (MOU) กับมหาวิทยาลัย เก็บเป็นฟิลด์ของบริษัทที่ Identity และแสดงบนการ์ดงานกับหน้า Directory ผ่านข้อมูล Snapshot
  • สิทธิ์ featured_enabled / fast_track_enabled ที่ Admin เปิดให้ (จำลองการชำระเงิน) เก็บในบริษัทเช่นกัน และเผยแพร่ด้วย CompanyEntitlementChanged ให้ Job Management (ป้าย Featured) และ Verification (ลำดับคิว) นำไปใช้ — Fast-Track เปลี่ยนเฉพาะลำดับในคิว

อาจารย์ที่ปรึกษา

  • อาจารย์สมัครด้วย @ac.th ยืนยันอีเมล และรอ Admin อนุมัติ; อาจารย์คนเดียวกันทำหน้าที่ทั้งที่ปรึกษาและดูแลรายวิชาฝึกงาน
  • อาจารย์เพิ่มนักศึกษาด้วยฟอร์ม (ปรับ Requirement 2026-11-21): นักศึกษา ไม่สมัครสมาชิกเอง อาจารย์ที่ ACTIVE กรอก อีเมล @ac.th (มหาวิทยาลัยเดียวกับอาจารย์), ชื่อ-นามสกุล, รหัสนักศึกษา, สาขา, ชั้นปี → ระบบสร้างบัญชี STUDENT ส่งอีเมลคำเชิญ (ลิงก์ใช้ได้ครั้งเดียว อายุ 7 วัน) ให้นักศึกษาตั้งรหัสผ่านและยอมรับนโยบายความเป็นส่วนตัว แล้วบัญชีเป็น ACTIVE และผูกกับอาจารย์ผู้สร้างเป็น LINKED ตั้งแต่ตอนสร้าง (Identity ส่ง AdvisorLinkChanged) อาจารย์ส่งคำเชิญซ้ำหรือยกเลิกคำเชิญที่ยังไม่ถูกใช้ได้ อีเมลซ้ำกับบัญชีที่มีอยู่ ⇒ 409 STATE_CONFLICT (EMAIL_ALREADY_REGISTERED) ไม่มีขั้นที่นักศึกษาเลือกอาจารย์และไม่มีการสมัครสมาชิกนักศึกษา
  • เปลี่ยนอาจารย์: Admin ย้ายนักศึกษาให้อาจารย์คนใหม่เท่านั้น (เช่น อาจารย์ลาออก) Identity ส่ง AdvisorLinkChanged ให้ Lifecycle ย้าย advisor_id ของใบสมัครที่ค้างอยู่ไปพร้อมกับนักศึกษา
  • รายชื่อนักศึกษาของอาจารย์และตัวกรอง: อาจารย์ดูรายชื่อนักศึกษาในความดูแลพร้อมกรองตาม ชั้นปี, กำลังฝึกงาน (มีใบสมัครสถานะ IN_PROGRESS) และ ฝึกงานเสร็จแล้ว (มีใบสมัครสถานะ COMPLETED) ตัวกรองเพิ่มเติม PM จะแจ้งภายหลัง
  • ระบบเก็บ university_id ไว้รองรับหลายมหาวิทยาลัย (สาธิตด้วยมหาวิทยาลัยเดียว)

5.7 ความปลอดภัยของบัญชีและการเข้าถึง

  • ยืนยันอีเมล: ทุกบทบาทต้องยืนยันอีเมลก่อนใช้งานจริง (ลิงก์มีอายุจำกัด) นักศึกษาและอาจารย์ต้องใช้โดเมน @ac.th ส่วนบริษัทต้องไม่ใช่อีเมลสาธารณะ
  • รหัสผ่าน: เก็บเป็น Hash ด้วย argon2 หรือ bcrypt (ไม่เก็บรหัสจริง) มีระบบ รีเซ็ตรหัสผ่าน ผ่านลิงก์ในอีเมลที่ใช้ได้ครั้งเดียวและหมดอายุเร็ว
  • Token: JWT Access Token อายุ 15 นาที และ Refresh Token ซึ่งตอนต่ออายุจะอ่านข้อมูลล่าสุดจาก Identity เพื่อออก Claim ใหม่ (company_id, company_role, company_categories, advisor_id, university_id, role) ทุก Service ตรวจ Token ด้วย Public Key ของ Identity เอง ไม่ต้องเรียก Identity ทุกคำขอ
  • ระงับบัญชี: บัญชีที่ถูกระงับถูกใส่ใน Denylist และ Gateway/Service ปฏิเสธ Token ที่ยังไม่หมดอายุของบัญชีนั้นทันที
  • Rate Limit ที่ Gateway: จำกัดการล็อกอิน, สมัครสมาชิกบริษัท/อาจารย์, การเพิ่มนักศึกษาโดยอาจารย์, ขอรีเซ็ตรหัสผ่าน และหน้าตรวจสอบ E-Certificate ต่อ IP/บัญชี พร้อมล็อกชั่วคราวเมื่อล็อกอินผิดซ้ำ
  • การเรียกระหว่าง Service: ใช้ Service Token แยกจาก Token ผู้ใช้ และแต่ละ Service เปิดเฉพาะ Endpoint ภายในให้ Service ที่มีสิทธิ์
  • ความลับ: คีย์ รหัสผ่านฐานข้อมูล และ Token ของบริการภายนอกเก็บใน .env / Secret ของที่ Deploy ห้ามขึ้น Git (มี .env.example ให้ทีม)
  • สิทธิ์ตาม Role: ตรวจที่ทุก Service (ไม่พึ่ง Gateway อย่างเดียว) เช่น HR เห็นเฉพาะข้อมูลบริษัทตนผ่าน company_id ใน Token

5.8 เจ้าของข้อมูล Event และความทนทานของการประมวลผล

เจ้าของข้อมูล (Single Owner) — Service อื่นอ่านผ่าน API หรือ Event เท่านั้น ห้ามอ่านตารางข้ามกัน

ข้อมูล เจ้าของ วิธีที่ Service อื่นใช้
บัญชีผู้ใช้, สถานะบริษัท, สิทธิ์ Featured/Fast-Track, ป้าย University Partner, ผูกอาจารย์, Company Directory Identity & Organization Event CompanyStatusChanged, CompanyEntitlementChanged, AdvisorLinkChanged; Notification ดึงอีเมลด้วย user_id
สถานะประกาศงาน, โควตา, ข้อมูลที่ใช้ค้นหา, Tag ทักษะ (รายการกลางและ Tag ของประกาศ) Job Management JobStatusChanged; โควตาผ่าน API (reserve / confirm / release); รายการ Tag ผ่าน API
ตัวนับ Report, ธง UNDER_REVIEW, คิว Admin, ผลการตรวจรีวิว (เผยแพร่ทันที) Verification & Trust Event JobVerified (เฉพาะประกาศของบริษัทที่ติดธง), ReportThresholdReached, ReviewModerationResult
ใบสมัคร, State Machine, ประเมินผล, E-Certificate, รีวิว, รายงานปัญหา, โปรไฟล์/เรซูเม่ Lifecycle ApplicationStatusChanged, ReviewPublished, CertificateIssued/Revoked, ReminderDue
กล่องข้อความ In-App และบันทึกการส่ง Notification รับ Event อย่างเดียว ไม่มี Business Logic

Event หลัก (ชื่อและ Payload ยืนยันตอนออกแบบ API Contract; ทุก Event ใช้ Envelope เดียวกัน: event_id, type, version, occurred_at, correlation_id, payload)

Event ผู้ส่ง ผู้รับ
JobSubmitted Job Management Verification
JobVerified (มี decision: อนุมัติ / รอตรวจ / ตีกลับ / ปฏิเสธ / ระงับถาวร / คืนสถานะ) Verification Job Management
JobStatusChanged Job Management Lifecycle, Notification
ReportThresholdReached Verification Job Management, Notification
CompanyStatusChanged (แนบ Snapshot ชื่อ/โลโก้/ป้าย) Identity Job Management, Lifecycle, Verification, Notification
CompanyEntitlementChanged Identity Job Management
AdvisorLinkChanged Identity Lifecycle, Notification
ApplicationStatusChanged Lifecycle Notification
ReviewSubmitted Lifecycle Verification
ReviewModerationResult Verification Lifecycle
ReviewPublished Lifecycle Identity (Directory), Notification
CertificateIssued / CertificateRevoked Lifecycle Notification
ReminderDue Lifecycle Notification
UserDeletionRequested Identity Lifecycle, Job Management, Verification, Notification
UserSuspended Identity Gateway (อัปเดต Denylist), Notification
ProblemReportCreated Lifecycle Notification
CompanyFlagChanged (ธง UNDER_REVIEW) Verification Job Management, Notification

ความทนทาน (Reliability)

  • Fail-safe: หาก Verification Service ไม่ตอบใน 5 นาที (เฉพาะประกาศของบริษัทที่ติดธง UNDER_REVIEW) ประกาศงานเข้า PENDING_REVIEW ไม่ Publish เอง
  • Outbox Pattern: การเปลี่ยนข้อมูลและการเตรียม Event ต้องอยู่ใน Transaction เดียวกัน — Service เขียน Event ลงตาราง outbox_events พร้อมข้อมูลหลัก แล้วมีตัวส่งแยกอ่านตารางนี้ไปเผยแพร่ที่ RabbitMQ และทำเครื่องหมายว่าส่งแล้ว กรณีบันทึกสำเร็จแต่ส่งไม่ได้ Event จึงไม่หาย (ส่งซ้ำได้ เพราะ Consumer idempotent)
  • Retry: Consumer ที่ประมวลผลล้มเหลวลองใหม่ 3 ครั้งแบบ Exponential Backoff แล้วย้ายไป Dead Letter Queue และขึ้นแจ้งเตือนให้ผู้ดูแล
  • Idempotency: Consumer ทุกตัวรองรับ Event ซ้ำด้วย event_id (บันทึกใน processed_events) ส่วน API โควตาใช้ application_id เป็น Idempotency Key (จองซ้ำไม่ลดโควตาซ้ำ)
  • Reconciliation โควตา: Job Management เก็บรายการจองพร้อม application_id ทุกรายการ ตัวตรวจกระทบยอดรันทุก 30 นาที: เรียก Lifecycle เช็กว่าใบสมัครของแต่ละการจองที่เก่ากว่า 15 นาทียังอยู่ในสถานะที่ควรถือโควตาหรือไม่ ถ้าไม่ใช่ให้คืนโควตา โดย Lifecycle เป็นฝ่ายชี้ขาดสถานะ
  • Correlation ID: ทุกคำขอและ Event พก correlation_id เดียวกันตลอดสายเพื่อไล่ปัญหาข้าม Service จาก Log
  • ลำดับ Event: Consumer เปรียบเทียบ version / เวลาของข้อมูลก่อนเขียนทับ เพื่อไม่ให้ Event เก่ามาถึงทีหลังแล้วทับข้อมูลใหม่ (เช่น Snapshot บริษัท)

5.9 กติกาการเก็บและอัปโหลดไฟล์

  • ที่เก็บ: Cloudflare R2 (Deploy) / RustFS (พัฒนา) ผ่าน S3 API; ฐานข้อมูลเก็บเฉพาะ Object Key และ metadata ไม่เก็บไฟล์
  • Bucket สาธารณะ: เฉพาะโลโก้บริษัท (แสดงบนหน้าเว็บ) | Bucket ส่วนตัว (Private): เรซูเม่, รูปโปรไฟล์นักศึกษา, เอกสารยืนยันบริษัท, PDF E-Certificate — เข้าถึงผ่าน Signed URL อายุประมาณ 10 นาที ที่ออกให้หลังตรวจสิทธิ์แล้วเท่านั้น
  • ชนิดและขนาด: เรซูเม่/เอกสารเป็น PDF; รูปเป็น jpg / png / webp; ไฟล์ทั่วไป ≤ 5 MB และโลโก้ ≤ 2 MB
  • ตรวจฝั่ง Server: ตรวจ MIME จริงจากเนื้อไฟล์ (ไม่เชื่อนามสกุล) ปฏิเสธชนิดอื่น
  • ตั้งชื่อ Key แบบสุ่ม (เช่น UUID) ไม่ใช้ชื่อไฟล์เดิมหรือข้อมูลส่วนบุคคลใน Key
  • อัปโหลดผ่าน NestJS Service เจ้าของข้อมูลเท่านั้น (เช่น เรซูเม่ผ่าน Lifecycle, โลโก้/เอกสารบริษัทผ่าน Identity) Service ตรวจสิทธิ์และขนาดก่อนเขียนลง Storage; Presigned URL ใช้เฉพาะเวลาดาวน์โหลดตามที่ระบุ
  • ไม่มีการสแกนไวรัส ในเฟสนี้ (ดู 5.12)

5.10 ประวัติการเปลี่ยนสถานะและ Audit Log

  • status_history (Append-only): ทุกการเปลี่ยนสถานะของใบสมัคร ประกาศงาน บัญชีบริษัท และใบรับรอง บันทึกแถวใหม่ (entity, from, to, actor_id, actor_role, reason, occurred_at, correlation_id) ห้ามแก้หรือลบ ใช้สร้าง Timeline ให้นักศึกษา (Application Tracker) และตรวจสอบย้อนหลัง
  • admin_audit_log: ทุกการกระทำของ Admin (อนุมัติ/ปฏิเสธ, ตั้งหรือเคลียร์ธง, เพิกถอนใบรับรอง, โอนหรือแต่งตั้ง Owner, ติดป้าย Partner, เปิดสิทธิ์ Featured/Fast-Track, ปลดล็อกสมัครซ้ำ, ย้ายอาจารย์, ยุติการฝึก) บันทึกผู้กระทำ เป้าหมาย ค่าก่อน-หลัง และเหตุผล
  • แยกเก็บตาม Service เจ้าของข้อมูล: แต่ละ Service เขียน History/Audit ของตัวเองลงฐานข้อมูลของตัวเอง
  • ข้อมูลเหล่านี้เก็บรักษาไว้แม้ผู้ใช้ลบบัญชี โดยทำให้ไม่ระบุตัวตนตาม 5.11

5.11 ข้อมูลส่วนบุคคล (PDPA) และการมองเห็นข้อมูล

  • ผู้ใช้ติ๊กยอมรับนโยบายความเป็นส่วนตัวตอนสมัครบัญชี และ ให้ความยินยอมอีกครั้งก่อนส่งเรซูเม่ให้บริษัทแต่ละแห่ง (บันทึกความยินยอมที่ Identity)
ข้อมูล ผู้ที่มองเห็นได้
เรซูเม่/โปรไฟล์ นักศึกษาเจ้าของ, HR ของบริษัทที่นักศึกษาส่งใบสมัครไป (หลังให้ความยินยอม), อาจารย์ที่ปรึกษาที่ผูกแล้ว (Admin ดูได้เฉพาะเคสที่ถูกยกระดับ)
ผลประเมินการฝึกงาน นักศึกษาเจ้าของ, HR ของบริษัทเจ้าของ, อาจารย์ที่ปรึกษา (Admin ดูได้เฉพาะเคสที่ถูกยกระดับ)
รายงานปัญหาระหว่างฝึกงาน นักศึกษาผู้รายงาน, อาจารย์ที่ปรึกษา, Admin — บริษัทมองไม่เห็น
รีวิวบริษัท สาธารณะ (ตามตัวเลือกไม่ระบุชื่อของนักศึกษา)
E-Certificate ไฟล์เห็นได้เฉพาะเจ้าของ; หน้าตรวจสอบสาธารณะเห็นข้อมูลจำกัดตาม 5.4

การลบบัญชี

  • ผู้ใช้ขอลบบัญชีหรือเรซูเม่ได้ Identity ส่ง UserDeletionRequested ให้ทุก Service ลบหรือ ทำให้ไม่ระบุตัวตน (Anonymize) ข้อมูลของผู้ใช้ในฐานข้อมูลตนเอง รวมถึงไฟล์ใน Storage
  • สิ่งที่ เก็บแต่ไม่ระบุตัวตน เพื่อความถูกต้องของระบบ: E-Certificate (ชื่อบนหน้าตรวจสอบแสดงเป็น "ผู้ใช้ที่ลบบัญชีแล้ว"), รีวิวที่เผยแพร่แล้ว, status_history และ admin_audit_log (แทน actor_id ด้วยรหัสนิรนาม)
  • ข้อจำกัดของการลบ: ลบไม่ได้ขณะมีใบสมัครที่ยังดำเนินอยู่ (ADVISOR_PENDING, ADVISOR_APPROVED, IN_PROGRESS หรือรอประเมิน) ผู้ใช้ต้องถอน/ยุติก่อน และ Owner ที่ยังเป็นเจ้าของบริษัทต้องโอนสิทธิ์ก่อน
  • Notification ลบกล่องข้อความและบันทึกการส่งของผู้ใช้เมื่อได้รับ Event

5.12 ข้อจำกัดที่ทราบและงานในอนาคต (Known Limitations & Future Work)

  • ไม่เชื่อมต่อ Payment Gateway จริง (จำลองโดยให้ Admin เปิดสิทธิ์)
  • ยังไม่มี Logbook / รายงานความก้าวหน้ารายสัปดาห์ระหว่างฝึกงาน
  • ยังตรวจไม่ได้ว่าบริษัทกับนักศึกษารวมหัวกันสร้างการฝึกงานปลอมเพื่อให้ได้ใบรับรอง (เกณฑ์ 30 วันเป็นเพียงด่านป้องกันเบื้องต้น)
  • หน้าตรวจสอบ E-Certificate ใช้ Certificate ID + Hash เก็บในระบบ ยังไม่มีลายเซ็นดิจิทัลหรือ Blockchain
  • ยังไม่มีการสแกนไวรัสไฟล์ที่อัปโหลด (ตรวจเฉพาะชนิดและขนาดไฟล์)
  • การแจ้งเตือนอีเมลใช้ Mailpit เป็นค่าเริ่มต้น (ไม่ส่งออกไปยังอีเมลจริง) ถ้าต้องการให้คนอื่นรับอีเมลจริงให้ตั้ง SMTP_* ไปที่บริการ SMTP
  • Backend ตอนสาธิตรันบนเครื่องทีม: ต้องเปิดเครื่อง/Docker/tunnel ระหว่างสาธิต, URL ของ quick tunnel เปลี่ยนทุกครั้งที่รัน (ต้องอัปเดต API_ORIGIN ของ Worker), ไม่มี SLA และใช้ได้เฉพาะงานสาธิต — Front ต้องแสดงข้อความ "ระบบหลังบ้านออฟไลน์" แทนหน้าพังเมื่อเรียก API ไม่ได้ และควรเตรียมวิดีโอ/ภาพหน้าจอสำรองไว้
  • ข้อจำกัดของบริการแผนฟรี: CloudAMQP (จำนวนข้อความต่อเดือน, connection และจำนวน queue จำกัด — ใช้ retry queue ร่วมต่อ Service ไม่แยกต่อ queue), Cloudflare Workers (100,000 request ต่อวัน, CPU 10 ms ต่อ request — ไฟล์ static ไม่นับ จึงให้ Front เป็น static และให้ Worker ทำแค่ proxy; หลีกเลี่ยงการ poll ถี่ เช่น กระดิ่งแจ้งเตือนควร ≥ 30 วินาที) ต้องออกแบบไม่ให้เกินเพดาน
  • ระบบรองรับหลายมหาวิทยาลัยในระดับโครงสร้างข้อมูล (university_id) แต่สาธิตจริงเพียงแห่งเดียว
  • รายการ Tag ทักษะกลางเริ่มต้นกำหนดโดย Admin และเพิ่ม/ปิดได้หลังใช้งานจริง; ตัวกรองรายชื่อนักศึกษาของอาจารย์นอกเหนือจากชั้นปี/กำลังฝึกงาน/ฝึกงานเสร็จแล้ว PM จะแจ้งเพิ่มภายหลัง
  • HR Pro Subscription และ Talent Pool Search เป็น Future Phase

6. แนวทางการพัฒนาตาม SDLC (System Development Life Cycle)

  1. Planning & Requirement Analysis: วิเคราะห์ปัญหาการประสานงานฝึกงาน กำหนดกฎ Tag ทักษะและสิทธิ์สมาชิก HR ตามสายงาน, ลำดับการอนุมัติระหว่าง HR–นักศึกษา–อาจารย์, ค่า SLA และเกณฑ์ต่าง ๆ ใน config กลาง และวางแผน UAT Test Cases
  2. System & Architecture Design: ออกแบบสถาปัตยกรรม Microservices (5 Services + API Gateway) ใน Monorepo, Prisma Schema ของแต่ละ Service, API Contract (OpenAPI), Application State Machine และ Event Catalog (Envelope มี event_id, version, correlation_id) โดยเอกสารทั้งหมดเก็บในโฟลเดอร์ docs/ ของ Monorepo และอัปเดตผ่าน Pull Request
  3. Implementation: พัฒนาแยกตามราย Service โดยยึดหลัก 1 คน = เจ้าของ Service หลักของตน ตามตารางหัวข้อ 11 (Notification Service เป็นของ Junior Developer) ทุก Service ใช้ NestJS + Prisma ตามเทมเพลตเดียวกัน (โครงโฟลเดอร์ รูปแบบ Error การตรวจ JWT การเขียน Outbox) และแชร์โค้ดผ่าน libs/contracts กับ libs/common เท่านั้น
  4. Testing & Integration:
    • Automated Test: แต่ละ Service เขียน Unit / Integration Test ด้วย Mocha + Chai + Sinon และวัด Coverage ด้วย c8 ทดสอบ API ด้วย supertest กับ Test Database แยก (Docker) ไม่ใช้ฐานข้อมูลจริง เคสสำคัญที่ต้องมีเทสอัตโนมัติ ได้แก่ State Machine ใบสมัคร, การจอง/คืนโควตาแบบ Atomic (รวมกรณียิงพร้อมกัน), Idempotency ของ Consumer และสิทธิ์สมาชิก HR ตามสายงาน
    • CI: GitHub Actions รัน Lint, Test และ Build ของ Service ที่ถูกแก้ทุก Pull Request (รันเทสบน CI แทนเครื่องของแต่ละคนเพื่อไม่ให้เครื่องหนักเกินไป)
    • Integration & UAT: ทดสอบการส่ง Event ข้าม Service และ UAT ตามหัวข้อ 10 โดย ผู้ทดสอบต้องไม่ใช่เจ้าของ Service ที่ทดสอบ (Lifecycle Service ซึ่ง Tester เป็นเจ้าของ ให้ PM และ Junior Developer เป็นผู้ทดสอบหลัก)
  5. Deployment & Demo: ตอนพัฒนารันทุกอย่างด้วย Docker Compose (PostgreSQL, RabbitMQ, RustFS, Mailpit) โดยแบ่งเป็น Profile ต่อ Service เพื่อให้แต่ละคนรันเฉพาะส่วนที่กำลังทำ ตอนสาธิตรัน Backend (NestJS + PostgreSQL) ด้วย Docker Compose บนเครื่องทีม ใช้ CloudAMQP (Broker) และ Cloudflare R2 (ไฟล์) ส่วน Front โฮสต์บน Cloudflare Workers และเรียก Backend ผ่าน Worker proxy + Cloudflare Tunnel (ดู 4.4 และ docs/architecture.md §8)

7. กลุ่มผู้ใช้งานเป้าหมาย (User Personas)

กลุ่มผู้ใช้งาน ข้อมูล (Persona Profile) เป้าหมาย (Goals) ปัญหาที่พบเดิม (Pain Points)
1. นักศึกษา
"น้องภัทร (ปี 3 สายไอที)"
นักศึกษาชั้นปีที่ 3 ที่ต้องหาที่ฝึกงานภาคฤดูร้อน ต้องการบริษัทที่ปลอดภัยและอาจารย์รับรอง หางานในหมวด Tech / Business ที่ตรงสาย อ่านรีวิวจากรุ่นพี่ที่เคยไปฝึกจริง สมัครหลายที่ได้ แล้วเลือกยืนยันที่เดียว และขออนุมัติฝึกงานกับอาจารย์ได้ในที่เดียว เจอประกาศงานลอยๆ ในเว็บทั่วไป ไม่รู้ว่าบริษัทมีตัวตนจริงไหม ต้องเดินเอกสารขออนุมัติฝึกงานหลายขั้นตอน และไม่รู้สถานะว่าใบสมัครค้างอยู่ที่ใคร
2. ฝ่ายบุคคลบริษัท
"คุณพลอย (HR Tech Startup)"
HR ของบริษัทที่ต้องการรับเด็กฝึกงานที่มีคุณภาพจากมหาวิทยาลัย ต้องการโพสต์รับนักศึกษาฝึกงาน ประเมินผล และออก E-Certificate ให้เด็กได้สะดวกในระบบเดียว และรู้เหตุผลชัดเจนเมื่อประกาศถูกตีกลับ โพสต์ในกลุ่มโซเชียลแล้วประสานงานกับทางมหาวิทยาลัยยาก ขาดช่องทางส่งผลประเมินและใบรับรองที่เป็นระบบ และกลัวประกาศถูกตีกลับโดยไม่ทราบสาเหตุ
3. อาจารย์มหาวิทยาลัย
"อ.สมเกียรติ (อาจารย์ที่ปรึกษาและผู้ดูแลรายวิชาฝึกงาน)"
อาจารย์ที่ปรึกษาซึ่งดูแลรายวิชาฝึกงานของนักศึกษาในสาขาด้วยตนเอง ตรวจสอบว่านักศึกษาไปฝึกงานตรงสายหรือไม่ ติดตามสถานะเด็กทุกคน และยืนยันผลผ่านรายวิชาได้ง่าย ข้อมูลสถานที่ฝึกงานของนักศึกษากระจัดกระจาย ไม่รู้ว่าใครเริ่มฝึกหรือจบฝึกแล้วบ้าง และไม่รู้ว่าเกิดเหตุผิดปกติ (ยุติกลางคัน, บริษัทถูกระงับ, นักศึกษารายงานปัญหา) หากไม่มีระบบรวมศูนย์
4. ผู้ดูแลแพลตฟอร์ม
"คุณนนท์ (Platform Admin)"
ทีมงานผู้ดูแลระบบหลังบ้านของแพลตฟอร์มที่คอยคัดกรองบริษัทและประกาศงาน อนุมัติบัญชีบริษัทที่เชื่อถือได้ และจัดการเคสที่ถูกรายงานโดยใช้เวลาตรวจน้อยที่สุด และรู้ทันทีว่าคิวใดเกินกำหนด หากไม่มีคิวและธงบริษัทช่วยจัดลำดับ ทีมงานหลังบ้านจะต้องเสียเวลาไล่ตรวจทุกเคสตั้งแต่ศูนย์ และเสี่ยงถูกใช้ระบบรายงานกลั่นแกล้งบริษัท

8. การออกแบบ UI/UX (โทนสว่าง - Light Theme)

  • เทคโนโลยีหน้าเว็บ: Next.js (TSX) + Tailwind CSS โดยเก็บสีและฟอนต์ทั้งหมดเป็นตัวแปร (Design Token) ใน tailwind.config และสร้าง UI Kit กลาง (ปุ่ม ฟอร์ม ตาราง ป้ายสถานะ Timeline Modal Toast) ที่ทุกหน้าใช้ร่วมกัน (เจ้าของคือ PM คอมโพเนนต์อยู่ที่ apps/web/src/components/ui/ ตอนนี้มี StatusBadge และแมปสถานะที่ apps/web/src/lib/status-map.ts ชิ้นที่ยังไม่มีให้ใช้ Design Token สร้างในหน้าไปก่อน และห้ามใช้ emoji ในโค้ดและหน้าเว็บ) รวมถึง Admin Layout (Admin Shell ที่ PM ทำ) ที่ทุก Service ใช้เป็นเปลือกของหน้า Admin ของตน เพื่อให้ปรับโทนสีทั้งเว็บได้ในที่เดียว
  • ฟอนต์ (Typography):
    • ฟอนต์หลัก: ภาษาไทยใช้ Noto Sans Thai (โหลดผ่าน next/font/google ชุดอักขระ thai และ latin); ตัวอักษรละตินใช้ SF Pro ของระบบบนอุปกรณ์ Apple และ Noto Sans Thai บนอุปกรณ์อื่น
    • ขนาดและระยะบรรทัด: ข้อความเนื้อหา 16 px และความสูงบรรทัดอย่างน้อย 1.6 (ภาษาไทยมีสระและวรรณยุกต์ซ้อน ห้ามบีบระยะบรรทัดจนชน) ไม่ใช้ตัวพิมพ์ใหญ่ทั้งหมดหรือเว้นระยะอักษรกว้างกับข้อความภาษาไทย
    • E-Certificate (PDF): ฝังฟอนต์ไทย (Sarabun หรือ Noto Sans Thai) ในไฟล์ และสร้างจากหน้า HTML เพื่อให้การวางสระ/วรรณยุกต์ถูกต้อง ทดสอบด้วยชื่อที่มีสระบนและวรรณยุกต์ซ้อนกัน
  • แนวทางหน้าตา (ปรับ 2026-11-21): อิง DESIGN-apple.md แล้วปรับให้เหมาะกับแพลตฟอร์มฝึกงาน — สีโต้ตอบสีเดียว (Action Blue), แบ่งส่วนด้วยการเปลี่ยนสีพื้น (ขาว / Parchment / Tile เข้ม) แทนเงาหรือกรอบหนา, ไม่มีเงาบนการ์ดและปุ่ม, ปุ่มหลักเป็นแคปซูล, หัวข้อหนา 600 ตัวชิด, เมนูบนเป็นแถบกระจกฝ้า, ท้ายหน้าพื้น Parchment ตัวอักษรเล็ก, กดปุ่มแล้วหดเล็กน้อย (scale 0.97) ค่าทั้งหมดอยู่ใน apps/web/tailwind.config.ts และ apps/web/src/app/globals.css
  • ชุดสีหลัก (Color Palette):
    • พื้นหลังและเส้นขอบ: หน้าเว็บ #FFFFFF, พื้น Parchment ของส่วน/แผง #F5F5F7, Tile เข้ม #272729, เส้นขอบบาง #E0E0E0
    • ตัวหนังสือ: หลัก #1D1D1F, รอง #6E6E73
    • Primary (Action Blue): ปุ่มและลิงก์หลัก #0066CC, Hover/วงโฟกัส #0071E3, พื้นหลังอ่อน #EAF3FD, ลิงก์บนพื้นเข้ม #2997FF
    • Accent (ม่วง): #AF52DE (ตัวหนังสือ #8944AB บนพื้น #F6EDFB) ใช้กับป้ายบริการเสริม Featured / Urgent และ Fast-Track เท่านั้น เพื่อไม่ให้ปนกับสีสถานะ — Tag ทักษะใช้ป้ายสีเทา
    • สีสถานะ (ป้ายใช้พื้นสีอ่อนกับตัวหนังสือสีเข้ม เพื่อให้อ่านชัด; ชุดสีระบบของ Apple):
      • เขียว: Verified by Platform, University Partner, PASS / Approved (ตัวหนังสือ #1F7A35 บนพื้น #E9F8EE; ไอคอน #34C759)
      • ส้ม: สถานะรอ (Pending Review, รออาจารย์/Admin) (ตัวหนังสือ #9A5200 บนพื้น #FFF4E3; ไอคอน #FF9F0A)
      • แดง: Rejected / Suspended / Fail และป้าย OVERDUE (ตัวหนังสือ #C4001A บนพื้น #FFEEED; ไอคอน #FF3B30)
      • เทา: สถานะสิ้นสุดแบบเป็นกลาง เช่น Expired / Withdrawn / Cancelled / Terminated / Offer Rescinded (#86868B)
  • องค์ประกอบสำคัญบนหน้าจอ (Key UI Components):
    • Company Directory & Structured Job Card: หน้าค้นหาบริษัทที่ผ่านการรับรอง (D 07-A) และการ์ดงานที่แสดงหมวดหมู่สายงาน, ป้ายสถานะของบริษัท (Verified / University Partner), คะแนนดาวรีวิว, สถานที่และรูปแบบการฝึก (On-site / Remote / Hybrid), ชั่วโมงต่อสัปดาห์, เบี้ยเลี้ยงชัดเจน และป้ายเตือนเมื่อสาขาของนักศึกษาไม่ตรงกับ target_majors
    • Application Tracker (นักศึกษา): Timeline (จาก status_history) แสดงสถานะใบสมัครแต่ละใบ พร้อมปุ่มยืนยันรับข้อเสนอ / ปฏิเสธ / ถอนใบสมัคร / โต้แย้งผล FAIL และปุ่ม รายงานปัญหาระหว่างฝึกงาน (เฉพาะเมื่อ IN_PROGRESS) พร้อมการแจ้งเตือนในระบบ (Notification Bell) และข้อความอธิบายเมื่อปุ่มสมัครถูกบล็อก (เช่น ผ่านวิชาแล้ว)
    • HR Applicant Board: กระดานผู้สมัครของบริษัท พร้อมฟอร์มส่งข้อเสนอ (ระบุวันเริ่ม-สิ้นสุด), ปุ่มถอนข้อเสนอ (บังคับเหตุผล), ปุ่มยืนยันเริ่มงานพร้อมปรับวันที่, ปุ่มยุติ, ฟอร์มประเมินผล และปุ่มออก/เพิกถอน E-Certificate; หน้าจัดการทีม HR และโอนสิทธิ์ Owner
    • Advisor Approval Dashboard: หน้าคิวคำขอออกฝึกงานของนักศึกษาในที่ปรึกษา พร้อมปุ่มอนุมัติ/ไม่อนุมัติ (บังคับกรอกเหตุผล) คิวคำโต้แย้งผล FAIL รายงานปัญหาจากนักศึกษา ธงเตือนเมื่อบริษัทถูกระงับ และตัวติดตามสถานะการฝึกงานรายบุคคล
    • Admin Queue: ตารางตรวจประกาศของบริษัทที่ติดธงและอนุมัติบัญชีบริษัทของ Platform Admin พร้อมป้าย OVERDUE และ Fast-Track และคิวคำร้อง Report/รีวิวที่ถูกติดธง/รายงานปัญหาระหว่างฝึกงาน รวมถึงเมนูตั้งป้าย University Partner, เปิดสิทธิ์ Featured/Fast-Track, แต่งตั้ง Owner, ปลดล็อกสมัครซ้ำ และดู Audit Log
    • Public Certificate Verification Page: หน้าสาธารณะที่ QR Code ชี้มา แสดงสถานะ VALID / REVOKED และข้อมูลใบรับรองแบบจำกัด

9. แผนการดำเนินงาน 4 สัปดาห์ (Work Plan: 4 Weeks)

สัปดาห์ เป้าหมายหลัก (Weekly Milestone) งานที่ต้องดำเนินการ (Key Activities) สิ่งที่ส่งมอบ (Deliverables)
Week 1 Design, Setup & Organization Onboarding - สรุป Requirement, กำหนดกฎ Tag ทักษะและสิทธิ์สมาชิก HR ตามสายงาน, กำหนดค่า SLA/เกณฑ์ใน config กลาง และวางแผน UAT Test Cases
- ออกแบบ System Architecture (5 Services), Prisma Schema ต่อ Service, API Contract, Application State Machine และ Event Catalog (Envelope + Outbox)
- วาง Monorepo (pnpm workspaces, apps/*, libs/contracts, libs/common, docs/), เทมเพลต NestJS + Prisma + Mocha และ CI (GitHub Actions)
- สมัครและตั้งค่า Cloudflare (Workers, R2) และ CloudAMQP; Docker Compose (PostgreSQL, RabbitMQ, MinIO, Mailpit) แบบ Profile ต่อ Service; เตรียมข้อมูลจำลอง (Mock Data)
- พัฒนาระบบ Auth (4 Roles, ยืนยันอีเมล, รีเซ็ตรหัสผ่าน, JWT + Refresh), การที่อาจารย์เพิ่มนักศึกษาด้วยฟอร์ม (นักศึกษาไม่สมัครเอง ผูก LINKED อัตโนมัติ), การอนุมัติบัญชีอาจารย์และบริษัทโดย Admin ตามเกณฑ์, HR Owner/Member พร้อมสายงานของสมาชิก และการบันทึก Consent
- Figma (UI/UX)
เอกสาร Requirement + Architecture Diagram + State Machine + Event Catalog + API Contract + Monorepo ที่รันได้ + Demo การสมัครสมาชิก ผูกอาจารย์ และ Admin อนุมัติบัญชีบริษัท
Week 2 Core Publishing & Trust
(ประกาศ Tag และระบบรายงาน)
- พัฒนาระบบ Tag ทักษะ (รายการกลางที่ Admin จัดการ, ติด Tag ให้ประกาศ, กรองการค้นหา) และการเผยแพร่ประกาศทันที
- พัฒนาฟอร์มสร้างการ์ดประกาศงาน (ข้อมูลบังคับ, หมวด Tech/Business/Corporate, target_majors, quota), สิทธิ์สมาชิกตามสายงาน และกติกาแก้ไขประกาศ
- พัฒนา Admin Queue (ประกาศของบริษัทที่ติดธง, รายงาน) พร้อม SLA และป้าย OVERDUE, และ Fail-safe 5 นาที
- เชื่อมต่อ Message Queue (JobSubmitted เฉพาะบริษัทที่ติดธง / JobVerified / JobStatusChanged) พร้อม Outbox/Retry/DLQ/Idempotency และเริ่ม Notification Service (In-App + Mailpit)
- ทดสอบ Integration และตรวจสอบความถูกต้องของกฎ Tag และสายงาน
Demo ไฮไลต์: HR โพสต์งานพร้อม Tag ทักษะแล้วขึ้นหน้าค้นหาทันที + กรองด้วย Tag + สมาชิก HR จัดการได้เฉพาะสายงานของตน + นักศึกษารายงานประกาศจนระบบระงับอัตโนมัติและเข้าคิว Admin
Week 3 Student–Advisor Flow, SLA & Auto-Suspend - Company Directory (SA, ใน Identity Service) และ Job Search (Junior, ใน Job Management Service)
- ตั้ง Cloudflare Tunnel + Worker proxy ให้ Front บน Cloudflare เรียก Backend ที่รันบนเครื่องทีมได้ก่อนเริ่มต่อ Service เข้าด้วยกัน
- พัฒนาระบบสมัครงาน → HR ตอบรับพร้อมวันเริ่ม-สิ้นสุด → นักศึกษายืนยัน → อาจารย์กดอนุมัติ/ไม่อนุมัติ (พร้อมเหตุผล) → HR ยืนยันเริ่มงาน (ปรับวันที่ได้) รวมถึงการถอนใบสมัคร ถอนข้อเสนอ และกฎห้ามสมัครซ้ำ
- พัฒนากติกายืนยันได้ทีละ 1 ที่ การถอน/ปฏิเสธอัตโนมัติ และการจอง/ยืนยัน/คืนโควตาแบบ Atomic พร้อม Reconciliation
- พัฒนา SLA Scheduler (เตือน/หมดอายุ/ยกระดับ แบบ idempotent)
- สร้างระบบรายงานและ Auto-Suspend (จำกัดการรายงาน, กันรายงานเท็จ, คืนสถานะเมื่อ Admin ยกคำร้อง), ธง UNDER_REVIEW ของบริษัท และแจ้งเตือนอาจารย์เมื่อเกิดเคสปัญหา
- ปรับปรุง API Gateway (Routing, ตรวจ Token, Rate Limit) และทดสอบ Flow การทำงานหลัก
Demo นักศึกษาสมัครงาน → HR ตอบรับ → นักศึกษายืนยัน → อาจารย์อนุมัติ → HR ยืนยันเริ่มงาน, การหมดอายุตาม SLA และทดสอบระบบ Report Auto-Suspend
Week 4 Evaluation, E-Certificate, Review & UAT - พัฒนาการยุติกลางคัน (TERMINATED), HR ประเมินผล (PASS/FAIL พร้อมเหตุผล), การโต้แย้งและประเมินซ้ำ, เส้นทาง NO_EVALUATION, การจัดการเมื่อบริษัทถูกระงับขณะฝึก, รายงานปัญหาระหว่างฝึกงาน และอาจารย์บันทึก academic_result
- พัฒนา E-Certificate (PDF) พร้อม Certificate ID, QR, หน้าตรวจสอบสาธารณะ, SHA-256 และการเพิกถอน (เช็กฝึกจริง ≥ 30 วัน)
- พัฒนาระบบรีวิวบริษัท (สิทธิ์เขียน, Moderation ผ่าน Verification, บริษัทตอบกลับ, ไม่ระบุชื่อ, อัปเดตคะแนนที่ Directory) และการมองเห็นข้อมูลตาม PDPA รวมถึงการลบบัญชี (UserDeletionRequested), status_history และ admin_audit_log
- ดำเนินการทดสอบ UAT ครบทุกเคสจริง และสรุปรายงาน Bug
- จัดทำสไลด์นำเสนอและสรุปผลการดำเนินงาน
ระบบฉบับสมบูรณ์พร้อมผลการทดสอบ UAT และรายงานผลการทดสอบระบบ

10. การทดสอบการยอมรับของผู้ใช้งาน (User Acceptance Testing - UAT)

รหัสทดสอบ ชื่อกรณีศึกษา (Test Case) ผู้ทดสอบ (Actor) ขั้นตอนการทดสอบ (Test Steps) ผลลัพธ์ที่คาดหวัง (Expected Result)
UAT-01 การบล็อกการโพสต์งานของบริษัทที่ยังไม่ผ่านการอนุมัติ HR 1. สมัครบัญชีบริษัทใหม่ (Admin ยังไม่กด Approve) 2. กด "เผยแพร่งาน" ระบบไม่อนุญาตให้เผยแพร่และแจ้งเตือนว่ารอการอนุมัติบัญชีจาก Admin
UAT-02 Tag ทักษะของประกาศงาน HR & Admin 1. Admin เพิ่ม Tag NextJs และ Rust ในรายการกลาง 2. HR สร้างงานโดยเลือก Tag จากรายการ 3. HR พยายามส่งงานที่ไม่มี Tag, มี Tag เกิน 10 รายการ หรือใช้ Tag ที่ไม่อยู่ในรายการ 4. Admin ปิดใช้งาน Tag หนึ่ง ข้อ 2 งานติด Tag และ PUBLISHED ทันที; ข้อ 3 ถูกปฏิเสธ 400 VALIDATION_FAILED; ข้อ 4 Tag ไม่ขึ้นให้เลือกใหม่ แต่ประกาศเดิมยังแสดง Tag นั้น
UAT-03 แก้ไขประกาศที่เผยแพร่แล้ว HR 1. เปิดงานที่ PUBLISHED 2. แก้ไข description และเพิ่ม/ลด Tag 3. บันทึกการแก้ไข 4. ตรวจหน้าค้นหา งานยังคง PUBLISHED ไม่ถูกซ่อน ไม่มีการตรวจซ้ำ (ยกเว้นบริษัทที่ติดธง UNDER_REVIEW ซึ่งต้องผ่าน Admin อีกครั้ง)
UAT-04 การเผยแพร่ประกาศทันที HR (Approved) 1. ใช้อีเมลองค์กรที่ผ่านการอนุมัติแล้ว (บริษัท VERIFIED) 2. สร้างงานที่กรอกข้อมูลบังคับครบและเลือก Tag 3. ส่งประกาศ งานเปลี่ยนเป็น PUBLISHED ทันทีและขึ้นหน้าค้นหา (กรองด้วย ?tags= ได้)
UAT-05 การระงับงานอัตโนมัติเมื่อถูกรายงาน (Community Report) นักศึกษา 3 บัญชี และ Admin 1. นักศึกษา 3 บัญชีรายงานประกาศงานเดียวกัน
2. Admin ตรวจสอบคำร้อง (ยกคำร้อง หรือ ยืนยันระงับถาวร)
งานถูกระงับชั่วคราว (SUSPENDED) ทันทีเมื่อครบ 3 บัญชี และเข้าคิวให้ Admin ตัดสินชี้ขาด; ยกคำร้อง → PUBLISHED ทันทีและตัวนับรีเซ็ต; ยืนยันระงับ → REMOVED
UAT-06 ลำดับการอนุมัติฝึกงานระหว่าง HR นักศึกษา และอาจารย์ นักศึกษา, HR & อาจารย์ 1. นักศึกษากดสมัครงาน 2. HR กดรับพร้อมระบุ start_date/end_date (HR_ACCEPTED) 3. นักศึกษายืนยันรับข้อเสนอ (ADVISOR_PENDING) 4. อาจารย์กดอนุมัติ (ADVISOR_APPROVED) 5. HR กดยืนยันเริ่มงาน
(ทดสอบซ้ำกรณีอาจารย์กดไม่อนุมัติโดยไม่ใส่เหตุผล และกรณีใส่เหตุผล)
สถานะเปลี่ยนเป็น IN_PROGRESS เมื่อ HR ยืนยันเริ่มงาน; หากอาจารย์ไม่อนุมัติโดยไม่ใส่เหตุผล ระบบไม่อนุญาต; หากใส่เหตุผล สถานะเป็น ADVISOR_REJECTED คืนโควตาให้บริษัท และแจ้งนักศึกษากับ HR พร้อมเหตุผล
UAT-07 การป้องกันปิดปากนักศึกษา (Review Silencing) HR & นักศึกษา 1. HR กดประเมินนักศึกษาว่า FAIL (พร้อมเหตุผล) 2. นักศึกษาพยายามเขียนรีวิวบริษัท นักศึกษาเขียนรีวิวได้สำเร็จ แต่มีป้ายกำกับว่ารีวิวนี้มาจากนักศึกษาที่ไม่ผ่านเกณฑ์
UAT-08 การป้องกันปั๊มใบเซอร์ (Certificate Farming) HR 1. HR ส่งข้อเสนอที่ end_date − start_date < 30 วัน
2. กรณีฝึกจริง: HR ยืนยันเริ่มงานแล้วพยายามประเมินก่อนถึง end_date
3. กรณียุติกลางคัน: HR ยุติการฝึกที่วันที่ 10 แล้วพยายามกดออก E-Certificate
ข้อ 1 ระบบปฏิเสธการส่งข้อเสนอ; ข้อ 2 ระบบไม่เปิดให้ประเมิน; ข้อ 3 ระบบปฏิเสธการออกใบเนื่องจากฝึกจริงยังไม่ถึง 30 วัน และอาจารย์ตัดสิน academic_result เอง
UAT-09 การออก E-Certificate และการยืนยันผลรายวิชา HR, นักศึกษา & อาจารย์ 1. ฝึกงานครบตาม end_date (ฝึกจริง ≥ 30 วัน) 2. HR กด PASS และออก E-Certificate 3. นักศึกษาเข้าดาวน์โหลด 4. อาจารย์บันทึก academic_result เป็น ACADEMIC_PASS ระบบสร้าง E-Certificate (PDF) ให้นักศึกษาดาวน์โหลดได้ สถานะใบสมัครเป็น COMPLETED
UAT-10 การอนุมัติบัญชีบริษัทและอาจารย์โดย Admin Admin, HR & อาจารย์ 1. HR สมัครด้วยอีเมลสาธารณะ (เช่น Gmail)
2. HR สมัครด้วยอีเมลองค์กรพร้อมเอกสารไม่ครบ → Admin ตอบ NEED_MORE_INFO
3. HR ส่งเอกสารครบ → Admin อนุมัติ
4. อาจารย์สมัครด้วย @ac.th และ Admin อนุมัติ
ข้อ 1 ระบบไม่รับอีเมลสาธารณะ; ข้อ 2 สถานะ NEED_MORE_INFO พร้อมแจ้งสิ่งที่ต้องส่งเพิ่ม; ข้อ 3 บัญชีเป็น VERIFIED และโพสต์งานได้; ข้อ 4 อาจารย์เข้าใช้งานได้หลังอนุมัติ
UAT-11 ประกาศของบริษัทที่ติดธงผ่านคิว Admin HR & Admin 1. บริษัทถูกติดธง UNDER_REVIEW 2. HR ส่งงานสองงาน 3. Admin อนุมัติงานหนึ่ง และปฏิเสธอีกงานหนึ่ง งานเข้า PENDING_REVIEW; ที่อนุมัติเป็น PUBLISHED; ที่ปฏิเสธเป็น ADMIN_REJECTED พร้อมแจ้ง HR
UAT-12 สิทธิ์สมาชิก HR ตามสายงาน HR Owner & HR Member 1. Owner เชิญสมาชิกและกำหนดสาย Tech & IT 2. สมาชิกสร้างงานสาย Tech & IT 3. สมาชิกพยายามสร้าง/แก้งานและดูผู้สมัครของสาย Business & Marketing 4. Owner เพิ่มสาย Business & Marketing ให้สมาชิก แล้วสมาชิกรีเฟรช Token ข้อ 2 ทำได้; ข้อ 3 ถูกปฏิเสธ 403 FORBIDDEN_ROLE (details[].issue = FORBIDDEN_CATEGORY) และรายการประกาศ/ผู้สมัครไม่แสดงของสายอื่น; ข้อ 4 หลังรีเฟรชทำได้ Owner เห็นทุกสายตลอด
UAT-13 อาจารย์เพิ่มนักศึกษาด้วยฟอร์ม อาจารย์ & นักศึกษา 1. อาจารย์ที่ ACTIVE กรอกฟอร์มเพิ่มนักศึกษา (อีเมล @ac.th, ชื่อ, รหัสนักศึกษา, สาขา, ชั้นปี) 2. นักศึกษาเปิดลิงก์คำเชิญตั้งรหัสผ่านและยอมรับนโยบาย 3. อาจารย์กรอกอีเมลซ้ำ 4. อาจารย์ส่งคำเชิญซ้ำ/ยกเลิกคำเชิญที่ยังไม่ถูกใช้ ข้อ 1 ส่งอีเมลคำเชิญ; ข้อ 2 บัญชี ACTIVE และผูกกับอาจารย์เป็น LINKED ทันที สมัครงานได้; ข้อ 3 409 STATE_CONFLICT (EMAIL_ALREADY_REGISTERED); ข้อ 4 ลิงก์เดิมใช้ไม่ได้เมื่อส่งใหม่/ยกเลิก
UAT-14 กติกาแก้ไขฟิลด์โครงสร้างกับฟิลด์ข้อความ HR 1. เปิดงาน PUBLISHED แล้วแก้ quota และวันปิดรับ 2. แก้ description เพียงเล็กน้อย ข้อ 1 และข้อ 2 ไม่ตรวจซ้ำ งานยัง PUBLISHED (ยกเว้นบริษัทที่ติดธง UNDER_REVIEW: ข้อ 2 งานถูกซ่อนและตรวจซ้ำ VERIFYING — ข้อ 1 ยังไม่ตรวจซ้ำ); ถ้าพยายามเปลี่ยน category ได้ 400 CATEGORY_LOCKED
UAT-15 ย้ายอาจารย์ที่ปรึกษาและตัวกรองรายชื่อนักศึกษา อาจารย์ & Admin 1. อาจารย์มีนักศึกษาหลายชั้นปี บางคนกำลังฝึกงาน (IN_PROGRESS) บางคนฝึกงานเสร็จแล้ว (COMPLETED) 2. อาจารย์กรองรายชื่อตามชั้นปี, กำลังฝึกงาน, ฝึกงานเสร็จแล้ว 3. Admin ย้ายนักศึกษาที่มีใบสมัครค้างอยู่ไปอาจารย์อีกคน ข้อ 2 รายชื่อตรงตามตัวกรอง; ข้อ 3 ย้ายอาจารย์ได้และใบสมัครที่ค้างย้ายตามนักศึกษา; อาจารย์เดิมไม่เห็นนักศึกษาคนนั้นอีก
UAT-16 สมัครหลายที่และยืนยันได้ทีละ 1 ที่ นักศึกษา, HR 2 บริษัท & อาจารย์ 1. นักศึกษาสมัคร 3 บริษัท 2. 2 บริษัทตอบรับ 3. นักศึกษายืนยันบริษัท A 4. บริษัท B (ที่ตอบรับไว้) และบริษัท C (ที่ยัง PENDING) ถูกตรวจสถานะ 5. อาจารย์อนุมัติ 6. บริษัท C พยายามกดตอบรับระหว่างขั้นตอน ข้อเสนอของ B เป็น STUDENT_DECLINED และคืนโควตา; ใบสมัคร C เป็น WITHDRAWN เมื่ออาจารย์อนุมัติ; ปุ่มตอบรับของ C ถูกปิดระหว่างที่นักศึกษามีใบสมัครที่ยืนยันแล้ว
UAT-17 โควตาตำแหน่งและการแข่งขันพร้อมกัน HR & นักศึกษา 1. ประกาศมี quota = 1 และมีผู้สมัคร 2 คน 2. HR กดตอบรับทั้งสองคนพร้อมกัน (ยิงคำขอพร้อมกันจากสคริปต์) 3. คนที่ได้ข้อเสนอปฏิเสธหรือหมดเวลา ตอบรับได้เพียง 1 คน อีกคนถูกปฏิเสธเพราะโควตาเต็ม (ไม่เกินโควตาแม้ยิงพร้อมกัน); เมื่อข้อเสนอถูกปฏิเสธ/หมดเวลา โควตาถูกคืนและกดตอบรับอีกคนได้
UAT-18 การหมดเวลาและการเตือนตาม SLA ระบบ, HR, นักศึกษา & อาจารย์ (ปรับ config ให้เวลาเร็วขึ้นสำหรับทดสอบ) 1. HR ไม่ตอบใบสมัคร 2. นักศึกษาไม่ยืนยันข้อเสนอ 3. อาจารย์ไม่อนุมัติ ส่งการแจ้งเตือนตามกำหนด; ข้อ 1 เป็น EXPIRED; ข้อ 2 เป็น EXPIRED และคืนโควตา; ข้อ 3 แจ้ง Admin และไม่อนุมัติอัตโนมัติ
UAT-19 คิว Admin เกิน SLA Admin & HR 1. มีเคสเข้าคิวปกติและคิว Fast-Track (เช่น ประกาศของบริษัทที่ติดธง, คำร้อง Report) 2. ปล่อยเกินเวลา SLA ของแต่ละคิว รายการที่เกินกำหนดแสดงป้าย OVERDUE สีแดง; Fast-Track อยู่ลำดับต้นของคิว
UAT-20 การยุติการฝึกกลางคัน HR/นักศึกษา/Admin & อาจารย์ 1. ใบสมัครอยู่ IN_PROGRESS 2. HR (หรือนักศึกษา หรือ Admin) ยุติโดยไม่ใส่เหตุผล แล้วลองใหม่โดยใส่เหตุผล 3. ตรวจ E-Certificate และการบันทึกผลโดยอาจารย์ ไม่ใส่เหตุผลไม่ได้; หลังยุติสถานะเป็น TERMINATED (ระบุ terminated_by) และแจ้งอาจารย์; ไม่มี E-Certificate หากฝึกไม่ถึง 30 วัน และอาจารย์บันทึก academic_result ได้; นักศึกษารีวิวได้พร้อมป้ายยุติก่อนกำหนด
UAT-21 การโต้แย้งผล FAIL HR, นักศึกษา & อาจารย์ 1. HR ให้ FAIL โดยไม่ใส่เหตุผล แล้วลองใหม่ 2. นักศึกษาโต้แย้งภายใน 7 วัน 3. อาจารย์สั่งประเมินซ้ำ 4. HR ยัง FAIL 5. อาจารย์พยายามเปลี่ยนผลเป็น PASS และบันทึก academic_result FAIL ต้องมีเหตุผล; สถานะ FAIL_DISPUTED → REEVALUATION_REQUESTED (ได้ 1 รอบ); อาจารย์เปลี่ยนเป็น PASS ไม่ได้ และบันทึกได้เฉพาะ ACADEMIC_FAIL หรือ REPEAT_REQUIRED; โต้แย้งหลังเกิน 7 วันไม่ได้
UAT-22 บริษัทไม่ประเมินผล HR, Admin & อาจารย์ 1. หลัง end_date HR ไม่ประเมินจนเกิน 14 วัน 2. Admin ยืนยันว่าติดตามบริษัทแล้ว 3. อาจารย์บันทึกผล ระบบเตือนตามกำหนดและแจ้งอาจารย์/Admin ที่วันที่ 14; สถานะเป็น NO_EVALUATION; อาจารย์บันทึก academic_result ได้; ไม่มี E-Certificate; นักศึกษารีวิวได้พร้อมป้ายบริษัทไม่ได้ประเมิน
UAT-23 การตรวจสอบและเพิกถอน E-Certificate บุคคลภายนอก, HR & Admin 1. สแกน QR ของใบรับรอง 2. HR เพิกถอนใบของบริษัทตนโดยระบุเหตุผล 3. Admin เพิกถอนใบอื่น 4. สแกน QR อีกครั้ง หน้าสาธารณะแสดง VALID พร้อมข้อมูลจำกัด (ไม่มีข้อมูลติดต่อ); หลังเพิกถอนแสดง REVOKED; HR เพิกถอนใบของบริษัทอื่นไม่ได้
UAT-24 กลไกกันการรายงานเท็จ นักศึกษา & Admin 1. นักศึกษาคนเดิมรายงานประกาศเดิมซ้ำ 2. นักศึกษารายงานเกิน 5 ครั้งต่อวัน 3. รายงานของนักศึกษา X ถูกยกคำร้อง 3 ครั้งติด แล้ว X รายงานอีกครั้ง ข้อ 1–2 ระบบปฏิเสธ; ข้อ 3 รายงานใหม่ของ X เข้าคิว Admin แต่ไม่ถูกนับเข้าเกณฑ์ระงับอัตโนมัติ
UAT-25 บริษัทถูกติดธง UNDER_REVIEW HR & Admin 1. ประกาศของบริษัทเดียวกันถูกปฏิเสธ/ระงับรวม 3 ครั้งใน 30 วัน 2. บริษัทส่งงานใหม่ 3. Admin เคลียร์ธง บริษัทติดธง UNDER_REVIEW และเข้าคิว Admin; งานใหม่เข้า PENDING_REVIEW แทนการ Publish ทันที; หลังเคลียร์ธงกลับสู่ Flow ปกติ (เผยแพร่ทันที)
UAT-26 ประกาศถูกซ่อน/ตีกลับขณะมีใบสมัครค้างอยู่ HR, นักศึกษา & อาจารย์ 1. มีใบสมัครที่ PENDING/HR_ACCEPTED และอีกใบที่ IN_PROGRESS ของประกาศเดียวกัน 2. ประกาศเข้า SUSPENDED แล้ว Admin ยกคำร้อง 3. ทำซ้ำโดยประกาศถูก REMOVED ข้อ 2 ใบสมัครถูก Freeze แล้วดำเนินต่อได้เมื่อกลับเป็น PUBLISHED; ข้อ 3 ใบสมัครที่ยังไม่ถึง ADVISOR_APPROVED เป็น CANCELLED พร้อมแจ้งและคืนโควตา ส่วนใบที่ IN_PROGRESS ติดธงเตือนอาจารย์
UAT-27 บริษัทถูกระงับขณะนักศึกษากำลังฝึก Admin, อาจารย์ & นักศึกษา 1. Admin ระงับบัญชีบริษัทที่มีนักศึกษา IN_PROGRESS 2. อาจารย์เลือกฝึกต่อในเคสหนึ่ง และยุติอีกเคสหนึ่ง ประกาศและการสมัครใหม่ถูกปิดทันที; ระบบไม่ตัดการฝึกเอง; แจ้งอาจารย์และนักศึกษา; ที่ยุติเป็น TERMINATED (terminated_by = ADVISOR)
UAT-28 กติกาการรีวิวและ Moderation นักศึกษา, HR & Admin 1. นักศึกษาพยายามรีวิวก่อนประเมินผล 2. รีวิวหลังประเมิน แล้วพยายามรีวิวซ้ำ 3. รีวิวที่มีเบอร์โทร/LINE ID แล้วผู้ใช้อื่นกด Report 4. HR ตอบกลับรีวิวสองครั้ง 5. เลือกแสดงแบบไม่ระบุชื่อ 6. ตรวจคะแนนดาวของบริษัทในหน้า Directory หลังรีวิวถูกเผยแพร่ ข้อ 1 ไม่ได้; ข้อ 2 รีวิวได้ 1 ครั้ง; ข้อ 3 รีวิวเผยแพร่ทันที (ไม่สแกนเนื้อหา ไม่มีการพัก) รายงานเข้าคิว Admin ซึ่งลบรีวิวได้ (ADMIN_REMOVE) แล้วคะแนนรวมของบริษัทลดตาม; ข้อ 4 ตอบได้เพียง 1 ครั้ง; ข้อ 5 แสดงเฉพาะสาขาและชั้นปี; ข้อ 6 คะแนนรวมของบริษัทอัปเดตหลังรีวิวเผยแพร่ (ผ่าน ReviewPublished)
UAT-29 การควบคุมสิทธิ์ตาม Role และข้อมูลส่วนบุคคล ทุก Role 1. นักศึกษาเรียกหน้า/API ของ HR, Advisor, Admin 2. HR ดูผู้สมัครของบริษัทอื่น 3. อาจารย์ดูนักศึกษานอกความดูแล 4. นักศึกษาส่งเรซูเม่โดยไม่ติ๊ก Consent 5. HR พยายามเปิดรายงานปัญหาระหว่างฝึกงานของนักศึกษา ข้อ 1–3 ถูกปฏิเสธ (403); ข้อ 4 ส่งไม่ได้; ข้อ 5 ถูกปฏิเสธ บริษัทมองไม่เห็นรายงาน
UAT-30 ความทนทานของ Message Broker และ Verification Service ระบบ & Tester 1. หยุด Verification Service แล้ว HR ส่งงาน 2. ส่ง Event เดิมซ้ำ 3. ทำให้ Consumer ล้มเหลวต่อเนื่อง ข้อ 1 หลัง 5 นาทีงานเข้า PENDING_REVIEW ไม่ Publish เอง; ข้อ 2 ไม่ทำซ้ำ (Idempotent); ข้อ 3 Retry 3 ครั้งแล้วเข้า DLQ และแจ้งเตือนผู้ดูแล
UAT-31 บริการ Featured / Fast-Track (จำลอง) Admin & HR 1. Admin เปิดสิทธิ์ Featured และ Fast-Track ให้บริษัท 2. HR ใช้ Featured กับงานที่ยังไม่ PUBLISHED 3. Admin ตรวจเคสบริษัทนี้ผ่านคิว Fast-Track ข้อ 2 ไม่แสดงเป็น Featured จนกว่างาน PUBLISHED; ข้อ 3 อยู่ลำดับต้นของคิวและ SLA 12 ชั่วโมง
UAT-32 การแจ้งเตือน ทุก Role ดำเนินการเปลี่ยนสถานะสำคัญ เช่น ส่งข้อเสนอ, อาจารย์ไม่อนุมัติ, ประกาศถูกตีกลับ, เตือนตาม SLA ผู้เกี่ยวข้องได้รับแจ้งเตือนทั้ง In-App และอีเมล (ดูในกล่องจดหมาย Mailpit) ตามเหตุการณ์ โดย Event ไม่พกอีเมลปลายทาง (Notification ดึงจาก Identity ด้วย user_id)
UAT-33 การถอนใบสมัครและการถอนข้อเสนอ นักศึกษา, HR & อาจารย์ 1. นักศึกษาถอนใบสมัครในสถานะ PENDING, ADVISOR_PENDING และ ADVISOR_APPROVED 2. นักศึกษาพยายามถอนเมื่อ IN_PROGRESS 3. HR ถอนข้อเสนอใน HR_ACCEPTED / ADVISOR_APPROVED โดยไม่ใส่เหตุผล แล้วลองใหม่โดยใส่เหตุผล ข้อ 1 เป็น WITHDRAWN คืนโควตา (ถ้าจองไว้) และแจ้ง HR/อาจารย์; ข้อ 2 ไม่ได้ ต้องใช้การขอยุติ (TERMINATED); ข้อ 3 ต้องมีเหตุผล สถานะเป็น OFFER_RESCINDED คืนโควตา และแจ้งนักศึกษากับอาจารย์
UAT-34 ใบสมัครค้างที่ ADVISOR_APPROVED ระบบ, HR & อาจารย์ (ปรับ config ให้เร็วขึ้น) 1. อาจารย์อนุมัติแล้ว HR ไม่กดยืนยันเริ่มงานเมื่อถึง start_date 2. รอผ่านวันที่ +3, +7 และ +14 เตือน HR ใน start_date และ +3; แจ้งอาจารย์/Admin เมื่อเกิน 7 วัน; เกิน 14 วันเป็น EXPIRED และคืนโควตา
UAT-35 HR ปรับวันที่ตอนยืนยันเริ่มงาน HR, นักศึกษา & อาจารย์ 1. HR กดยืนยันเริ่มงานโดยเลื่อน start_date และปรับ end_date 2. ปรับให้ระยะฝึกจริงสั้นกว่า 30 วัน ข้อ 1 บันทึก actual_start_date ได้ แจ้งนักศึกษาและอาจารย์ สถานะ IN_PROGRESS; ข้อ 2 ระบบเตือนว่าจะไม่มีสิทธิ์รับ E-Certificate
UAT-36 การลบบัญชีและการไม่ระบุตัวตน นักศึกษา, HR (Owner) & อาจารย์ 1. นักศึกษาที่ใบสมัครยัง IN_PROGRESS ขอลบบัญชี 2. นักศึกษาที่จบแล้วและมี E-Certificate/รีวิวขอลบบัญชี 3. Owner ที่ยังเป็นเจ้าของบริษัทขอลบบัญชี ข้อ 1 ลบไม่ได้ ต้องยุติ/ถอนก่อน; ข้อ 2 ลบข้อมูลส่วนบุคคลและไฟล์ในทุก Service (UserDeletionRequested) ส่วนใบรับรองและรีวิวเก็บแบบไม่ระบุตัวตน ("ผู้ใช้ที่ลบบัญชีแล้ว") และ status_history ไม่เหลือ ID เดิม; ข้อ 3 ต้องโอนสิทธิ์ Owner ก่อน
UAT-37 ความปลอดภัยของบัญชี ทุก Role & Admin 1. สมัครแล้วเข้าสู่ระบบก่อนยืนยันอีเมล 2. ขอรีเซ็ตรหัสผ่านและใช้ลิงก์ซ้ำ 3. ล็อกอินผิดซ้ำเกินกำหนด 4. ใช้ Access Token ที่หมดอายุ แล้วต่ออายุด้วย Refresh Token 5. Admin ระงับบัญชีที่ยังมี Token ใช้งานอยู่ ข้อ 1 เข้าใช้งานไม่ได้; ข้อ 2 ใช้ลิงก์ได้ครั้งเดียว; ข้อ 3 ถูกจำกัดชั่วคราว (Rate Limit); ข้อ 4 Token เก่าถูกปฏิเสธ และ Token ใหม่มี Claim ล่าสุด; ข้อ 5 Token เดิมถูกปฏิเสธทันที (Denylist)
UAT-38 ประวัติสถานะและ Audit Log นักศึกษา & Admin 1. ดำเนินใบสมัครผ่านหลายสถานะ 2. ดู Timeline ใน Application Tracker 3. Admin ทำรายการ (เพิกถอนใบรับรอง, ตั้งธง, โอน Owner) แล้วเปิด Audit Log 4. พยายามแก้/ลบแถวใน status_history ผ่านระบบ Timeline แสดงครบทุกสถานะพร้อมผู้กระทำและเหตุผล; Audit Log บันทึกผู้กระทำ เป้าหมาย ค่าก่อน-หลัง; ไม่มีทางแก้หรือลบประวัติ (Append-only)
UAT-39 รายงานปัญหาระหว่างฝึกงาน นักศึกษา, อาจารย์, Admin & HR 1. นักศึกษาที่ IN_PROGRESS กดรายงานปัญหา 2. อาจารย์และ Admin เปิดดูและเปลี่ยนสถานะ (ACKNOWLEDGED → RESOLVED) 3. HR พยายามเข้าถึงรายงาน 4. นักศึกษาที่ไม่ได้ IN_PROGRESS พยายามรายงาน ข้อ 1 อาจารย์และ Admin ได้รับแจ้งพร้อมกัน; ข้อ 2 เปลี่ยนสถานะได้และอยู่ในรายการงานของ Admin; ข้อ 3 บริษัทมองไม่เห็น; ข้อ 4 ปุ่มไม่แสดง/ถูกปฏิเสธ; การรายงานไม่เปลี่ยนสถานะใบสมัครเอง
UAT-40 กฎห้ามสมัครซ้ำหลังผ่านวิชา นักศึกษา & Admin 1. นักศึกษาที่ ACADEMIC_PASS พยายามสมัครงานใหม่ 2. Admin ปลดล็อกให้ 3. นักศึกษาที่ ACADEMIC_FAIL / REPEAT_REQUIRED สมัครใหม่ ข้อ 1 ถูกบล็อกพร้อมเหตุผล; ข้อ 2 สมัครได้หลังปลดล็อก (บันทึก Audit Log); ข้อ 3 สมัครได้ตามปกติ
UAT-41 ข้อมูลบังคับของประกาศ HR 1. ส่งประกาศโดยไม่กรอกสถานที่/ชั่วโมงต่อสัปดาห์/เบี้ยเลี้ยง/สายงาน/Tag 2. ใส่ช่องทางติดต่อส่วนตัวในประกาศแล้วนักศึกษารายงานจนครบเกณฑ์ ข้อ 1 ส่งไม่ได้จนกว่าจะครบ (เบี้ยเลี้ยงเลือก "ไม่มี" ได้); ข้อ 2 ไม่มีการตรวจอัตโนมัติ งานถูกระงับ SUSPENDED ตามกติกา Report (5.1.3)
UAT-42 กติกาไฟล์ที่อัปโหลด นักศึกษา & HR 1. อัปโหลดเรซูเม่เป็น .exe ที่เปลี่ยนนามสกุลเป็น .pdf 2. อัปโหลดไฟล์ > 5 MB และโลโก้ > 2 MB 3. คัดลอกลิงก์ดาวน์โหลดเรซูเม่/ใบรับรองไปเปิดหลังเกินเวลา หรือเปิดโดยผู้ที่ไม่มีสิทธิ์ ข้อ 1–2 ถูกปฏิเสธ (ตรวจ MIME จริงและขนาด); ข้อ 3 Signed URL หมดอายุ/ขอใหม่ไม่ได้หากไม่มีสิทธิ์; เรซูเม่และใบรับรองอยู่ใน Private Bucket (เข้าตรง URL ไม่ได้); โลโก้แสดงสาธารณะได้
UAT-43 การปิดประกาศขณะมีใบสมัครค้าง HR & นักศึกษา 1. HR ปิดรับ (CLOSED) ประกาศที่มีใบสมัคร PENDING, HR_ACCEPTED และ IN_PROGRESS 2. นักศึกษาใหม่พยายามสมัคร 3. HR ตอบรับผู้สมัครที่ค้างอยู่ ข้อ 1 ใบสมัครเดิมไม่ถูกกระทบ; ข้อ 2 สมัครไม่ได้; ข้อ 3 ตอบรับได้หากโควตายังเหลือ
UAT-44 การโอน Owner และป้าย University Partner HR (Owner), HR Member & Admin 1. Owner เชิญ HR Member 2. Owner โอนสิทธิ์ให้ Member และผู้รับกดยืนยัน 3. Admin แต่งตั้ง Owner ให้บริษัทที่ไม่มี Owner 4. Admin ติดป้าย University Partner ข้อ 2 Owner เดิมกลายเป็น Member; ข้อ 3 แต่งตั้งได้และบันทึก Audit Log; ข้อ 4 ป้ายขึ้นบนการ์ดงานและ Directory (ผ่าน CompanyStatusChanged); Member จัดการสมาชิกไม่ได้
UAT-45 Scheduler ไม่ส่งเตือนซ้ำ ระบบ & Tester (ปรับ config ให้เร็วขึ้น) 1. รัน Scheduler สองตัวพร้อมกัน/รีสตาร์ตระหว่างรอบ 2. ตรวจจำนวนการแจ้งเตือนและ reminder_log แต่ละการเตือนถูกส่งเพียงครั้งเดียวต่อรายการ ต่อประเภท ต่อวันกำหนด (Unique Key); EXPIRED ไม่ถูกทำซ้ำ
UAT-46 Outbox, Reconciliation และ Correlation ID ระบบ & Tester 1. หยุด RabbitMQ ชั่วคราวระหว่างเปลี่ยนสถานะใบสมัคร แล้วเปิดกลับ 2. สร้างกรณีจองโควตาสำเร็จแต่สร้างใบสมัครล้มเหลว แล้วรอรอบตรวจกระทบยอด 3. ไล่ Log ของคำขอเดียวข้าม Service ข้อ 1 Event ไม่หาย ถูกส่งหลังเปิด Broker (Outbox) และผู้รับไม่ทำซ้ำ; ข้อ 2 โควตาที่ค้างถูกคืนอัตโนมัติ; ข้อ 3 พบ correlation_id เดียวกันตลอดสาย
UAT-47 ผ่านการประเมินแต่ยังไม่ออกใบรับรอง HR, Admin & นักศึกษา (ปรับ config ให้เร็วขึ้น) 1. HR กด PASS ให้ผู้ที่ฝึกครบ ≥ 30 วัน แต่ไม่กดออก E-Certificate 2. รอผ่านวันที่ 3 และ 14 เตือน HR วันที่ 3; แจ้ง Admin วันที่ 14; นักศึกษาเห็นสถานะว่ารอบริษัทออกใบรับรอง

11. สมาชิกในทีมและการแบ่งความรับผิดชอบ (Team Members)

สมาชิก

ลำดับ ชื่อ-นามสกุล รหัสนักศึกษา ตำแหน่ง
1 นายธนกฤต เพ็ชรกำจัด 67115588 PM
2 นายนิรินทร์ เทพิสุทธิพันธุ์ 67132694 SA
3 นายอนันยศ ชัยชนะ 67097950 Tester
4 นายณัชพล วงศาจันทร์ 67107433 Junior Developer

หน้าที่ที่รับผิดชอบ

ตำแหน่ง หน้าที่หลักที่รับผิดชอบ
PM คุมภาพรวมโครงการ; จัดทำและอัปเดตเอกสารเทคนิคทั้งหมดใน docs/ (README, API Contract, Application State Machine, Event Catalog, Database Schema) และวางโครง Monorepo กับเทมเพลต Service, Docker Compose และ CI; ออกแบบ Business Logic ของระบบ Trust (Report Abuse, UNDER_REVIEW, Review Moderation) และดูแล Verification & Trust Service พร้อมหน้า Admin ของคิวที่เกี่ยวข้อง; ดูแล โครงเว็บรวมใน apps/web (Header, Footer, เมนูตามบทบาท, Admin Shell/Sidebar, การเปลี่ยนเส้นทางตามสิทธิ์), หน้าแรก (Landing Page) และหน้านโยบายความเป็นส่วนตัว; ดูแล หน้าเว็บฝั่งผู้ใช้ทั้งหมดที่ไม่ใช่หน้า Admin (ค้นหาและรายละเอียดงาน, ฝั่ง HR, ฝั่งนักศึกษา, Company Directory, บัญชีและองค์กร, ศูนย์แจ้งเตือน — ตามตารางด้านล่าง ยกเว้นหน้าที่ระบุเป็นของ Tester) โดยเจ้าของ Service จัดเตรียม API และ contract ที่หน้าเว็บเรียก; ร่วมเป็นผู้ทดสอบหลักของ Lifecycle Service
SA Identity & Organization Service (บัญชีและความปลอดภัย, อาจารย์ที่ปรึกษา, บริษัท, สิทธิ์ Featured/Fast-Track, ป้าย University Partner และ Company Directory) พร้อมหน้า Admin ของ Service นี้ และ API Gateway (Routing, ตรวจ Token, Rate Limit)
Tester Student Experience & Internship Lifecycle Service (State Machine ใบสมัคร, SLA Scheduler, หน้าอาจารย์อนุมัติ/บันทึกผล, หน้า HR ประเมินและออก E-Certificate, รีวิวบริษัท, รายงานปัญหาระหว่างฝึกงาน, API ของโปรไฟล์และ Application Tracker — หน้าเว็บส่วนนี้ PM ทำ); วางเทมเพลตการทดสอบ (Mocha + Chai + Sinon + c8) และทำ UAT Testing ของ Service อื่น (Verification, Identity, Job Management, Notification)
Junior Developer Job Management Service (ประกาศงานฝั่ง HR, สถานะประกาศงาน, โควตาตำแหน่งแบบ Atomic และ Job Search) และ Notification Service; ออกแบบ UI/UX (Figma); ร่วมเป็นผู้ทดสอบหลักของ Lifecycle Service

หลักการแบ่งงาน

  • ทุก Service มีเจ้าของคนเดียว และเจ้าของดูแลหน้า Admin ของ Service ตนเอง โดยเสียบหน้าเข้า Admin Shell กลางที่ PM ทำใน apps/web และสร้างหน้าจากรายการ endpoint /admin/** ของ Service ตนใน docs/api-contract.md (ยังไม่มี UI Kit กลาง: ใช้ Design Token ใน apps/web/tailwind.config.ts ตามหัวข้อ 8 ไปก่อน)
  • หน้าเว็บฝั่งผู้ใช้ที่ไม่ใช่หน้า Admin เป็นของ PM (ยกเว้นหน้าที่ตารางด้านล่างระบุเป็นของ Tester) เจ้าของ Service รับผิดชอบ API และ contract ที่หน้าเว็บเรียก และแจ้ง PM เมื่อ endpoint พร้อมใช้งาน
  • ผู้ทดสอบไม่ใช่เจ้าของ Service ที่ทดสอบ: Lifecycle ทดสอบโดย PM และ Junior; Service อื่นทดสอบโดย Tester
  • เอกสารเทคนิคทั้งหมดและโครงพื้นฐานของ Monorepo จัดทำโดย PM

เจ้าของหน้า Admin ตาม Service (สร้างหน้าจาก endpoint ใน docs/api-contract.md; Gateway ส่ง /admin/** ไป Service เจ้าของตามตาราง §3)

เจ้าของ Service หน้า Admin ที่ต้องมี
SA Identity รายการและรายละเอียดบริษัท (กรองตามสถานะ, เอกสารและเกณฑ์อนุมัติ); ปุ่ม verify / need-more-info / reject / suspend / unsuspend; ตั้ง University Partner; ตั้งสิทธิ์ Featured และ Fast-Track; แต่งตั้ง Owner บริษัท; รายการอาจารย์ที่รออนุมัติ (approve / reject); ย้ายอาจารย์ที่ปรึกษาของนักศึกษา; ระงับ/ปลดระงับผู้ใช้; Audit log ของ Identity (/admin/audit-logs)
Tester Lifecycle ใบสมัครที่ HR ไม่ประเมินเกิน 14 วัน และยืนยัน NO_EVALUATION; ยุติใบสมัคร (terminate); เพิกถอนใบรับรอง; ปลดล็อกการสมัครซ้ำของนักศึกษา; รายการรายงานปัญหาระหว่างฝึกงาน; สถิติบริษัท (ถอนข้อเสนอ/ยุติ); Audit log ของ Lifecycle (/admin/lifecycle/audit-logs)
PM Verification คิวตรวจแบบไฟจราจร (ประกาศของบริษัทที่ติดธง, รายงานประกาศ, ธงบริษัท, รายงานรีวิว) พร้อมปุ่มตัดสิน; ธงบริษัท UNDER_REVIEW; Audit log ของ Verification (/admin/audit)
Junior Job รายการประกาศทุกสถานะ (GET /admin/jobs, ไว้อ้างอิงจากคิว) — Notification ไม่มีหน้า Admin

เจ้าของหน้าที่ไม่ใช่หน้า Admin

หน้า เจ้าของ หมายเหตุ
โครงเว็บรวม: Header, Footer, เมนูตามบทบาท, Admin Shell/Sidebar, การเปลี่ยนเส้นทางเมื่อยังไม่ล็อกอินหรือผิดบทบาท, 404/หน้า Error PM เจ้าของอื่นเสียบหน้า Admin เข้าโครงนี้
หน้าแรก (Landing Page), หน้านโยบายความเป็นส่วนตัว PM หน้าแรกใช้ข้อมูลจำลองจนกว่าจะมี endpoint สาธารณะของงานและบริษัท (ต้องตกลงและเพิ่มใน api-contract ก่อน)
หน้า Auth/Account ที่ทำแล้ว (สมัคร, ล็อกอิน, ยืนยันอีเมล, รีเซ็ตรหัสผ่าน, ปลดล็อก, บัญชี) SA (ทำแล้ว) PM ดูแลต่อเมื่อต้องแก้
ออนบอร์ดดิ้งและโปรไฟล์บริษัท, จัดการสมาชิก HR และโอน Owner, สายงานของสมาชิก HR, PDPA consent, ลบบัญชี PM API: SA (Identity); ลบบัญชี: Tester ทำ endpoint ตาม api-contract §4.2 และ §9
ค้นหางานและรายละเอียดงาน (กรองด้วย Tag ทักษะ) PM API: Junior (Job Search), SA (Directory สำหรับป้ายและคะแนนบริษัท)
ฟอร์มเพิ่มนักศึกษาโดยอาจารย์, รายชื่อนักศึกษาของอาจารย์พร้อมตัวกรอง (ชั้นปี / กำลังฝึกงาน / ฝึกงานเสร็จแล้ว) PM API: SA (Identity: สร้างนักศึกษา/คำเชิญ), Lifecycle (ตัวกรองสถานะการฝึกงาน)
หน้า Admin: จัดการรายการ Tag ทักษะกลาง PM API: Junior (Job: /admin/tags)
ฟอร์มสร้าง/แก้ประกาศ (เลือก Tag ทักษะ), รายการประกาศของ HR (ตามสายงานของสมาชิก) PM API: Junior (HR Job); ผลตรวจเฉพาะบริษัทที่ติดธงดูจากสถานะประกาศ
ปุ่มรายงานประกาศและรายงานรีวิว PM เรียก POST /jobs/{id}/reports และ POST /reviews/{id}/reports ของ Verification
Company Directory ("บริษัทและรีวิว") PM API: SA (/directory/**), Tester (GET /companies/{id}/reviews)
ศูนย์แจ้งเตือน In-App PM API: Junior (Notification)
กระดานผู้สมัครของ HR; สมัครงาน, เรซูเม่, โปรไฟล์นักศึกษา, Application Tracker PM API: Tester (Lifecycle)
หน้าอาจารย์อนุมัติ/บันทึกผล, หน้า HR ประเมินและออกใบรับรอง, เขียนรีวิว, รายงานปัญหาระหว่างฝึกงาน, หน้าตรวจใบรับรองสาธารณะ Tester คงตามหน้าที่เดิมใน §11

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages