ระบบติดตาม %CV POCT Glucose – รพ.ศรีนครินทร์

เว็บ dashboard ติดตามค่า %CV ของการทำ IQC (L1 / L2) เครื่อง ACCU-Chek Inform II แยกตามหอผู้ป่วย เกณฑ์ผ่าน: %CV < 6.7 (แก้ได้ที่ชีต Config → cv_threshold)

Google Sheet (ฐานข้อมูล) ←→ Apps Script (ตัวอ่าน/เขียนชีต) ←→ Vercel Functions /api (เก็บรหัสผ่าน) ←→ เว็บ static (Dashboard / Admin)

ไฟล์	หน้าที่
index.html + js/dashboard.js	Dashboard: (1) แท่งร้อยละที่ผ่านต่อเดือน (2) กราฟเส้น %CV รายหอ (3) ตารางรายละเอียด + กดดูรายหอ, ตัวกรอง L1 / L2 / รวม
admin.html + js/admin.js	หน้า admin: ฟอร์มบันทึก/แก้ไข %CV รายเดือน (วางจาก Excel ได้), เพิ่ม/แก้ไขหอและเครื่อง
apps-script/Code.gs	Backend ที่ผูกกับ Google Sheet
api/data.js, api/admin.js	Vercel Functions: อ่านข้อมูล และรับคำสั่งบันทึก (ตรวจ ADMIN_PASSWORD ที่นี่)
config.js	ตั้งค่าฝั่งเว็บ (API_BASE: "/api") – ไม่มีความลับ
data/seed.json	ข้อมูลสำรอง (Excel ปี 2568–2569) ใช้แสดงผลเมื่อยังไม่ได้ตั้งค่า API
tools/convert.py	สคริปต์แปลง Excel รายปี → ข้อมูลแบบ long (ใช้ซ้ำได้)

ขั้นตอนติดตั้ง (ทำครั้งเดียว ~10 นาที)

1) Google Sheet

ใช้ชีต "POCT Glucose %CV – รพ.ศรีนครินทร์ (ฐานข้อมูล)" ที่สร้างไว้แล้ว มี 3 ชีต

• Data – 1 แถว = 1 เครื่อง × 1 เดือน: month (YYYY-MM ค.ศ.), device, L1, L2, note, updated_at
• Wards – no, ward, device, active
• Config – cv_threshold = 6.7

2) Apps Script (ตัวอ่าน/เขียนชีต)

1. เปิดชีต → เมนู ส่วนขยาย > Apps Script วางโค้ดจาก apps-script/Code.gs (ทับของเดิมทั้งหมด) → บันทึก
2. เลือกฟังก์ชัน setup → Run (อนุญาตสิทธิ์ครั้งแรก)
3. เลือกฟังก์ชัน createApiKey → Run → คัดลอกค่าที่ขึ้นใน "บันทึกการดำเนินการ" (คือ API_KEY ที่ถูกสร้างใน Script properties แล้ว; จะตั้งเองที่ Project Settings > Script properties ก็ได้)
4. Deploy > Manage deployments > ✏ Edit > Version: New version > Deploy (หรือ New deployment ถ้ายังไม่เคย) — Execute as: Me, Who has access: Anyone แล้วคัดลอก URL /exec

ทุกครั้งที่แก้ Code.gs ต้อง Deploy เป็น New version URL เดิมจึงจะใช้โค้ดใหม่

3) Vercel Environment Variables

Vercel → Project → Settings > Environment Variables (เลือก Production และ Preview) เพิ่ม 3 ตัว:

Name	ค่า
ADMIN_PASSWORD	รหัสผ่านเข้าหน้า admin
APPS_SCRIPT_URL	URL /exec ของ Apps Script
APPS_SCRIPT_KEY	ค่าเดียวกับ API_KEY ใน Script properties

จากนั้น Deployments > ⋯ > Redeploy เพื่อให้ค่าใหม่มีผล

