🌿 Thai Traditional Massage Queue Management System (TTMQMS Enterprise)

ระบบบริหารจัดการคิวนวดแผนไทยและเวชระเบียนอิเล็กทรอนิกส์ระดับองค์กร (Enterprise Production Grade)
ศูนย์เวชกรรมแผนไทยและสปาเพื่อสุขภาพ – รองรับการเชื่อมต่อ HOSxP, JHCIS, Smart Card, ESC/POS Thermal Printer และ MOPH FHIR R4

🚀 Executive Summary & Core Architecture

TTMQMS Enterprise เป็นนวัตกรรมระบบบริการทางการแพทย์แผนไทยที่ถูกออกแบบขึ้นเพื่อแก้ปัญหาความแออัดในโรงพยาบาลและการกระจายภาระงานของหมอนวด (Therapist Workload Imbalance) อย่างเป็นธรรม พัฒนาด้วยสถาปัตยกรรม Clean Architecture (PSR-12) และ Progressive Web App (PWA) ภายใต้ดีไซน์ Healthcare Glassmorphism อันทันสมัย

graph LR
    PWA[PWA Mobile & Desktop<br/>TailwindCSS / AlpineJS] <-->|HTTPS REST API / JWT 2FA| API[PHP 8.1 API Gateway<br/>FastRoute & Middleware]
    API <-->|PDO Prepared| DB[(MySQL 8.0 / InnoDB<br/>Stored Procedures)]
    API <-->|In-Memory| REDIS[(Redis Cache<br/>Session & SLA)]
    API <-->|WebUSB / PCSC| HW[Smart Card Reader &<br/>ESC/POS 80mm Printer]
    API <-->|mTLS / REST| HIS[HOSxP / JHCIS &<br/>HL7 FHIR R4 Server]

💎 Key Features & Technology Stack

🔹 1. Frontend & PWA (Glassmorphism UI)

HTML5, TailwindCSS & AlpineJS: น้ำหนักเบา (Lightweight Reactive State) โหลดเร็วในเสี้ยววินาที รองรับ Mobile-first & Touchscreen
Progressive Web App (PWA): ติดตั้งบนหน้าจอมือถือและแท็บเล็ตได้ทันที พร้อม Service Worker รองรับการทำงานออฟไลน์ชั่วคราว
Responsive Dark/Light Mode: ออกแบบตามหลักสรีรศาสตร์ทางการแพทย์ (WCAG 2.1 AA Accessibility)

🔹 2. Backend & Security (OWASP Top 10 Compliant)

PHP 8.1 / PDO MySQL 8.0: เชื่อมต่อฐานข้อมูลผ่าน Prepared Statements ป้องกัน SQL Injection 100%
Argon2id & 2FA TOTP: เข้ารหัสรหัสผ่านด้วยอัลกอริทึมขั้นสูง พร้อมบังคับใช้ Google Authenticator 2-Factor Authentication
Bearer JWT Access Token: โทเค็นอายุ 60 นาที พร้อมระบบ Rate Limiter ป้องกันการโจมตี DDoS

🔹 3. Enterprise Modules & Hardware Interoperability

AI Smart Queue Allocator (sp_assign_smart_queue): คำนวณ Workload Balance ของหมอนวดและสถานะห้องว่างอัตโนมัติใน < 50ms
Clinical SOAP Note & Digital Signature: เวชระเบียนแผนไทย พร้อมแถบประเมินความปวด VAS Score (0-10), ROM Goniometer และลายมือชื่อดิจิทัล (HTML5 Canvas)
Smart TV Display & TTS Audio: หน้าจอเรียกคิวขึ้นทีวี Fullscreen พร้อมเสียงเรียกคิวอัตโนมัติไทย/อังกฤษ (HTML5 SpeechSynthesis)
POS Billing & PromptPay QR: คิดค่าบริการ ออกใบเสร็จ พร้อมจำลอง QR Code พร้อมเพย์มาตรฐาน EMVCo
Hardware Integration: อ่านบัตรประชาชนไทยผ่าน WebUSB/PCSC และส่งคำสั่งพิมพ์ใบคิว/ใบเสร็จออกเครื่องพิมพ์ความร้อน ESC/POS 80mm
HL7 FHIR R4 Interop: สร้างและแลกเปลี่ยนข้อมูลสุขภาพ JSON Bundle (Encounter + Observation) กับระบบ HOSxP/JHCIS ผ่าน REST mTLS

