Clinical App Mini-Project — ผู้ช่วยคัดกรองช่องทาง ER/OPD

เปิดใช้งานระบบ

เว็บแอปทำงานได้จริงบนมือถือ/แท็บเล็ต ไม่ต้องติดตั้งอะไร

ปัญหาที่แก้ (ต่อเนื่องจาก Problem Statement วิชา 3)

พยาบาลคัดกรองหน้าห้องฉุกเฉินต้องจัดระดับความเร่งด่วน 1–5 ภายในไม่กี่นาที โดยเทียบเกณฑ์ 30 ข้อและรายการทรัพยากร 16 รายการจากความจำ และระดับที่ให้กำหนดช่องทาง ER หรือ OPD โดยอัตโนมัติ เคสก้ำกึ่งที่รอยต่อระดับ 2/3 จึงมักถูกดันขึ้นเพื่อความปลอดภัย ทำให้ผู้ป่วยที่ควรไป OPD ไหลเข้า ER

ระบบนี้เสนอระดับและช่องทาง พร้อมแสดงข้อเกณฑ์ที่เข้า/ไม่เข้าเป็นรายข้อ โดยพยาบาลเป็นผู้ตัดสินสุดท้ายเสมอและ override ได้ทุกครั้ง

ฟีเจอร์ที่ทำงานจริง

• รับข้อมูลแบบแตะเลือก — อาการนำ · อายุ (ปี/เดือน) · GCS · สัญญาณชีพ · pain score พร้อมตรวจค่าที่เป็นไปไม่ได้ (เช่น ชีพจร 400) ก่อนประเมิน
• Criteria engine เดินตาม 4 จุดตัดสินใจ ก–ง ของคู่มือ MOPH ED Triage 2561 ผลลัพธ์ deterministic — ใส่ข้อมูลเดิมได้คำตอบเดิมเสมอ ไม่มีการสุ่ม ไม่เรียก AI
• อ้างเกณฑ์รายข้อพร้อมเลขหน้าคู่มือ และแยกให้เห็น 3 กลุ่ม: เข้าเกณฑ์ · ตัดสินไม่ได้เพราะข้อมูลไม่ครบ · ไม่เข้าเกณฑ์
• สลับชุดเกณฑ์ได้โดยไม่แก้โค้ด — มีให้เลือก 2 ชุด (ฉบับคู่มือ และฉบับโรงพยาบาลที่ใช้จุดตัดตามอายุ) หรือโหลดไฟล์ .json ของโรงพยาบาลเองเข้ามา
• ยืนยัน / override พร้อมเหตุผล → บันทึกผู้บันทึกและเวลา และสรุปอัตราการแก้ระดับ (ดันขึ้น/ลดลง) · เก็บผลล่าสุด ยังไม่เก็บประวัติการแก้ซ้ำ
• ตารางเคส + ส่งออก CSV (UTF-8 BOM เปิดใน Excel ภาษาไทยไม่เพี้ยน)
• Known-Answer Test ในตัว 29 เคส — รวมตัวอย่างที่คู่มือเฉลยไว้เอง

ที่มาของเกณฑ์

ชุดหลัก: กรมการแพทย์ กระทรวงสาธารณสุข. MOPH ED. TRIAGE. พิมพ์ครั้งที่ 1 (2561) — แปลจาก ESI ใช้ 4 หัวข้อเป็นจุดตัด (ถอดความจาก text layer ของเล่ม พร้อมเลขหน้ากำกับทุกข้อ)

ชุดฉบับโรงพยาบาล: ชุดหลัก + จุดตัดตามอายุจาก วิธีปฏิบัติ PMK-WND-037 การคัดกรองผู้ป่วยนอก รพ.พระมงกุฎเกล้า (2561) — ระบุที่มารายข้อในแอป

เหตุผลที่ต้องมี 2 ชุด: คู่มือ MOPH ใช้เกณฑ์ shock SBP < 90 เท่ากันทุกช่วงอายุ ถ้าใช้ตรงตัวกับทารกจะได้ระดับ 1 แทบทุกราย — แอปแสดงผลตามที่คู่มือเขียนโดยไม่แก้ให้เอง แต่เปิดให้สลับไปใช้ชุดที่มีจุดตัดตามอายุได้ (ดูเคส 20b เทียบ 20c ในแท็บทดสอบ)

ไฟล์ในโปรเจกต์

• P49-triage.html — ตัวแอป
• engine.js — criteria engine รับเกณฑ์เป็นข้อมูล ยกเว้นสูตรจุดตัด shock ตามอายุจาก PMK-WND-037 ที่ชุดฉบับโรงพยาบาลเรียกใช้
• criteria-moph-2561.json · criteria-moph-2561-local.json — ชุดเกณฑ์
• kat-cases.js — ชุดทดสอบ 29 เคส (ใช้ร่วมกันทั้งในแอปและใน node test-engine.js)
• test-engine.js — ชุดตรวจ 58 ข้อ รันด้วย Node
• supabase-data.js — ชั้นข้อมูล Supabase (CRUD ครบสี่คำสั่งบนตารางจริง)
• supabase-w6-additions.sql — policy update/delete + trigger สร้าง profiles
• supabase-w7-hardening.sql — กันผู้ใช้แก้บทบาท/หน่วยงานตัวเอง + อ่านเคสหน่วยเดียวกันได้จริง พร้อมชุดทดสอบ

