📘 คู่มือการใช้งาน Smart Nurse Rostering System

ระบบจัดตารางเวรพยาบาลอัจฉริยะ

เวอร์ชัน 1.6 | อัปเดตล่าสุด: มีนาคม 2569

สารบัญ

1. บทนำ
2. เริ่มต้นใช้งาน (Getting Started)
3. ตั้งค่าองค์กร (Organization Setup)
   • 3.6 วันหยุดราชการ
   • 3.7 ใบอนุญาตวิชาชีพ
   • 3.8 ทักษะเฉพาะทาง
   • 3.9 ทักษะที่หน่วยงานต้องการ
   • 3.10 ประวัติการอบรม
   • 3.11 ค่าตอบแทนเวร
4. การจัดเวร (Scheduling)
   • 4.7 กำหนดเวรเรียกตัว (On-call)
   • 4.8 แก้ไขเวรแบบรวดเร็ว (Inline Edit)
   • 4.9 ลากย้ายเวร (Drag & Drop)
5. บริการตนเอง (Self-Service)
   • 5.6 คำขอเวรล่วงหน้า
   • 5.7 ส่งออกปฏิทิน
   • 5.8 ขอเปลี่ยนเวร (Shift Change Request)
   • 5.9 ดูค่าตอบแทนเวร
6. การอนุมัติ (Approval)
7. รายงาน (Reports)
   • 7.5 HA Compliance Report
8. การแจ้งเตือน (Notifications)
   • 8.7 แจ้งเตือนผ่าน LINE OA
   • 8.8 แชทภายในทีม
9. การชำระเงินและอัปเกรด (SAAS)
10. ภาคผนวก

1. บทนำ

1.1 ภาพรวมระบบ

Smart Nurse Rostering System เป็นระบบจัดตารางเวรพยาบาลอัจฉริยะที่ใช้เทคโนโลยี AI (CSP Solver) ในการสร้างตารางเวรโดยอัตโนมัติ พร้อมระบบจัดการครบวงจร ตั้งแต่การจำแนกผู้ป่วย คำนวณภาระงาน สร้างตารางเวร บริการตนเองของพยาบาล ไปจนถึงรายงานและการแจ้งเตือน

ระบบรองรับทั้งโหมด SAAS (หลายองค์กร) และ SINGLE_SITE (องค์กรเดียว)

1.2 ความสามารถหลัก (Key Features)

1.3 บทบาทในระบบ (Roles)

ระบบมี 5 บทบาทหลัก:

ระดับพยาบาล (Nurse Level) — 3 ระดับ:

1.4 ตารางสิทธิ์การเข้าถึง (Role-Access Matrix)

2. เริ่มต้นใช้งาน

Flow การเริ่มต้น

สมัครสมาชิก → ยืนยัน OTP → เข้าสู่ระบบ → ตั้งค่าโปรไฟล์

2.1 สมัครสมาชิก (Register)

📍 หน้า: /register 👤 สิทธิ์: สาธารณะ (ไม่ต้อง login)

วัตถุประสงค์: สร้างบัญชีองค์กรใหม่ในระบบ (SAAS mode)

ขั้นตอน:

1. เปิดหน้าเว็บระบบ → คลิก "สมัครสมาชิก"
2. กรอกข้อมูล:
   • ชื่อองค์กร — ชื่อโรงพยาบาลหรือหน่วยงาน
   • ชื่อ-นามสกุล — ชื่อผู้ดูแลระบบ
   • อีเมล — อีเมลสำหรับเข้าสู่ระบบ
   • รหัสผ่าน — ตั้งรหัสผ่าน (ไม่น้อยกว่า 8 ตัวอักษร)
   • ยืนยันรหัสผ่าน — กรอกรหัสผ่านซ้ำ
3. คลิก "สมัครสมาชิก"
4. ระบบจะสร้าง Tenant + User (บทบาท Hospital Admin) + Subscription ทดลองใช้งาน 30 วัน
5. ระบบจะส่งรหัส OTP ไปยังอีเมลที่ลงทะเบียน

2.2 ยืนยันอีเมล OTP

📍 หน้า: /verify-email 👤 สิทธิ์: สาธารณะ

วัตถุประสงค์: ยืนยันตัวตนผ่านรหัส OTP ที่ส่งทางอีเมล

ขั้นตอน:

1. ตรวจสอบอีเมล (รวมถึงโฟลเดอร์ Spam/Junk)
2. กรอกรหัส OTP 6 หลักที่ได้รับ
3. คลิก "ยืนยัน"
4. ระบบจะ activate บัญชีผู้ใช้และ Tenant โดยอัตโนมัติ
5. เข้าสู่ระบบอัตโนมัติ → redirect ไปหน้า Dashboard

2.3 เข้าสู่ระบบ (Login)

📍 หน้า: /login 👤 สิทธิ์: สาธารณะ

วัตถุประสงค์: เข้าสู่ระบบด้วยอีเมลและรหัสผ่าน

ขั้นตอน:

1. กรอก อีเมล ที่ลงทะเบียน
2. กรอก รหัสผ่าน
3. คลิก "เข้าสู่ระบบ"
4. ระบบจะตรวจสอบสิทธิ์:
   • หากยังไม่ยืนยันอีเมล → redirect ไป /verify-email
   • หากตรวจสอบสำเร็จ → redirect ไป /dashboard

2.4 ภาพรวม Dashboard (Analytics)

📍 หน้า: /dashboard 👤 สิทธิ์: ทุก Role (แสดงข้อมูลต่างกันตาม Role)

วัตถุประสงค์: แสดงภาพรวมสถิติ กราฟวิเคราะห์ และข้อมูลเชิงลึก พร้อมตัวเลือกเดือน/ปี

Dashboard สำหรับผู้บริหาร (HOSPITAL_ADMIN / NURSING_DIRECTOR)

KPI Cards 5 ตัว: พยาบาลทั้งหมด | หน่วยงาน | เวรเดือนนี้ | คำขอรอดำเนินการ | ใบอนุญาตใกล้หมดอายุ

กราฟวิเคราะห์:

Dashboard สำหรับหัวหน้าพยาบาล (HEAD_NURSE)

KPI Cards 5 ตัว: พยาบาลในหน่วย | เวรเดือนนี้ | คำขอรอดำเนินการ | ใบอนุญาตใกล้หมด | ดัชนีความเป็นธรรม

กราฟวิเคราะห์:

Dashboard สำหรับพยาบาล (STAFF_NURSE / NURSE_ASSISTANT)

KPI Cards 4 ตัว: เวรเดือนนี้ | ชั่วโมงทำงาน | ล่วงเวลา (OT) | คำขอรอดำเนินการ

กราฟวิเคราะห์:

2.5 จัดการโปรไฟล์

📍 หน้า: /profile 👤 สิทธิ์: ทุก Role

วัตถุประสงค์: ดูและแก้ไขข้อมูลส่วนตัว เปลี่ยนรหัสผ่าน อัปโหลดรูปโปรไฟล์

Tab 1: ข้อมูลส่วนตัว

1. ดู/แก้ไข รูปโปรไฟล์ — คลิกที่ avatar เพื่ออัปโหลดรูปใหม่
2. แก้ไข ชื่อ-นามสกุล
3. แก้ไข เบอร์โทรศัพท์
4. คลิก "บันทึก"

Tab 2: เปลี่ยนรหัสผ่าน

1. กรอก รหัสผ่านปัจจุบัน
2. กรอก รหัสผ่านใหม่ (ไม่น้อยกว่า 8 ตัวอักษร)
3. กรอก ยืนยันรหัสผ่านใหม่
4. คลิก "เปลี่ยนรหัสผ่าน"

3. ตั้งค่าองค์กร

Flow การตั้งค่าองค์กร

โรงพยาบาล → แผนก → หน่วยงาน/วอร์ด → พยาบาล (เพิ่มที่เมนู "พยาบาล")

3.1 เพิ่มโรงพยาบาล

📍 หน้า: /settings/hospitals 👤 สิทธิ์: HOSPITAL_ADMIN

วัตถุประสงค์: เพิ่ม/แก้ไข/ลบ โรงพยาบาลในองค์กร

ขั้นตอนการเพิ่ม:

1. คลิกปุ่ม "+ เพิ่มโรงพยาบาล"
2. กรอกข้อมูลในป๊อปอัพ:
   • ชื่อโรงพยาบาล (จำเป็น)
   • ที่อยู่ (ไม่บังคับ)
3. คลิก "บันทึก"

การแก้ไข:

1. คลิกไอคอน ✏️ ที่รายการโรงพยาบาล
2. แก้ไขข้อมูล → คลิก "บันทึก"

การลบ:

1. คลิกไอคอน 🗑️ ที่รายการ
2. ยืนยันการลบในป๊อปอัพ → คลิก "ลบ"

3.2 เพิ่มแผนก

📍 หน้า: /settings/departments 👤 สิทธิ์: HOSPITAL_ADMIN

วัตถุประสงค์: เพิ่ม/แก้ไข/ลบ แผนกในแต่ละโรงพยาบาล

ประเภทแผนก 6 ประเภท:

ขั้นตอนการเพิ่ม:

1. เลือก โรงพยาบาล จาก dropdown
2. คลิกปุ่ม "+ เพิ่มแผนก"
3. กรอกข้อมูล:
   • ชื่อแผนก (จำเป็น)
   • ประเภทแผนก (เลือกจาก 6 ประเภท)
4. คลิก "บันทึก"

3.3 เพิ่มหน่วยงาน/วอร์ด

📍 หน้า: /settings/units 👤 สิทธิ์: HOSPITAL_ADMIN

วัตถุประสงค์: เพิ่ม/แก้ไข/ลบ หน่วยงานหรือวอร์ดในแต่ละแผนก

ตารางแสดงข้อมูลหน่วยงาน:

• เช้า / บ่าย / ดึก — แสดงรายละเอียดแต่ละกะ: เวลา, ชม./กะ, จำนวนขั้นต่ำ, RN ขั้นต่ำ (ถ้ากะปิดจะแสดง "ปิด")
• พยาบาล — จำนวนพยาบาลที่สังกัดหน่วยงาน
• ระบบเวร — แสดงชื่อ Preset ที่ใช้ เช่น "เช้า-บ่าย-ดึก (มาตรฐาน)" หรือ "กำหนดเอง"

ขั้นตอนการเพิ่ม:

1. เลือก โรงพยาบาล → เลือก แผนก (cascade dropdown)
2. คลิกปุ่ม "+ เพิ่มหน่วยงาน"
3. กรอกข้อมูล:
   • ชื่อหน่วยงาน/วอร์ด (จำเป็น)
4. คลิก "บันทึก"

นำเข้าหน่วยงานจาก Excel (Bulk Import)

👤 สิทธิ์: HOSPITAL_ADMIN, NURSING_DIRECTOR

ขั้นตอน:

1. คลิกปุ่ม "นำเข้า Excel" (สีเขียว) ที่มุมขวาบน
2. เลือก โรงพยาบาล → เลือก แผนก ที่ต้องการนำเข้า
3. คลิก "ดาวน์โหลด Template Excel" เพื่อดาวน์โหลดแม่แบบ
4. กรอกข้อมูลในไฟล์ Excel ตั้งแต่แถวที่ 3 (แถว 2 เป็นตัวอย่าง ลบได้):
   • ชื่อหน่วยงาน (จำเป็น)
   • จำนวนพยาบาลขั้นต่ำ/เวร (ค่าเริ่มต้น: 2)
   • จำนวนพยาบาลสูงสุด/เวร (ค่าเริ่มต้น: 10)
5. เลือกไฟล์ Excel แล้วคลิก "นำเข้า"
6. ระบบแสดงผลลัพธ์: จำนวนที่สร้างสำเร็จ / ข้าม (ซ้ำ) / ผิดพลาด

ตั้งค่าระบบเวร (Shift System)

คลิกปุ่ม นาฬิกา (⏰) ที่หน่วยงาน → เปิด Modal ตั้งค่า