• Dashboard: https://<project>.vercel.app/
• Admin: https://<project>.vercel.app/admin

เหตุผลที่ต้องมี API_KEY: URL ของ Apps Script เปิดแบบ Anyone จึงต้องมีคีย์ลับที่รู้กันเฉพาะ Vercel กับ Apps Script ไม่ให้คนนอกเรียกอ่าน/เขียนชีตตรงๆ ได้ ส่วนรหัสผ่านแอดมินอยู่ที่ Vercel ที่เดียว

วิธีใช้งานประจำเดือน

1. เข้า /admin ใส่รหัสผ่าน
2. เลือกเดือน (ค่าเริ่มต้นคือเดือนถัดจากเดือนล่าสุดที่มีข้อมูล)
3. กรอก L1/L2 ของแต่ละเครื่อง หรือคัดลอก 2 คอลัมน์ (L1, L2) จาก Excel มาวางที่ช่อง L1 แถวแรก
4. เครื่องที่ปิดปรับปรุง/ไม่ได้ตรวจ ให้ติ๊ก "ปิด/ไม่ได้ตรวจ"
5. กด บันทึก – ข้อมูลเข้า Google Sheet และ dashboard อัปเดตทันที (เลือกเดือนเดิมเพื่อแก้ไขได้)

ปีงบประมาณใหม่ไม่ต้องตั้งค่า: ระบบคำนวณจากเดือน (ต.ค.–ก.ย., พ.ศ. = ค.ศ. ของเดือนที่ ≥ ต.ค. + 1 + 543) หอ/เครื่องใหม่: แท็บ "หอผู้ป่วย / เครื่อง" → เพิ่มแล้วจะปรากฏในฟอร์มรายเดือนทันที

นิยามการนับ "ผ่านเกณฑ์"

• ผ่าน = %CV < 6.7 (เท่ากับ 6.7 ถือว่าไม่ผ่าน)
• L1 / L2 = นับเฉพาะระดับนั้น · รวม = เครื่องผ่านเมื่อ ทั้ง L1 และ L2 ผ่านพร้อมกัน
• ร้อยละ = เครื่องที่ผ่าน ÷ เครื่องที่มีข้อมูลในเดือนนั้น (เดือนที่ปิดปรับปรุง/ไม่มีค่า ไม่นับในตัวหาร)

หมายเหตุข้อมูลที่แปลงจาก Excel

• 67 หอ/เครื่อง × 24 เดือน (ต.ค. 67 – ก.ย. 69) = 1,608 แถว
• พบค่าพิมพ์ผิดในต้นฉบับ 2 จุด แก้เป็นค่าที่น่าจะถูกและใส่หมายเหตุในคอลัมน์ note: 6..64 → 6.64 (PICU มี.ค. 68, L1) และ 1..17 → 1.17 (สว.9A(2) มิ.ย. 69, L2) โปรดตรวจกับใบรายงานจริง
• เซลล์ "ปิดปรับปรุงหอผู้ป่วย" เก็บเป็นค่าว่าง + หมายเหตุ

ความปลอดภัย

• ADMIN_PASSWORD, APPS_SCRIPT_URL, APPS_SCRIPT_KEY อยู่ใน Vercel Environment Variables เท่านั้น ไม่อยู่ในโค้ด/GitHub/ชีต; เบราว์เซอร์ไม่เห็น URL หรือคีย์ของ Apps Script
• Apps Script ปฏิเสธทุกคำขอที่ไม่มี API_KEY ที่ถูกต้อง (ทั้งอ่านและเขียน) · /api/admin ตรวจรหัสผ่านแบบ timing-safe และหน่วง 0.8 วินาทีเมื่อรหัสผิด
• Dashboard เปิดอ่านได้สำหรับทุกคนที่มีลิงก์เว็บ (ข้อมูลเป็นค่า QC รายหอ ไม่มีข้อมูลผู้ป่วย) ถ้าต้องจำกัด ให้เปิด Vercel Authentication / Password Protection ที่ตัวโปรเจกต์
• รัน/ดูตัวอย่างในเครื่อง: เปิดไฟล์โดยตั้ง API_BASE: "" จะแสดงข้อมูลสำรองจาก data/seed.json (บันทึกข้อมูลไม่ได้)

