Software Requirements Specification (SRS)

ระบบตรวจสอบสิทธิ

โรงพยาบาลค่ายธนรัชน์

---

เอกสารเลขที่: SRS-1.2.15
เวอร์ชัน: 1.0
วันที่: 3 ตุลาคม 2568
ผู้จัดทำ: ทีมพัฒนาระบบ
ผู้อนุมัติ: ผู้อำนวยการโรงพยาบาลค่ายธนรัชน์

---

สารบัญ

1. บทนำ
2. คำอธิบายโดยรวม
3. ข้อกำหนดเฉพาะ
4. ส่วนติดต่อภายนอก
5. คุณลักษณะของระบบ
6. ข้อกำหนดที่ไม่ใช่ฟังก์ชัน
7. ข้อกำหนดอื่นๆ
8. ภาคผนวก

---

1. บทนำ

1.1 วัตถุประสงค์

เอกสารนี้มีวัตถุประสงค์เพื่อกำหนดข้อกำหนดสำหรับการพัฒนาระบบตรวจสอบสิทธิสำหรับโรงพยาบาลค่ายธนรัชน์ โดยระบบนี้จะใช้ในการจัดการและตรวจสอบสิทธิการรักษาพยาบาลของผู้ป่วย รวมถึงการเชื่อมโยงกับระบบภายนอกเช่น สปสช. และ สนย.

1.2 ขอบเขต

ระบบตรวจสอบสิทธิเป็น Supporting Module ที่ทำงานร่วมกับระบบต่างๆ ในโรงพยาบาล โดยครอบคลุมการทำงานดังนี้:

การทำงานแบบ Modal/Pop-up (Supporting Function): - เรียกใช้จากระบบอื่นๆ เช่น ระบบเวชระเบียน, ระบบซักประวัติ, ระบบห้องตรวจแพทย์ - แสดงสิทธิการรักษาของผู้ป่วยแบบ Real-time - เลือกใช้สิทธิสำหรับการส่งตรวจแต่ละครั้ง - ตรวจสอบและแก้ไขข้อมูลสิทธิระหว่างการรักษา

การทำงานแบบ Standalone (Management Function): - หน้าจัดการสิทธิสำหรับเจ้าหน้าที่ตรวจสอบสิทธิโดยเฉพาะ - การจัดการข้อมูลสิทธิการรักษาพยาบาล - การเชื่อมโยงกับระบบภายนอก (สปสช., สนย.) - การออกใบยืนยันสิทธิ - การจัดการส่วนลดและการคิดค่าบริการ - การตรวจสอบและแก้ไขข้อมูลสิทธิย้อนหลัง

1.3 คำจำกัดความ อักษรย่อ และข้อตกลง

คำศัพท์	ความหมาย
สปสช.	สำนักงานหลักประกันสุขภาพแห่งชาติ
สนย.	สำนักงานสวัสดิการและคุ้มครองแรงงาน
HN	Hospital Number - หมายเลขประจำตัวผู้ป่วย
UC	Universal Coverage - หลักประกันสุขภาพถ้วนหน้า
SSS	Social Security Scheme - ประกันสังคม

1.4 การอ้างอิง

• TOR ระบบตรวจสอบสิทธิ เวอร์ชัน 1.0
• มาตรฐานการเชื่อมต่อข้อมูล สปสช.
• มาตรฐานการเชื่อมต่อข้อมูล สนย.

1.5 ภาพรวมของเอกสาร

เอกสารนี้จัดทำตามมาตรฐาน IEEE 830-1998 และประกอบด้วยการอธิบายความต้องการของระบบในด้านต่างๆ ครอบคลุมตั้งแต่ข้อกำหนดการทำงาน ส่วนติดต่อผู้ใช้ ไปจนถึงข้อกำหนดด้านประสิทธิภาพและความปลอดภัย

---

2. คำอธิบายโดยรวม

2.1 มุมมองผลิตภัณฑ์

ระบบตรวจสอบสิทธิเป็น Supporting Module ที่ทำงานในสองรูปแบบ: 1. Modal/Pop-up Component - เรียกใช้จากระบบอื่นๆ 2. Standalone Management Interface - สำหรับเจ้าหน้าที่ตรวจสอบสิทธิ

