คู่มือใช้งาน SCPACS
SCPACS — SCK Studies Explorer ระบบจัดการภาพและข้อมูลตรวจจาก Orthanc สำหรับโรงพยาบาล รองรับ AI วิเคราะห์ภาพ, Worklist จาก HOSxP, ส่งภาพเข้า MOPH Imaging Hub และ DICOM Modality Worklist
Worklist config rev 2 · อัปเดต 2026-06-17
HOSxP Worklist
คู่มือฉบับเต็ม API + MWL
MOPH Imaging Hub
สเปก API ส่งภาพหมอพร้อม
ทดสอบ MWL
C-FIND ไปยัง Worklist SCP
Provider ID OAuth
Login รับ Bearer Token
เริ่มต้นใช้งานอย่างรวดเร็ว
- ติดตั้งและเปิด Orthanc PACS ให้ API ทำงานได้ (ค่าเริ่มต้น
http://127.0.0.1:8042) - เข้า จัดการระบบ → ตั้ง Orthanc API URL และ Orthanc Public Viewer URL → กดทดสอบการเชื่อมต่อ
- เปิด หน้าแรก จะเห็นรายการ Studies — กดเปิด Viewer หรือวิเคราะห์ AI ได้ทันที
- (ถ้าใช้ Worklist) ตั้งค่า HOSxP ใน Admin → เปิด MWL SCP → ทดสอบที่ ทดสอบ MWL
- (ถ้าส่งหมอพร้อม) Login Provider ID → ตั้งค่า MOPH ใน Admin → ส่งภาพจากหน้าแรก
ภาพรวมระบบ
SCPACS ทำหน้าที่เป็นชั้นกลางระหว่างผู้ใช้งานกับ Orthanc และระบบภายนอก:
Orthanc PACS
เก็บ DICOM Studies, Series, Instances — SCPACS ดึงรายการและเปิด Viewer
HOSxP
ดึงรายการสั่ง X-Ray จาก xray_report → Worklist / DICOM MWL
MOPH Imaging Hub
ส่ง DICOM/PNG เข้าคลังภาพหมอพร้อม ผ่าน API /ct/v1/import/dicom
แผนที่เมนู
| เมนู | URL | หน้าที่หลัก |
|---|---|---|
| หน้าแรก | / | ค้นหา Studies, Viewer, AI, Export, ส่ง MOPH |
| ประวัติรายงาน AI | /ai-reports | ดาวน์โหลดรายงาน TXT/PDF ที่ AI สร้าง |
| Chat AI | /ai-chat | สนทนากับ AI Gateway ภายใน รพ. |
| X-Ray Worklist | /worklist/xray | รายการสั่ง X-Ray จาก HOSxP (ค่าเริ่มต้นวันนี้) |
| ทดสอบ MWL | /worklist/mwl-test | ทดสอบ DICOM C-FIND ไปยัง MWL SCP |
| คู่มือ | /guide | คู่มือนี้ |
| Provider ID OAuth | /moph/provider-id | Login รับ Token สำหรับ MOPH API |
| จัดการระบบ | /admin | ตั้งค่าทั้งหมด (ต้อง login) |
1. หน้าแรก: ค้นหาและจัดการรายการตรวจ
ทำอะไรได้: แสดงรายการ Studies จาก Orthanc พร้อม HN, ชื่อผู้ป่วย, วันที่ตรวจ, Modality, Accession Number และจำนวน Series/Instances
ตัวกรอง: ค้นหาข้อความ, กรองวันนี้ / เมื่อวาน / ทั้งหมด, เลือก Modality
ปุ่มสำคัญ:
- เปิด Viewer — ดูภาพ DICOM ผ่าน Orthanc Viewer/Stone/OHIF
- AI วิเคราะห์ / AI Radiology — วิเคราะห์ภาพด้วย Gemini หรือ External Model
- สร้างลิงก์แชร์ — ลิงก์มีวันหมดอายุ + QR Code
- Export DICOM — ดาวน์โหลดไฟล์ DICOM ของ Study
- Export ตาราง — ส่งออก CSV, JSON หรือ XLSX
- ส่งเข้า MOPH Imaging Hub — เลือกหลาย Study แล้วส่งภาพเข้าคลังหมอพร้อม (ต้องตั้งค่า MOPH ก่อน)
ถ้ารายการโหลดช้า ให้ Admin รัน SQLite Index Sync เพื่อ cache ข้อมูล Study
2. Viewer และการเปิดภาพ DICOM
ทำอะไรได้: เปิดภาพ DICOM ผ่าน URL ของ Orthanc Viewer ที่ตั้งค่าไว้
วิธีใช้: ที่หน้าแรก กดปุ่มเปิดภาพของ Study — ระบบพาไป /viewer/<StudyUID> แล้ว redirect ไป Public Viewer
ตั้งค่าใน Admin:
- Orthanc API URL — สำหรับ SCPACS ดึงข้อมูล (เช่น
http://127.0.0.1:8042) - Orthanc Public Viewer URL — URL ที่เครื่อง client เปิดดูภาพได้ (เช่น Stone Web Viewer หรือ OHIF)
3. AI วิเคราะห์ภาพ X-ray / DICOM
ทำอะไรได้: วิเคราะห์ภาพจาก Study ด้วย Google Gemini หรือ External Model API (FastAPI/Ollama, Roboflow, HuggingFace ฯลฯ)
วิธีใช้: หน้าแรก → กด AI วิเคราะห์ (ใช้ค่า default) หรือ AI Radiology (บังคับ external model)
ตั้งค่า Gemini: Admin → ใส่ Google Gemini API Key → กดทดสอบ API Key
ตั้งค่า External Model: เปิด External Model API → เลือก Provider Preset → ใส่ Endpoint เช่น http://127.0.0.1:3001/predict → ทดสอบ
ผลลัพธ์: บันทึกเป็นรายงาน TXT/PDF ในโฟลเดอร์ data — ดูย้อนหลังที่เมนู ประวัติรายงาน AI
4. Chat AI โรงพยาบาล
ทำอะไรได้: สนทนากับ AI Gateway ภายใน รพ. ช่วยถามตอบ สรุปข้อมูล งานแพทย์ พยาบาล และ IT
วิธีใช้: เมนู Chat AI → เลือกโมเดลหรือ Auto → พิมพ์หรือกดไมค์พูด
ไฟล์แนบ: TXT, CSV, JSON, MD, LOG, XML, HTML และรูปภาพ — รูปจะวิเคราะห์ผ่าน /predict ก่อนส่งต่อ /chat
ประวัติ: เก็บใน localStorage ของ browser เท่านั้น ไม่บันทึกถาวรบน server
ตั้งค่า: Admin → Chat AI Endpoint, API Key, Model → ทดสอบ Chat AI
5. ประวัติรายงาน AI
แสดงรายการรายงาน AI (TXT/PDF) ที่ระบบสร้างไว้ ค้นหาจากชื่อไฟล์หรือ Study UID แล้วดาวน์โหลดได้
6. Export, Share Link และ QR
- Export ตาราง — CSV, JSON, XLSX จากหน้าแรก
- Export DICOM — ดาวน์โหลด Study เดี่ยวหรือหลายรายการที่เลือก
- Share Link — สร้างลิงก์แชร์มีวันหมดอายุ + QR สำหรับเปิดดูจากเครื่องอื่น
7. FTP Import สำหรับ ECG / ไฟล์ภาพ / PDF
เปิด FTP Server รับไฟล์จากเครื่อง ECG, Control, Fax หรืออุปกรณ์อื่น แล้วนำ DICOM/JPG/PNG/PDF เข้า Orthanc
ตั้งค่า: Admin → FTP Import → Host/Port/User/Password และโฟลเดอร์ incoming/processed/failed
แนะนำ port 2121 บน Windows และ host 0.0.0.0 เพื่อรับจาก LAN
ถ้าเปิด MOPH Imaging Hub ไว้ ระบบสามารถส่งไฟล์ที่รับผ่าน FTP เข้าหมอพร้อมอัตโนมัติได้
8. HOSxP X-Ray Worklist และ DICOM MWL
ดึงรายการสั่ง X-Ray จาก HOSxP ส่งต่อให้เครื่อง console ผ่านหน้าเว็บ, JSON/CSV API, ไฟล์ล่าสุด หรือ DICOM Modality Worklist (C-FIND)
- หน้า Worklist: /worklist/xray — ค่าเริ่มต้นแสดงวันนี้เท่านั้น
- รวม HN เดียวกัน: ชื่อรายการคั่นด้วย comma เช่น
Skull AP,Skull Lat - MWL SCP: ตั้ง IP/Port/AE ที่เครื่อง X-Ray Console ให้ตรงกับ Admin
- โปรแกรม GUI แยก:
mwl_scp_gui.pyสำหรับแพ็กใช้กับระบบอื่นโดยไม่ต้องเปิด Flask
9. ทดสอบ DICOM Modality Worklist (MWL)
หน้า /worklist/mwl-test ใช้ทดสอบ C-FIND ไปยัง MWL SCP โดยไม่ต้องใช้เครื่อง X-Ray จริง
กรอก: Server IP, Port, Called AE, Calling AE, วันที่ query, Modality, HN (ไม่บังคับ)
ผลลัพธ์: แสดงจำนวนรายการที่พบและรายละเอียด Patient ID, ชื่อ, Procedure, Accession
ใช้ตรวจว่า MWL SCP ทำงาน, port ไม่ถูกบล็อก และ AE Title ตรงกับที่ตั้งใน Admin
10. ส่งภาพเข้า MOPH Imaging Hub
ส่ง DICOM หรือ PNG เข้าคลังภาพหมอพร้อม ตามสเปก POST /ct/v1/import/dicom
ขั้นตอนตั้งค่า:
- Admin → เปิด MOPH Imaging Hub → เลือก UAT/PRD
- Login Provider ID OAuth หรือใส่ Provider Token ใน Admin
- ตั้ง Provider HCODE (5 หลัก) และ client-id / secret-key
- ระบบดึง CID จาก HOSxP ตาม HN อัตโนมัติ — หรือตั้ง Default CID สำรอง
วิธีส่งภาพ:
- หน้าแรก — เลือก Study → กด ส่งเข้า MOPH Imaging Hub
- FTP Import — ส่งอัตโนมัติเมื่อรับไฟล์ (ถ้าเปิดใช้)
- CLI —
python test_moph_upload.py path\to\file.dcm
สำคัญ: ฟิลด์ cid บังคับ 13 หลัก — ถ้าไม่มี CID ใน HOSxP การส่งจะล้มเหลวและเก็บ offline backup
11. MOPH Provider ID OAuth
หน้า /moph/provider-id ใช้ Login ผ่าน Provider ID เพื่อรับ Bearer Access Token สำหรับเรียก MOPH API
ตั้ง Client ID ใน Admin ก่อน → กด Login → ระบบ redirect กลับมาพร้อม token ที่บันทึกใน config
Token มีวันหมดอายุ — ถ้าส่งภาพไม่ได้ให้ login ใหม่
12. งานผู้ดูแลระบบ (Admin)
เข้า /admin ต้อง login ด้วยรหัส Admin ก่อน
- Orthanc — API URL, Viewer URL, ทดสอบการเชื่อมต่อ
- AI / Chat AI — Gemini, External Model, Chat endpoint
- FTP Import — รับไฟล์จากอุปกรณ์ภายนอก
- HOSxP Worklist — DB, MWL SCP, checkbox บันทึกอัตโนมัติ
- MOPH Imaging Hub — API, token, HCODE, ส่งอัตโนมัติ
- License — ตรวจสอบและ Gen license
- Storage Root — ตำแหน่ง config, data, logs, exports
- SQLite Index Sync — cache Studies ให้หน้าแรกโหลดเร็วขึ้น
- Migration Archive — restore ไฟล์เก่าจากการย้ายระบบ
Config หลัก: C:\XRAY_PACS\app_config.json
13. แก้ปัญหาเบื้องต้น
| อาการ | แนวทางแก้ไข |
|---|---|
| หน้าแรกไม่มีรายการ Study | ตรวจ Orthanc ทำงาน, API URL ถูกต้อง, กดทดสอบใน Admin, รัน Index Sync |
| เปิด Viewer ไม่ได้ | ตรวจ Orthanc Public Viewer URL — client ต้องเข้าถึง URL นั้นได้ |
| Worklist ยังเห็นเมื่อวาน | รีสตาร์ทโปรแกรม (rev 2) — ถ้าใช้ .exe ต้อง build ใหม่ |
| Console ดึง MWL ไม่ได้ | เปิด MWL SCP, ตรวจ port 11112, AE Title ตรงกัน, ทดสอบที่ ทดสอบ MWL |
| ส่ง MOPH ล้มเหลว missing cid | ตรวจ CID ใน HOSxP (patient/person) หรือตั้ง Default CID ใน Admin |
| MOPH 401 / 500 | Login Provider ID ใหม่, ตรวจ client-id/secret-key และ hospital-code |
| ตั้งค่าไม่จำ | ตรวจรันโปรแกรมตัวเดียวบนพอร์ต 5000, config ที่ C:\XRAY_PACS\app_config.json |
ติดต่อและสนับสนุน
พัฒนาโดย โรงพยาบาลสันติสุข จังหวัดน่าน | XROOT | 0877875854 | https://projectxshop.blogspot.com/