เลือก Preset ระบบเวร:

เมื่อเลือก Preset ระบบจะตั้งค่าเวลากะ + กฎการจัดเวรให้อัตโนมัติ สามารถปรับแต่งเพิ่มเติมได้

ตั้งค่ากฎการจัดเวร (RuleSet):

3.4 จัดการผู้ใช้

📍 หน้า: /settings/users 👤 สิทธิ์: HOSPITAL_ADMIN

วัตถุประสงค์: เพิ่มผู้ใช้ที่ ไม่ใช่พยาบาล เข้าสู่ระบบ (เช่น ผู้ดูแลระบบ, ผู้อำนวยการฝ่ายการพยาบาล) หรือจัดการบัญชีผู้ใช้ทั้งหมด

ขั้นตอนการเพิ่มผู้ใช้ (สำหรับ Role ที่ไม่ใช่พยาบาล):

1. ไปที่ "ตั้งค่า" → "ผู้ใช้งาน" (/settings/users)
2. คลิกปุ่ม "+ เพิ่มผู้ใช้"
3. กรอกข้อมูล:
   • อีเมล — อีเมลสำหรับเข้าสู่ระบบ
   • รหัสผ่าน — ตั้งรหัสผ่าน (ไม่น้อยกว่า 8 ตัวอักษร)
   • ชื่อ-นามสกุล
4. กำหนด บทบาท (Role) ให้ผู้ใช้:
   • HOSPITAL_ADMIN — ผู้ดูแลระบบ
   • NURSING_DIRECTOR — ผู้อำนวยการฝ่ายการพยาบาล
5. คลิก "บันทึก"
6. ผู้ใช้จะได้รับอีเมลยืนยัน

3.5 เพิ่มข้อมูลพยาบาล

📍 หน้า: /nurses (รายการ), /nurses/new (เพิ่ม), /nurses/[id] (แก้ไข) 👤 สิทธิ์: HOSPITAL_ADMIN, NURSING_DIRECTOR, HEAD_NURSE

วัตถุประสงค์: เพิ่มพยาบาลใหม่เข้าสู่ระบบ — ระบบจะสร้างบัญชีผู้ใช้ + โปรไฟล์พยาบาลให้อัตโนมัติในขั้นตอนเดียว (ไม่ต้องไปสร้างบัญชีผู้ใช้แยกก่อน)

ขั้นตอนการเพิ่ม:

1. ไปที่เมนู "พยาบาล" (/nurses) → คลิก "+ เพิ่มพยาบาลใหม่"
2. กรอกข้อมูลบัญชีผู้ใช้:
   • อีเมล — อีเมลสำหรับเข้าสู่ระบบ (ต้องไม่ซ้ำกับที่มีในระบบ)
   • รหัสผ่าน — ตั้งรหัสผ่านเริ่มต้น (ไม่น้อยกว่า 8 ตัวอักษร)
   • ชื่อ-นามสกุล
3. กำหนดตำแหน่ง:
   • บทบาท — HEAD_NURSE / STAFF_NURSE / NURSE_ASSISTANT
4. เลือกสังกัด:
   • โรงพยาบาล → แผนก → หน่วยงาน (cascade dropdown)
5. กรอกข้อมูลพยาบาล:
   • ระดับพยาบาล — RN / PN / NA
   • ประเภทสัญญา — FULL_TIME / PART_TIME / OUTSOURCED / FLOAT_POOL
   • ประสบการณ์ (ปี)
   • จำนวนชั่วโมงทำงานสูงสุด/สัปดาห์
   • จำนวนเวรดึกสูงสุด/เดือน
6. คลิก "บันทึก"

การดูรายการพยาบาล:

• กรองตาม ระดับพยาบาล (RN/PN/NA)
• Mobile: แสดงเป็น Card view
• Desktop: แสดงเป็น Table view
• คลิกที่รายการเพื่อดู/แก้ไขรายละเอียด

การลบพยาบาล:

1. คลิกไอคอน 🗑️ ที่รายการ
2. ยืนยันการลบในป๊อปอัพ → คลิก "ลบ"

การนำเข้าจาก Excel (Bulk Import):

สำหรับเพิ่มพยาบาลจำนวนมากพร้อมกัน ระบบสร้างบัญชีผู้ใช้ + โปรไฟล์พยาบาลอัตโนมัติ

1. ไปที่หน้า พยาบาล → คลิก "นำเข้า Excel"
2. คลิก "ดาวน์โหลดแบบฟอร์ม Excel" เพื่อรับ template
3. กรอกข้อมูลใน template:
   • คอลัมน์ที่ต้องกรอก: ชื่อ, นามสกุล, อีเมล, ระดับพยาบาล (RN/PN/NA)
   • คอลัมน์เพิ่มเติม (ไม่บังคับ): เบอร์โทร, บทบาท, ประเภทสัญญา, ประสบการณ์, วันเริ่มงาน ฯลฯ
   • แถวที่ 1 คือหัวตาราง, แถวที่ 2 คือตัวอย่าง → กรอกข้อมูลจริงตั้งแต่แถวที่ 3
4. เลือก โรงพยาบาล → แผนก → หน่วยงาน ที่ต้องการเพิ่มพยาบาลเข้าไป
5. ตั้ง รหัสผ่านเริ่มต้น (ค่าเริ่มต้น: Nurse@1234)
6. เลือกไฟล์ .xlsx ที่กรอกแล้ว → คลิก "นำเข้า"
7. ระบบจะแสดง ผลลัพธ์: จำนวนที่สร้างสำเร็จ, ข้ามเนื่องจากซ้ำ, ผิดพลาด

กฎการตรวจสอบซ้ำ:

• อีเมลซ้ำ — ข้ามอัตโนมัติ (ทั้งซ้ำในไฟล์และซ้ำกับที่มีในระบบ)
• ชื่อ-นามสกุลซ้ำ — ข้ามอัตโนมัติ

3.6 วันหยุดราชการ (Thai Holidays)

📍 หน้า: /settings/holidays 👤 สิทธิ์: HOSPITAL_ADMIN

วัตถุประสงค์: จัดการปฏิทินวันหยุดราชการไทย ใช้ประกอบการจัดเวรอัตโนมัติ

วันหยุดเริ่มต้น: ระบบมีวันหยุดราชการไทยมาตรฐาน 20+ วัน/ปี (วันขึ้นปีใหม่, วันมาฆบูชา, วันจักรี, วันสงกรานต์, วันแรงงาน, วันฉัตรมงคล, วันวิสาขบูชา, วันเฉลิมพระชนมพรรษาฯ, วันอาสาฬหบูชา, วันเข้าพรรษา, วันแม่แห่งชาติ, วันปิยมหาราช, วันพ่อแห่งชาติ, วันรัฐธรรมนูญ, วันสิ้นปี ฯลฯ)

ขั้นตอน:

1. เลือก ปี จาก dropdown (แสดงเป็น พ.ศ.)
2. คลิก "นำเข้าวันหยุดเริ่มต้น" เพื่อ seed วันหยุดเริ่มต้นของปีนั้น (ครั้งแรก)
3. ดูรายการวันหยุดทั้งหมดในปีที่เลือก

การเพิ่มวันหยุดเฉพาะองค์กร:

1. คลิกปุ่ม "เพิ่มวันหยุด"
2. กรอกข้อมูล: วันที่, ชื่อวันหยุด (อังกฤษ/ไทย), เป็นวันหยุดประจำปีหรือไม่
3. คลิก "บันทึก"

นำเข้าวันหยุดจาก Excel (Bulk Import)

👤 สิทธิ์: HOSPITAL_ADMIN

ขั้นตอน:

1. ไปที่หน้า "ตั้งค่า" → "วันหยุดราชการ" (/settings/holidays)
2. คลิกปุ่ม "นำเข้า Excel" (สีเขียว) ที่มุมขวาบน
3. คลิก "ดาวน์โหลด Template Excel" เพื่อดาวน์โหลดแม่แบบ (ระบบจะสร้าง template ตามปีที่เลือกอยู่)
4. กรอกข้อมูลในไฟล์ Excel ตั้งแต่แถวที่ 3 (แถว 2 เป็นตัวอย่าง ลบได้):
   • วันที่ (YYYY-MM-DD) (จำเป็น) — เช่น 2026-01-01
   • ชื่อวันหยุด (EN) (จำเป็น) — ชื่อภาษาอังกฤษ
   • ชื่อวันหยุด (TH) (จำเป็น) — ชื่อภาษาไทย
   • เป็นวันหยุดประจำปี — เลือก "ใช่" หรือ "ไม่ใช่" (ค่าเริ่มต้น: ไม่ใช่)
5. เลือกไฟล์ที่กรอกแล้ว (.xlsx) แล้วคลิก "นำเข้า"
6. ระบบแสดงผลลัพธ์: จำนวนที่สร้างสำเร็จ / ข้าม (ซ้ำ) / ผิดพลาด

3.7 ใบอนุญาตวิชาชีพ (Nurse Licenses)

📍 หน้า: /nurses/[id]/licenses 👤 สิทธิ์: HEAD_NURSE, NURSING_DIRECTOR, HOSPITAL_ADMIN (จัดการ) / ทุก Role (ดู)

วัตถุประสงค์: จัดการใบอนุญาตวิชาชีพของพยาบาลแต่ละคน ติดตามวันหมดอายุ

ประเภทใบอนุญาต 7 ประเภท:

ขั้นตอนการเพิ่ม:

1. ไปที่หน้า พยาบาล → คลิกที่พยาบาล → เลือกแท็บ "ใบอนุญาต"
2. คลิกปุ่ม "เพิ่มใบอนุญาต" → กรอกข้อมูล: ประเภท, เลขที่, วันที่ออก, วันหมดอายุ
3. คลิก "บันทึก"

แจ้งเตือนใบอนุญาตหมดอายุ:

• 🔴 สีแดง: หมดอายุภายใน 30 วัน
• 🟡 สีเหลือง: หมดอายุภายใน 90 วัน
• 🟢 สีเขียว: มากกว่า 90 วัน

นำเข้าใบอนุญาตวิชาชีพจาก Excel (Bulk Import)

👤 สิทธิ์: HEAD_NURSE, NURSING_DIRECTOR, HOSPITAL_ADMIN

สำหรับเพิ่มใบอนุญาตวิชาชีพของพยาบาลหลายคนพร้อมกัน ผ่านหน้า พยาบาล (/nurses)

ขั้นตอน:

1. ไปที่หน้า พยาบาล → คลิกปุ่ม "นำเข้า Excel"
2. ในช่อง "ประเภทการนำเข้า" เลือก "ใบอนุญาตวิชาชีพ"
3. เลือก โรงพยาบาล → แผนก → หน่วยงาน ที่ต้องการนำเข้า
4. คลิก "ดาวน์โหลดแบบฟอร์ม Excel (ใบอนุญาตวิชาชีพ)" — template จะมีรายชื่อพยาบาลในหน่วยงานที่เลือกไว้ให้อ้างอิง (แผ่น "รายชื่อพยาบาล")
5. กรอกข้อมูลในไฟล์ Excel ตั้งแต่แถวที่ 3 (แถว 2 เป็นตัวอย่าง ลบได้):
   • อีเมลพยาบาล (จำเป็น) — ต้องตรงกับอีเมลในระบบ
   • ประเภทใบอนุญาต (จำเป็น) — เลือกจาก dropdown: RN_LICENSE, MIDWIFE_LICENSE, PN_LICENSE, CPR_CERT, BLS_CERT, ACLS_CERT, OTHER
   • เลขที่ใบอนุญาต (จำเป็น)
   • วันที่ออก (YYYY-MM-DD) (จำเป็น)
   • วันหมดอายุ (YYYY-MM-DD) (จำเป็น)
   • เปิดใช้งาน — "ใช่" หรือ "ไม่ใช่" (ค่าเริ่มต้น: ใช่)