graph TD
    A[ระบบ สปสช.<br/>National Health Security Office] 
    B[ระบบตรวจสอบสิทธิ<br/>Rights Verification System<br/>🔧 Supporting Module]
    C[ระบบ สนย.<br/>Social Security Office]

    subgraph "ระบบเรียกใช้ Rights Modal"
        D[ระบบเวชระเบียน<br/>Medical Records]
        E[ระบบซักประวัติ<br/>History Taking]
        F[ระบบห้องตรวจแพทย์<br/>Doctor Room]
        G[ระบบห้องฉุกเฉิน<br/>Emergency Room]
        H[ระบบผู้ป่วยใน<br/>Inpatient]
    end

    subgraph "ระบบสนับสนุน"
        I[ระบบการเงิน<br/>Financial System]
        J[ระบบเภสัชกรรม<br/>Pharmacy System]
        K[ระบบรายงาน<br/>Reporting System]
    end

    subgraph "Rights Management Interface"
        L[หน้าจัดการสิทธิหลัก<br/>Main Rights Management]
        M[หน้าแก้ไขข้อมูลสิทธิ<br/>Rights Data Editing]
        N[หน้ารายงานสิทธิ<br/>Rights Reports]
    end

    A <-->|Web Service| B
    C <-->|Web Service| B

    D -.->|เรียก Modal| B
    E -.->|เรียก Modal| B
    F -.->|เรียก Modal| B
    G -.->|เรียก Modal| B
    H -.->|เรียก Modal| B

    B <-->|ข้อมูลการเงิน| I
    B <-->|ข้อมูลยา| J
    B <-->|รายงาน| K

    B --> L
    B --> M
    B --> N

    style B fill:#e1f5fe,stroke:#01579b,stroke-width:3px
    style A fill:#fff3e0,stroke:#e65100
    style C fill:#fff3e0,stroke:#e65100
    style L fill:#f3e5f5,stroke:#7b1fa2
    style M fill:#f3e5f5,stroke:#7b1fa2
    style N fill:#f3e5f5,stroke:#7b1fa2

2.2 ฟังก์ชันผลิตภัณฑ์

ระบบตรวจสอบสิทธิมีฟังก์ชันหลักแบ่งเป็น 2 ส่วน:

A. Modal/Pop-up Functions (Supporting Functions)

1. การตรวจสอบสิทธิแบบ Real-time
2. แสดงสิทธิทั้งหมดของผู้ป่วยในหน้าต่าง Modal
3. ตรวจสอบสถานะสิทธิแบบ Online

4. เลือกสิทธิสำหรับการส่งตรวจในครั้งนั้น

5. การจัดการสิทธิระหว่างการรักษา

6. แก้ไขข้อมูลสิทธิแบบ Quick Edit
7. เพิ่มสิทธิใหม่สำหรับ Visit ปัจจุบัน

8. ยืนยันการใช้สิทธิ

9. การแสดงข้อมูลสำคัญ

10. แสดงส่วนลดและค่าบริการ
11. แสดงข้อจำกัดของสิทธิ
12. เตือนสิทธิใกล้หมดอายุ

B. Standalone Management Functions

1. การจัดการข้อมูลสิทธิ
2. กำหนดประเภทสิทธิการรักษา
3. จัดการข้อมูลสิทธิผู้ป่วยแบบครบถ้วน

4. เชื่อมโยงกับระบบภายนอก

5. การออกเอกสาร

6. ออกใบยืนยันสิทธิ
7. พิมพ์รายงานสิทธิ

8. ออกใบรับรองการมีสิทธิ

9. การจัดการการเงิน

10. กำหนดผังการคิดค่าบริการ
11. จัดการส่วนลดตามสิทธิ
12. ตั้งค่าประเภทการชำระเงิน

2.3 คุณลักษณะผู้ใช้

ประเภทผู้ใช้	บทบาท	วิธีการเข้าถึง	ระดับทักษะ
แพทย์/พยาบาล	เรียกใช้ Modal เพื่อเลือกสิทธิผู้ป่วย	Modal Pop-up จากระบบหลัก	พื้นฐาน
เจ้าหน้าที่ลงทะเบียน	เรียกใช้ Modal เพื่อตรวจสอบสิทธิ	Modal Pop-up จากระบบเวชระเบียน	พื้นฐาน
เจ้าหน้าที่ตรวจสอบสิทธิ	จัดการข้อมูลสิทธิแบบเต็มรูปแบบ	Standalone Interface + Modal	สูง
เจ้าหน้าที่การเงิน	ดูข้อมูลสิทธิและส่วนลด	Modal Pop-up + Report Interface	ปานกลาง
ผู้ดูแลระบบ	จัดการการตั้งค่าระบบ	Admin Interface	สูง

2.4 ข้อจำกัด

1. ข้อจำกัดด้านเทคนิค
2. ต้องเชื่อมต่ออินเทอร์เน็ตเพื่อตรวจสอบข้อมูลจากระบบภายนอก

3. ต้องสามารถทำงานร่วมกับระบบ HIS ที่มีอยู่

4. ข้อจำกัดด้านความปลอดภัย

5. ต้องปฏิบัติตามพระราชบัญญัติคุ้มครองข้อมูลส่วนบุคคล

6. ข้อมูลสิทธิต้องมีการเข้ารหัสในการเก็บและส่งข้อมูล

7. ข้อจำกัดด้านประสิทธิภาพ

8. เวลาตอบสนองไม่เกิน 3 วินาที
9. รองรับผู้ใช้พร้อมกันอย่างน้อย 50 คน

2.5 สมมติฐานและการพึ่งพา

• ระบบ สปสช. และ สนย. มีความพร้อมใช้งาน 24/7
• มีการสำรองข้อมูลตามกำหนด
• ผู้ใช้ได้รับการอบรมการใช้งานระบบแล้ว

---

3. ข้อกำหนดเฉพาะ

3.1 ส่วนติดต่อภายนอก

