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

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

เวอร์ชัน 1.0 | อัปเดตล่าสุด: กุมภาพันธ์ 2569

สารบัญ

1. บทนำ
2. เริ่มต้นใช้งาน (Getting Started)
3. ตั้งค่าองค์กร (Organization Setup)
4. การจัดเวร (Scheduling)
5. บริการตนเอง (Self-Service)
6. การอนุมัติ (Approval)
7. รายงาน (Reports)
8. การแจ้งเตือน (Notifications)
9. การชำระเงินและอัปเกรด (SAAS)
10. ภาคผนวก

1. บทนำ

1.1 ภาพรวมระบบ

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

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

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

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

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

ระดับพยาบาล (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

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

วัตถุประสงค์: แสดงภาพรวมสถิติสำคัญของระบบ

KPI Cards 4 ตัว:

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

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

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

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

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

📍 หน้า: ผ่านเมนู พยาบาล 👤 สิทธิ์: HOSPITAL_ADMIN

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

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

1. ระบบสร้างผู้ใช้ผ่านหน้า เพิ่มพยาบาล หรือโดย Admin โดยตรง
2. กำหนด บทบาท (Role) ให้ผู้ใช้:
   • HOSPITAL_ADMIN — ผู้ดูแลระบบ
   • NURSING_DIRECTOR — ผู้อำนวยการฝ่ายการพยาบาล
   • HEAD_NURSE — หัวหน้าหอผู้ป่วย
   • STAFF_NURSE — พยาบาลประจำการ
3. ผู้ใช้จะได้รับอีเมลยืนยัน

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

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

วัตถุประสงค์: สร้างโปรไฟล์พยาบาลจากผู้ใช้ที่มีอยู่ในระบบ

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

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

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

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

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

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

4. การจัดเวร

Flow การจัดเวร

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

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. คลิก "สร้างตารางเวร"
4. ระบบจะใช้ AI ประมวลผลตามเงื่อนไข:
   • กฎ Forward Rotation (เช้า → บ่าย → ดึก)
   • ห้าม Night → Morning (ช่วงพักระหว่างกะ ≥ 10 ชม.)
   • จำนวนชั่วโมงทำงานสูงสุด/สัปดาห์
   • จำนวนเวรดึกสูงสุด/เดือน
   • สัดส่วน RN ≥ 80% ต่อกะ
   • อัตราพยาบาลต่อผู้ป่วย (1:2 วิกฤต, 1:4 ทั่วไป)
5. รอจนประมวลผลเสร็จ (ใช้ Worker Thread แยกประมวลผล)
6. ตรวจสอบผลลัพธ์ในหน้า ตารางเวร

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

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

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

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

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

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

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. ยืนยันในป๊อปอัพ "ยืนยันการล็อก" → คลิก "ล็อก"

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

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

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

5.1 เวรของฉัน

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

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

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

1. Card View:

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

2. Calendar View:

• แสดงเป็นปฏิทิน 7 คอลัมน์
• แต่ละช่องแสดงกะเวรด้วยสี:
  • 🟡 เช้า (MORN) — สีเหลือง
  • 🟠 บ่าย (AFTER) — สีส้ม
  • 🟣 ดึก (NIGHT) — สีม่วง
• วันนี้จะถูก 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

วัตถุประสงค์: ส่งคำขอลางาน 5 ประเภท

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

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

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. ระบบจะ:
   • สร้างเวรใหม่ให้คุณอัตโนมัติ
   • ส่งแจ้งเตือนไปยังหัวหน้าหน่วยงาน

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. ดำเนินการ:
   • ✅ อนุมัติ → ส่งแจ้งเตือน + อีเมลไปยังผู้ขอ
   • ❌ ปฏิเสธ → ส่งแจ้งเตือน + อีเมลไปยังผู้ขอ

7. รายงาน

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

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

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

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

📍 หน้า: /reports/schedule

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

ขั้นตอน:

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

เนื้อหา PDF:

• ตารางเวรรายเดือน แสดงพยาบาลทุกคน
• วันที่แสดงเป็น พ.ศ. (Buddhist Era)
• แยกตามกะ (เช้า/บ่าย/ดึก)
• ใช้ Font Kanit สำหรับภาษาไทย

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)

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

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

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

วิธีใช้งาน:

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

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

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

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

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

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

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

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

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

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.3 กฎการจัดเวร

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

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

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

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

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

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

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

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

Subscription:

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

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

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

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

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

Q: ลืมรหัสผ่านทำอย่างไร? A: ติดต่อผู้ดูแลระบบโรงพยาบาล (Hospital Admin) เพื่อรีเซ็ตรหัสผ่าน

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 แสดงเป็น พ.ศ.

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

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

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