6. เลือกไฟล์ที่กรอกแล้ว (.xlsx) แล้วคลิก "นำเข้า"

กฎการตรวจสอบซ้ำ:

• พยาบาล 1 คนมีใบอนุญาตแต่ละประเภทได้ 1 ใบ — ถ้าซ้ำจะถูกข้าม
• อีเมลที่ไม่พบในหน่วยงานที่เลือก จะแสดงเป็นข้อผิดพลาด

3.8 ทักษะเฉพาะทาง (Nurse Competencies)

📍 หน้า: /nurses/[id]/competencies 👤 สิทธิ์: HEAD_NURSE, NURSING_DIRECTOR, HOSPITAL_ADMIN (จัดการ) / ทุก Role (ดู)

วัตถุประสงค์: บันทึกทักษะเฉพาะทางของพยาบาล (เช่น ICU, OR, ER, VENTILATOR)

ระดับทักษะ 4 ระดับ: BASIC (เบื้องต้น), INTERMEDIATE (ปานกลาง), ADVANCED (สูง), EXPERT (เชี่ยวชาญ)

ขั้นตอนการเพิ่ม:

1. ไปที่หน้าพยาบาล → คลิกที่พยาบาล → แท็บ "ทักษะ"
2. คลิกปุ่ม "เพิ่มทักษะ" → กรอก: ชื่อทักษะ, ระดับ, วันที่ได้รับรอง, วันหมดอายุ
3. คลิก "บันทึก"

นำเข้าทักษะเฉพาะทางจาก Excel (Bulk Import)

👤 สิทธิ์: HEAD_NURSE, NURSING_DIRECTOR, HOSPITAL_ADMIN

สำหรับเพิ่มทักษะเฉพาะทางของพยาบาลหลายคนพร้อมกัน ผ่านหน้า พยาบาล (/nurses)

ขั้นตอน:

1. ไปที่หน้า พยาบาล → คลิกปุ่ม "นำเข้า Excel"
2. ในช่อง "ประเภทการนำเข้า" เลือก "ทักษะเฉพาะทาง"
3. เลือก โรงพยาบาล → แผนก → หน่วยงาน ที่ต้องการนำเข้า
4. คลิก "ดาวน์โหลดแบบฟอร์ม Excel (ทักษะเฉพาะทาง)" — template จะมีรายชื่อพยาบาลในหน่วยงานให้อ้างอิง
5. กรอกข้อมูลในไฟล์ Excel ตั้งแต่แถวที่ 3 (แถว 2 เป็นตัวอย่าง ลบได้):
   • อีเมลพยาบาล (จำเป็น) — ต้องตรงกับอีเมลในระบบ
   • ชื่อทักษะ (จำเป็น) — เช่น ICU Care, Ventilator, OR Scrub
   • ระดับ — เลือกจาก dropdown: BASIC (พื้นฐาน), INTERMEDIATE (ปานกลาง), ADVANCED (สูง), EXPERT (เชี่ยวชาญ) — ค่าเริ่มต้น: BASIC
   • วันที่ได้รับ (YYYY-MM-DD) — ไม่บังคับ
   • วันหมดอายุ (YYYY-MM-DD) — ไม่บังคับ
6. เลือกไฟล์ที่กรอกแล้ว (.xlsx) แล้วคลิก "นำเข้า"

กฎการตรวจสอบซ้ำ:

• พยาบาล 1 คนมีทักษะเดียวกันได้ 1 รายการเท่านั้น — ถ้าซ้ำจะถูกข้าม
• อีเมลที่ไม่พบในหน่วยงานที่เลือก จะแสดงเป็นข้อผิดพลาด

3.9 ทักษะที่หน่วยงานต้องการ (Unit Required Competencies)

📍 หน้า: /settings/competencies 👤 สิทธิ์: HOSPITAL_ADMIN, HEAD_NURSE

วัตถุประสงค์: กำหนดทักษะขั้นต่ำที่หน่วยงานต้องการในแต่ละกะเวร

ขั้นตอน:

1. เลือก หน่วยงาน จาก dropdown
2. คลิก "เพิ่ม" เพื่อเพิ่มทักษะที่ต้องการ
3. กรอกข้อมูล: ชื่อทักษะ, ระดับขั้นต่ำ, จำนวนขั้นต่ำ/กะ, กะเวร (ทุกเวร หรือเฉพาะ เช้า/บ่าย/ดึก)
4. คลิก "บันทึก"

นำเข้าทักษะที่หน่วยงานต้องการจาก Excel (Bulk Import)

👤 สิทธิ์: HEAD_NURSE, NURSING_DIRECTOR, HOSPITAL_ADMIN

ขั้นตอน:

1. ไปที่หน้า "ตั้งค่า" → "ทักษะเฉพาะทาง" (/settings/competencies)
2. เลือก หน่วยงาน จาก dropdown ก่อน
3. คลิกปุ่ม "นำเข้า Excel" (สีเขียว) ที่มุมขวาบน
4. คลิก "ดาวน์โหลด Template Excel" เพื่อดาวน์โหลดแม่แบบ
5. กรอกข้อมูลในไฟล์ Excel ตั้งแต่แถวที่ 3 (แถว 2 เป็นตัวอย่าง ลบได้):
   • ชื่อทักษะ (จำเป็น) — เช่น ICU, Ventilator, ER
   • ระดับขั้นต่ำ — เลือกจาก dropdown: BASIC, INTERMEDIATE, ADVANCED, EXPERT (ค่าเริ่มต้น: BASIC)
   • จำนวนขั้นต่ำ/เวร — ตัวเลข 0-20 (ค่าเริ่มต้น: 1)
   • ประเภทเวร — เลือกจาก dropdown: ทุกเวร (ค่าเริ่มต้น), MORN (เช้า), AFTER (บ่าย), NIGHT (ดึก)
6. เลือกไฟล์ที่กรอกแล้ว (.xlsx) แล้วคลิก "นำเข้า"

3.10 ประวัติการอบรม (Nurse Trainings)

📍 หน้า: /nurses/[id]/trainings 👤 สิทธิ์: HEAD_NURSE, NURSING_DIRECTOR, HOSPITAL_ADMIN (จัดการ) / ทุก Role (ดู)

วัตถุประสงค์: บันทึกประวัติการอบรม/สัมมนา/CPD ของพยาบาล

สถานะการอบรม 4 สถานะ: PLANNED (วางแผน), IN_PROGRESS (กำลังอบรม), COMPLETED (เสร็จสิ้น), CANCELLED (ยกเลิก)

ขั้นตอนการเพิ่ม:

1. ไปที่หน้าพยาบาล → คลิกที่พยาบาล → แท็บ "ประวัติอบรม"
2. คลิก "เพิ่มประวัติอบรม" → กรอก: ชื่อหลักสูตร, ผู้จัด, วันที่เริ่ม/สิ้นสุด, จำนวนชั่วโมง, สถานะ, URL ใบประกาศ
3. คลิก "บันทึก"

นำเข้าประวัติอบรมจาก Excel (Bulk Import)

👤 สิทธิ์: HEAD_NURSE, NURSING_DIRECTOR, HOSPITAL_ADMIN

สำหรับเพิ่มประวัติอบรมของพยาบาลหลายคนพร้อมกัน ผ่านหน้า พยาบาล (/nurses)

ขั้นตอน:

1. ไปที่หน้า พยาบาล → คลิกปุ่ม "นำเข้า Excel"
2. ในช่อง "ประเภทการนำเข้า" เลือก "ประวัติอบรม"
3. เลือก โรงพยาบาล → แผนก → หน่วยงาน ที่ต้องการนำเข้า
4. คลิก "ดาวน์โหลดแบบฟอร์ม Excel (ประวัติอบรม)" — template จะมีรายชื่อพยาบาลในหน่วยงานให้อ้างอิง
5. กรอกข้อมูลในไฟล์ Excel ตั้งแต่แถวที่ 3 (แถว 2 เป็นตัวอย่าง ลบได้):
   • อีเมลพยาบาล (จำเป็น) — ต้องตรงกับอีเมลในระบบ
   • ชื่อหลักสูตร (จำเป็น) — เช่น Basic Life Support, ICU Advanced Care
   • หน่วยจัดอบรม — เช่น สภากาชาดไทย, รพ.ศิริราช (ไม่บังคับ)
   • วันเริ่ม (YYYY-MM-DD) (จำเป็น)
   • วันสิ้นสุด (YYYY-MM-DD) — ไม่บังคับ
   • ชั่วโมงอบรม — ตัวเลข (ค่าเริ่มต้น: 0)
   • สถานะ — เลือกจาก dropdown: PLANNED (วางแผน), IN_PROGRESS (กำลังอบรม), COMPLETED (เสร็จสิ้น), CANCELLED (ยกเลิก) — ค่าเริ่มต้น: COMPLETED
6. เลือกไฟล์ที่กรอกแล้ว (.xlsx) แล้วคลิก "นำเข้า"

กฎการตรวจสอบซ้ำ:

• พยาบาล 1 คนสามารถมีหลักสูตรอบรมเดียวกันได้หลายรายการ (ไม่จำกัด)
• ตรวจสอบซ้ำภายในไฟล์เท่านั้น: อีเมล+ชื่อหลักสูตร+วันเริ่ม เดียวกัน จะถูกข้าม

3.11 ค่าตอบแทนเวร (Compensation)

📍 หน้า: /settings/compensation 👤 สิทธิ์: HOSPITAL_ADMIN, NURSING_DIRECTOR

วัตถุประสงค์: กำหนดอัตราค่าตอบแทนเวรของโรงพยาบาล (ค่าเวร, ค่าเวรวันหยุด, ค่าเวรเรียกตัว, ค่าล่วงเวลา)

อัตราค่าตอบแทนเริ่มต้น (อ้างอิง สธ.):

ขั้นตอนการตั้งค่า:

1. ไปที่เมนู "ตั้งค่า" → "ค่าตอบแทนเวร"
2. เลือกโรงพยาบาล (ถ้ามีหลายแห่ง)
3. แก้ไขอัตราค่าตอบแทนในแต่ละช่อง
4. คลิก "บันทึก"

นำเข้าค่าตอบแทนเวรจาก Excel:

1. คลิกปุ่ม "นำเข้า Excel" (สีเขียว) ที่มุมขวาบน
2. คลิก "ดาวน์โหลด Template Excel" เพื่อดาวน์โหลดแบบฟอร์ม
3. กรอกข้อมูลค่าตอบแทนในไฟล์ Excel (ประเภทเวร, ค่าเวร, ค่า OT, ค่าเวรวันหยุด, ค่าเรียกตัว, เปิดใช้งาน)
4. เลือกไฟล์ที่กรอกแล้ว (.xlsx) แล้วคลิก "นำเข้า"
5. ระบบจะแสดงผลลัพธ์: สร้างใหม่ / อัปเดต / ผิดพลาด
6. ถ้าประเภทเวรซ้ำกับที่มีอยู่แล้ว ระบบจะ อัปเดตข้อมูลเดิม โดยอัตโนมัติ (ไม่สร้างซ้ำ)

4. การจัดเวร

Flow การจัดเวร

จำแนกผู้ป่วย → ดูภาระงาน → สร้างเวร AI → ตรวจสอบ/แก้ไข → เผยแพร่ → ล็อก → (กำหนดเวร On-call ถ้าต้องการ)

4.1 จำแนกผู้ป่วย

📍 หน้า: /patients/classification 👤 สิทธิ์: HOSPITAL_ADMIN, NURSING_DIRECTOR, HEAD_NURSE

วัตถุประสงค์: บันทึกจำนวนผู้ป่วยแต่ละหมวดในแต่ละหน่วยงาน เพื่อคำนวณภาระงาน

หมวดผู้ป่วย 5 ระดับ:

ขั้นตอน:

1. เลือก หน่วยงาน และ วันที่
2. กรอกจำนวนผู้ป่วยในแต่ละหมวด (CAT 1-5)
3. เลือก กิจกรรมพยาบาล ที่ต้องทำในวันนั้น (15 กิจกรรมตาม POR 2010)
4. คลิก "บันทึก"

กิจกรรมพยาบาล 15 กิจกรรม (POR 2010):

4.2 ภาระงานพยาบาล (NHPPD / FTE)

📍 หน้า: /workload 👤 สิทธิ์: ทุก Role (ดูได้), HOSPITAL_ADMIN, NURSING_DIRECTOR, HEAD_NURSE (จัดการ)

วัตถุประสงค์: แสดงภาระงานพยาบาลตามมาตรฐาน POR 2010

ตัวชี้วัดที่แสดง:

โหมดการแสดงผล:

• ภาพรวม — แสดงทุกหน่วยงานในตาราง (Productivity แสดงเป็น Ring Progress สี)
• รายละเอียด — เลือกหน่วยงาน → ดูข้อมูลเชิงลึก

สีบ่งบอกสถานะ:

• 🟢 เขียว — ผลิตภาพปกติ
• 🟡 เหลือง — ผลิตภาพต่ำ ต้องระวัง
• 🔴 แดง — ผลิตภาพวิกฤต ต้องเสริมกำลัง

4.3 สร้างตารางเวรอัตโนมัติ (AI)

📍 หน้า: /schedules/generate 👤 สิทธิ์: HOSPITAL_ADMIN, NURSING_DIRECTOR, HEAD_NURSE

วัตถุประสงค์: ใช้ AI (CSP Solver) สร้างตารางเวรโดยอัตโนมัติ

ขั้นตอน:

1. เลือก หน่วยงาน ที่ต้องการสร้างเวร
2. เลือก เดือน และ ปี
3. ปรับจำนวนพยาบาลต่อกะ (ถ้าต้องการ) — ระบบจะโหลดค่าจากการตั้งค่าหน่วยงานเป็นค่าเริ่มต้น สามารถปรับ "จำนวนขั้นต่ำ" และ "RN ขั้นต่ำ" ของแต่ละกะได้ เฉพาะรอบนี้ โดยไม่กระทบค่า Settings ถาวร
4. คลิก "สร้างตารางเวร" → ระบบแสดง summary จำนวนคนแต่ละกะใน confirmation modal
5. ระบบจะใช้ AI ประมวลผลตามเงื่อนไข:
   • กฎ Forward Rotation (เช้า → บ่าย → ดึก)
   • ห้าม Night → Morning (ช่วงพักระหว่างกะ ≥ 10 ชม.)
   • จำนวนชั่วโมงทำงานสูงสุด/สัปดาห์
   • จำนวนเวรดึกสูงสุด/เดือน
   • สัดส่วน RN ≥ 80% ต่อกะ
   • อัตราพยาบาลต่อผู้ป่วย (1:2 วิกฤต, 1:4 ทั่วไป)
   • จำกัด OT ต่อวัน (HC15) — ไม่ให้เกินชั่วโมงที่กำหนด
   • วันพักหลังทำงานติด (HC16) — บังคับพักหลังทำงานต่อเนื่อง
   • Mandatory Rest (HC14) — หลังเวร ≥ 16 ชม. ต้องพักวันถัดไป
   • ทักษะเฉพาะทาง (HC-SkillMatch) — จับคู่ทักษะพยาบาลกับหน่วยงาน
   • เวรเรียกตัว (On-call) — ไม่นำเข้า AI (จัดเอง ไม่นับ staffing)
6. รอจนประมวลผลเสร็จ (ใช้ Worker Thread แยกประมวลผล)
7. ตรวจสอบผลลัพธ์ในหน้า ตารางเวร

4.4 ตรวจสอบ/แก้ไขตารางเวร

📍 หน้า: /schedules 👤 สิทธิ์: HOSPITAL_ADMIN, NURSING_DIRECTOR, HEAD_NURSE, STAFF_NURSE (ดูอย่างเดียว)

วัตถุประสงค์: ตรวจสอบ แก้ไข และจัดการตารางเวร

ขั้นตอนการตรวจสอบ:

1. เลือก หน่วยงาน, เดือน, ปี จาก filter
2. ดูตารางเวรที่แสดง:
   • Mobile: Card view จัดกลุ่มตามวัน
   • Desktop: Table view แสดงทุกคอลัมน์
3. สถานะแสดงเป็น Badge:
   • เผยแพร่แล้ว — เวรถูก publish ให้พยาบาลเห็น
   • ล็อกแล้ว — เวรถูกล็อก ไม่สามารถแก้ไข
   • แลกเวร — เวรที่เกิดจากการแลกเวร
   • OC (สี teal) — เวรเรียกตัวฉุกเฉิน (On-call)
4. วันลา/วันหยุด แสดงในตาราง:

   • ช่องที่ไม่มีเวร + มีวันลาอนุมัติ → แสดงรหัสลา สีชมพู:

     รหัส	ประเภท	ความหมาย
     V	VACATION	ลาพักผ่อน
     S	SICK	ลาป่วย
     P	PERSONAL	ลากิจ
     T	TRAINING	ลาอบรม
     M	MATERNITY	ลาคลอด
     O	ORDINATION	ลาอุปสมบท
     ML	MILITARY	ลาทหาร
     SZ	STERILIZATION	ลาทำหมัน
     SF	SPOUSE_FOLLOW	ลาติดตามคู่สมรส
     R	REHABILITATION	ลาฟื้นฟูสมรรถภาพ
     SL	STUDY_LEAVE	ลาศึกษาต่อ

   • ช่องที่ไม่มีเวร + ไม่มีวันลา → แสดง Off สีเทา (วันหยุด)

   • ช่องที่มีเวร → แสดงเวรตามปกติ (เวรมี priority สูงกว่า)

5. สรุปสถิติ ด้านบนตาราง แสดงจำนวนเวรแต่ละกะ + วันลา (สีชมพู)
6. Legend ท้ายตาราง แสดงคำอธิบายสัญลักษณ์ทุกตัว ได้แก่ กะเวร, ควบเวร, Off, V, S, P, T, M, O, ML, SZ, SF, R, SL

การแก้ไข (เฉพาะเวรที่ยังไม่ล็อก):

1. คลิกที่เวรที่ต้องการแก้ไข
2. เปลี่ยนกะเวร / พยาบาล
3. คลิก "บันทึก"

4.5 เผยแพร่ตารางเวร (Publish)

📍 หน้า: /schedules 👤 สิทธิ์: HOSPITAL_ADMIN, NURSING_DIRECTOR, HEAD_NURSE

วัตถุประสงค์: เผยแพร่ตารางเวรให้พยาบาลเห็น พร้อมแจ้งเตือน

ขั้นตอน:

1. ตรวจสอบตารางเวรให้ครบถ้วน
2. คลิกปุ่ม "เผยแพร่"
3. ระบบจะ:
   • อัปเดตสถานะเป็น "เผยแพร่แล้ว"
   • ส่ง อีเมลแจ้งเตือน ไปยังพยาบาลทุกคนในหน่วยงาน
   • ส่ง แจ้งเตือนในระบบ (Real-time ผ่าน Socket.IO)
   • ส่ง Telegram (ถ้าตั้งค่าไว้)

4.6 ล็อกตารางเวร (Lock)

📍 หน้า: /schedules 👤 สิทธิ์: HOSPITAL_ADMIN, NURSING_DIRECTOR, HEAD_NURSE

วัตถุประสงค์: ล็อกตารางเวรเพื่อป้องกันการแก้ไข

ขั้นตอน:

1. เลือกเวรที่ต้องการล็อก
2. คลิกไอคอน 🔒
3. ยืนยันในป๊อปอัพ "ยืนยันการล็อก" → คลิก "ล็อก"

4.7 กำหนดเวรเรียกตัว (On-call)

📍 หน้า: /schedules 👤 สิทธิ์: HOSPITAL_ADMIN, NURSING_DIRECTOR, HEAD_NURSE

วัตถุประสงค์: กำหนดเวรเรียกตัวฉุกเฉินให้พยาบาล — ใช้สำหรับกรณีที่ต้องการสำรองคนรับเรียกมาเพิ่มเมื่อมีเหตุฉุกเฉิน

ลักษณะเวร On-call:

• ไม่นับ staffing — ไม่ถูกนับรวมในจำนวนพยาบาลขั้นต่ำต่อกะ
• ไม่นับชั่วโมงทำงาน — ไม่ถูกนำไปรวม OT
• ไม่เข้า AI — ไม่ถูกนำเข้าระบบจัดเวรอัตโนมัติ (จัดมือเท่านั้น)
• แสดง Badge "OC" สี teal ในทุกหน้า (ตารางเวร, เวรของฉัน, รายงาน)
• รายงาน PDF/Excel แสดง * หลังชื่อกะ (เช่น ช* หมายถึง เช้า + on-call)

ขั้นตอนการกำหนด:

1. ไปที่หน้า ตารางเวร → เลือก หน่วยงาน/เดือน/ปี
2. คลิกไอคอน 📞 (โทรศัพท์) ที่แถวพยาบาลในวันที่ต้องการ
3. ระบบจะสร้างเวร On-call (Badge "OC" จะแสดงข้างกะเวร)

การยกเลิกเวร On-call:

1. คลิกไอคอน 🗑️ ที่เวร On-call
2. ยืนยันการลบในป๊อปอัพ

4.8 แก้ไขเวรแบบรวดเร็ว (Inline Edit)

📍 หน้า: /schedules 👤 สิทธิ์: HOSPITAL_ADMIN, NURSING_DIRECTOR, HEAD_NURSE (เฉพาะ Desktop)

วัตถุประสงค์: เปลี่ยนกะเวรได้ทันทีโดยคลิกที่ช่องเวรบนตาราง Roster Grid โดยไม่ต้องเปิดป๊อปอัพ

เงื่อนไข:

• เฉพาะ เวรเดี่ยว (เช้า/บ่าย/ดึก) เท่านั้น — เวรควบ (ชบ/บด/ชบด) จะเปิด detail modal เหมือนเดิม
• เฉพาะเวรที่ ยังไม่ล็อก เท่านั้น
• แสดงเฉพาะกะที่ เปิดใช้งาน (Active) ตามการตั้งค่าหน่วยงาน

ขั้นตอน:

1. เปิดหน้า ตารางเวร → เลือก หน่วยงาน/เดือน/ปี
2. คลิก ที่ช่องเวรของพยาบาลที่ต้องการแก้ไข (เวรเดี่ยว, ไม่ล็อก)
3. ช่อง Select จะแสดงขึ้นมา พร้อมรายการกะที่เลือกได้
4. เลือก กะเวรใหม่ → ระบบบันทึกทันที
5. คลิกที่อื่นเพื่อปิด Select

4.9 ลากย้ายเวร (Drag & Drop)

📍 หน้า: /schedules 👤 สิทธิ์: HOSPITAL_ADMIN, NURSING_DIRECTOR, HEAD_NURSE (เฉพาะ Desktop)

วัตถุประสงค์: ลากเวรจากช่องหนึ่งไปวางที่อีกช่องบนตาราง Roster Grid เพื่อย้ายเวรระหว่างพยาบาลหรือระหว่างวัน

รองรับ 3 กรณี:

ขั้นตอน:

1. เปิดหน้า ตารางเวร → เลือก หน่วยงาน/เดือน/ปี
2. กดค้างแล้วลาก ที่เวร (Badge) ของพยาบาลที่ต้องการย้าย
3. ขณะลากจะเห็น Badge ลอย (DragOverlay) แสดงข้อมูลเวร
4. วาง ที่ช่องปลายทาง → ระบบจะย้ายเวรทันที
5. ถ้าเวรถูก เผยแพร่แล้ว → ระบบจะแสดง ป๊อปอัพยืนยัน ก่อนย้าย

5. บริการตนเอง

Flow บริการตนเอง