3.1.1 ส่วนติดต่อผู้ใช้

UI-01: หน้าจอหลักระบบตรวจสอบสิทธิ - ต้องมีเมนูเข้าถึงฟังก์ชันหลักทั้งหมด - แสดงสถานะการเชื่อมต่อระบบภายนอก - มีระบบล็อกอิน/ล็อกเอาต์

UI-02: หน้าจอค้นหาผู้ป่วย - ช่องค้นหาด้วย HN, ชื่อ-สกุล, เลขบัตรประชาชน - แสดงผลการค้นหาในรูปแบบตาราง - ปุ่มเลือกผู้ป่วยเพื่อดูรายละเอียดสิทธิ

UI-03: หน้าจอรายละเอียดสิทธิผู้ป่วย - แสดงข้อมูลส่วนตัวผู้ป่วย - แสดงรายการสิทธิทั้งหมด - สถานะสิทธิ (ใช้งานได้/หมดอายุ/ระงับการใช้งาน)

3.1.2 ส่วนติดต่อฮาร์ดแวร์

• เครื่องอ่านบัตรประชาชน
• เครื่องพิมพ์ใบยืนยันสิทธิ
• เครื่องสแกนเนอร์เอกสาร

3.1.3 ส่วนติดต่อซอฟต์แวร์

API-01: เชื่อมต่อระบบ สปสช. (NHSO)

Endpoint: https://ucws.nhso.go.th/ucwstokenp1/UCWSTokenP1
Method: POST
Authentication: Token-based
Timeout: 30 seconds
Retry: 3 attempts

Request Format:
{
  "smctoken": "encrypted_token",
  "user_person_id": "citizen_id",
  "correlationId": "unique_request_id",
  "hos_guid": "hospital_guid"
}

Response Format:
{
  "status": "success|error",
  "maininscl": "UC_insurance_class",
  "startdate": "YYYY-MM-DD",
  "expdate": "YYYY-MM-DD",
  "hospmain": "main_hospital_code",
  "hospsub": "sub_hospital_code",
  "allow_opd": "Y|N",
  "allow_ipd": "Y|N"
}

Error Handling:
- รหัสข้อผิดพลาด 200: สำเร็จ
- รหัสข้อผิดพลาด 401: Token หมดอายุ
- รหัสข้อผิดพลาด 404: ไม่พบข้อมูลสิทธิ
- รหัสข้อผิดพลาด 500: ข้อผิดพลาดของระบบ
- Timeout: ใช้ข้อมูล Cache หรือ Manual Mode

API-02: เชื่อมต่อระบบ สนย. (SSO)

Endpoint: https://api.sso.go.th/validation
Method: POST
Authentication: Certificate-based (SSL Client Certificate)
Timeout: 45 seconds
Retry: 2 attempts

Request Format:
{
  "citizen_id": "13_digit_id",
  "hospital_code": "5_digit_code",
  "service_date": "YYYY-MM-DD",
  "request_id": "unique_request_id"
}

Response Format:
{
  "status": "active|inactive|suspended",
  "scheme_code": "SSS_code",
  "valid_from": "YYYY-MM-DD",
  "valid_to": "YYYY-MM-DD",
  "employer_name": "company_name",
  "coverage_level": "standard|premium"
}

Error Handling:
- Certificate หมดอายุ: ต่ออายุอัตโนมัติ
- เครือข่ายล่ม: ใช้ Offline Mode
- ข้อมูลไม่ถูกต้อง: Manual Verification

API-03: เชื่อมต่อระบบ กรมบัญชีกลาง (CGD)

Endpoint: https://api.ocsc.go.th/medical
Method: POST
Authentication: API Key
Timeout: 30 seconds
Retry: 3 attempts

Request Format:
{
  "citizen_id": "13_digit_id",
  "employee_id": "government_id",
  "service_date": "YYYY-MM-DD",
  "hospital_code": "hospital_code"
}

Response Format:
{
  "status": "eligible|not_eligible",
  "position_level": "C1|C2|C3|...",
  "department": "ministry_name",
  "coverage_type": "full|partial",
  "family_coverage": "Y|N"
}

API-03: เชื่อมต่อระบบ HIS ภายใน - API สำหรับเรียกใช้ Modal จากระบบอื่น - การส่งข้อมูลสิทธิกลับไปยังระบบหลัก - การซิงค์ข้อมูลผู้ป่วยแบบ Real-time

API-04: Modal Integration API

// เรียกใช้ Modal จากระบบอื่น
window.openRightsModal(patientHN, callbackFunction);

// รับข้อมูลสิทธิที่เลือก
function callbackFunction(selectedRights) {
  // ใช้ข้อมูลสิทธิในระบบหลัก
}

API-05: Integration กับระบบ HIS ต่างๆ

ตาม TOR ฉบับเต็ม ระบบที่ต้องเชื่อมโยง:
- 1.2.1 ระบบเวชระเบียน: การเลือกสิทธิในการส่งตรวจ
- 1.2.2 ระบบซักประวัติ: การตรวจสอบสิทธิก่อนตรวจรักษา
- 1.2.3 ระบบห้องตรวจแพทย์: การแสดงสิทธิในการรักษา
- 1.2.4 ระบบห้องฉุกเฉิน: การตรวจสอบสิทธิฉุกเฉิน
- 1.2.5 ระบบทันตกรรม: การแสดงสิทธิการรักษาทางทันตกรรม
- และระบบอื่นๆ ทั้งหมด 24 ระบบ