วิชา 5 — Database Schema Design

ERD 9 ตารางที่ถอดมาจากแอปนี้ พร้อมคำอธิบาย relationship / data type / RLS และไฟล์ SQL ที่พร้อมรันใน Supabase SQL Editor (มี seed ชุดเกณฑ์จริงทั้ง 2 ฉบับ)

วิชา 5 Part 2 — Frontend–Backend Integration

แอปเชื่อม Supabase (PostgreSQL) ผ่าน client SDK แล้ว ทำ CRUD ครบสี่คำสั่งบนตารางจริงตาม ERD:

• POST บันทึกเคส → cases → assessments → assessment_criteria → overrides
• GET อ่านเคสพร้อมข้อมูลผู้ป่วย เกณฑ์ที่เข้า และการแก้ระดับ ในคำขอเดียว
• PUT แก้ระดับที่ตัดสินจริงและเหตุผลในตาราง overrides
• DELETE ลบเคส โดย assessments / criteria / overrides หายตาม cascade

ความปลอดภัยหลายชั้น: Supabase Auth → RBAC จากคอลัมน์ role ใน profiles → validation ทั้งฝั่งหน้าเว็บและ CHECK constraint → RLS ทุกตาราง เทียบ auth.uid() กับเจ้าของแถว

กุญแจ: ค่าเชื่อมต่ออยู่ใน supabase-config.js ในรีโป — เป็น anon/publishable key ที่ออกแบบให้เปิดเผยฝั่ง client ได้ เพราะเปิด RLS ครบทุกตาราง (ยังไม่ล็อกอิน = อ่านไม่ได้เลย) · ผู้ที่ล็อกอินแก้บทบาทหรือหน่วยงานของตัวเองไม่ได้ ปรับแล้ว 23 ก.ย. ใน supabase-w7-hardening.sql · service_role key ไม่อยู่ในรีโปและห้ามใช้ฝั่งหน้าเว็บ · หน้าเว็บสาธารณะนี้จึงสาธิต CRUD บนฐานข้อมูลจริงได้เมื่อเข้าสู่ระบบ

ข้อมูลส่วนบุคคลและความยินยอม

ไม่ล็อกอิน: เคสอยู่ใน localStorage ของเบราว์เซอร์เครื่องนั้นเท่านั้น

ล็อกอิน: แอปจะส่งเคสเข้า Supabase ภูมิภาค Singapore เมื่อผู้ใช้อ่านข้อมูลที่เก็บ ติ๊กยินยอมข้อ 1–2 และตอบคำถามตรวจความเข้าใจแล้ว · ข้อ 3–4 เลือกได้ ให้หรือถอนด้วยคลิกเดียว · ถอนข้อ 1–2 ด้วยปุ่มเดียวแล้วออกจากระบบ · บันทึกเวอร์ชันและเวลาของการให้หรือถอน 10 ครั้งล่าสุดไว้กับบัญชี · ตัวกั้นนี้อยู่ที่หน้าแอป ฐานข้อมูลยังไม่ตรวจความยินยอมเอง

ผู้รับผิดชอบ: นพ.กิตติพศ เกียรติพัฒนาชัย ผู้พัฒนา · ขอลบบัญชีหรือแจ้งเหตุผ่าน GitHub Issues โดยไม่ใส่ข้อมูลส่วนบุคคล

เอกสารโครงการ

• README — สรุป 1 หน้า
• docs/TECHNICAL.md — สถาปัตยกรรม เกณฑ์ ฐานข้อมูล
• docs/PRODUCTION-PLAN.md — ถ้าจะใช้จริงต้องเปลี่ยนอะไร + แผนรับมือแพลตฟอร์มล่ม
• docs/DEVLOG.md — บันทึกการพัฒนาแบบ PDCA
• docs/W7-CHECKLIST.md — เช็คลิสต์ 43 ข้อของวิชา 7 พร้อมหลักฐาน

ประวัติเวอร์ชัน

• 1.2.1 · 23 ก.ย. 2569 — แก้ตามผลตรวจ Codex รอบ 3: คำขอบันทึกความยินยอมที่ค้างในคิวไม่เขียนลงบัญชีอื่น · ตรวจความยินยอมซ้ำก่อนบันทึกเคส · ผลประเมินระบุข้อส่วนขยาย รพ. แยกจากเลขหน้าคู่มือ · ลิงก์ #test เปิดแท็บทดสอบ
• 1.2.0 · 23 ก.ย. 2569 — แจ้งข้อมูลที่เก็บ + แบบขอความยินยอม v1.0 ก่อนล็อกอิน ไม่บันทึกลงฐานข้อมูลถ้ายังไม่ยินยอม · เลขเวอร์ชันบนหน้าแอป · README 1 หน้า + เอกสารใน docs/
• 1.1.0 · 12 ก.ย. 2569 — เชื่อม Supabase ครบ CRUD สี่คำสั่ง + RLS ทุกตาราง (วิชา 5 Part 2)
• 1.0.0 · 3 ก.ย. 2569 — Clinical App Mini-Project: criteria engine + ชุดเกณฑ์ 2 ฉบับ + ชุดทดสอบ (วิชา 4)