ดูเวรของฉัน → ขอแลกเวร / ขอลา / รับเวรว่าง / ขอยืมตัวพยาบาล → รอผลอนุมัติ

5.1 เวรของฉัน

📍 หน้า: /my-schedule 👤 สิทธิ์: HEAD_NURSE, STAFF_NURSE (เฉพาะผู้ที่มี Nurse Profile)

วัตถุประสงค์: ดูตารางเวรส่วนตัวในแต่ละเดือน

โหมดการแสดงผล 2 แบบ (เลือกจาก SegmentedControl):

1. Card View:

• แสดงเวรเป็นการ์ดจัดกลุ่มตามวัน
• แต่ละการ์ดระบุ: วันที่, กะเวร (เช้า/บ่าย/ดึก), เวลา
• เวรที่เกิดจากแลกเวรจะมี Badge "แลกเวร"
• เวรเรียกตัวจะมี Badge "OC" สี teal

2. Calendar View:

• แสดงเป็นปฏิทิน 7 คอลัมน์
• แต่ละช่องแสดงกะเวรด้วยสี:
  • 🟡 เช้า (MORN) — สีเหลือง
  • 🟠 บ่าย (AFTER) — สีส้ม
  • 🟣 ดึก (NIGHT) — สีม่วง
  • 🟢 OC (On-call) — ต่อท้ายกะ เมื่อเป็นเวรเรียกตัว
• วันนี้จะถูก highlight
• วันอาทิตย์ = สีแดง, วันเสาร์ = สีน้ำเงิน

สรุปเวร:

• แสดงจำนวนเวรแต่ละประเภท (เช้า, บ่าย, ดึก) ในเดือนที่เลือก

5.2 ขอแลกเวร

📍 หน้า: /swap-requests (tab "ของฉัน") 👤 สิทธิ์: HEAD_NURSE, STAFF_NURSE

วัตถุประสงค์: ส่งคำขอแลกเวรกับพยาบาลคนอื่น

ขั้นตอนการขอแลกเวร:

1. คลิกปุ่ม "+ ขอแลกเวร"
2. กรอกข้อมูลในป๊อปอัพ:
   • วันที่เวรของฉัน — เลือกจาก CustomDatePicker
   • กะเวรของฉัน — เลือกกะ (เช้า/บ่าย/ดึก)
   • พยาบาลคู่แลก — เลือกจาก dropdown
   • วันที่เวรคู่แลก — เลือกวันที่
   • กะเวรคู่แลก — เลือกกะ
3. คลิก "ส่งคำขอ"
4. ระบบจะ:
   • สร้างคำขอสถานะ "รออนุมัติ" (PENDING)
   • ส่งแจ้งเตือนในระบบไปยังพยาบาลคู่แลก
   • ส่งอีเมลแจ้งเตือนไปยังคู่แลก

การยกเลิกคำขอ:

• คลิกปุ่ม "ยกเลิก" ที่คำขอที่ยังเป็น PENDING
• สถานะจะเปลี่ยนเป็น "ยกเลิก" (CANCELLED)

การตอบรับ/ปฏิเสธ (เมื่อมีคนขอแลกเวรกับคุณ):

• คลิก ✅ "ตอบรับ" → ระบบจะแลกเวรทันที
• คลิก ❌ "ปฏิเสธ"

5.3 ขอลางาน

📍 หน้า: /leave-requests (tab "ของฉัน") 👤 สิทธิ์: HEAD_NURSE, STAFF_NURSE

วัตถุประสงค์: ส่งคำขอลางาน 11 ประเภท (5 ประเภทหลัก + 6 ประเภทเพิ่มเติมสำหรับ รพ.รัฐ)

ประเภทการลา:

ขั้นตอนการขอลา:

1. ดู สรุปสิทธิ์การลา — แสดงจำนวนวันลาที่ใช้ไป/เหลือ ต่อประเภท (Progress bar)
2. คลิกปุ่ม "+ ขอลางาน"
3. กรอกข้อมูลในป๊อปอัพ:
   • ประเภทการลา — เลือกจาก dropdown
   • ช่วงวันที่ลา — เลือกช่วงวันที่ (CustomDatePicker type="range")
   • เหตุผล — อธิบายเหตุผลการลา
4. คลิก "ส่งคำขอ"
5. ระบบจะ:
   • สร้างคำขอสถานะ "รออนุมัติ" (PENDING)
   • ส่งแจ้งเตือนไปยังหัวหน้าและผู้ดูแล

การยกเลิกคำขอ:

• คลิก "ยกเลิก" ที่คำขอที่ยังเป็น PENDING

5.4 รับเวรว่าง

📍 หน้า: /open-shifts 👤 สิทธิ์: HEAD_NURSE, STAFF_NURSE (รับเวร), ทุก Role (ดู)

วัตถุประสงค์: แสดงเวรที่ยังขาดคน เปิดให้พยาบาลสมัครรับ

ขั้นตอน:

1. ดูรายการเวรว่าง:
   • กรองตาม หน่วยงาน และ กะเวร
   • แต่ละรายการแสดง: หน่วยงาน, แผนก, วันที่, วัน, กะ
   • Staffing: ต้องการ / มีแล้ว / ขาด (Badge สีแดงแสดงจำนวนที่ขาด)
2. คลิกปุ่ม "รับเวร" ที่เวรที่ต้องการ
3. ระบบจะ:
   • สร้างเวรใหม่ให้คุณอัตโนมัติ
   • ส่งแจ้งเตือนไปยังหัวหน้าหน่วยงาน

5.5 ขอยืมตัวพยาบาล (Float Request)

📍 หน้า: /float-requests (tab "หน่วยของฉัน") 👤 สิทธิ์: HEAD_NURSE (สร้างคำขอ), NURSING_DIRECTOR, HOSPITAL_ADMIN (ดู/อนุมัติ)

วัตถุประสงค์: ส่งคำขอยืมตัวพยาบาลจากหน่วยงานอื่นมาขึ้นเวรในหน่วยที่ขาดคน

Flow การยืมตัว:

หน่วยขาดคน → ค้นหาพยาบาลว่าง → ส่งคำขอ → หัวหน้าต้นสังกัดอนุมัติ → สร้างเวรอัตโนมัติ

ขั้นตอนการขอยืมตัว:

1. คลิกปุ่ม "+ ขอยืมตัว"
2. กรอกข้อมูลในป๊อปอัพ:
   • วันที่ — เลือกจาก CustomDatePicker
   • กะเวร — เลือกกะ (เช้า/บ่าย/ดึก)
3. คลิก "ค้นหาพยาบาล" → ระบบจะค้นหาพยาบาลจากหน่วยอื่นที่ว่างในวัน/กะนั้น
   • กรองอัตโนมัติ: ไม่มีเวรซ้ำ, ไม่ลาวันนั้น, ไม่มีคำขอยืมค้าง, ผ่านกฎ Forward Rotation
4. เลือกพยาบาลจาก dropdown (แสดง: ชื่อ, ระดับ, หน่วยต้นสังกัด)
5. กรอก เหตุผล (ถ้ามี)
6. คลิก "ส่งคำขอ"
7. ระบบจะ:
   • สร้างคำขอสถานะ "รออนุมัติ" (PENDING)
   • ส่งแจ้งเตือนในระบบไปยังหัวหน้าหน่วยต้นสังกัดของพยาบาล
   • ส่งอีเมลแจ้งหัวหน้าหน่วยต้นสังกัด

การยกเลิกคำขอ:

• คลิกปุ่ม "ยกเลิก" ที่คำขอที่ยังเป็น PENDING
• สถานะจะเปลี่ยนเป็น "ยกเลิก" (CANCELLED)

เมื่อคำขอได้รับอนุมัติ:

• สถานะเปลี่ยนเป็น "เสร็จสิ้น" (COMPLETED)
• ระบบสร้างเวรให้พยาบาลอัตโนมัติ ในหน่วยที่ขอยืม
• พยาบาลจะเห็นเวรนี้ในหน้า "เวรของฉัน" พร้อม Badge "(ยืมตัว)" สี cyan
• ส่งแจ้งเตือน + อีเมลไปยังผู้ขอและพยาบาลที่ถูกยืม

5.6 คำขอเวรล่วงหน้า (Schedule Preferences)

📍 หน้า: /schedule-preferences 👤 สิทธิ์: ทุก Role (ดู) / HEAD_NURSE, STAFF_NURSE, NURSE_ASSISTANT (สร้างคำขอ) / HEAD_NURSE+ (ตรวจสอบ)

วัตถุประสงค์: ส่งความต้องการเวรล่วงหน้าเป็นรายเดือน ก่อนที่หัวหน้าจะสร้างตารางเวร AI

สถานะคำขอเวร 3 สถานะ:

Tab: ของฉัน (Default สำหรับพยาบาล) / ทั้งหมด (Default สำหรับ Admin/Director)

ประเภทเวรที่เลือกได้ (7 แบบ):

ขั้นตอนการสร้างคำขอ:

1. เลือก เดือน และ ปี → คลิกปุ่ม "ส่ง Preference"
2. ในป๊อปอัพ: คลิกวันที่ → Popover เลือกเวร จะเปิดขึ้น
3. เลือกประเภทเวรที่ต้องการ (7 แบบ) หรือ "หลีกเลี่ยง" สำหรับวันที่ไม่ต้องการ
4. แต่ละตัวเลือกจะแสดง จำนวนคนที่ขอแล้ว / จำนวนขั้นต่ำ (เช่น ช 2/3)
   • สีเขียว = ยังขาดคน (แนะนำให้เลือก)
   • สีส้ม = ครบตามจำนวนขั้นต่ำแล้ว (ยังเลือกได้ ไม่บล็อก)
5. คลิกขวาที่วัน → ล้างค่าทันที
6. กรอก หมายเหตุ (ถ้ามี) → คลิก "ส่ง Preference"

ข้อมูลแสดงบนปฏิทิน:

• ตัวเลขมุมขวาบน ของแต่ละวัน = จำนวนพยาบาลคนอื่นที่ขอเวรวันนั้นแล้ว
• แถบแจ้ง เหนือปฏิทิน = "มีพยาบาลส่ง preference แล้ว X คน"
• Tooltip เมื่อชี้ที่วัน = รายละเอียดว่ามีใครขอเวรอะไรบ้าง

การตรวจสอบ (หัวหน้าพยาบาล+):

1. เปิดแท็บ "ทั้งหมด" → กรองหน่วยงาน, สถานะ
2. ดูรายละเอียดคำขอ → คลิก "ตรวจสอบแล้ว" หรือ "นำไปใช้แล้ว"

การแจ้งเตือน:

• เมื่อพยาบาลส่งคำขอเวร → แจ้งเตือนหัวหน้าและผู้มีสิทธิ์ตรวจสอบ ผ่านกระดิ่ง (และช่องทางที่ตั้งค่าไว้)
• เมื่อหัวหน้าตรวจสอบคำขอ → แจ้งเตือนพยาบาลเจ้าของคำขอ ว่าถูกตรวจสอบแล้ว

5.7 ส่งออกปฏิทิน (Calendar Export)

📍 หน้า: /my-schedule 👤 สิทธิ์: HEAD_NURSE, STAFF_NURSE, NURSE_ASSISTANT

วัตถุประสงค์: ดาวน์โหลดตารางเวรเป็นไฟล์ .ics เพื่อนำไปเปิดในแอปปฏิทิน

วิธีที่ 1 — ดาวน์โหลดไฟล์ iCal (.ics):

1. ไปที่หน้า "เวรของฉัน" → เลือกเดือนและปี
2. คลิกปุ่ม "ส่งออก iCal"
3. เปิดไฟล์ด้วย Apple Calendar, Google Calendar (Import), หรือ Outlook

วิธีที่ 2 — เพิ่มลง Google Calendar:

1. คลิกไอคอน Google ที่แต่ละรายการเวร
2. ระบบจะเปิดหน้า Google Calendar พร้อมข้อมูลเวรที่กรอกไว้แล้ว