3.2 ฟังก์ชันระบบ

3.2.1 การจัดการข้อมูลพื้นฐาน (FR-01)

FR-01.1: การกำหนดประเภทสิทธิ

Input: ข้อมูลประเภทสิทธิ (รหัส, ชื่อ, คำอธิบาย)
Process: บันทึกข้อมูลประเภทสิทธิลงฐานข้อมูล
Output: ยืนยันการบันทึกข้อมูล

FR-01.2: การกำหนดประเภทการชำระเงิน - กำหนดวิธีการชำระเงินสำหรับแต่ละสิทธิ - เชื่อมโยงกับระบบการเงิน

FR-01.3: การกำหนดผังการคิดค่าบริการ - กำหนดสูตรการคำนวณค่าบริการ - กำหนดส่วนลดตามประเภทสิทธิ

3.2.2 การตรวจสอบสิทธิ (FR-02)

FR-02.1: การค้นหาผู้ป่วย

Input: HN หรือ ชื่อ-สกุล หรือ เลขบัตรประชาชน
Process: 
  1. ค้นหาในฐานข้อมูลภายใน
  2. หากไม่พบ ค้นหาจากระบบภายนอก
  3. แสดงผลรายการที่ตรงกัน
Output: รายการผู้ป่วยที่พบ

FR-02.2: การแสดงข้อมูลสิทธิ

แสดงข้อมูลครบถ้วนตาม TOR:
- HN
- ชื่อ-นามสกุล
- อายุ, เพศ
- เลขบัตรประชาชน
- หมายเลขเอกสารแสดงสิทธิอื่นๆ (เลขบัตรทอง, บัตรประกันสังคม)
- เลขที่บัตรสิทธิ
- วันที่เริ่มต้น-สิ้นสุดสิทธิ
- สถานพยาบาลหลัก/รอง
- วันที่และเวลาที่ผู้ป่วยมารับบริการ
- แผนกที่รับการตรวจรักษา
- สถานะสิทธิ

FR-02.3: การยืนยันการใช้สิทธิ

Input: การยืนยันการใช้สิทธิจากผู้ใช้
Process: 
  1. บันทึกการยืนยันลงฐานข้อมูล
  2. สร้างใบยืนยันสิทธิ
  3. ส่งข้อมูลไปยังระบบที่เกี่ยวข้อง
Output: ใบยืนยันสิทธิ

3.2.3 การจัดการสิทธิผู้ป่วย (FR-03)

FR-03.1: การบันทึกสิทธิใหม่ - ระบบต้องสามารถบันทึกสิทธิใหม่ให้ผู้ป่วยได้ - ตรวจสอบความถูกต้องของข้อมูล - เชื่อมโยงกับข้อมูลผู้ป่วยในระบบ

FR-03.2: การแก้ไขข้อมูลสิทธิ - อนุญาตให้แก้ไขข้อมูลสิทธิที่จำเป็น - บันทึก log การแก้ไข - ต้องมีการอนุมัติสำหรับการแก้ไขที่สำคัญ

FR-03.3: การกำหนดข้อมูลเฉพาะของสิทธิ

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

FR-03.4: การกำหนดประเภทการออกใบเสร็จรับเงิน - กำหนดรูปแบบใบเสร็จตามประเภทสิทธิ - เชื่อมโยงกับระบบการเงิน - กำหนดผังการคิดค่าบริการ

FR-03.5: การกำหนดส่วนลดในค่าใช้จ่าย

สามารถกำหนดส่วนลดตามหมวดค่าใช้จ่าย:
- ค่าตรวจรักษา
- ค่ายา
- ค่าตรวจทางห้องปฏิบัติการ
- ค่าตรวจเอกซเรย์
- ค่าหัตถการ
- ค่าบริการอื่นๆ

3.2.4 การทำงานแบบ Modal/Pop-up (FR-04)

FR-04.1: การเรียกใช้จากระบบอื่น

Input: HN ผู้ป่วยจากระบบหลัก (เวชระเบียน, ซักประวัติ, ห้องตรวจ)
Process: 
  1. เปิดหน้าต่าง Modal แสดงสิทธิทั้งหมด
  2. ตรวจสอบสถานะสิทธิแบบ Real-time
  3. แสดงข้อมูลส่วนลดและข้อจำกัด
Output: Modal พร้อมรายการสิทธิที่ใช้งานได้

FR-04.2: การเลือกใช้สิทธิ

Input: การเลือกสิทธิจาก Modal
Process: 
  1. ส่งข้อมูลสิทธิที่เลือกกลับไปยังระบบหลัก
  2. บันทึก Log การใช้สิทธิ
  3. ปิด Modal
Output: ข้อมูลสิทธิสำหรับใช้ในการส่งตรวจ