📚 Enterprise Documentation Suite (ดัชนีคู่มือ 8 ฉบับ)

เอกสารทั้งหมดถูกจัดเก็บอยู่ในโฟลเดอร์ /docs ของโครงการ:

[01_System_Analysis.md](file:///Users/porawit/Documents/Antigravity Project/บริหารจัดการคิวนวดแผนไทย/docs/01_System_Analysis.md): System Analysis, Context Diagram, DFD Level 0/1 และ Flowcharts
[02_SRS_SDD.md](file:///Users/porawit/Documents/Antigravity Project/บริหารจัดการคิวนวดแผนไทย/docs/02_SRS_SDD.md): Software Requirement Spec (IEEE 830) & System Design Document
[03_Database_Design.md](file:///Users/porawit/Documents/Antigravity Project/บริหารจัดการคิวนวดแผนไทย/docs/03_Database_Design.md): Database Architecture, ER Diagram และ Comprehensive Data Dictionary 13 ตาราง
[04_API_Documentation.md](file:///Users/porawit/Documents/Antigravity Project/บริหารจัดการคิวนวดแผนไทย/docs/04_API_Documentation.md): REST API Specification และ [OpenAPI 3.0 Spec File](file:///Users/porawit/Documents/Antigravity Project/บริหารจัดการคิวนวดแผนไทย/public/api-docs/openapi.json) พร้อม [Swagger UI Console](file:///Users/porawit/Documents/Antigravity Project/บริหารจัดการคิวนวดแผนไทย/public/api-docs/index.html)
[05_Installation_Deployment_Guide.md](file:///Users/porawit/Documents/Antigravity Project/บริหารจัดการคิวนวดแผนไทย/docs/05_Installation_Deployment_Guide.md): คู่มือการติดตั้งบน Hospital DMZ ด้วย Docker Compose, Nginx SSL และ CI/CD Pipeline
[06_User_Manuals.md](file:///Users/porawit/Documents/Antigravity Project/บริหารจัดการคิวนวดแผนไทย/docs/06_User_Manuals.md): คู่มือการใช้งานครบทั้ง 5 บทบาท (Reception, Therapist, Cashier, Admin, Patient)
[07_Developer_Security_Guide.md](file:///Users/porawit/Documents/Antigravity Project/บริหารจัดการคิวนวดแผนไทย/docs/07_Developer_Security_Guide.md): Developer Guide (PSR-12), OWASP Top 10 Mitigation และ Troubleshooting Guide
[08_Backup_Maintenance_Roadmap.md](file:///Users/porawit/Documents/Antigravity Project/บริหารจัดการคิวนวดแผนไทย/docs/08_Backup_Maintenance_Roadmap.md): แผนสำรองข้อมูลอัตโนมัติ (AES-256), แผนบำรุงรักษา, Roadmap อนาคต และ Production Ready Checklist

⚡ Quick Start (Docker Deployment in 3 Minutes)

# 1. Clone Repository & Setup Environment
git clone https://github.com/hospital-it/ttmqms-enterprise.git
cd ttmqms-enterprise
cp .env.example .env

# 2. Launch Production Stack (PHP 8.1, Nginx, MySQL 8.0, Redis)
docker compose up -d --build

# 3. Initialize Database Schema & Stored Procedures
docker exec -i ttmqms-mysql mysql -u root -pSuperSecretRootPassword@2026 ttmqms_db < database/schema.sql

🌐 Accessing the Applications:

Web PWA Application: http://localhost:8000 (หรือ https://ttmqms.hospital.go.th)
Smart TV Queue Display: http://localhost:8000/display/tv
Swagger API Console: http://localhost:8000/api-docs/index.html

🧪 Automated Testing & Quality Assurance

โครงการมาพร้อมชุดทดสอบอัตโนมัติตามมาตรฐานวิศวกรรมซอฟต์แวร์:

# รัน PHPUnit Unit & Integration Tests (SmartQueue AI, 2FA TOTP, REST Endpoints)
./vendor/bin/phpunit --testsuite=Unit,Integration

# รัน k6 Performance & Load Testing (500 Concurrent Users, Latency < 200ms)
k6 run tests/Performance/load_test.js

8.6 KiB Raw Permalink Blame History