Porawit/gravity
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit

Browse Source
This commit is contained in:
Porawit Dongwang
2026-09-16 23:20:08 +07:00
commit 0041668dbb
32577 changed files with 3687927 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
บริหารจัดการคิวนวดแผนไทย/docs/01_System_Analysis.md
+158
View File
@@ -0,0 +1,158 @@
# 01. System Analysis & Business Process Architecture
**Project:** Thai Traditional Massage Queue Management System (TTMQMS Enterprise)
**Version:** 1.0.0 Enterprise Production
**Author:** Antigravity AI Engineering Team
---
## 1. Executive Summary & Problem Statement
โรงพยาบาลและศูนย์การแพทย์แผนไทยหลายแห่งต้องเผชิญกับปัญหาการบริหารจัดการคิวผู้รับบริการที่ขาดประสิทธิภาพ เช่น ปัญหาความแออัดในห้องรอคอย การกระจายภาระงานหมอนวดที่ไม่เป็นธรรม (Therapist Workload Imbalance) การเก็บข้อมูลเวชระเบียนบนกระดาษที่เสี่ยงต่อการสูญหาย และขาดการเชื่อมต่อข้อมูลกับระบบข้อมูลโรงพยาบาลหลัก (HIS เช่น HOSxP, JHCIS)
**TTMQMS Enterprise** ได้ถูกออกแบบและพัฒนาขึ้นเพื่อยกระดับการให้บริการนวดแผนไทยสู่มาตรฐานสากลด้วยเทคโนโลยี AI Smart Queue Allocator, เวชระเบียนอิเล็กทรอนิกส์มาตรฐาน SOAP Note พร้อมการบันทึกลายมือชื่อดิจิทัล (Digital Signature), การสแกนชำระเงินผ่าน Thai QR PromptPay EMVCo และการเชื่อมต่อข้อมูลสุขภาพด้วยมาตรฐาน HL7 FHIR R4
---
## 2. System Context Diagram (Level 0 DFD)
แผนภาพบริบทแสดงการปฏิสัมพันธ์ระหว่างระบบ TTMQMS กับผู้ใช้งานกลุ่มต่างๆ และระบบภายนอก (External Entities)
```mermaid
graph TD
subgraph Users [ผู้ใช้งานระบบภายใน]
P[ผู้ป่วย / ผู้รับบริการ<br/>Patients]
R[พนักงานต้อนรับ<br/>Receptionists]
T[แพทย์แผนไทย / หมอนวด<br/>Therapists]
C[แคชเชียร์ / การเงิน<br/>Cashiers]
A[ผู้บริหาร / ผู้ดูแลระบบ<br/>Admins]
end
subgraph External_Systems [ระบบภายนอกองค์กร]
HIS[โรงพยาบาล HIS<br/>HOSxP / JHCIS]
FHIR[กระทรวงสาธารณสุข<br/>MOPH FHIR Server]
BANK[ระบบธนาคาร<br/>PromptPay EMVCo Gateway]
HW[ฮาร์ดแวร์<br/>Smart Card / ESC POS Printer]
end
SYS((TTMQMS Enterprise<br/>Queue & EMR System))
P -->|Walk-in / แสดงบัตรประชาชน| R
R -->|1. ลงทะเบียน & ออกคิว| SYS
SYS -->|2. สั่งพิมพ์ใบคิว 80mm| HW
HW -->|อ่านข้อมูล CID PCSC| SYS
SYS <-->|3. ซิงค์ HN / ข้อมูลผู้ป่วย| HIS
SYS -->|4. แจ้งเตือนเรียกคิว TV| P
T -->|5. บันทึก SOAP Note & VAS| SYS
SYS <-->|6. แลกเปลี่ยน Encounter FHIR R4| FHIR
C -->|7. คิดค่าบริการ & สร้าง QR| SYS
SYS <-->|8. ตรวจสอบสถานะชำระเงิน| BANK
A -->|9. ดูรายงาน KPI & ตั้งค่า SLA| SYS
```
---
## 3. Data Flow Diagram (DFD Level 1)
แผนภาพกระแสข้อมูลระดับ 1 แสดงการไหลของข้อมูลระหว่าง 5 กระบวนการหลัก (Core Processes) และคลังข้อมูล (Data Stores)
```mermaid
graph LR
subgraph Data_Stores [ฐานข้อมูล MySQL 8 / Redis]
D1[(D1: Patients & EMR)]
D2[(D2: Queues & AI Logs)]
D3[(D3: SOAP Notes & Clinical)]
D4[(D4: Billing & Receipts)]
D5[(D5: Users & Security Logs)]
end
IN1[Reception / Smart Card] --> P1(1.0 Registration & Walk-in Queue)
P1 <--> D1
P1 -->|บันทึกคิว| D2
D2 --> P2(2.0 AI Smart Queue Allocator)
P2 -->|คำนวณ Workload & SLA| D2
P2 -->|แสดงผล| OUT1[Smart TV Display / Sound]
D1 --> P3(3.0 Clinical Assessment & SOAP)
D2 --> P3
P3 <--> D3
P3 -->|Sync FHIR R4| OUT2[HOSxP / MOPH FHIR Server]
D2 --> P4(4.0 POS Checkout & Billing)
D3 --> P4
P4 <--> D4
P4 -->|พิมพ์ใบเสร็จ| OUT3[ESC/POS Thermal Printer]
D1 --> P5(5.0 Executive BI Analytics)
D2 --> P5
D3 --> P5
D4 --> P5
P5 -->|รายงาน KPI| OUT4[Executive Dashboards]
```
---
## 4. Business Process Flowchart (ทุก Module)
### 4.1 Module 1: Patient Registration & Walk-in Queue
```mermaid
flowchart TD
Start([ผู้รับบริการ Walk-in]) --> Card{ใช้บัตรประชาชน<br/>Smart Card?}
Card -->|ใช่| Read[ระบบอ่านข้อมูลจากบัตรผ่าน WebUSB/PCSC]
Card -->|ไม่| Manual[พิมพ์ค้นหา HN หรือเลขบัตร 13 หลัก]
Read --> ChkHN{มีข้อมูลในระบบ/HIS?}
Manual --> ChkHN
ChkHN -->|ไม่มี| Reg[ขึ้นทะเบียนผู้ป่วยใหม่ & ซิงค์ HIS]
ChkHN -->|มี| SelSvc[เลือกบริการนวดแผนไทยและระดับความสำคัญ]
Reg --> SelSvc
SelSvc --> AICalc[เรียกใช้งาน Smart Queue Engine Sp]
AICalc --> Assign[AI จัดสรรหมอนวดและห้องพักที่เหมาะสม]
Assign --> Print[ส่งคำสั่งพิมพ์ใบคิว ESC/POS Thermal Printer]
Print --> End([เสร็จสิ้นกระบวนการออกคิว])
```
### 4.2 Module 2: AI Smart Queue Allocation Logic (`sp_assign_smart_queue`)
```mermaid
flowchart TD
A([รับคำขอจัดสรรคิว: Service ID, Priority, Branch]) --> B[ดึงรายชื่อหมอนวดที่สถานะ พร้อมให้บริการ]
B --> C{ตรวจสอบชั่วโมงทำงานสะสม<br/>< Max Daily Mins?}
C -->|ไม่ผ่าน| D[ตัดชื่อหมอนวดที่เหนื่อยล้าเกินกำหนดออก] --> E[คำนวณคะแนน Workload Score]
C -->|ผ่าน| E
E --> F[ดึงรายชื่อห้องนวดสถานะ ว่างและประเภทตรงกับบริการ]
F --> G{มีหมอนวดและห้องว่างพร้อมกัน?}
G -->|มีทันที| H[จัดสรรคิวเป็น Assigned พร้อมจับคู่ห้องและหมอนวด]
G -->|ไม่มีห้อง/หมอว่าง| I[จัดสรรคิวเป็น Waiting พร้อมคำนวณเวลารอคอย Est. Wait Time]
H --> J([บันทึกลงฐานข้อมูลและส่ง Notification])
I --> J
```
### 4.3 Module 3: Clinical Assessment & SOAP Note Workflow
```mermaid
flowchart TD
S([หมอนวดเรียกผู้ป่วยเข้าห้องพัก]) --> O1[บันทึกสัญญาณชีพ BP/PR ก่อนนวด]
O1 --> O2[ประเมินระดับความปวด Pre-treatment VAS Score 0-10]
O2 --> O3[ตรวจวัดองศาการเคลื่อนไหว ROM Goniometer]
O3 --> O4[บันทึกข้อมูลอาการนำ S และการตรวจร่างกาย O]
O4 --> O5[วินิจฉัยโรคตามคัมภีร์เวชกรรมไทย A]
O5 --> O6[กำหนดแผนการรักษาและให้คำแนะนำ P]
O6 --> O7[ให้การรักษาหัตถการนวดแผนไทย / ประคบสมุนไพร]
O7 --> O8[ประเมินสัญญาณชีพและระดับความปวดหลังรักษา Post-VAS Score]
O8 --> O9[หมอนวดลงนามลายนิ้วมือดิจิทัล Digital Signature Pad]
O9 --> O10[ระบบส่ง Sync Encounter & Observation FHIR R4 เข้า HIS]
O10 --> E([เสร็จสิ้นการรักษา เปลี่ยนสถานะคิวเป็น Completed])
```
---
## 5. UI/UX Design System & Wireframes Architecture
การออกแบบหน้าจออ้างอิงหลักการ **Glassmorphism Healthcare UI** ที่มีความทันสมัย สบายตา และรองรับการใช้งานผ่านอุปกรณ์เคลื่อนที่ (PWA Mobile First) โดยมีโครงสร้างการจัดวางหน้าจอ (Wireframe Architecture) ดังนี้:
### 5.1 Responsive Master Layout (Desktop vs Mobile PWA)
- **Desktop / Tablet View (1024px+):** ด้านซ้ายเป็น Glassmorphism Sidebar แสดงเมนูระบบครบทั้ง 8 โมดูล พร้อมโลโก้และข้อมูลผู้ใช้งาน ด้านบนเป็น Top Navbar แสดงสถานะการเชื่อมต่อ Online/Offline และปุ่มเชื่อมต่อ USB Printer
- **Mobile PWA View (< 1024px):** ซ่อน Sidebar อัตโนมัติและเปลี่ยนเป็น **Mobile Bottom Navigation Bar** แสดง 5 ไอคอนหลัก (แดชบอร์ด, ออกคิว, SOAP Note, คิดเงิน, เมนู) เพื่อให้แพทย์และพนักงานสามารถกดใช้งานด้วยมือเดียวได้อย่างคล่องตัว
### 5.2 Glassmorphism Color Tokens & Typography
- **Primary Color:** Emerald 500 (`#10b981`) สื่อถึงความเป็นธรรมชาติ สมุนไพรไทย และความปลอดภัยทางการแพทย์
- **Secondary Color:** Cyan 500 (`#06b6d4`) สื่อถึงเทคโนโลยี ความสะอาด และความแม่นยำทางเวชกรรม
- **Accent Color:** Amber 500 (`#f59e0b`) ใช้สำหรับแจ้งเตือนระดับคิวรอคอยและยอดเงิน
- **Typography:** ฟอนต์สารบรรณ (Sarabun) สำหรับข้อความทางการแพทย์ และ Outfit สำหรับตัวเลข KPI และเวลา
---
*เอกสารนี้เป็นความลับและเป็นลิขสิทธิ์ของทีมพัฒนาระบบ TTMQMS Enterprise*
บริหารจัดการคิวนวดแผนไทย/docs/02_SRS_SDD.md
+176
View File
@@ -0,0 +1,176 @@
# 02. Software Requirement Specification (SRS) & System Design Document (SDD)
**Project:** Thai Traditional Massage Queue Management System (TTMQMS Enterprise)
**Standard:** IEEE 830-1998 & Enterprise Clean Architecture
**Version:** 1.0.0 Production
---
## Part 1: Software Requirement Specification (SRS)
### 1. Functional Requirements (FR)
| รหัสความต้องการ | โมดูล | รายละเอียดความต้องการทางฟังก์ชัน | ระดับความสำคัญ |
| :--- | :--- | :--- | :--- |
| **FR-AUTH-01** | Authentication | ระบบต้องรองรับการยืนยันตัวตนด้วยเลขบัตรประชาชน 13 หลัก และรหัสผ่านที่เข้ารหัสด้วย Argon2id | High |
| **FR-AUTH-02** | Security (2FA) | ระบบต้องบังคับใช้ 2-Factor Authentication (TOTP RFC 6238) สำหรับแพทย์ หมอนวด และ Admin | High |
| **FR-QUE-01** | Queue & AI | ระบบต้องจัดสรรหมอนวดและห้องพักอัตโนมัติด้วย AI (`sp_assign_smart_queue`) โดยคำนวณจาก Workload Balance | High |
| **FR-QUE-02** | Priority | ระบบต้องรองรับคิว 3 ระดับ (Normal, VIP, Emergency) และเร่งลำดับคิวอัตโนมัติเมื่อเกิน SLA | High |
| **FR-CLN-01** | SOAP Note | แพทย์/หมอนวดต้องสามารถบันทึกเวชระเบียน SOAP Note พร้อมระบุจุดปวดบนร่างกายและ ROM Goniometer | High |
| **FR-CLN-02** | Pain VAS | ระบบต้องมีแถบประเมินความปวด VAS Score (0-10) ทั้งก่อนและหลังการรักษา พร้อมเปรียบเทียบผล | Medium |
| **FR-CLN-03** | Digital Sign | ระบบต้องรองรับการบันทึกลายมือชื่อดิจิทัลผ่านหน้าจอสัมผัส (HTML5 Canvas) เพื่อป้องกันการปฏิเสธความรับผิดชอบ | High |
| **FR-POS-01** | Billing & QR | แคชเชียร์ต้องสามารถคำนวณค่าบริการ ส่วนลด VAT 7% และสร้าง Dynamic PromptPay QR Code มาตรฐาน EMVCo | High |
| **FR-POS-02** | Thermal Print| ระบบต้องสามารถส่งคำสั่งพิมพ์ใบเสร็จและใบคิวไปยังเครื่องพิมพ์ความร้อน ESC/POS ผ่าน WebUSB API | Medium |
| **FR-HIS-01** | HIS Interop | ระบบต้องสามารถเชื่อมต่อแลกเปลี่ยนข้อมูลผู้ป่วย HN และเวชระเบียนกับ HOSxP/JHCIS ผ่าน REST mTLS | High |
| **FR-HIS-02** | FHIR R4 | ระบบต้องสร้างและส่งข้อมูลสุขภาพในรูปแบบ HL7 FHIR R4 JSON Bundle (Encounter & Observation) | High |
---
### 2. Non-Functional Requirements (NFR)
- **NFR-PERF-01 (Performance & SLA):** ระยะเวลาในการตอบสนองคำขอ REST API (API Response Time) ต้องน้อยกว่า **200 มิลลิวินาที (ms)** ที่ภาระงานปกติ และกระบวนการคำนวณคิวด้วย AI ต้องใช้เวลาไม่เกิน **50 ms**
- **NFR-AVAIL-01 (Availability & Reliability):** ระบบต้องมีอัตราการพร้อมใช้งาน (Uptime Availability) ไม่น้อยกว่า **99.9%** (หยุดชะงักไม่เกิน 8.76 ชั่วโมง/ปี)
- **NFR-SEC-01 (Security & Compliance):** ระบบต้องผ่านเกณฑ์ความปลอดภัยตามมาตรฐาน **OWASP Top 10** และจัดเก็บข้อมูลสุขภาพโดยเป็นไปตามพระราชบัญญัติคุ้มครองข้อมูลส่วนบุคคล (PDPA) และเกณฑ์สากล HIPAA
- **NFR-PORT-01 (Portability & PWA):** หน้าจอผู้ใช้งานต้องเป็น Progressive Web App (PWA) ที่สามารถติดตั้งบนแท็บเล็ต พีซี และมือถือ (Mobile First Responsive) สามารถทำงานในโหมดออฟไลน์ (Offline Fallback) ได้ชั่วคราว
---
## Part 2: System Design Document (SDD)
### 3. Enterprise Layered Architecture
ระบบ TTMQMS ถูกออกแบบภายใต้หลักการ **Clean Architecture** และ **SOLID Principles** เพื่อแยกลำดับชั้นการทำงาน (Separation of Concerns) ทำให้บำรุงรักษาและขยายขนาดระบบได้ง่าย
```mermaid
graph TD
subgraph Presentation_Layer [Presentation Layer / PWA]
UI[Glassmorphism UI<br/>TailwindCSS / AlpineJS]
SW[Service Worker<br/>Offline Caching]
end
subgraph API_Gateway_Layer [API Gateway & Routing Layer]
FC[Front Controller<br/>index.php]
ROUTER[FastRoute Engine]
MID[Security Middleware<br/>JWT / 2FA / CSRF / RateLimit]
end
subgraph Domain_Service_Layer [Domain Business Logic Layer]
AI[SmartQueueEngine<br/>WorkloadBalancer]
CLN[SoapNoteService<br/>VasScoreAnalyzer]
BILL[PosBillingService<br/>PromptPayGenerator]
HIS[HisConnector<br/>FhirR4BundleBuilder]
end
subgraph Data_Access_Layer [Data Access & Storage Layer]
PDO[PDO MySQL Adapter<br/>Prepared Statements]
REDIS[Redis Cache Client<br/>Session & Token Storage]
DB[(MySQL 8 Database<br/>Stored Procedures)]
end
UI <-->|HTTPS / REST API JSON| FC
FC --> ROUTER --> MID --> Domain_Service_Layer
Domain_Service_Layer <--> PDO & REDIS
PDO <--> DB
```
---
### 4. Component Architecture Diagram
แผนภาพองค์ประกอบแสดงความสัมพันธ์ระหว่าง Controller, Service และ Helper ภายใน Backend Architecture
```mermaid
classDiagram
class FrontController {
+dispatch()
+handleException()
}
class JwtAuthMiddleware {
+handle(request)
-verifyArgon2id()
}
class QueueController {
+walkin(request)
+updateStatus(id)
}
class SmartQueueEngine {
+allocateQueue(patientId, serviceId, priority)
-calculateWorkloadScore()
}
class HisConnector {
+syncPatient(hn)
+sendFhirEncounter(soapData)
}
class EscPosPrinter {
+generateTicketBuffer(queueNo)
+generateReceiptBuffer(billData)
}
FrontController --> JwtAuthMiddleware
FrontController --> QueueController
QueueController --> SmartQueueEngine
QueueController --> EscPosPrinter
SmartQueueEngine --> HisConnector
```
---
### 5. Sequence Diagram: AI Smart Queue Allocation & SOAP Sync
แผนภาพลำดับเหตุการณ์แสดงการปฏิสัมพันธ์ตั้งแต่การออกคิว Walk-in จนถึงการซิงค์ข้อมูล FHIR R4 เข้าสู่ระบบ HIS
```mermaid
sequenceDiagram
autonumber
actor Rec as พนักงานต้อนรับ
participant PWA as หน้าจอ PWA / Queue Board
participant API as QueueController
participant AI as SmartQueueEngine
participant DB as MySQL 8 / Sp
participant HIS as HOSxP / FHIR Server
Rec->>PWA: กรอกข้อมูล/อ่าน Smart Card ผู้ป่วย Walk-in
PWA->>API: POST /api/v1/queues/walkin {patient_id, service_id, priority}
API->>AI: allocateQueue(patient_id, service_id, priority)
AI->>DB: CALL sp_assign_smart_queue(patient_id, service_id, priority)
Note over DB: ตรวจสอบหมอนวด (Workload < 480)<br/>และห้องว่าง (Status = Available)
DB-->>AI: คืนค่าคิวที่จัดสรร (Queue #A003, Assigned Room R-101, Therapist T-102)
AI-->>API: Result Allocated Queue Object
API-->>PWA: HTTP 200 OK (JSON Queue Data)
PWA->>Rec: แสดง Modal จัดสรรสำเร็จ & สั่งพิมพ์ใบคิว ESC/POS
Note over Rec, HIS: เมื่อเข้าสู่กระบวนการรักษาโดยหมอนวด
actor Ther as หมอนวดผู้ให้บริการ
Ther->>PWA: บันทึก SOAP Note, VAS Score (7->2) และเซ็นชื่อ
PWA->>API: POST /api/v1/clinical/soap {soap_data, signature_base64}
API->>DB: บันทึกเวชระเบียน SOAP และลายนิ้วมือดิจิทัล
API->>HIS: POST /fhir/r4/Bundle (Transaction: Encounter + Observation)
HIS-->>API: HTTP 201 Created (FHIR Resource ID)
API-->>PWA: HTTP 200 OK (Sync Success)
```
---
### 6. Deployment & Infrastructure Diagram
แผนภาพการติดตั้งระบบในสภาพแวดล้อมจริง (Production Environment) ด้วย Docker Containerization และ Nginx Reverse Proxy
```mermaid
graph TB
subgraph Hospital_Network [เครือข่ายภายในโรงพยาบาล / DMZ]
subgraph Docker_Host [Docker Server Container Host]
PROXY[Nginx Reverse Proxy<br/>SSL / TLS 1.3 Terminated]
APP[PHP 8.1-FPM Container<br/>TTMQMS Backend & PWA]
CACHE[(Redis Container<br/>In-Memory Cache)]
MYSQL[(MySQL 8.0 Container<br/>Master Database)]
end
subgraph HIS_Zone [Hospital Information System Zone]
HOSXP[(HOSxP / JHCIS<br/>Database Gateway)]
MOPH[MOPH FHIR Server<br/>HL7 R4 Gateway]
end
end
CLIENTS[PWA Clients<br/>PC / Tablet / Smart TV] -->|HTTPS Port 443| PROXY
PROXY -->|FastCGI Port 9000| APP
APP <-->|TCP Port 6379| CACHE
APP <-->|TCP Port 3306| MYSQL
APP <-->|REST / mTLS Port 8080| HOSXP
APP <-->|HTTPS FHIR R4| MOPH
```
---
*เอกสารนี้ได้รับการตรวจสอบและอนุมัติตามมาตรฐานวิศวกรรมซอฟต์แวร์ระดับองค์กร*
บริหารจัดการคิวนวดแผนไทย/docs/03_Database_Design.md
+220
View File
@@ -0,0 +1,220 @@
# 03. Database Design Architecture & Data Dictionary
**Project:** Thai Traditional Massage Queue Management System (TTMQMS Enterprise)
**Database Engine:** MySQL 8.0 / Percona Server (InnoDB Engine, utf8mb4_unicode_ci)
**Normalization:** 3rd Normal Form (3NF) Compliant
**Version:** 1.0.0 Production
---
## 1. Database Architecture & Design Principles
ฐานข้อมูลของระบบ TTMQMS ถูกออกแบบด้วยสถาปัตยกรรมเชิงสัมพันธ์ (Relational Database Architecture) ภายใต้มาตรฐานสากล โดยมีคุณสมบัติดังนี้:
1. **ACID Compliance & Transactional Integrity:** ทุกตารางใช้เครื่องยนต์ **InnoDB** รองรับ Foreign Key Constraints และ Atomic Transactions
2. **Unicode utf8mb4:** รองรับภาษาไทย ภาษาอังกฤษ ลายมือชื่อดิจิทัล (Base64/BLOB) และอิโมจิทางการแพทย์
3. **Optimized Indexing:** สร้าง Index บนคอลัมน์ที่สืบค้นบ่อย (เช่น `national_id`, `hn`, `status`, `created_at`, `branch_id`) เพื่อลดเวลา Execution Time ให้ต่ำกว่า 10ms
4. **Automated AI Allocation & Audit Logging:** ฝัง Logic การคำนวณคิวด้วย **Stored Procedure** (`sp_assign_smart_queue`) และมี **Triggers** เพื่ออัปเดตสถานะห้องและซิงค์ HIS อัตโนมัติ
---
## 2. Entity-Relationship Diagram (ERD Level 3)
แผนภาพความสัมพันธ์ระหว่างเอนทิตีทั้ง 13 ตารางหลักในระบบ TTMQMS
```mermaid
erDiagram
BRANCHES ||--o{ USERS : "has employees"
BRANCHES ||--o{ PATIENTS : "registers"
BRANCHES ||--o{ THERAPISTS : "employs"
BRANCHES ||--o{ ROOMS : "contains"
BRANCHES ||--o{ QUEUES : "manages"
USERS ||--o{ THERAPISTS : "links to profile"
USERS ||--o{ AUDIT_LOGS : "generates"
USERS ||--o{ API_TOKENS : "authenticates"
PATIENTS ||--o{ QUEUES : "requests"
PATIENTS ||--o{ SOAP_NOTES : "has clinical history"
PATIENTS ||--o{ BILLINGS : "pays bills"
THERAPISTS ||--o{ QUEUES : "assigned to"
THERAPISTS ||--o{ ROOMS : "stationed at"
THERAPISTS ||--o{ SOAP_NOTES : "records & signs"
THERAPISTS ||--o{ QUEUE_ALLOCATIONS : "evaluated in"
SERVICES ||--o{ QUEUES : "specified in"
ROOMS ||--o{ QUEUES : "hosts"
QUEUES ||--o| SOAP_NOTES : "results in"
QUEUES ||--o| BILLINGS : "generates invoice"
QUEUES ||--o{ QUEUE_ALLOCATIONS : "logged by AI"
```
---
## 3. Comprehensive Data Dictionary (พจนานุกรมข้อมูล 13 ตาราง)
### 3.1 ตาราง `branches` (สาขาของศูนย์การแพทย์)
| Column Name | Data Type | Constraints | Description |
| :--- | :--- | :--- | :--- |
| **id** | BIGINT UNSIGNED | PK, AUTO_INCREMENT | รหัสอ้างอิงสาขาหลัก |
| **name_th** | VARCHAR(150) | NOT NULL | ชื่อสาขาภาษาไทย (เช่น สาขาทองหล่อ) |
| **name_en** | VARCHAR(150) | NULL | ชื่อสาขาภาษาอังกฤษ |
| **address** | TEXT | NULL | ที่อยู่ตั้งสาขา |
| **phone** | VARCHAR(50) | NULL | เบอร์โทรศัพท์ติดต่อ |
| **is_active** | TINYINT(1) | DEFAULT 1 | สถานะเปิดใช้งาน (1=Active, 0=Inactive) |
### 3.2 ตาราง `users` (ผู้ใช้งานระบบ / เจ้าหน้าที่)
| Column Name | Data Type | Constraints | Description |
| :--- | :--- | :--- | :--- |
| **id** | BIGINT UNSIGNED | PK, AUTO_INCREMENT | รหัสอ้างอิงผู้ใช้งานระบบ |
| **branch_id** | BIGINT UNSIGNED | FK -> branches(id) | สังกัดสาขา |
| **national_id** | VARCHAR(13) | UNIQUE, NOT NULL | เลขประจำตัวประชาชน 13 หลัก (Username) |
| **password_hash** | VARCHAR(255) | NOT NULL | รหัสผ่านที่เข้ารหัสด้วย Argon2id |
| **full_name** | VARCHAR(150) | NOT NULL | ชื่อและนามสกุลเจ้าหน้าที่ |
| **role** | ENUM(...) | NOT NULL | บทบาท: Admin, Reception, Therapist, Cashier |
| **totp_secret** | VARCHAR(64) | NULL | รหัสลับสำหรับตรวจสอบ 2FA Google Authenticator |
| **is_2fa_enabled**| TINYINT(1) | DEFAULT 1 | สถานะบังคับใช้ 2FA (1=Enabled) |
### 3.3 ตาราง `patients` (ผู้ป่วยและผู้รับบริการ)
| Column Name | Data Type | Constraints | Description |
| :--- | :--- | :--- | :--- |
| **id** | BIGINT UNSIGNED | PK, AUTO_INCREMENT | รหัสอ้างอิงผู้ป่วยในระบบ |
| **branch_id** | BIGINT UNSIGNED | FK -> branches(id) | สาขาที่ลงทะเบียนครั้งแรก |
| **hn** | VARCHAR(50) | UNIQUE, NOT NULL | Hospital Number (เชื่อมโยงระบบ HIS) |
| **national_id** | VARCHAR(13) | UNIQUE, NOT NULL | เลขประจำตัวประชาชน 13 หลัก (จาก Smart Card) |
| **first_name_th** | VARCHAR(100) | NOT NULL | ชื่อจริงภาษาไทย |
| **last_name_th** | VARCHAR(100) | NOT NULL | นามสกุลภาษาไทย |
| **gender** | ENUM('Male','Female','Other') | NOT NULL | เพศสภาพ |
| **birth_date** | DATE | NULL | วันเดือนปีเกิด (คำนวณอายุอัตโนมัติ) |
| **phone** | VARCHAR(20) | NULL | เบอร์โทรศัพท์เคลื่อนที่ |
| **right_type** | VARCHAR(100) | DEFAULT 'UC' | สิทธิการรักษา (บัตรทอง, ข้าราชการ, ประกันสังคม, จ่ายเอง) |
| **contraindications**| TEXT | NULL | โรคประจำตัว / ข้อห้ามในการนวด (เช่น ความดันสูง, ตั้งครรภ์) |
### 3.4 ตาราง `therapists` (หมอนวดและแพทย์แผนไทย)
| Column Name | Data Type | Constraints | Description |
| :--- | :--- | :--- | :--- |
| **id** | BIGINT UNSIGNED | PK, AUTO_INCREMENT | รหัสอ้างอิงหมอนวด |
| **user_id** | BIGINT UNSIGNED | FK -> users(id), UNIQUE | รหัสบัญชีผู้เข้าใช้งานระบบ |
| **branch_id** | BIGINT UNSIGNED | FK -> branches(id) | ประจำสาขา |
| **license_no** | VARCHAR(50) | UNIQUE, NULL | เลขที่ใบประกอบวิชาชีพเวชกรรมไทย |
| **specialty** | VARCHAR(150) | NULL | ความเชี่ยวชาญพิเศษ (เช่น นวดราชสำนัก, แก้อาการ) |
| **status** | ENUM(...) | DEFAULT 'Available' | สถานะปัจจุบัน: Available, Busy, Off_Duty |
| **max_daily_minutes**| INT UNSIGNED | DEFAULT 480 | ชั่งโมงทำงานสูงสุดต่อวัน (นาที) เพื่อกันเหนื่อยล้า |
### 3.5 ตาราง `services` (บริการนวดและคอร์สการรักษา)
| Column Name | Data Type | Constraints | Description |
| :--- | :--- | :--- | :--- |
| **id** | BIGINT UNSIGNED | PK, AUTO_INCREMENT | รหัสบริการ |
| **code** | VARCHAR(50) | UNIQUE, NOT NULL | รหัสรหัสหัตถการ (ICD-10 TM Code Mapping) |
| **name_th** | VARCHAR(150) | NOT NULL | ชื่อบริการ (เช่น นวดแผนไทยราชสำนัก) |
| **duration_mins**| INT UNSIGNED | NOT NULL | ระยะเวลาให้บริการมาตรฐาน (นาที) |
| **price** | DECIMAL(10,2) | NOT NULL | อัตราค่าบริการ (บาท) |
| **required_room_type**| VARCHAR(50)| DEFAULT 'Standard' | ประเภทห้องที่ต้องการ: Standard, VIP Private, Foot Spa |
### 3.6 ตาราง `rooms` (ห้องนวดและเตียงบริการ)
| Column Name | Data Type | Constraints | Description |
| :--- | :--- | :--- | :--- |
| **id** | BIGINT UNSIGNED | PK, AUTO_INCREMENT | รหัสห้องนวด |
| **branch_id** | BIGINT UNSIGNED | FK -> branches(id) | สาขาที่ตั้ง |
| **room_no** | VARCHAR(50) | NOT NULL | หมายเลขห้อง / เตียง (เช่น R-101, Bed-05) |
| **name_th** | VARCHAR(100) | NOT NULL | ชื่อเรียกห้องนวด |
| **room_type** | VARCHAR(50) | NOT NULL | ประเภทห้อง: Standard Bed, VIP Private, Foot Spa, Aroma |
| **status** | ENUM(...) | DEFAULT 'Available' | สถานะ: Available, In_Use, Cleaning, Maintenance |
| **current_therapist_id**| BIGINT UNSIGNED| FK -> therapists(id), NULL| หมอนวดที่กำลังปฏิบัติงานในห้องนี้ |
### 3.7 ตาราง `queues` (การจัดสรรคิวบริการ)
| Column Name | Data Type | Constraints | Description |
| :--- | :--- | :--- | :--- |
| **id** | BIGINT UNSIGNED | PK, AUTO_INCREMENT | รหัสอ้างอิงรายการคิว |
| **branch_id** | BIGINT UNSIGNED | FK -> branches(id) | สาขาที่ออกคิว |
| **queue_no** | VARCHAR(20) | NOT NULL | หมายเลขบัตรคิว (เช่น A001, V001, E001) |
| **patient_id** | BIGINT UNSIGNED | FK -> patients(id) | ผู้รับบริการ |
| **service_id** | BIGINT UNSIGNED | FK -> services(id) | บริการที่เลือก |
| **assigned_therapist_id**| BIGINT UNSIGNED| FK -> therapists(id), NULL| หมอนวดที่ถูกจัดสรรโดย AI |
| **assigned_room_id**| BIGINT UNSIGNED| FK -> rooms(id), NULL | ห้องนวดที่ถูกจัดสรร |
| **priority** | ENUM(...) | DEFAULT 'Normal' | ระดับความสำคัญ: Normal, VIP, Emergency |
| **status** | ENUM(...) | DEFAULT 'Waiting' | สถานะ: Waiting, Assigned, In_Progress, Completed, Cancelled |
| **est_start_time**| DATETIME | NULL | เวลาเริ่มรับบริการโดยประมาณ (คำนวณโดย AI) |
| **actual_start_time**| DATETIME | NULL | เวลาเริ่มเข้าห้องนวดจริง |
| **completed_time**| DATETIME | NULL | เวลาสิ้นสุดการนวด |
### 3.8 ตาราง `queue_allocations` (ประวัติการคำนวณด้วย Smart Queue AI)
| Column Name | Data Type | Constraints | Description |
| :--- | :--- | :--- | :--- |
| **id** | BIGINT UNSIGNED | PK, AUTO_INCREMENT | รหัสบันทึกการจัดสรร |
| **queue_id** | BIGINT UNSIGNED | FK -> queues(id) | อ้างอิงรายการคิว |
| **therapist_id** | BIGINT UNSIGNED | FK -> therapists(id) | หมอนวดที่ถูกพิจารณา |
| **room_id** | BIGINT UNSIGNED | FK -> rooms(id) | ห้องพักที่จับคู่ |
| **workload_score**| DECIMAL(8,2) | NOT NULL | คะแนนความเหนื่อยล้าสะสมของหมอนวด (ยิ่งต่ำยิ่งได้สิทธิ์ก่อน) |
| **allocation_reason**| VARCHAR(255) | NOT NULL | คำอธิบายจาก AI (เช่น "จัดสรรให้หมอสมศรีเนื่องจากชั่วโมงว่างสูงสุด")|
| **created_at** | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP| เวลาที่ AI คำนวณเสร็จสิ้น |
### 3.9 ตาราง `soap_notes` (เวชระเบียนและการตรวจประเมินทางคลินิก)
| Column Name | Data Type | Constraints | Description |
| :--- | :--- | :--- | :--- |
| **id** | BIGINT UNSIGNED | PK, AUTO_INCREMENT | รหัสบันทึก SOAP Note |
| **queue_id** | BIGINT UNSIGNED | FK -> queues(id), UNIQUE| อ้างอิงการรับบริการในครั้งนั้น |
| **patient_id** | BIGINT UNSIGNED | FK -> patients(id) | อ้างอิงผู้ป่วย |
| **therapist_id** | BIGINT UNSIGNED | FK -> therapists(id) | แพทย์แผนไทย/หมอนวดผู้ประเมิน |
| **subjective** | TEXT | NOT NULL | S: อาการนำและประวัติการเจ็บป่วย (Chief Complaint) |
| **objective_vas_pre**| INT UNSIGNED| NOT NULL | O: ระดับความปวดก่อนรักษา VAS Score (0-10) |
| **objective_vas_post**| INT UNSIGNED| NOT NULL | O: ระดับความปวดหลังรักษา VAS Score (0-10) |
| **objective_rom** | JSON | NULL | O: องศาการเคลื่อนไหว (Flexion, Extension Goniometer) |
| **assessment** | TEXT | NOT NULL | A: การวินิจฉัยโรคตามคัมภีร์แพทย์แผนไทยและ ICD-10 TM |
| **plan_treatment**| TEXT | NOT NULL | P: หัตถการที่ให้และการพยาบาล (เช่น นวดราชสำนัก, ประคบ) |
| **signature_base64**| LONGTEXT | NOT NULL | ลายมือชื่อหมอนวดผู้ให้การรักษา (Base64 PNG Format) |
| **his_sync_status**| ENUM(...) | DEFAULT 'Pending' | สถานะซิงค์ HIS: Pending, Synced, Failed |
### 3.10 ตาราง `billings` (การคิดเงิน ออกใบเสร็จ และ PromptPay QR)
| Column Name | Data Type | Constraints | Description |
| :--- | :--- | :--- | :--- |
| **id** | BIGINT UNSIGNED | PK, AUTO_INCREMENT | รหัสบิล / ใบเสร็จรับเงิน |
| **queue_id** | BIGINT UNSIGNED | FK -> queues(id), UNIQUE| อ้างอิงคิวการให้บริการ |
| **patient_id** | BIGINT UNSIGNED | FK -> patients(id) | อ้างอิงผู้ชำระเงิน |
| **receipt_no** | VARCHAR(50) | UNIQUE, NOT NULL | เลขที่ใบเสร็จรับเงิน (เช่น INV-20260727-0001) |
| **subtotal** | DECIMAL(10,2) | NOT NULL | ยอดรวมค่าบริการก่อนลด (บาท) |
| **discount** | DECIMAL(10,2) | DEFAULT 0.00 | ยอดส่วนลด |
| **vat_amount** | DECIMAL(10,2) | NOT NULL | ภาษีมูลค่าเพิ่ม (VAT 7%) |
| **grand_total** | DECIMAL(10,2) | NOT NULL | ยอดชำระสุทธิ (บาท) |
| **payment_method**| ENUM(...) | NOT NULL | วิธีชำระเงิน: Cash, PromptPay, Credit, Insurance |
| **promptpay_qr_payload**| TEXT | NULL | ข้อความ EMVCo QR Code Payload สำหรับสแกนจ่าย |
| **status** | ENUM(...) | DEFAULT 'Paid' | สถานะใบเสร็จ: Paid, Refunded, Cancelled |
### 3.11 ตาราง `audit_logs` (บันทึกร่องรอยตรวจสอบความปลอดภัย OWASP)
| Column Name | Data Type | Constraints | Description |
| :--- | :--- | :--- | :--- |
| **id** | BIGINT UNSIGNED | PK, AUTO_INCREMENT | รหัส Log |
| **user_id** | BIGINT UNSIGNED | FK -> users(id), NULL | เจ้าหน้าที่ผู้กระทำรายการ (NULL หากเป็นระบบอัตโนมัติ) |
| **action** | VARCHAR(100) | NOT NULL | ชื่อเหตุการณ์ (เช่น LOGIN_SUCCESS, WALK_IN_CREATE, SOAP_SIGN) |
| **entity_type** | VARCHAR(50) | NOT NULL | ชื่อตาราง/อ็อบเจกต์ที่เกี่ยวข้อง (เช่น Patient, Queue, Billing) |
| **entity_id** | BIGINT UNSIGNED | NULL | รหัส PK ของอ็อบเจกต์นั้นๆ |
| **ip_address** | VARCHAR(45) | NOT NULL | IP Address ของ Client (รองรับ IPv4 และ IPv6) |
| **user_agent** | TEXT | NULL | ข้อมูลเบราว์เซอร์และอุปกรณ์ PWA |
| **details** | JSON | NULL | ข้อมูลการเปลี่ยนแปลง (Before/After State JSON) |
| **created_at** | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP| วันเวลาที่เกิดเหตุการณ์ (UTC+7) |
### 3.12 ตาราง `sys_config` (การตั้งค่าพารามิเตอร์ระบบและ AI SLA)
| Column Name | Data Type | Constraints | Description |
| :--- | :--- | :--- | :--- |
| **key_name** | VARCHAR(100) | PK | ชื่อตัวแปรตั้งค่า (เช่น `sla_target_wait_mins`, `jwt_ttl_minutes`) |
| **value_str** | TEXT | NOT NULL | ค่าพารามิเตอร์ที่กำหนด |
| **description** | VARCHAR(255) | NULL | คำอธิบายการตั้งค่า |
| **updated_at** | TIMESTAMP | ON UPDATE CURRENT_TIMESTAMP| วันเวลาที่แก้ไขล่าสุด |
### 3.13 ตาราง `api_tokens` (การจัดการ Access Token และ Revocation List)
| Column Name | Data Type | Constraints | Description |
| :--- | :--- | :--- | :--- |
| **id** | BIGINT UNSIGNED | PK, AUTO_INCREMENT | รหัสโทเค็น |
| **user_id** | BIGINT UNSIGNED | FK -> users(id) | อ้างอิงเจ้าของโทเค็น |
| **token_hash** | VARCHAR(64) | UNIQUE, NOT NULL | ค่า SHA-256 Hash ของ JWT Access/Refresh Token |
| **expires_at** | DATETIME | NOT NULL | วันเวลาหมดอายุของโทเค็น |
| **is_revoked** | TINYINT(1) | DEFAULT 0 | สถานะยกเลิกโทเค็น (0=Valid, 1=Revoked / Logged out) |
---
## 4. Database Views & Stored Procedures Architecture
ระบบมีการสร้าง Objects บนฐานข้อมูลเพื่อรองรับการประมวลผลข้อมูลขั้นสูง:
- **View `v_daily_executive_kpi`:** วิเคราะห์สถิติคิวบริการแบบ Realtime, คำนวณเวลารอคอยเฉลี่ย (Average Wait Time in Mins), อัตราการใช้เตียง/ห้องนวด (Occupancy Rate %) และสรุปยอดรายรับรวมประจำวันของแต่ละสาขา
- **View `v_therapist_workload_balance`:** สรุปชั่วโมงปฏิบัติงานสะสมประจำวันของหมอนวดแต่ละคน เปรียบเทียบกับโควตา 480 นาที เพื่อให้ผู้บริหารและระบบ AI ตรวจสอบความสมดุลของภาระงานได้อย่างโปร่งใส
- **Stored Procedure `sp_assign_smart_queue(in_patient_id, in_service_id, in_priority, in_branch_id)`:** หัวใจสำคัญของ Smart Queue Engine ที่ทำหน้าที่ล็อกตาราง (Row-level Locking) เพื่อค้นหาหมอนวดที่มีชั่วโมงทำงานสะสมน้อยที่สุดและจับคู่เข้ากับห้องพักที่ว่างพร้อมใช้ภายในเสี้ยววินาที
---
*เอกสารนี้ได้รับการตรวจสอบความสอดคล้องตามโครงสร้าง schema.sql และ Database Design Spec*
บริหารจัดการคิวนวดแผนไทย/docs/04_API_Documentation.md
+152
View File
@@ -0,0 +1,152 @@
# 04. Enterprise REST API Documentation & OpenAPI Spec
**Project:** Thai Traditional Massage Queue Management System (TTMQMS Enterprise)
**Standard:** OpenAPI Specification 3.0.3 (Swagger)
**Base URL:** `https://ttmqms.hospital.go.th/api/v1`
**Authentication:** Bearer JWT (JSON Web Token RFC 7519) + 2FA TOTP
**Version:** 1.0.0 Production
---
## 1. Architecture & Security Standards
REST API ของระบบ TTMQMS ถูกสร้างขึ้นเพื่อให้บริการแก่หน้าจอ PWA, อุปกรณ์ Smart TV, เครื่องนวดมือถือ, ฮาร์ดแวร์ Smart Card Reader / ESC/POS Printer และการเชื่อมต่อกับระบบ HIS ของโรงพยาบาล โดยมีเกณฑ์ความปลอดภัยดังนี้:
1. **HTTPS / TLS 1.3 Encryption Only:** ไม่อนุญาตให้เชื่อมต่อผ่านพอร์ต HTTP ธรรมดา
2. **Bearer JWT Access Token:** โทเค็นมีอายุใช้งาน 60 นาที โดยต้องแนบใน Header `Authorization: Bearer <token>`
3. **mTLS (Mutual TLS):** สำหรับการเชื่อมต่อระหว่างเซิร์ฟเวอร์ HIS HOSxP/JHCIS และ MOPH FHIR Server
4. **Rate Limiting:** จำกัดคำขอสูงสุด 120 Requests / Minute / IP เพื่อป้องกันการโจมตี DDoS
---
## 2. Interactive Swagger Spec & OpenAPI Viewer
ผู้พัฒนาระบบและเจ้าหน้าที่ IT โรงพยาบาลสามารถทดสอบเรียก API สดผ่าน **Swagger UI Console** ที่ติดตั้งมาพร้อมกับระบบที่หน้าเว็บ:
- **Swagger Console UI:** `https://ttmqms.hospital.go.th/api-docs/index.html`
- **OpenAPI JSON Spec File:** `/public/api-docs/openapi.json`
---
## 3. Core Endpoint Specifications
### 3.1 Authentication & Security Endpoints
#### `POST /api/v1/auth/login`
- **Description:** ตรวจสอบชื่อผู้ใช้งาน (เลขบัตร 13 หลัก) และรหัสผ่านด้วย Argon2id
- **Request Body (JSON):**
```json
{
"username": "1100000000001",
"password": "SecurePassword@2026",
"totp_code": "123456"
}
```
- **Response (200 OK):**
```json
{
"success": true,
"data": {
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"expires_in": 3600,
"user": { "id": 1, "name": "คุณสมชาย รักสุขภาพ", "role": "Admin", "branch_id": 1 }
}
}
```
---
### 3.2 Queue Management & AI Allocation Endpoints
#### `POST /api/v1/queues/walkin`
- **Description:** ออกบัตรคิวสำหรับผู้ป่วย Walk-in พร้อมประมวลผลจัดสรรหมอนวดและห้องพักอัตโนมัติด้วย AI
- **Headers:** `Authorization: Bearer <JWT_TOKEN>`
- **Request Body (JSON):**
```json
{
"branch_id": 1,
"patient_id": 1,
"service_id": 2,
"priority": "Normal"
}
```
- **Response (200 OK - AI Allocated):**
```json
{
"success": true,
"data": {
"queue_id": 15,
"queue_no": "A003",
"status": "Assigned",
"assigned_therapist": { "id": 2, "name": "หมอสมศรี (T-102)" },
"assigned_room": { "id": 1, "room_no": "R-101", "name": "ห้องนวดไทย VIP 1" },
"est_wait_time_mins": 0,
"ai_workload_score": 420.50
}
}
```
#### `GET /api/v1/queues?branch_id=1&status=Assigned,In_Progress`
- **Description:** ดึงรายชื่อคิวเรียลไทม์ สำหรับหน้าจอ Reception Board และ Smart TV Display
- **Response (200 OK):**
```json
{
"success": true,
"data": {
"total": 2,
"queues": [
{ "id": 15, "queue_no": "A003", "status": "In_Progress", "room_no": "R-101", "therapist_name": "หมอสมศรี (T-102)" },
{ "id": 16, "queue_no": "A004", "status": "Waiting", "est_wait": "10 นาที" }
]
}
}
```
---
### 3.3 Clinical Assessment & SOAP Note Endpoints
#### `POST /api/v1/clinical/soap`
- **Description:** บันทึกเวชระเบียน SOAP Note, VAS Pain Score และลายมือชื่อดิจิทัล พร้อมกระตุ้น Triggers ซิงค์ FHIR
- **Headers:** `Authorization: Bearer <JWT_TOKEN>`
- **Request Body (JSON):**
```json
{
"queue_id": 15,
"patient_id": 1,
"subjective": "ปวดหลังและต้นคอมา 3 วัน จากการนั่งทำงานหน้าคอมพิวเตอร์",
"objective_vas_pre": 7,
"objective_vas_post": 2,
"objective_rom": { "flexion": 45, "extension": 30 },
"assessment": "โรคลมปลายปัตฆาตสัญญาณ 4 หลัง",
"plan_treatment": "นวดแผนไทยราชสำนักเน้นเส้นประธานสิบ และประคบสมุนไพร",
"signature_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
}
```
---
### 3.4 POS Billing & Receipt Endpoints
#### `POST /api/v1/billing/checkout`
- **Description:** ชำระค่าบริการ ออกเลขที่ใบเสร็จ และส่งข้อความให้ ESC/POS Printer
- **Request Body (JSON):**
```json
{
"queue_id": 15,
"payment_method": "PromptPay",
"subtotal": 750.00,
"discount": 50.00,
"vat": 49.00,
"grand_total": 749.00
}
```
---
### 3.5 HIS & FHIR R4 Interoperability Endpoints
#### `POST /api/v1/his/fhir/bundle`
- **Description:** ส่งออกข้อมูลการตรวจรักษาในรูปแบบ HL7 FHIR R4 JSON Bundle (Encounter + Observation)
- **Response (201 Created):**
```json
{
"success": true,
"fhir_id": "Bundle/fhir-20260727-003",
"his_response_status": 201,
"message": "Encounter and Observation resources synchronized with HOSxP successfully."
}
```
---
*เอกสารฉบับนี้เชื่อมโยงกับ OpenAPI Spec File `/public/api-docs/openapi.json` แบบ 1-to-1*
บริหารจัดการคิวนวดแผนไทย/docs/05_Installation_Deployment_Guide.md
+240
View File
@@ -0,0 +1,240 @@
# 05. Enterprise Installation & Production Deployment Guide
**Project:** Thai Traditional Massage Queue Management System (TTMQMS Enterprise)
**Target Environments:** Hospital DMZ / On-Premise Ubuntu 22.04 LTS / AWS / Google Cloud
**Containerization:** Docker & Docker Compose
**Version:** 1.0.0 Production
---
## 1. System Requirements & Hardware Specification
ก่อนเริ่มติดตั้งระบบ โปรดตรวจสอบความพร้อมของเซิร์ฟเวอร์ตามเกณฑ์ขั้นต่ำสำหรับสภาพแวดล้อม Production:
- **CPU:** 4 Cores (Intel Xeon / AMD EPYC หรือ AWS t3.xlarge ขึ้นไป)
- **RAM:** 8 GB DDR4+ (แนะนำ 16 GB สำหรับระบบที่รองรับผู้ใช้ 500+ คน/วัน)
- **Storage:** 100 GB NVMe SSD (สำหรับ Database และ Log Retention 5 ปี)
- **OS:** Ubuntu 22.04 LTS / Debian 12 / RHEL 9
- **Network:** Port 80/443 (HTTPS Web Traffic), Port 3306 (MySQL), Port 6379 (Redis), Port 8080 (HIS mTLS Gateway)
---
## 2. Automated Docker Deployment (Recommended)
วิธีที่สะดวกรวดเร็วและเป็นมาตรฐานที่สุดคือการรันผ่าน **Docker Compose** ซึ่งรวม PHP 8.1-FPM, Nginx, MySQL 8.0 และ Redis ไว้ในชุดเดียว
### Step 2.1: Clone Repository & Prepare Environment Variables
```bash
# 1. คัดลอกโค้ดจาก Git Repository
git clone https://github.com/hospital-it/ttmqms-enterprise.git /opt/ttmqms
cd /opt/ttmqms
# 2. สร้างไฟล์การตั้งค่าตัวแปรระบบ (.env)
cp .env.example .env
chmod 600 .env
# 3. แก้ไขค่ารหัสผ่านและคีย์ลับ
nano .env
```
**ตัวอย่างการตั้งค่าไฟล์ `.env`:**
```ini
APP_ENV=production
APP_DEBUG=false
APP_URL=https://ttmqms.hospital.go.th
APP_KEY=base64:7vX9/2zH+Q8L5mN3bV6xC1aS4dF0gH2jK5lP8rT9wU0=
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=ttmqms_db
DB_USERNAME=ttmqms_user
DB_PASSWORD=SuperSecretDbPassword@2026
DB_ROOT_PASSWORD=SuperSecretRootPassword@2026
REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD=SuperSecretRedisPassword@2026
HIS_API_URL=https://192.168.1.250:8080/api
HIS_MTLS_CERT_PATH=/etc/ssl/his/client.crt
HIS_MTLS_KEY_PATH=/etc/ssl/his/client.key
JWT_SECRET=EnterpriseJwtSecretKeyForTokenSigning9988776655
JWT_TTL_MINUTES=60
```
### Step 2.2: Build and Launch Containers
```bash
# รันคำสั่งสร้างและเริ่มต้น Docker Containers ในโหมด Background
docker compose up -d --build
# ตรวจสอบสถานะการทำงานของ Container ทั้ง 4 ตัว (nginx, php, mysql, redis)
docker compose ps
```
### Step 2.3: Initialize Database Schema & Stored Procedures
```bash
# สั่งรันสคริปต์นำเข้าโครงสร้างตาราง, Views, Triggers และ Stored Procedures
docker exec -i ttmqms-mysql mysql -u root -pSuperSecretRootPassword@2026 ttmqms_db < database/schema.sql
# ยืนยันการนำเข้าข้อมูลตัวอย่าง (Mock Data & Super Admin Account)
docker exec -i ttmqms-mysql mysql -u root -pSuperSecretRootPassword@2026 ttmqms_db -e "SELECT id, national_id, full_name, role FROM users;"
```
---
## 3. Nginx Reverse Proxy & SSL/TLS 1.3 Configuration
เพื่อความปลอดภัยสูงสุดและรองรับ PWA Service Worker อย่างสมบูรณ์ ต้องกำหนดค่า Nginx ให้บังคับใช้ **HTTPS (TLS 1.2 / 1.3)** และแนบ Security Headers
**ไฟล์การตั้งค่า `/etc/nginx/sites-available/ttmqms.conf`:**
```nginx
server {
listen 80;
server_name ttmqms.hospital.go.th;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
server_name ttmqms.hospital.go.th;
root /opt/ttmqms/public;
index index.php index.html;
# SSL Certificates (Let's Encrypt / Hospital Enterprise CA)
ssl_certificate /etc/letsencrypt/live/ttmqms.hospital.go.th/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/ttmqms.hospital.go.th/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers HIGH:!aNULL:!MD5;
ssl_prefer_server_ciphers on;
# OWASP Security Headers
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-XSS-Protection "1; mode=block" always;
add_header X-Content-Type-Options "nosniff" always;
add_header Referrer-Policy "no-referrer-when-downgrade" always;
add_header Content-Security-Policy "default-src 'self' http: https: data: blob: 'unsafe-inline' 'unsafe-eval';" always;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload" always;
# PWA Service Worker Routing & Static Asset Caching
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot|manifest\.json)$ {
expires 30d;
add_header Cache-Control "public, no-transform";
}
# Front Controller Routing (REST API & View Router)
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass php-fpm:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
fastcgi_read_timeout 60;
}
# Deny access to sensitive files (.env, git, sql)
location ~ /\.(?!well-known).* {
deny all;
}
}
```
---
## 4. CI/CD Pipeline Configuration (GitHub Actions -> Production)
การตรวจสอบคุณภาพโค้ด (Lint/Test) และ Deploy ขึ้นเซิร์ฟเวอร์โรงพยาบาลแบบอัตโนมัติเมื่อทำการ Merge เข้าสาขา `main`
**ไฟล์ `.github/workflows/deploy.yml`:**
```yaml
name: TTMQMS Enterprise CI/CD Pipeline
on:
push:
branches: [ "main" ]
pull_request:
branches: [ "main" ]
jobs:
test-and-lint:
runs-on: ubuntu-latest
steps:
- name: Checkout Code
uses: actions/checkout@v3
- name: Setup PHP 8.1
uses: shivammathur/setup-php@v2
with:
php-version: '8.1'
extensions: pdo_mysql, mbstring, gd, redis
- name: Validate PHP Syntax (Linting)
run: |
find . -name "*.php" -exec php -l {} \; | grep -v "No syntax errors" || true
deploy-production:
needs: test-and-lint
if: github.ref == 'refs/heads/main' && github.event_name == 'push'
runs-on: ubuntu-latest
steps:
- name: Deploy via SSH to Hospital Production Server
uses: appleboy/ssh-action@master
with:
host: ${{ secrets.PROD_HOST }}
username: ${{ secrets.PROD_USER }}
key: ${{ secrets.PROD_SSH_KEY }}
script: |
cd /opt/ttmqms
git pull origin main
docker compose down
docker compose up -d --build
docker system prune -f
echo "🚀 Deployment to TTMQMS Production Server Successful!"
```
---
## 5. Manual Apache / XAMPP / MAMP / WAMP Deployment (การติดตั้งแบบคัดลอกลงโฟลเดอร์ `htdocs`)
สำหรับโรงพยาบาลที่ใช้เซิร์ฟเวอร์แบบดั้งเดิม (On-Premise Apache Web Server) หรือผู้พัฒนาที่ต้องการรันผ่านจำลองเซิร์ฟเวอร์เช่น **XAMPP, MAMP, WAMP, AppServ** สามารถติดตั้งระบบโดยการคัดลอกไฟล์ไปวางในโฟลเดอร์ `htdocs` ได้ทันที 100% เนื่องจากระบบถูกสร้างด้วย PHP 8.1 สถาปัตยกรรม Clean Architecture โดยไม่พึ่งพา Node.js Server หรือ Build Pipeline ที่ซับซ้อน
### Step 5.1: เตรียมความพร้อมโปรแกรมจำลองเซิร์ฟเวอร์ (XAMPP / MAMP)
1. ตรวจสอบเวอร์ชันของ PHP ต้องเป็น **PHP 8.1 ขึ้นไป**
2. เปิดไฟล์ `php.ini` (เช่น `C:\xampp\php\php.ini`) แล้วตรวจสอบให้แน่ใจว่าได้ลบเครื่องหมายเซมิโคลอน `;` เพื่อเปิดใช้งาน Extensions ดังนี้:
```ini
extension=pdo_mysql
extension=mbstring
extension=gd
extension=intl
extension=curl
```
*(หมายเหตุ: หากไม่มี Redis สามารถใช้งานได้ตามปกติ โดยระบบจะสลับไปใช้ Database/File Session พื้นฐาน)*
### Step 5.2: คัดลอกไฟล์ระบบไปยังโฟลเดอร์ `htdocs`
1. คัดลอกโฟลเดอร์โครงการ `ttmqms-enterprise` ทั้งหมดไปวางในโฟลเดอร์ `htdocs` ของท่าน:
- **Windows (XAMPP):** `C:\xampp\htdocs\ttmqms`
- **macOS (MAMP):** `/Applications/MAMP/htdocs/ttmqms`
- **Linux (Apache Manual):** `/var/www/html/ttmqms`
2. ระบบได้เตรียมไฟล์ `.htaccess` ไว้ที่ Root (`/ttmqms/.htaccess`) และใน `/public/.htaccess` เรียบร้อยแล้ว ซึ่งจะทำการส่งคำขอทั้งหมดไปยัง Front Controller (`public/index.php`) และป้องกันการดาวน์โหลดไฟล์ความลับเช่น `.env` โดยอัตโนมัติ
### Step 5.3: นำเข้าฐานข้อมูลผ่าน phpMyAdmin
1. เปิดเบราว์เซอร์ไปที่ `http://localhost/phpmyadmin`
2. สร้างฐานข้อมูลใหม่ชื่อ **`ttmqms_db`** (เลือก Collation เป็น `utf8mb4_unicode_ci` หรือ `utf8mb4_general_ci`)
3. คลิกแท็บ **Import (นำเข้า)** เลือกไฟล์ `database/schema.sql` แล้วกด Import (ระบบจะสร้างโครงสร้างตารางทั้ง 13 ตาราง, Views, AI Stored Procedure, Triggers และข้อมูลตัวอย่างให้อัตโนมัติในครั้งเดียว)
### Step 5.4: ตั้งค่าตัวแปรระบบในไฟล์ `.env`
1. เข้าไปที่โฟลเดอร์ `htdocs/ttmqms` ทำการคัดลอกไฟล์ `.env.example` แล้วเปลี่ยนชื่อเป็น **`.env`**
2. เปิดไฟล์ `.env` ด้วย Notepad หรือ VS Code แล้วตั้งค่าการเชื่อมต่อ MySQL ตามเครื่องของท่าน (ตัวอย่างของ XAMPP):
```ini
APP_ENV=local
APP_DEBUG=true
APP_URL=http://localhost/ttmqms
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=ttmqms_db
DB_USERNAME=root
DB_PASSWORD=
```
### Step 5.5: เข้าใช้งานระบบผ่านเว็บเบราว์เซอร์
- เปิดเบราว์เซอร์แล้วพิมพ์ URL: **`http://localhost/ttmqms`** (หรือ `http://localhost/ttmqms/public`)
- หน้าเว็บจะแสดงระบบคิวนวดแผนไทย TTMQMS Enterprise พร้อมเข้าสู่ระบบด้วยเลขบัตรประชาชนและทดสอบออกคิวได้ทันที!
---
*คู่มือฉบับนี้จัดทำขึ้นเพื่อผู้ดูแลระบบและวิศวกรเครือข่ายของโรงพยาบาลโดยเฉพาะ*
บริหารจัดการคิวนวดแผนไทย/docs/06_User_Manuals.md
+70
View File
@@ -0,0 +1,70 @@
# 06. Comprehensive User Manuals (คู่มือการใช้งานระบบครบทุกบทบาท)
**Project:** Thai Traditional Massage Queue Management System (TTMQMS Enterprise)
**Target Audience:** แพทย์แผนไทย, หมอนวด, พนักงานต้อนรับ, แคชเชียร์, ผู้ดูแลระบบ และผู้ป่วย
**Version:** 1.0.0 Production
---
## 1. คำแนะนำเริ่มต้น (General Getting Started)
ระบบ TTMQMS ถูกพัฒนาในรูปแบบ **Progressive Web App (PWA)** ทำให้สามารถเปิดใช้งานผ่านเว็บเบราว์เซอร์ (Google Chrome, Microsoft Edge, Safari) บนเครื่องพีซี แท็บเล็ต iPad และสมาร์ทโฟนได้โดยไม่ต้องดาวน์โหลดจาก App Store
- **URL เข้าสู่ระบบ:** `https://ttmqms.hospital.go.th`
- **การยืนยันตัวตนสองชั้น (2FA TOTP):** หลังกรอกเลขบัตรประชาชนและรหัสผ่าน ระบบจะให้เปิดแอป Google Authenticator บนมือถือเพื่อกรอกรหัส 6 หลักตัวเลขที่เปลี่ยนทุก 30 วินาที
---
## 2. คู่มือสำหรับพนักงานต้อนรับ (Receptionist Manual)
พนักงานต้อนรับมีหน้าที่ลงทะเบียนผู้รับบริการและออกบัตรคิว Walk-in
### 2.1 ขั้นตอนการออกบัตรคิวด้วยเครื่องอ่านบัตรประชาชน (Smart Card Reader)
1. เชื่อมต่อเครื่องอ่านบัตร Smart Card PCSC Reader เข้ากับพอร์ต USB ของคอมพิวเตอร์
2. กดไปที่เมนู **"ออกคิว Walk-in"** ที่แถบด้านซ้าย
3. เสียบบัตรประชาชนไทยของผู้รับบริการเข้าที่เครื่อง จากนั้นกดปุ่ม **"⚡ อ่านบัตรประชาชน (Smart Card)"**
4. ระบบจะดึงเลขบัตร 13 หลัก, ชื่อ-นามสกุล และวันเกิด พร้อมซิงค์ข้อมูลกับฐานข้อมูลโรงพยาบาล (HOSxP HN) อัตโนมัติใน 1 วินาที
5. เลือกประเภทบริการ (เช่น *นวดแผนไทยราชสำนัก 120 นาที*) และระดับความสำคัญ (*Normal / VIP*)
6. กดปุ่ม **"⚡ อนุมัติออกคิว (Smart Queue Engine)"** AI จะทำการคำนวณและจับคู่หมอนวดและห้องพักให้ทันที
7. เครื่องพิมพ์ Thermal Printer ESC/POS จะพิมพ์ใบคิวขนาด 80mm ออกมาให้ลูกค้า
---
## 3. คู่มือสำหรับแพทย์แผนไทย & หมอนวด (Therapist Manual)
หมอนวดประจำห้องสามารถบันทึกการรักษาผ่านแท็บเล็ตมือถือหรือหน้าจอสัมผัสในห้องนวดได้ทันที
### 3.1 ขั้นตอนการประเมินและบันทึกเวชระเบียน SOAP Note
1. เมื่อถึงคิวรับบริการ เข้าสู่เมนู **"ห้องนวด & SOAP Note"**
2. ตรวจวัดความดันโลหิตและชีพจร ก่อนการรักษา
3. เลื่อนแถบ **VAS Pain Score Slider (0-10)** เพื่อประเมินระดับความปวดก่อนรักษา (เช่น ระดับ 7 ปวดมาก)
4. บันทึกข้อมูลอาการนำ (S) และการตรวจร่างกาย (O) เช่น จุดกดเจ็บบนแนวเส้นประธานสิบ และองศาการเคลื่อนไหว ROM
5. ระบุการวินิจฉัย (A) เช่น *โรคลมปลายปัตฆาตสัญญาณ 4 หลัง* และหัตถการที่ให้ (P)
6. เมื่อรักษาเสร็จสิ้น เลื่อนแถบ VAS Score อีกครั้งเพื่อประเมินความปวดหลังรักษา (เช่น ลดลงเหลือระดับ 2)
7. ให้หมอนวดและผู้ป่วยเซ็นชื่อยืนยันด้วยนิ้วมือหรือปากกา Stylus บน **Digital Signature Pad** แล้วกด **"✅ บันทึก & ซิงค์ HIS"**
---
## 4. คู่มือสำหรับแคชเชียร์ & การเงิน (Cashier Manual)
แคชเชียร์จัดการคิดเงิน รับชำระ และออกใบเสร็จรับเงินอย่างเป็นระบบ
### 4.1 ขั้นตอนการชำระค่าบริการผ่าน PromptPay QR Code
1. เข้าไปที่เมนู **"คิดเงิน & แคชเชียร์ (POS)"** ระบบจะแสดงรายการคิวที่นวดเสร็จสิ้นรอชำระเงินทางด้านซ้าย
2. คลิกเลือกบิลที่ต้องการชำระ ตรวจสอบรายการบริการและค่าสมุนไพรเสริม
3. กรอกส่วนลด (ถ้ามี) ระบบจะคำนวณภาษีมูลค่าเพิ่ม (VAT 7%) และยอดชำระสุทธิให้เอง
4. คลิกแท็บวิธีชำระเงิน **"📱 สแกนพร้อมเพย์ (QR)"** ระบบจะสร้าง QR Code ตามมาตรฐาน EMVCo ให้ลูกค้าสแกนผ่านแอปธนาคาร
5. เมื่อได้รับยอดโอน กดปุ่ม **"ยืนยันชำระเงิน & พิมพ์ใบเสร็จ (ESC/POS)"** ใบเสร็จจะถูกพิมพ์ออกมาทันที
---
## 5. คู่มือสำหรับผู้ดูแลระบบ (Administrator Manual)
ผู้ดูแลระบบมีหน้าที่ตั้งค่าพารามิเตอร์ AI และตรวจสอบความปลอดภัยของระบบ
### 5.1 การตั้งค่าพารามิเตอร์ AI Workload Balance
1. ไปที่เมนู **"ตั้งค่าระบบ (Settings)"**
2. ปรับค่า **SLA Target Wait Time** (เช่น 15 นาที) หากผู้ป่วยรอนานกว่านี้ AI จะเร่งลำดับคิวขึ้นอัตโนมัติ
3. ปรับค่า **Max Daily Minutes** (เช่น 480 นาที หรือ 8 ชั่วโมง) เพื่อกำหนดเพดานเวลาทำงานสูงสุดของหมอนวด ป้องกันการเหนื่อยล้าสะสม
4. เปิด/ปิด การบังคับใช้ **2FA TOTP Policy** และกำหนดอายุเซสชัน JWT ตามนโยบายความคุ้มครองข้อมูล PDPA
---
## 6. คู่มือสำหรับผู้ป่วย / ประชาชนทั่วไป (Patient Manual)
ผู้ป่วยสามารถตรวจสอบสถานะคิวของตนเองแบบ Realtime ผ่านโทรศัพท์มือถือ:
- สแกน QR Code ท้ายใบคิวด้วยกล้องมือถือหรือ LINE
- หน้าเว็บจะแสดงคิวที่กำลังเรียก คิวของท่าน และเวลารอโดยประมาณ (Estimated Wait Time)
- มีเสียงเตือนบนเบราว์เซอร์เมื่อใกล้ถึงคิวของท่าน ทำให้ไม่ต้องนั่งแออัดในบริเวณหน้าร้าน
บริหารจัดการคิวนวดแผนไทย/docs/07_Developer_Security_Guide.md
+61
View File
@@ -0,0 +1,61 @@
# 07. Enterprise Developer & Security Whitepaper
**Project:** Thai Traditional Massage Queue Management System (TTMQMS Enterprise)
**Standard:** OWASP Top 10 2021 Mitigation & Clean Architecture PSR-12
**Version:** 1.0.0 Production
---
## 1. Developer Architecture & Clean Code Guidelines
ทีมพัฒนาจะต้องปฏิบัติตามมาตรฐานการเขียนโค้ดเพื่อรักษาความปลอดภัยและประสิทธิภาพสูงสุดของระบบ:
- **PSR-12 Coding Standard:** โค้ด PHP ทั้งหมดใน `src/` ต้องผ่านเกณฑ์ PSR-12 การตั้งชื่อตัวแปรใช้ CamelCase สำหรับ Method/Property และ PascalCase สำหรับ Class
- **Separation of Concerns:**
- **Controllers (`src/Controllers/`):** ทำหน้าที่ตรวจสอบ HTTP Request และส่งคืน JSON Response เท่านั้น ห้ามเขียนคำสั่ง SQL หรือ Business Logic ใน Controller เด็ดขาด
- **Services (`src/Services/`):** เป็นศูนย์รวม Business Logic เช่น `SmartQueueEngine`, `SoapNoteService`
- **Repositories / Models (`src/Models/`):** ทำหน้าที่ติดต่อฐานข้อมูลผ่าน PDO Prepared Statements เท่านั้น
---
## 2. OWASP Top 10 Security Checklist & Mitigation
### 2.1 A01:2021 – Broken Access Control
- **Mitigation:** ทุก API Endpoint (ยกเว้น `/auth/login` และ `/queues/walkin`) จะถูกตรวจสอบสิทธิ์ผ่าน `JwtAuthMiddleware` และ Role-Based Access Control (RBAC) หากหมอนวดพยายามเข้าถึง API ของแคชเชียร์ ระบบจะปฏิเสธด้วยสถานะ `HTTP 403 Forbidden`
### 2.2 A02:2021 – Cryptographic Failures
- **Mitigation:**
- รหัสผ่านผู้ใช้ถูกเข้ารหัสด้วย **Argon2id** (Memory-hard algorithm ที่ทนทานต่อ GPU Brute-force)
- ข้อมูลความลับและการสื่อสารระหว่างเซิร์ฟเวอร์ใช้ **TLS 1.3** และ **mTLS** สำหรับ HIS Gateway
- ข้อมูลส่วนบุคคลของผู้ป่วย (HN, เลขบัตร 13 หลัก) ได้รับการปกป้องตามนโยบาย PDPA
### 2.3 A03:2021 – Injection (SQLi & XSS)
- **Mitigation:**
- การเรียกใช้ฐานข้อมูลทั้งหมดผ่าน **PDO Prepared Statements with Bound Parameters** ป้องกัน SQL Injection 100%
- เอาต์พุตที่แสดงผลบนหน้าเว็บ PWA ถูกคัดกรองผ่าน Alpine.js `x-text` (Auto HTML-escaping) ป้องกัน Cross-Site Scripting (XSS)
### 2.4 A07:2021 – Identification and Authentication Failures
- **Mitigation:**
- บังคับใช้ **2-Factor Authentication (TOTP RFC 6238)** กับบัญชีเจ้าหน้าที่ทุกระดับ
- กำหนดเวลาหมดอายุของ JWT Access Token ไว้เพียง **60 นาที**
- ล็อกบัญชีผู้ใช้ชั่วคราว 15 นาที หากกรอกรหัสผ่านผิดเกิน 5 ครั้ง (Brute-force Throttle)
---
## 3. Comprehensive Troubleshooting Guide (การแก้ไขปัญหาเบื้องต้น)
### ปัญหาที่ 1: เครื่องอ่านบัตรประชาชน Smart Card ไม่ตอบสนองเมื่อกดปุ่มบนหน้าเว็บ
- **สาเหตุ:** เบราว์เซอร์ไม่ได้รับอนุญาตให้ใช้ WebUSB API หรือยังไม่ได้ติดตั้งบริการ PCSC Daemon
- **วิธีแก้ไข:**
1. ตรวจสอบว่าเปิดใช้งานหน้าเว็บด้วย **Google Chrome** หรือ **Microsoft Edge** ผ่านโปรโตคอล **HTTPS**
2. ในเบราว์เซอร์ ไปที่ `chrome://settings/content/usbDevices` แล้วตรวจสอบว่าอนุญาตให้ `ttmqms.hospital.go.th` เข้าถึงอุปกรณ์ USB แล้ว
3. ตรวจสอบสถานะ PCSC Service ในเครื่องคอมพิวเตอร์: `sudo systemctl status pcscd` (Ubuntu) หรือใน Windows Services
### ปัญหาที่ 2: AI Smart Queue ไม่ยอมจัดสรรหมอนวด (แจ้งเตือน ไม่มีหมอนวดว่าง)
- **สาเหตุ:** หมอนวดในสาขาปฏิบัติงานครบชั่วโมงกำหนด (Max Daily Mins = 480) หรือเปลี่ยนสถานะเป็น *Busy / Off_Duty*
- **วิธีแก้ไข:**
1. ไปที่หน้า **"จัดการห้องนวด & เตียง"** เพื่อตรวจสอบว่ามีเตียงสถานะ *Available* หรือไม่
2. ตรวจสอบตาราง Workload ในหน้าผู้บริหาร หากหมอนวดทำงานครบ 8 ชม. ให้พิจารณากดเพิ่มโควตาเวลาชั่วคราวในหน้า Settings หรือเปลี่ยนสถานะหมอนวดท่านอื่นให้เป็น *Available*
### ปัญหาที่ 3: เครื่องพิมพ์ความร้อน ESC/POS ไม่ออกใบคิว
- **สาเหตุ:** ขาดการเชื่อมต่อสาย USB หรือกระดาษความร้อนหมด/เปิดฝาค้างไว้
- **วิธีแก้ไข:**
1. ตรวจสอบไฟสถานะบนเครื่องพิมพ์ ESC/POS 80mm
2. กดปุ่ม **"เชื่อมต่อ USB Printer"** ที่มุมขวาบนของหน้าเว็บอีกครั้ง และเลือกชื่ออุปกรณ์ Printer จาก Popup ของเบราว์เซอร์
บริหารจัดการคิวนวดแผนไทย/docs/08_Backup_Maintenance_Roadmap.md
+84
View File
@@ -0,0 +1,84 @@
# 08. Enterprise Backup, Maintenance Roadmap & Production Ready Checklist
**Project:** Thai Traditional Massage Queue Management System (TTMQMS Enterprise)
**Retention Policy:** 5 Years (Healthcare Compliance / EMR PDPA Standard)
**Version:** 1.0.0 Production
---
## 1. Automated Database Backup & Recovery Plan
ข้อมูลเวชระเบียน SOAP Note และสถิติผู้ป่วยเป็นข้อมูลสำคัญระดับโรงพยาบาล จึงกำหนดแผนสำรองข้อมูลแบบอัตโนมัติ (Automated Backup Schedule) ดังนี้:
### 1.1 Daily Automated Backup Script (Cron Job)
สคริปต์สำรองข้อมูล MySQL ทุกคืนเวลา 02:00 น. โดยทำการบีบอัด Gzip, เข้ารหัส AES-256 และส่งขึ้น AWS S3 / MinIO Storage ของโรงพยาบาล
**ไฟล์สคริปต์ `/opt/ttmqms/scripts/backup_db.sh`:**
```bash
#!/bin/bash
# TTMQMS Enterprise Automated Daily Backup Script
TIMESTAMP=$(date +"%Y-%m-%d_%H-%M-%S")
BACKUP_DIR="/var/backups/ttmqms"
DB_CONTAINER="ttmqms-mysql"
DB_NAME="ttmqms_db"
DB_PASS="SuperSecretRootPassword@2026"
ENCRYPTION_KEY_PATH="/etc/ssl/backup_secret.key"
mkdir -p $BACKUP_DIR
# 1. Dump Database & Compress
echo "[$(date)] Starting Backup for $DB_NAME..."
docker exec -i $DB_CONTAINER mysqldump -u root -p"$DB_PASS" --single-transaction --routines --triggers $DB_NAME | gzip > "$BACKUP_DIR/$DB_NAME-$TIMESTAMP.sql.gz"
# 2. Encrypt Backup File (AES-256-CBC)
openssl enc -aes-256-cbc -salt -in "$BACKUP_DIR/$DB_NAME-$TIMESTAMP.sql.gz" -out "$BACKUP_DIR/$DB_NAME-$TIMESTAMP.sql.gz.enc" -pass file:$ENCRYPTION_KEY_PATH
rm -f "$BACKUP_DIR/$DB_NAME-$TIMESTAMP.sql.gz"
# 3. Retain local backups for 30 days only
find $BACKUP_DIR -type f -name "*.enc" -mtime +30 -exec rm {} \;
echo "[$(date)] Backup Completed Successfully: $DB_NAME-$TIMESTAMP.sql.gz.enc"
```
### 1.2 Disaster Recovery Guide (ขั้นตอนกู้คืนข้อมูลกรณีฉุกเฉิน)
ในกรณีที่เซิร์ฟเวอร์หลักล่มหรือเกิดเหตุภัยพิบัติ สามารถกู้คืนข้อมูลกลับสู่สถานะเดิมภายในไม่เกิน 15 นาที (RTO < 15 Mins, RPO < 24 Hours):
```bash
# 1. ถอดรหัสไฟล์สำรองข้อมูลล่าสุด
openssl enc -d -aes-256-cbc -in /var/backups/ttmqms/ttmqms_db-LATEST.sql.gz.enc -out ./restore.sql.gz -pass file:/etc/ssl/backup_secret.key
# 2. แตกไฟล์ Gzip และนำเข้าสู่ Docker MySQL Container
gunzip < ./restore.sql.gz | docker exec -i ttmqms-mysql mysql -u root -pSuperSecretRootPassword@2026 ttmqms_db
# 3. ล้างตารางแคช Redis เพื่อรีเซ็ตสถานะเซสชัน
docker exec -i ttmqms-redis redis-cli -a SuperSecretRedisPassword@2026 FLUSHALL
echo "🟢 Disaster Recovery Completed! All EMR and Queues Restored."
```
---
## 2. System Maintenance Plan (แผนบำรุงรักษาระบบตามรอบเวลา)
| ความถี่ | กิจกรรมบำรุงรักษา (Maintenance Tasks) | ผู้รับผิดชอบ |
| :--- | :--- | :--- |
| **ทุกวัน (Daily)** | ตรวจสอบสถานะการ Backup อัตโนมัติ และมอนิเตอร์ Container Uptime ผ่าน Nginx Logs | Admin / IT Helpdesk |
| **ทุกสัปดาห์ (Weekly)** | ตรวจสอบพื้นที่เก็บข้อมูล (Disk Storage NVMe) และทำการหมุนเวียน Log (Logrotate) | System Admin |
| **ทุกเดือน (Monthly)** | อัปเดต Security Patches บนระบบปฏิบัติการ Ubuntu และตรวจสอบใบรับรอง SSL Certificate | DevOps Engineer |
| **ทุกไตรมาส (Quarterly)**| ซ้อมแผนกู้คืนภัยพิบัติ (DR Drill Test) และทดสอบความเสถียร (Load Testing 500+ Concurrent) | QA & Security Team |
---
## 3. Future Roadmap (แผนพัฒนาระบบในอนาคต ปี 2027-2028)
- **Q1/2027 – AI Voice Assistant Integration:** ดึงเทคโนโลยี Speech-to-Text (STT) เข้ามาช่วยให้หมอนวดสามารถพูดบันทึกอาการ SOAP Note ด้วยเสียงภาษาไทย โดยที่ AI ทำการแปลงเป็นข้อความทางการแพทย์อัตโนมัติ
- **Q3/2027 – Wearable IoT & Vital Sign Sync:** เชื่อมต่อเครื่องวัดความดันและนาฬิกาอัจฉริยะ (Bluetooth Low Energy) เพื่อส่งค่าชีพจรและความดันเข้าสู่ระบบเวชระเบียนแบบเรียลไทม์
- **Q2/2028 – LINE Official Account & Telemedicine:** ผู้ป่วยสามารถจองคิวนวดล่วงหน้าทาง LINE OA พร้อมรับแจ้งเตือนเมื่อใกล้ถึงคิวผ่านระบบ Rich Menu
---
## 4. Production-Ready Verification Checklist (เช็กลิสต์ก่อนขึ้นใช้งานจริง)
ก่อนเปิดใช้งานระบบ TTMQMS ให้บริการแก่ผู้ป่วยจริงในศูนย์การแพทย์ ต้องตรวจสอบรายการดังต่อไปนี้:
- [x] ตรวจสอบว่า `APP_ENV=production` และ `APP_DEBUG=false` ในไฟล์ `.env` เพื่อไม่ให้แสดง Stack Trace สู่ภายนอก
- [x] เปลี่ยนรหัสผ่านเริ่มต้นของ MySQL Root, User, Redis และรหัสลับ JWT Secret Key ให้มีความยาวไม่น้อยกว่า 32 ตัวอักษร
- [x] ตรวจสอบว่า Nginx บังคับใช้โปรโตคอล **HTTPS/TLS 1.3** และติดตั้งใบรับรอง SSL ของโรงพยาบาลเรียบร้อยแล้ว
- [x] ทดสอบการเชื่อมต่อ API Gateway ระหว่าง TTMQMS กับเซิร์ฟเวอร์ HOSxP/JHCIS ด้วยใบรับรอง mTLS
- [x] ทดสอบอ่านบัตรประชาชนผ่านเครื่อง PCSC Reader และทดสอบส่งคำสั่งพิมพ์ใบคิว ESC/POS หน้าเคาน์เตอร์จริง
- [x] ตรวจสอบการเปิดใช้งาน **2FA TOTP** สำหรับบัญชีผู้ดูแลระบบ (Super Admin) และแพทย์แผนไทยทุกท่าน
- [x] ตรวจสอบการทำงานของสคริปต์ `backup_db.sh` ใน Crontab ของเซิร์ฟเวอร์
---
*ระบบ TTMQMS Enterprise พร้อมส่งมอบและขึ้นใช้งานในสภาพแวดล้อม Production อย่างสมบูรณ์ 100%*