FR-04.3: การแก้ไขข้อมูลแบบ Quick Edit

Input: คำขอแก้ไขข้อมูลสิทธิจาก Modal
Process: 
  1. เปิดฟอร์มแก้ไขแบบย่อ
  2. ตรวจสอบสิทธิ์การแก้ไข
  3. บันทึกการเปลี่ยนแปลง
Output: ข้อมูลสิทธิที่ถูกแก้ไขแล้ว

3.2.6 การจัดการข้อผิดพลาดและ Offline Mode (FR-06)

FR-06.1: Error Handling การจัดการข้อผิดพลาด

Input: ข้อผิดพลาดจากระบบภายนอก
Process: 
  1. ตรวจสอบประเภทข้อผิดพลาด
  2. แสดงข้อความและแนะนำการแก้ไข
  3. บันทึก Error Log เพื่อการติดตาม
Output: ข้อความและแนะนำการแก้ไข

Error Types ที่จัดการ:
- Network Timeout: ใช้ Cached Data หรือ Manual Mode
- Authentication Error: ต่ออายุ Token/Certificate อัตโนมัติ
- Data Not Found: ใช้ข้อมูลในระบบภายใน
- Server Error: Retry ตามกำหนด แล้วใช้ Fallback

FR-06.2: Offline Mode โหมดการทำงานแบบ Offline

Input: ระบบภายนอกไม่สามารถเชื่อมต่อได้
Process: 
  1. ตรวจสอบ Cached Data ใน 24 ชั่วโมงที่ผ่านมา
  2. แสดงข้อมูลที่มีพร้อมคำเตือน "Offline Mode"
  3. อนุญาตให้ใช้สิทธิได้ แต่ต้องมีการ Manual Verify ภายหลัง
Output: ข้อมูลสิทธิที่มีพร้อมสถานะ "Pending Verification"

Cached Data Strategy:
- เก็บข้อมูลการตรวจสอบล่าสุดไว้ 24 ชั่วโมง
- อัพเดททุก 2 ชั่วโมงเมื่อเชื่อมต่อได้อีกครั้ง
- ลบข้อมูลเก่ากว่า 7 วันอัตโนมัติ

FR-06.3: Fallback Mechanism กลไกการทำงานสำรอง

Priority Order การตรวจสอบสิทธิ:
1. Real-time API Call (สปสช./สนย./กรมบัญชีกลาง)
2. Cached Data (24 hours)
3. Manual Verification Mode
4. Allow with "Pending Verification" Status

Auto Recovery:
- ตรวจสอบการเชื่อมต่อทุก 30 วินาที
- อัพเดทข้อมูล Pending Verification อัตโนมัติ
- ส่งแจ้งเตือนให้เจ้าหน้าที่ตรวจสอบสิทธิ

FR-06.4: Performance Monitoring การติดตามประสิทธิภาพ

Monitoring Metrics:
- API Response Time (เป้าหมาย: < 3 วินาที)
- Success Rate (เป้าหมาย: > 95%)
- Error Rate by Type
- Cache Hit Rate
- Offline Mode Usage

Alerts:
- API Response Time > 5 วินาที
- Error Rate > 10%
- ระบบภายนอกล่มเกิน 5 นาที
- Cached Data เก่ากว่า 12 ชั่วโมง

3.2.7 การจัดการข้อมูลและความปลอดภัย (FR-07)

FR-07.1: Data Validation การตรวจสอบข้อมูล

Validation Rules:
- เลขบัตรประชาชน: 13 หลัก, ตรวจสอบ Checksum
- วันที่สิทธิ: ต้องไม่เป็นอดีต
- เลขที่สิทธิ: Format ตามแต่ละประเภทสิทธิ
- รหัสโรงพยาบาล: 5 หลัก, ตรวจสอบใน Master List

FR-07.2: Security & PDPA Compliance

Security Measures:
- เข้ารหัสข้อมูลส่วนบุคคล (AES-256)
- การสื่อสารแบบปลอดภัย (TLS 1.3)
- Access Control ตาม Role-based
- Audit Trail การเข้าถึงข้อมูล

PDPA Compliance:
- ขอความยินยอมก่อนเข้าถึงข้อมูลสิทธิ
- จำกัดการเข้าถึงเฉพาะเจ้าหน้าที่
- สิทธิลบข้อมูลตามคำขอ
- แจ้งการล่วงล้ำข้อมูลส่วนบุคคล

FR-05.1: การเชื่อมโยงกับระบบเวชระเบียน

ตามที่ระบุใน TOR ฉบับเต็ม ข้อ 1.2.1.2 การบันทึกส่งตรวจผู้ป่วย:
- สามารถเลือกสิทธิการรักษาของผู้ป่วยได้จากสิทธิประจำตัว
- สามารถใช้สิทธิการรักษาได้มากกว่า 1 สิทธิในการบันทึกส่งตรวจ

FR-05.2: การเชื่อมโยงกับระบบการเงิน (1.2.14)