5.8 ขอเปลี่ยนเวร (Shift Change Request)

📍 หน้า: /shift-change-requests (tab "ของฉัน") 👤 สิทธิ์: HEAD_NURSE, STAFF_NURSE, NURSE_ASSISTANT

วัตถุประสงค์: ส่งคำขอเปลี่ยนกะเวรของตนเอง โดยไม่ต้องแลกกับพยาบาลคนอื่น (ต่างจาก "แลกเวร" ที่ต้องมีคู่แลก)

ขั้นตอนการขอเปลี่ยนเวร:

1. คลิกปุ่ม "+ ขอเปลี่ยนเวร"
2. กรอกข้อมูลในป๊อปอัพ:
   • เลือกเวร — เลือกจากรายการเวรปัจจุบันของคุณ (ที่ยังไม่ล็อก)
   • กะเวรใหม่ — เลือกกะที่ต้องการเปลี่ยนไป (เช้า/บ่าย/ดึก)
   • เหตุผล — ระบุเหตุผลในการเปลี่ยน (ไม่บังคับ)
3. คลิก "ส่งคำขอ"
4. ระบบจะ:
   • สร้างคำขอสถานะ "รอพิจารณา" (PENDING)
   • ส่ง แจ้งเตือนในระบบ ไปยังหัวหน้าหอผู้ป่วย
   • ส่ง อีเมล + แจ้งเตือนตามช่องทางที่ตั้งค่า (Telegram/LINE/SMS)

สถานะคำขอ:

การยกเลิกคำขอ:

• คลิกปุ่ม "ยกเลิก" ที่คำขอที่ยังเป็น PENDING เท่านั้น
• ยืนยันในป๊อปอัพ → สถานะเปลี่ยนเป็น "ยกเลิก"

การอนุมัติ/ปฏิเสธ (สำหรับหัวหน้า): 📍 หน้า: /shift-change-requests (tab "ทั้งหมด") 👤 สิทธิ์: HEAD_NURSE, NURSING_DIRECTOR, HOSPITAL_ADMIN

1. ดูรายการคำขอที่สถานะ PENDING
2. คลิก ✅ "อนุมัติ" หรือ ❌ "ปฏิเสธ"
3. ระบบแสดงป๊อปอัพยืนยัน — สามารถเพิ่ม หมายเหตุ ได้
4. เมื่ออนุมัติ:
   • กะเวรจะถูก เปลี่ยนอัตโนมัติ ในตารางเวร
   • ส่งแจ้งเตือน + อีเมลไปยังพยาบาลผู้ขอ

5.9 ดูค่าตอบแทนเวร

📍 หน้า: /my-compensation 👤 สิทธิ์: ทุก Role

วัตถุประสงค์: ดูสรุปค่าตอบแทนเวรของตนเองรายเดือน และสรุปค่าตอบแทนทั้งหน่วยงาน (สำหรับหัวหน้า)

แท็บ "ของฉัน" (พยาบาล):

• เลือกเดือน/ปี
• ดูสรุป: ค่าเวรปกติ, ค่าเวรวันหยุด, ค่าเวรเรียกตัว, ยอดรวม
• ดูรายละเอียดแต่ละเวร: วันที่, กะ, ประเภท (ปกติ/วันหยุด/สุดสัปดาห์/เรียกตัว), ค่าตอบแทน
• กราฟ PieChart — แสดงสัดส่วนค่าตอบแทน (ค่าเวร / ค่าวันหยุด / ค่าเรียกตัว)
• ปุ่มดาวน์โหลด — Export เป็น PDF หรือ Excel

แท็บ "หน่วยงาน" (HEAD_NURSE, NURSING_DIRECTOR, HOSPITAL_ADMIN):

• เลือกหน่วยงาน + เดือน/ปี
• ดูสรุปค่าตอบแทนของพยาบาลทุกคนในหน่วยงาน
• กราฟ BarChart — เปรียบเทียบค่าตอบแทนระหว่างพยาบาลแต่ละคน
• ยอดรวมทั้ง Unit
• ปุ่มดาวน์โหลด — Export เป็น PDF หรือ Excel

6. การอนุมัติ

Flow การอนุมัติ

ดูคำขอรออนุมัติ → ตรวจสอบรายละเอียด → อนุมัติ / ปฏิเสธ

6.1 อนุมัติแลกเวร

📍 หน้า: /swap-requests (tab "ทั้งหมด") 👤 สิทธิ์: HEAD_NURSE, NURSING_DIRECTOR, HOSPITAL_ADMIN

วัตถุประสงค์: ตรวจสอบและจัดการคำขอแลกเวร

ขั้นตอน:

1. เปิดหน้า "แลกเวร" → เลือก tab "ทั้งหมด"
2. กรองตาม สถานะ (รออนุมัติ / อนุมัติแล้ว / ไม่อนุมัติ)
3. ตรวจสอบรายละเอียด:
   • ผู้ขอ + เวรของผู้ขอ (วันที่ + กะ)
   • คู่แลก + เวรของคู่แลก (วันที่ + กะ)
4. ดำเนินการ:
   • ✅ ตอบรับ → ระบบแลกเวร 2 คนทันที + แจ้งเตือนผู้ขอ
   • ❌ ปฏิเสธ → แจ้งเตือนผู้ขอ

6.2 อนุมัติลางาน

📍 หน้า: /leave-requests (tab "ทั้งหมด") 👤 สิทธิ์: HEAD_NURSE, NURSING_DIRECTOR, HOSPITAL_ADMIN

วัตถุประสงค์: ตรวจสอบและอนุมัติ/ปฏิเสธคำขอลางาน

ขั้นตอน:

1. เปิดหน้า "ลางาน" → เลือก tab "ทั้งหมด"
2. กรองตาม สถานะ
3. ตรวจสอบรายละเอียด:
   • ผู้ขอ
   • ประเภทการลา
   • วันเริ่ม - วันสิ้นสุด (จำนวนวัน)
   • เหตุผล
4. ดำเนินการ:
   • ✅ อนุมัติ → ส่งแจ้งเตือน + อีเมลไปยังผู้ขอ
   • ❌ ปฏิเสธ → ส่งแจ้งเตือน + อีเมลไปยังผู้ขอ

6.3 อนุมัติยืมตัวพยาบาล

📍 หน้า: /float-requests (tab "หน่วยของฉัน" หรือ "ทั้งหมด") 👤 สิทธิ์: HEAD_NURSE (หน่วยต้นสังกัด), NURSING_DIRECTOR, HOSPITAL_ADMIN

วัตถุประสงค์: ตรวจสอบและอนุมัติ/ปฏิเสธคำขอยืมตัวพยาบาลจากหน่วยของตน

ขั้นตอน:

1. เปิดหน้า "ยืมตัวพยาบาล" → ดูคำขอที่สถานะ "รออนุมัติ"
2. ตรวจสอบรายละเอียด:
   • พยาบาล ที่ถูกขอยืม
   • หน่วยต้นสังกัด (หน่วยของพยาบาล)
   • หน่วยที่ขอยืม (หน่วยปลายทาง)
   • วันที่ + กะเวร
   • เหตุผล
3. ดำเนินการ:
   • ✅ อนุมัติ → ระบบจะ:
     • ตรวจสอบ Min Staffing: ถ้าหน่วยต้นสังกัดจะขาดคน → แจ้งเตือน ไม่ให้อนุมัติ
     • สร้างเวรใหม่ให้พยาบาลในหน่วยที่ขอยืม (isFloated: true)
     • แจ้งเตือน + อีเมลไปยังผู้ขอและพยาบาล
   • ❌ ปฏิเสธ → แจ้งเตือน + อีเมลไปยังผู้ขอ

7. รายงาน

Flow การดูรายงาน

เลือกประเภทรายงาน → กำหนดเงื่อนไข (หน่วยงาน, เดือน, ปี) → ดู/ดาวน์โหลด

📍 หน้าหลัก: /reports 👤 สิทธิ์: HOSPITAL_ADMIN, NURSING_DIRECTOR, HEAD_NURSE

7.1 รายงานตารางเวร (PDF)

📍 หน้า: /reports/schedule

วัตถุประสงค์: ดาวน์โหลดตารางเวรรายเดือนเป็นไฟล์ PDF

ขั้นตอน:

1. เลือก หน่วยงาน
2. เลือก เดือน และ ปี
3. คลิก "ดาวน์โหลด PDF"

เนื้อหา PDF:

• ตารางเวรรายเดือน แสดงพยาบาลทุกคน
• วันที่แสดงเป็น พ.ศ. (Buddhist Era)
• แยกตามกะ (เช้า/บ่าย/ดึก) + ควบเวร (ชบ/บด/ชบด)
• เวร On-call แสดง * หลังชื่อย่อกะ (เช่น ช*)
• วันลา แสดงรหัสย่อ: V (ลาพักผ่อน), S (ลาป่วย), P (ลากิจ), T (ลาอบรม), M (ลาคลอด)
• วันหยุด แสดง Off (วันที่ไม่มีเวรและไม่มีวันลา)
• Legend ครบ: กะเวร + ควบเวร 4 แบบ + * = เวรเรียกตัว (OC) + Off + V/S/P/T/M
• ใช้ Font Kanit สำหรับภาษาไทย

รายงาน Excel:

• ดาวน์โหลดตารางเวรรายเดือนเป็นไฟล์ .xlsx
• เนื้อหาเหมือน PDF: กะเวร + ควบเวร + On-call + วันลา + Off
• สีเซลล์วันลา: font สีชมพู + พื้นหลังชมพูอ่อน
• สีเซลล์ Off: font สีเทา + พื้นหลังเทาอ่อน
• Legend row ท้ายตาราง

7.2 รายงาน OT/ค่าตอบแทน (Excel)

📍 หน้า: /reports/ot

วัตถุประสงค์: แสดงชั่วโมงทำงานและ OT ของพยาบาลแต่ละคน

ขั้นตอน:

1. เลือก หน่วยงาน, เดือน, ปี
2. คลิก "ดูข้อมูล" เพื่อดูในระบบ
3. คลิก "ดาวน์โหลด Excel" เพื่อส่งออกเป็นไฟล์ .xlsx

ข้อมูลที่แสดง (ต่อพยาบาล):

7.3 Staffing Adequacy (อัตรากำลังเพียงพอ)

📍 หน้า: /reports/staffing

วัตถุประสงค์: วิเคราะห์ความเพียงพอของอัตรากำลังพยาบาล

KPI Cards:

ตาราง Daily Inadequate Shifts:

• แสดงวันที่มีเวรขาดคน (วันที่, กะ, ต้องการ, มีจริง, ขาด)

7.4 Fairness Index (ดัชนีความเป็นธรรม)

📍 หน้า: /reports/fairness

วัตถุประสงค์: วัดความเป็นธรรมในการกระจายเวรด้วย Jain's Fairness Index

KPI:

• Overall Fairness — ดัชนีรวม
• Total Shifts — ความเป็นธรรมจำนวนเวรรวม
• Night Shifts — ความเป็นธรรมเวรดึก
• Weekend Shifts — ความเป็นธรรมเวรวันหยุด

ข้อมูลรายพยาบาล:

• จำนวนเวร (เช้า/บ่าย/ดึก/รวม)
• จำนวนเวร Weekend
• Shift Ratio (Progress bar)

7.5 HA Compliance Report

📍 หน้า: /reports/ha-compliance 👤 สิทธิ์: HEAD_NURSE, NURSING_DIRECTOR, HOSPITAL_ADMIN

วัตถุประสงค์: รายงานการปฏิบัติตามมาตรฐาน HA (Hospital Accreditation) สำหรับรับรองคุณภาพ สรพ.

ขั้นตอน:

1. ไปที่ รายงาน → คลิก "HA Compliance Report"
2. เลือก เดือน และ ปี
3. ระบบแสดง Dashboard 5 หมวดพร้อมกราฟ
4. คลิก "ดาวน์โหลด PDF" เพื่อส่งออกรายงาน