ND (Not Done)

ช่องที่ไม่ได้ทำ QC ให้ใส่ ND ในคอลัมน์ note ของชีต Data (หรือติ๊ก ND ในหน้า Admin) – ND ไม่นำมาคำนวณ ร้อยละที่ผ่านเกณฑ์/ตัวหาร แต่นับว่า “บันทึกแล้ว” และแสดงเป็น ND ใน heatmap

แก้ UI (Tailwind + daisyUI + Lucide)

ไฟล์ที่ build แล้ว (css/tw.css, img/icons.svg) ถูก commit ไว้ Vercel ไม่ต้อง build. แก้สไตล์/ไอคอนแล้วรัน cd tools/ui && npm install && npm run build

อัปเดตรอบที่ 2 (ต้องทำที่ Apps Script)

1. วาง apps-script/Code.gs ใหม่ → รัน setup() อีกครั้ง (สร้างคอลัมน์ group ใน Wards, แถว target_pass_pct ใน Config, ชีต Log)
2. Deploy > Manage deployments > แก้ไข > New version
3. ตั้งกลุ่มหอในหน้า Admin (แท็บ หอผู้ป่วย/เครื่อง) → Dashboard จะมีตัวกรองและการ์ดสรุปรายกลุ่ม
4. เปลี่ยนเป้าหมายร้อยละที่ผ่านเกณฑ์ได้ที่ชีต Config (target_pass_pct, ค่าเริ่มต้น 95)
5. ประวัติการแก้ไขอยู่ในแท็บ “ประวัติการแก้ไข” (บันทึกเริ่มหลังอัปเดตนี้)
6. /api/admin ล็อก IP 15 นาที หากใส่รหัสผ่านผิด 5 ครั้ง

โหมดตัวอย่าง

ถ้าเชื่อม Google Sheet ไม่ได้ หน้า Dashboard จะแจ้งข้อผิดพลาดและไม่แสดงข้อมูลเก่าแทน (ป้องกันการเข้าใจผิด) · ต้องการดูข้อมูลตัวอย่างจากไฟล์ Excel ให้เปิด /?demo=1

บัญชีผู้ใช้ (แยกรายคน)

ตั้งที่ Vercel > Settings > Environment Variables:

• ADMIN_USERS = ชื่อ1:รหัสผ่าน1,ชื่อ2:รหัสผ่าน2 เช่น mook:xxxxxxxx,somchai:yyyyyyyy (ชื่อใช้ภาษาอังกฤษ ไม่สนตัวพิมพ์ใหญ่เล็ก · รหัสผ่านห้ามมีเครื่องหมาย ,)
• เมื่อตั้ง ADMIN_USERS แล้ว ADMIN_PASSWORD เดิมจะไม่ถูกใช้ (ลบทิ้งได้) · แก้ env แล้วต้อง Redeploy
• ชีต Log คอลัมน์ G (user) บันทึกชื่อผู้แก้ไขทุกครั้ง (ต้องวาง Code.gs ใหม่ + Deploy New version)

หัวข้อวิเคราะห์ / สรุปประชุม

• หัวข้อ 4: กราฟ L1×L2 (แยกต้นเหตุ), หอที่ดีขึ้น/แย่ลง, เครื่องที่ %CV แกว่งมาก, ปฏิทินความครบถ้วน
• ปุ่ม “สรุปประชุม 1 หน้า” → หน้า A4 แนวนอน 1 หน้า พร้อมรายชื่อหอที่ต้องดำเนินการ (พิมพ์/บันทึก PDF ได้)