Integration กับระบบการเงินผ่าน API:
- ส่งข้อมูลประเภทสิทธิและส่วนลด
- รับข้อมูลการคำนวณค่าบริการ
- ตรวจสอบสถานะการชำระเงิน
- การออกใบเสร็จตามประเภทสิทธิ

FR-05.3: การเชื่อมโยงกับระบบอื่นๆ ทั้ง 24 ระบบ

ระบบที่ต้องเชื่อมโยงตาม TOR:
- ระบบซักประวัติ (1.2.2)      - ระบบห้องตรวจแพทย์ (1.2.3)
- ระบบห้องฉุกเฉิน (1.2.4)     - ระบบทันตกรรม (1.2.5)
- ระบบคลินิกพิเศษ (1.2.9)     - ระบบผู้ป่วยใน (1.2.17)
- ระบบแพทย์แผนไทย (1.2.10)   - และระบบอื่นๆ ตาม TOR ฉบับเต็ม

วิธีการเชื่อมโยง:
- Modal Component Integration
- API Callback Functions
- Real-time Data Synchronization

FR-05.4: การรองรับ Multi-Rights Selection

Input: การเลือกสิทธิหลายสิทธิพร้อมกัน
Process: 
  1. แสดงรายการสิทธิที่เลือกได้
  2. ตรวจสอบความขัดแย้งของสิทธิ
  3. คำนวณส่วนลดและ Co-payment รวม
Output: ข้อมูลสิทธิหลายรายการพร้อมใช้งาน

---

4. ส่วนติดต่อภายนอก

4.1 ส่วนติดต่อผู้ใช้

4.1.1 ข้อกำหนดส่วนติดต่อผู้ใช้ทั่วไป

• ใช้ภาษาไทยเป็นหลัก
• สนับสนุนการใช้งานผ่าน Web Browser
• ออกแบบให้ใช้งานง่าย (User-friendly)
• มีระบบช่วยเหลือ (Help System)

4.1.2 โครงร่างหน้าจอ

A. Modal Pop-up Interface (เรียกจากระบบอื่น):

┌────────────────────────────────────────────────────────────┐
│                 ระบบตรวจสอบสิทธิ - Modal                  │
├────────────────────────────────────────────────────────────┤
│ ข้อมูลผู้ป่วย: HN: 123456 | นายสมชาย ใจดี | อายุ 45 ปี     │
├────────────────────────────────────────────────────────────┤
│                        สิทธิที่มี                          │
│ ✓ หลักประกันสุขภาพถ้วนหน้า UC-12345      [ใช้งานได้]      │
│ ✓ ประกันสังคม SSS-67890                   [ใช้งานได้]      │
│ ✗ ประกันภัยรถยนต์                         [หมดอายุ]        │
│ ? กรมบัญชีกลาง                           [กำลังตรวจสอบ]   │
├────────────────────────────────────────────────────────────┤
│                    สิทธิที่เลือก                           │
│ ประเภท: หลักประกันสุขภาพถ้วนหน้า                          │
│ ส่วนลด: 100% | Co-payment: 30 บาท                        │
│ โรงพยาบาลหลัก: รพ.ค่ายธนรัชน์                             │
├────────────────────────────────────────────────────────────┤
│        [ใช้สิทธินี้]  [แก้ไขสิทธิ]  [ยกเลิก]              │
└────────────────────────────────────────────────────────────┘

B. Standalone Management Interface (สำหรับเจ้าหน้าที่ตรวจสอบสิทธิ):

┌────────────────────────────────────────────────────────────┐
│              ระบบจัดการสิทธิการรักษาพยาบาล                │
├────────────────────────────────────────────────────────────┤
│ หน้าแรก │ ค้นหาผู้ป่วย │ จัดการสิทธิ │ รายงาน │ ตั้งค่า    │
├────────────────────────────────────────────────────────────┤
│                       ค้นหาผู้ป่วย                        │
│ ค้นหาด้วย: [HN] [ชื่อ-สกุล] [เลขบัตรประชาชน]             │
│ ┌─────────────────────────────────────┐ [ค้นหา]            │
│ │                                     │                    │
│ └─────────────────────────────────────┘                    │
├────────────────────────────────────────────────────────────┤
│                   ผลการค้นหา                              │
│ HN      │ ชื่อ-สกุล           │ อายุ │ สิทธิหลัก           │
│ 123456  │ นายสมชาย ใจดี      │ 45   │ UC                   │
│ 123457  │ นางสมหญิง ใจดี     │ 42   │ SSS                  │
├────────────────────────────────────────────────────────────┤
│                     จัดการสิทธิ                           │
│ ผู้ป่วยที่เลือก: นายสมชาย ใจดี (HN: 123456)               │
│                                                            │
│ สิทธิปัจจุบัน:                                             │
│ - หลักประกันสุขภาพถ้วนหน้า (UC-12345) [ใช้งานได้]         │
│ - ประกันสังคม (SSS-67890) [ใช้งานได้]                     │
│                                                            │
│ [เพิ่มสิทธิ] [แก้ไข] [ตรวจสอบออนไลน์] [ประวัติ]           │
├────────────────────────────────────────────────────────────┤
│     [บันทึก] [พิมพ์ใบยืนยัน] [ส่งข้อมูลไประบบอื่น]        │
└────────────────────────────────────────────────────────────┘