5 หมวดที่ตรวจสอบ:

คะแนน Compliance:

• แสดง Overall Score เป็น RingProgress (เขียว ≥ 80%, เหลือง ≥ 50%, แดง < 50%)
• ป้าย "ผ่านเกณฑ์" / "ต้องปรับปรุง" / "ไม่ผ่านเกณฑ์"

กราฟและ Visualization:

• BarChart — สัดส่วน RN % ต่อหน่วยงาน (เขียว/ส้ม/แดงตามเกณฑ์)
• PieChart — สรุปความเสี่ยง (เกิน Weekly Limit / ควบเวร)
• ตาราง High Risk Nurses — พยาบาลที่เวรเกิน 25 หรือดึกเกิน 6

8. การแจ้งเตือน

8.1 การแจ้งเตือนในระบบ (NotificationBell)

ตำแหน่ง: ไอคอนกระดิ่ง 🔔 ที่มุมขวาบนของ Header

วิธีใช้งาน:

1. Badge สีแดง บนไอคอนกระดิ่ง = จำนวนแจ้งเตือนที่ยังไม่ได้อ่าน
2. คลิกที่กระดิ่ง → เปิด Popover แสดงรายการแจ้งเตือน
3. คลิกที่แจ้งเตือน → ระบบจะ:
   • ทำเครื่องหมายว่า "อ่านแล้ว"
   • Redirect ไปหน้าที่เกี่ยวข้อง
4. คลิก "อ่านทั้งหมด" เพื่อทำเครื่องหมายอ่านแล้วทั้งหมด

ประเภทแจ้งเตือน 18 ประเภท:

Real-time: แจ้งเตือนส่งทันทีผ่าน Socket.IO — ไม่ต้อง refresh หน้าจอ

8.2 การแจ้งเตือนอีเมล

ระบบส่งอีเมลอัตโนมัติ 17 ประเภท:

8.3 การแจ้งเตือน Telegram

การตั้งค่า: ผู้ดูแลแพลตฟอร์มตั้งค่า Bot Token และ Chat ID ในหน้าตั้งค่าระบบ

เหตุการณ์ที่ส่ง Telegram:

• มีสลิปชำระเงินรอตรวจ
• มีผู้สมัครสมาชิกใหม่
• สรุปรายวัน (Daily Summary)
• Burnout Risk Alert
• Subscription ใกล้หมดอายุ

8.4 ตั้งค่าช่องทางแจ้งเตือนระดับหน่วยงาน

📍 หน้า: /settings/notifications 👤 สิทธิ์: HOSPITAL_ADMIN, NURSING_DIRECTOR, HEAD_NURSE

วัตถุประสงค์: กำหนดว่าแต่ละหน่วยงาน (Unit) จะรับแจ้งเตือนผ่านช่องทางใดบ้าง แยกอิสระไม่ปนกัน

ช่องทางแจ้งเตือน 5 ช่องทาง:

ประเภทการแจ้งเตือนที่ตั้งค่าได้ 13 ประเภท:

ขั้นตอนการตั้งค่า:

1. ไปที่เมนู "การแจ้งเตือน" ในแถบด้านข้าง
2. เลือกหน่วยงาน จาก Dropdown (HEAD_NURSE จะเห็นเฉพาะหน่วยงานตนเอง)
3. ดูสถานะ Badge:
   • Telegram ตั้งค่าแล้ว / ยังไม่ตั้งค่า
   • SMS พร้อมใช้งาน / ยังไม่ตั้งค่า
4. แท็บ "ช่องทางแจ้งเตือน" — ตาราง Matrix:
   • Desktop: ตาราง (แถว = ประเภทแจ้งเตือน, คอลัมน์ = ช่องทาง) พร้อมสวิตช์เปิด/ปิด
   • Mobile: Card view (1 การ์ด = 1 ประเภท, สวิตช์ 4 ช่องทาง)
   • ช่องทางที่ยังไม่ตั้งค่า (SMS/Telegram) จะ disabled พร้อม Tooltip แจ้งเตือน
5. คลิก "บันทึกการตั้งค่า"

สิทธิ์:

• HEAD_NURSE — แก้ไขได้เฉพาะหน่วยงานของตนเอง
• NURSING_DIRECTOR / HOSPITAL_ADMIN — แก้ไขหน่วยงานใดก็ได้ภายใน Tenant

8.5 ตั้งค่า Telegram ระดับหน่วยงาน

📍 หน้า: /settings/notifications (แท็บ "Telegram") 👤 สิทธิ์: HOSPITAL_ADMIN, NURSING_DIRECTOR, HEAD_NURSE

วัตถุประสงค์: ตั้งค่า Telegram Bot สำหรับแต่ละหน่วยงาน (แยกจาก Telegram ของผู้ดูแลแพลตฟอร์ม)

ขั้นตอนการตั้งค่า:

1. เลือกหน่วยงาน → คลิกแท็บ "Telegram"
2. กรอก Bot Token (จาก @BotFather)
3. กรอก Chat ID ของกลุ่ม (เช่น -1001234567890)
4. เปิดสวิตช์ "เปิดใช้งาน Telegram"
5. คลิก "บันทึก"
6. คลิก "ทดสอบ" เพื่อส่งข้อความทดสอบไปยังกลุ่ม

วิธีสร้าง Telegram Bot:

1. ค้นหา @BotFather ใน Telegram แล้วพิมพ์ /newbot
2. ตั้งชื่อ Bot และ username
3. คัดลอก Bot Token มาวาง
4. เพิ่ม Bot เข้าไปในกลุ่ม Telegram ของหน่วยงาน
5. ดึง Chat ID ของกลุ่มมาวาง

8.6 ตั้งค่า SMS Provider (ผู้ดูแลแพลตฟอร์ม)

📍 หน้า: /super-admin/settings (แท็บ "การแจ้งเตือน") 👤 สิทธิ์: Super Admin เท่านั้น

วัตถุประสงค์: ตั้งค่า SMS Provider สำหรับทั้งแพลตฟอร์ม เพื่อให้หน่วยงานต่างๆ สามารถเปิดใช้ช่องทาง SMS ได้

Provider ที่รองรับ:

ขั้นตอนการตั้งค่า:

1. ไปที่ ตั้งค่าระบบ → แท็บ "การแจ้งเตือน"
2. เลื่อนไปที่ส่วน "ตั้งค่า SMS Provider"
3. เลือก Provider (ThaiBulkSMS / SMSMKT)
4. กรอก Sender Name (ชื่อผู้ส่งที่จะแสดงในข้อความ)
5. กรอก API Key และ API Secret (จาก provider)
6. คลิก "บันทึก"
7. คลิก "ทดสอบ" → กรอกเบอร์โทร → ส่งข้อความทดสอบ

8.7 แจ้งเตือนผ่าน LINE OA

📍 หน้า: /settings/notifications (แท็บ "LINE") 👤 สิทธิ์: HOSPITAL_ADMIN, NURSING_DIRECTOR, HEAD_NURSE

วัตถุประสงค์: เชื่อมต่อ LINE Official Account สำหรับแต่ละหน่วยงาน

ขั้นตอนการตั้งค่า:

1. เลือกหน่วยงาน → คลิกแท็บ "LINE"
2. กรอก Channel Access Token (Long-lived) จาก LINE Developers Console
3. กรอก Channel Secret (ไม่บังคับ)
4. เปิดสวิตช์ "เปิดใช้งาน LINE" → คลิก "บันทึก"
5. คลิก "ทดสอบ" เพื่อส่ง broadcast ทดสอบ

วิธีสร้าง LINE OA:

1. เข้า LINE Developers Console (developers.line.biz)
2. สร้าง Provider → สร้าง Messaging API Channel
3. คัดลอก Channel Access Token (Long-lived) มาวาง
4. ให้พยาบาลในหน่วยงาน เพิ่มเพื่อน LINE OA — ระบบจะ broadcast ถึงทุกคนที่เป็นเพื่อน

8.8 แชทภายในทีม (In-App Chat)

📍 หน้า: /chat 👤 สิทธิ์: ทุก Role

วัตถุประสงค์: สื่อสารภายในทีมผ่านห้องแชทแบบ Real-time

ประเภทห้องแชท 2 ประเภท:

Unit Chat:

1. เปิดเมนู "แชท" จาก Sidebar
2. เลือกห้องแชทของหน่วยงาน → พิมพ์ข้อความ → Enter หรือคลิกปุ่มส่ง
3. ข้อความแสดง Real-time ผ่าน Socket.IO

Direct Message:

1. คลิกไอคอน ข้อความใหม่
2. ค้นหาชื่อผู้ใช้ → คลิกเพื่อเปิดห้องแชทส่วนตัว
3. พิมพ์ข้อความ → ส่ง

9. การชำระเงินและอัปเกรด

Flow การชำระเงิน (SAAS mode)

เลือกแพ็คเกจ → เลือกวิธีชำระ → ชำระเงิน → อัปโหลดสลิป → รอตรวจสอบ → เปิดใช้งาน

9.1 อัปเกรดแพ็คเกจ

📍 หน้า: /upgrade 👤 สิทธิ์: HOSPITAL_ADMIN (SAAS mode)

วัตถุประสงค์: เลือกและอัปเกรดแพ็คเกจบริการ

แพ็คเกจที่มี:

ขั้นตอน:

1. ดู แพ็คเกจปัจจุบัน และ วันหมดอายุ ที่ header
2. สลับ รอบบิล (รายเดือน / รายปี) — รายปีประหยัด ~17%
3. เลือก แพ็คเกจ ที่ต้องการ → คลิก "เลือก"
4. เลือก วิธีชำระเงิน ในป๊อปอัพ

9.2 ชำระเงิน

วิธีชำระเงิน 2 วิธี:

1. พร้อมเพย์ (PromptPay):

1. ระบบแสดง QR Code สำหรับสแกนจ่าย
2. จ่ายเงินผ่านแอปธนาคาร
3. กลับมาที่ระบบ → คลิก "อัปโหลดสลิป"

2. โอนเงิน (Bank Transfer):

1. ระบบแสดง ข้อมูลบัญชีธนาคาร (ชื่อธนาคาร, เลขที่บัญชี, ชื่อบัญชี, สาขา)
2. โอนเงินผ่านแอปธนาคาร
3. กลับมาที่ระบบ → คลิก "อัปโหลดสลิป"

การอัปโหลดสลิป:

1. คลิก "อัปโหลดสลิป"
2. เลือก ไฟล์รูปสลิป
3. กรอกข้อมูลเพิ่มเติม:
   • ชื่อธนาคาร ที่โอน
   • เลขอ้างอิงการโอน
   • วันเวลาที่โอน (CustomDatePicker datetime)
4. คลิก "ส่ง"
5. สถานะเปลี่ยนเป็น "รอตรวจสอบ" (REVIEWING)
6. ทีมงานจะได้รับแจ้งเตือนทาง Telegram

9.3 ประวัติชำระเงิน

📍 หน้า: /payments 👤 สิทธิ์: HOSPITAL_ADMIN

วัตถุประสงค์: ดูประวัติการชำระเงินทั้งหมด

ขั้นตอน:

1. กรองตาม สถานะ (รอดำเนินการ / รอตรวจสอบ / สำเร็จ / ปฏิเสธ)
2. ดูรายการ:
   • รหัสอ้างอิง (PAY-YYYYMMDD-XXXXX)
   • แพ็คเกจ
   • วิธีชำระ
   • จำนวนเงิน (บาท)
   • สถานะ
   • วันที่
3. คลิกที่รายการเพื่อดู รายละเอียด:
   • ข้อมูลการชำระเงิน
   • รูปสลิป (ถ้ามี)
   • เหตุผลที่ปฏิเสธ (ถ้ามี)
4. ดาวน์โหลด ใบเสร็จรับเงิน (PDF) — เฉพาะรายการที่สำเร็จแล้ว

สถานะการชำระเงิน:

10. ภาคผนวก

10.1 ตารางสิทธิ์ Role-Based Access (ครบทุกหน้า)

10.2 ประเภทกะเวร

10.2.1 สัญลักษณ์วันลาและวันหยุดในตารางเวร

ตารางเวรแสดง ทั้งเวรทำงานและวันหยุด/วันลา ในตารางเดียวกัน ตามแนวปฏิบัติมาตรฐานโรงพยาบาลไทย:

กฎ Priority การแสดงผล:

1. มีเวร → แสดงกะเวรตามปกติ (เช้า/บ่าย/ดึก/ควบเวร)
2. ไม่มีเวร + มีวันลาอนุมัติ → แสดงรหัสลา (V/S/P/T/M/O/ML/SZ/SF/R/SL)
3. ไม่มีเวร + ไม่มีวันลา → แสดง Off

10.3 กฎการจัดเวร

10.4 ระดับพยาบาล

10.5 สถานะคำขอต่างๆ

คำขอแลกเวร (Swap Request):

PENDING (รออนุมัติ) → ACCEPTED (ตอบรับ) / REJECTED (ปฏิเสธ)
                    → CANCELLED (ยกเลิกโดยผู้ขอ)

คำขอลางาน (Leave Request):

PENDING (รออนุมัติ) → APPROVED (อนุมัติ) / REJECTED (ปฏิเสธ)
                    → CANCELLED (ยกเลิกโดยผู้ขอ)

คำขอยืมตัวพยาบาล (Float Request):

PENDING (รออนุมัติ) → COMPLETED (เสร็จสิ้น — สร้างเวรอัตโนมัติ) / REJECTED (ปฏิเสธ)
                    → CANCELLED (ยกเลิกโดยผู้ขอ)

คำขอเวร (Schedule Preference):

PENDING (รอตรวจสอบ) → REVIEWED (ตรวจสอบแล้ว) → INCORPORATED (นำไปใช้แล้ว)

การชำระเงิน (Payment):

PENDING (รอดำเนินการ) → AWAITING_SLIP (รอส่งสลิป) → REVIEWING (รอตรวจสอบ)
                                                     → COMPLETED (สำเร็จ) / REJECTED (ปฏิเสธ)
PENDING → CANCELLED (ยกเลิก) / EXPIRED (หมดอายุ)

Subscription:

ACTIVE (ใช้งาน) → EXPIRED (หมดอายุ) / CANCELLED (ยกเลิก)

10.6 แพ็คเกจและราคา

ขีดจำกัดต่อแพ็คเกจ:

• จำนวนผู้ใช้สูงสุด
• จำนวนหน่วยงานสูงสุด
• จำนวนพยาบาลต่อหน่วยสูงสุด

10.7 คำถามที่พบบ่อย (FAQ)

Q: ลืมรหัสผ่านทำอย่างไร? A: คลิก "ลืมรหัสผ่าน?" ที่หน้า Login → กรอกอีเมล → ระบบส่ง OTP → กรอก OTP + รหัสผ่านใหม่ที่หน้า Reset Password

Q: ไม่ได้รับอีเมล OTP? A: ตรวจสอบโฟลเดอร์ Spam/Junk → รอ 60 วินาที → คลิก "ส่งรหัสใหม่"

Q: ทำไมไม่เห็นเมนู "เวรของฉัน"? A: เมนูนี้แสดงเฉพาะบทบาท HEAD_NURSE และ STAFF_NURSE ที่มี Nurse Profile เท่านั้น

Q: ทำไมไม่สามารถแก้ไขเวรได้? A: เวรที่ถูก "ล็อก" แล้วไม่สามารถแก้ไขหรือลบได้ — ติดต่อผู้ดูแลระบบ

Q: AI สร้างเวรใช้เวลานานแค่ไหน? A: ขึ้นอยู่กับจำนวนพยาบาลและเงื่อนไข — ปกติไม่เกิน 1-2 นาที (ทำงานใน Background)

Q: สามารถดูเวรย้อนหลังได้หรือไม่? A: ได้ — เลือกเดือน/ปีที่ต้องการในหน้าตารางเวร

Q: แพ็คเกจทดลองใช้หมดอายุแล้วจะเกิดอะไร? A: ระบบจะแจ้งเตือน 7 วันก่อนหมดอายุ → หลังหมดอายุจะไม่สามารถใช้งานบางฟีเจอร์ได้ → อัปเกรดแพ็คเกจเพื่อใช้งานต่อ

Q: ชำระเงินแล้วรอตรวจสอบนานแค่ไหน? A: ทีมงานจะได้รับแจ้งเตือนทันที — ปกติภายใน 1 วันทำการ

Q: ระบบรองรับ Dark Mode หรือไม่? A: รองรับ — คลิกไอคอน 🌙/☀️ ที่มุมขวาบนเพื่อสลับโหมดมืด/สว่าง

Q: Timezone ของระบบคืออะไร? A: Asia/Bangkok (UTC+7) — ทุก layer ใช้ timezone เดียวกัน วันที่ในรายงาน/PDF แสดงเป็น พ.ศ.

Q: ส่งออกตารางเวรไปยัง Google Calendar ได้อย่างไร? A: ไปที่หน้า "เวรของฉัน" → คลิกปุ่ม "ส่งออก iCal" เพื่อดาวน์โหลดไฟล์ .ics แล้วนำไป Import ใน Google Calendar หรือคลิกไอคอน Google ที่รายการเวรเพื่อเพิ่มลง Google Calendar โดยตรง

Q: แชทภายในทีมใช้งานอย่างไร? A: เปิดเมนู "แชท" จาก Sidebar → เลือกห้องแชทหน่วยงาน (Unit Chat) หรือคลิกไอคอนข้อความใหม่เพื่อเปิด Direct Message กับผู้ใช้คนอื่น ข้อความจะแสดง Real-time ผ่าน Socket.IO

Q: ตั้งค่า LINE OA สำหรับแจ้งเตือนอย่างไร? A: ไปที่ "ตั้งค่าการแจ้งเตือน" → เลือกหน่วยงาน → แท็บ "LINE" → กรอก Channel Access Token จาก LINE Developers Console → เปิดสวิตช์ → บันทึก แล้วให้พยาบาลเพิ่มเพื่อน LINE OA เพื่อรับแจ้งเตือน

Q: คำขอเวรล่วงหน้าคืออะไร? A: เป็นระบบให้พยาบาลส่งความต้องการเวรล่วงหน้าเป็นรายเดือน ก่อนที่หัวหน้าจะสร้างตารางเวร AI รองรับทั้งเวรเดี่ยว (เช้า/บ่าย/ดึก/หยุด) และ ควบเวร (ชบ เช้า-บ่าย 16 ชม., บด บ่าย-ดึก 16 ชม., ชบด เช้า-บ่าย-ดึก 24 ชม.) ระบบจะแสดงจำนวนคนที่ขอแล้วเทียบกับจำนวนขั้นต่ำเพื่อเป็นแนวทาง (ไม่บล็อก) และแจ้งเตือนหัวหน้าอัตโนมัติเมื่อมีคำขอใหม่

Q: ทำไมส่งคำขอเวรได้แค่เดือนละครั้ง? A: คำขอเวร 1 รายการครอบคลุมทุกวันในเดือนนั้น (เลือกได้หลายวัน) หากต้องการเปลี่ยนแปลง ให้กดปุ่มแก้ไขในขณะที่สถานะยัง "รอตรวจสอบ"

Q: เวรเรียกตัว (On-call) คืออะไร? A: เป็นเวรฉุกเฉินที่กำหนดมือ (ไม่ผ่าน AI) ให้พยาบาลสำรองนอกเวลา ไม่นับ staffing/OT จะแสดง Badge "OC" สี teal ในระบบ และ * ในรายงาน PDF/Excel

Q: OT สูงสุด/วัน คืออะไร? A: กฎ HC15 จำกัด OT ต่อวัน — เช่น ตั้ง 4 ชม. หมายความว่าพยาบาล 1 คนทำงานได้สูงสุด 12 ชม./วัน (8 ชม. ปกติ + 4 ชม. OT) ตั้งค่าได้ที่หน้า ตั้งค่าหน่วยงาน → กฎการจัดเวร

Q: Recovery Cycle (วันพักหลังทำงานติด) คืออะไร? A: กฎ HC16 บังคับพักหลังทำงานต่อเนื่อง — เช่น ตั้ง maxConsecutiveDays=6, minRecoveryDays=2 หมายความว่าหลังทำงานติด 6 วัน ต้องพักอย่างน้อย 2 วัน ก่อน AI จะจัดเวรใหม่

Q: ต้องตั้งค่าระบบเวรอย่างไรเมื่อ unit ทำ 12 ชม.? A: ไปที่ ตั้งค่าหน่วยงาน → คลิกไอคอนนาฬิกา → เลือก Preset "12 ชม. กลางวัน-กลางคืน" → ระบบจะตั้งค่าเวลา 12/12 ชม. + ปิดกะบ่าย + ตั้งกฎ OT/Recovery ให้อัตโนมัติ

Q: Inline Edit คืออะไร? ทำไมคลิกแล้วไม่ขึ้น Select? A: Inline Edit ให้คลิกที่ช่องเวรเดี่ยว (เช้า/บ่าย/ดึก) บน Desktop เพื่อเปลี่ยนกะทันที ถ้าไม่ขึ้น อาจเป็นเพราะ: 1) เวรถูกล็อกแล้ว 2) เป็นเวรควบ (ชบ/บด/ชบด) 3) ไม่มีสิทธิ์ Manager 4) ใช้งานบน Mobile

Q: ลาก Drag & Drop เวรไม่ได้ทำอย่างไร? A: Drag & Drop ใช้ได้เฉพาะ Desktop เท่านั้น ต้องกดค้างแล้วลากอย่างน้อย 8 พิกเซล คลิกสั้นๆ จะเป็น Inline Edit แทน ตรวจสอบว่าคุณมีสิทธิ์ Manager (HEAD_NURSE ขึ้นไป)

Q: "เปลี่ยนเวร" ต่างจาก "แลกเวร" อย่างไร? A: แลกเวร = 2 คนสลับเวรกัน (ต้องมีคู่แลก), เปลี่ยนเวร = ขอเปลี่ยนกะของตัวเองคนเดียว (เช่น เช้า→บ่าย) ไม่ต้องหาคู่แลก รอหัวหน้าอนุมัติ

Q: ค่าตอบแทนเวรคำนวณอย่างไร? A: ระบบคำนวณอัตโนมัติจากตารางเวรจริง × อัตราค่าตอบแทนที่ตั้งไว้ โดยเพิ่มค่าเวรวันหยุด (วันหยุดราชการ + เสาร์-อาทิตย์) และค่าเวรเรียกตัว (On-call) แยกต่างหาก ดูผลลัพธ์ได้ที่หน้า "ค่าตอบแทนเวร"

Q: ทำไมประเภทลาบางอย่างไม่แสดงใน dropdown? A: ประเภทลาเพิ่มเติม (ลาอุปสมบท, ลาทหาร, ลาทำหมัน ฯลฯ) เปิดใช้งานเริ่มต้นเป็น "ปิด" — HOSPITAL_ADMIN สามารถเปิดใช้งานได้ที่หน้า "ตั้งค่า → ประเภทการลา"

Q: อัตราค่าตอบแทนเวรแต่ละ รพ. ไม่เหมือนกันได้ไหม? A: ได้ — แต่ละโรงพยาบาลตั้งค่าอัตราค่าตอบแทนเวรได้อิสระ ค่าเริ่มต้นอ้างอิงจากอัตราเฉลี่ย รพ.รัฐ กระทรวงสาธารณสุข

ข้อมูลลิขสิทธิ์

© 2569 AJ Software Dev. สงวนลิขสิทธิ์. Powered by AJ Software Dev.

Smart Nurse Rostering System — ระบบจัดตารางเวรพยาบาลอัจฉริยะ