คู่มือใช้งาน SCPACS

SCPACS — SCK Studies Explorer ระบบจัดการภาพและข้อมูลตรวจจาก Orthanc สำหรับโรงพยาบาล รองรับ AI วิเคราะห์ภาพ, Worklist จาก HOSxP, ส่งภาพเข้า MOPH Imaging Hub และ DICOM Modality Worklist

Worklist config rev 2 · อัปเดต 2026-06-17

เริ่มต้นใช้งานอย่างรวดเร็ว

  1. ติดตั้งและเปิด Orthanc PACS ให้ API ทำงานได้ (ค่าเริ่มต้น http://127.0.0.1:8042)
  2. เข้า จัดการระบบ → ตั้ง Orthanc API URL และ Orthanc Public Viewer URL → กดทดสอบการเชื่อมต่อ
  3. เปิด หน้าแรก จะเห็นรายการ Studies — กดเปิด Viewer หรือวิเคราะห์ AI ได้ทันที
  4. (ถ้าใช้ Worklist) ตั้งค่า HOSxP ใน Admin → เปิด MWL SCP → ทดสอบที่ ทดสอบ MWL
  5. (ถ้าส่งหมอพร้อม) 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-idLogin รับ 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

ขั้นตอนตั้งค่า:

  1. Admin → เปิด MOPH Imaging Hub → เลือก UAT/PRD
  2. Login Provider ID OAuth หรือใส่ Provider Token ใน Admin
  3. ตั้ง Provider HCODE (5 หลัก) และ client-id / secret-key
  4. ระบบดึง 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

คู่มือ MOPH Imaging Hub ฉบับเต็ม
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/