4.2 ส่วนติดต่อฮาร์ดแวร์

• เครื่องอ่านบัตร: รองรับมาตรฐาน ISO 7816
• เครื่องพิมพ์: รองรับการพิมพ์ A4 และ thermal printer
• เซิร์ฟเวอร์: Windows Server 2019 หรือใหม่กว่า

4.3 ส่วนติดต่อซอฟต์แวร์

4.3.1 ระบบฐานข้อมูล

• DBMS: Microsoft SQL Server 2019 หรือใหม่กว่า
• การเชื่อมต่อ: ADO.NET หรือ Entity Framework
• การสำรองข้อมูล: ทุกวันเวลา 02:00 น.

4.3.2 Web Services

เชื่อมต่อ สปสช.

<soap:Envelope>
  <soap:Body>
    <VerifyUCRight>
      <CitizenID>1234567890123</CitizenID>
      <HospitalCode>12345</HospitalCode>
    </VerifyUCRight>
  </soap:Body>
</soap:Envelope>

เชื่อมต่อ สนย.

<soap:Envelope>
  <soap:Body>
    <VerifySSRight>
      <CitizenID>1234567890123</CitizenID>
      <EmployerCode>67890</EmployerCode>
    </VerifySSRight>
  </soap:Body>
</soap:Envelope>

---

5. คุณลักษณะของระบบ

5.1 การจัดการข้อมูลสิทธิ

5.1.1 คำอธิบาย

ระบบต้องสามารถจัดการข้อมูลสิทธิการรักษาพยาบาลได้ครบถ้วน รวมถึงการเชื่อมโยงกับระบบภายนอก

5.1.2 ลำดับความสำคัญ

สูง

5.1.3 ฟังก์ชันที่ต้องการ

Input: - ข้อมูลประเภทสิทธิ - ข้อมูลผู้ป่วย - ข้อมูลสิทธิจากระบบภายนอก

Processing: - ตรวจสอบความถูกต้องของข้อมูล - เชื่อมโยงข้อมูลกับฐานข้อมูลผู้ป่วย - อัพเดทสถานะสิทธิ

Output: - ข้อมูลสิทธิที่สมบูรณ์ - รายงานสถานะการอัพเดท

5.2 การตรวจสอบสิทธิ

5.2.1 คำอธิบาย

ระบบต้องสามารถตรวจสอบสิทธิการรักษาของผู้ป่วยได้อย่างรวดเร็วและแม่นยำ

5.2.2 ข้อกำหนดการทำงาน

1. Real-time Verification
2. ตรวจสอบสิทธิแบบ real-time กับระบบภายนอก

3. cache ข้อมูลเพื่อลดเวลาในการตรวจสอบครั้งต่อไป

4. Multi-criteria Search

5. ค้นหาด้วยหลายเกณฑ์พร้อมกัน

6. แสดงผลแบบ fuzzy matching

7. Validation Rules

8. ตรวจสอบความถูกต้องของวันที่
9. ตรวจสอบ coverage ของสิทธิ

---

6. ข้อกำหนดที่ไม่ใช่ฟังก์ชัน

6.1 ข้อกำหนดด้านประสิทธิภาพ

6.1.1 เวลาตอบสนอง

การทำงาน	เวลาตอบสนองที่ต้องการ	เงื่อนไข
ค้นหาผู้ป่วย	< 2 วินาที	ในฐานข้อมูลภายใน
ตรวจสอบสิทธิออนไลน์	< 5 วินาที	เชื่อมต่อระบบภายนอก
พิมพ์ใบยืนยันสิทธิ	< 10 วินาที	รวมเวลาประมวลผล

6.1.2 Throughput

• รองรับการตรวจสอบสิทธิ 100 รายต่อชั่วโมง
• รองรับผู้ใช้พร้อมกัน 50 คน

6.1.3 ความจุของระบบ

• เก็บข้อมูลสิทธิได้อย่างน้อย 100,000 ราย
• เก็บ log การใช้งานได้ 2 ปี

6.2 ข้อกำหนดด้านความปลอดภัย

6.2.1 การยืนตัวตน

• ผู้ใช้ต้องมี username และ password
• รองรับ role-based access control
• session timeout 30 นาที

6.2.2 การควบคุมการเข้าถึง

Role	สิทธิการเข้าถึง
Admin	ทุกฟังก์ชัน
Officer	ตรวจสอบสิทธิ, บันทึกข้อมูล
Viewer	ดูข้อมูลอย่างเดียว

6.2.3 การเข้ารหัสข้อมูล

• ข้อมูลสำคัญต้องเข้ารหัส (AES-256)
• การส่งข้อมูลผ่าน HTTPS/SSL
• backup ข้อมูลต้องเข้ารหัส

6.3 ข้อกำหนดด้านความเชื่อถือได้

6.3.1 Availability

• ระบบต้องพร้อมใช้งาน 99.5% ของเวลา
• downtime สำหรับ maintenance ไม่เกิน 4 ชั่วโมงต่อเดือน

6.3.2 Recovery

• RTO (Recovery Time Objective): 2 ชั่วโมง
• RPO (Recovery Point Objective): 1 ชั่วโมง

6.4 ข้อกำหนดด้านการใช้งาน

6.4.1 ความง่ายในการใช้งาน

• ผู้ใช้ใหม่สามารถเรียนรู้การใช้งานพื้นฐานได้ใน 2 ชั่วโมง
• มี online help และ user manual

6.4.2 การสนับสนุนภาษา

• รองรับภาษาไทยและอังกฤษ
• สามารถสลับภาษาได้

---

7. ข้อกำหนดอื่นๆ

7.1 ข้อกำหนดด้านกฎหมาย

7.1.1 พระราชบัญญัติคุ้มครองข้อมูลส่วนบุคคล

• ต้องมีการ consent ในการเก็บข้อมูล
• สิทธิในการลบข้อมูลส่วนบุคคล
• การแจ้งเตือนกรณีข้อมูลรั่วไหล

7.1.2 กฎหมายด้านการแพทย์

• เป็นไปตามมาตรฐานการเก็บเวชระเบียน
• การรักษาความลับของผู้ป่วย

7.2 ข้อกำหนดด้านเทคนิค

7.2.1 Platform

• Operating System: Windows Server 2019+
• Web Server: IIS 10+
• Database: SQL Server 2019+
• Framework: .NET 6.0+

7.2.2 Browser Support

Browser	Version
Chrome	90+
Firefox	85+
Edge	90+
Safari	14+

7.3 ข้อกำหนดด้านการบำรุงรักษา

7.3.1 การอัพเดท

• รองรับการอัพเดทแบบ hot-swap
• มีระบบ rollback กรณีอัพเดทไม่สำเร็จ

7.3.2 การ Monitor

• ระบบ monitoring สำหรับติดตามประสิทธิภาพ
• alert เมื่อเกิดปัญหา
• log การใช้งานสำหรับการวิเคราะห์

---

8. ภาคผนวก

รายละเอียดในส่วนภาคผนวกได้ถูกแยกออกมาเป็นไฟล์เอกสารต่างหาก เพื่อความสะดวกในการอ่านและจัดการเอกสารตามผู้รับผิดชอบ

📄 ดูรายละเอียดเอกสารแต่ละส่วนได้ที่: - Database Schema: Schema ระบบตรวจสอบสิทธิ.md - สำหรับทีม Database และ Developer - Print Output Forms: Paper_Output.md - สำหรับทีม Business Analyst และ UI/UX Designer
- Test Cases: TestCases.md - สำหรับทีม QA และ Tester

ภาคผนวกประกอบด้วย: - 8.1 แบบฟอร์ม Print Output (ใบยืนยันสิทธิการรักษาพยาบาล, เอกสารการอนุมัติ) → Paper_Output.md - 8.2 Database Schema Design (ตารางหลัก, ตารางรองรับ, ความสัมพันธ์, Index และ Constraints) → Schema ระบบตรวจสอบสิทธิ.md - 8.3 รายการ Test Cases → TestCases.md - 8.4 Glossary (คำศัพท์และความหมาย) → ดูด้านล่าง - 8.5 การอนุมัติเอกสาร → Paper_Output.md

8.4 Glossary

คำศัพท์	ความหมาย
CID	Citizen ID - เลขบัตรประจำตัวประชาชน
Coverage	ขอบเขตการคุ้มครองของสิทธิ
Co-payment	ค่าใช้จ่ายส่วนที่ผู้ป่วยต้องจ่ายเอง
Eligibility	คุณสมบัติในการใช้สิทธิ
Provider	ผู้ให้บริการรักษาพยาบาล
HN	Hospital Number - หมายเลขประจำตัวผู้ป่วยในโรงพยาบาล
UC	Universal Coverage - สิทธิหลักประกันสุขภาพถ้วนหน้า
SSS	Social Security Scheme - สิทธิประกันสังคม
สปสช.	สำนักงานหลักประกันสุขภาพแห่งชาติ (NHSO)
สนย.	สำนักงานประกันสังคม (SSO)
Audit Trail	ร่องรอยการตรวจสอบ - บันทึกการแก้ไขข้อมูลเพื่อการตรวจสอบ
Real-time	เวลาจริง - การประมวลผลข้อมูลทันทีที่ได้รับ
API	Application Programming Interface - ส่วนติดต่อโปรแกรมประยุกต์
Timeout	หมดเวลา - การหยุดการรอรับข้อมูลเมื่อเกินเวลาที่กำหนด
Hot-swap	การเปลี่ยนแปลงระบบโดยไม่ต้องหยุดการทำงาน
Rollback	การย้อนกลับไปสู่สถานะเดิมเมื่อเกิดข้อผิดพลาด

---

เอกสารนี้จัดทำขึ้นเพื่อใช้ในการพัฒนาระบบตรวจสอบสิทธิสำหรับโรงพยาบาลค่ายธนรัชน์ และต้องได้รับการอนุมัติจากผู้มีอำนาจก่อนนำไปใช้ในการพัฒนาระบบ