รายงาน PM ประจำปีสำหรับ HA¶

โมดูล รายงาน PM ประจำปีสำหรับ HA (roots_hemms_ha_report) สร้างรายงาน การบำรุงรักษาเชิงป้องกันประจำปีในรูปแบบราชการไทย ที่จำเป็นสำหรับการรับรอง คุณภาพ HA Thailand ภายใต้ มาตรฐานระบบบริการสุขภาพ ด้านที่ 6 ข้อ 6.1.4 (ทะเบียนครุภัณฑ์ + PM อิงความเสี่ยงพร้อมหลักฐานที่จัดทำเป็นเอกสาร)

โมดูลรวบรวมข้อมูล PM ที่บันทึกโดย roots_hemms_pm (Q1), จำแนกครุภัณฑ์ ทุกชิ้นเทียบกับ ตารางระดับความเสี่ยง 82 อุปกรณ์ของ MoPH และสร้าง PDF ที่ล็อกเมื่อ submit พร้อมภาคผนวกและหน้าลายเซ็นอิเล็กทรอนิกส์แบบสามผู้ลงนาม ที่ผ่านการกำหนดเส้นทางด้วย sign_oca (Q4)

ฟีเจอร์หลัก¶

1. หนึ่งรายงานต่อ (หน่วยงาน, ปีงบประมาณ)¶

แต่ละรายงานเป็น hemms.ha.report ที่มีเลขอ้างอิงแบบรันนิ่ง (HA/2026/00001) ครอบคลุมหนึ่งปีงบประมาณไทย (ปีงบประมาณ พ.ศ., ต.ค. → ก.ย.) และหนึ่งหน่วยงาน เงื่อนไข SQL unique จะป้องกันรายงานซ้ำสำหรับหน่วยงาน × ปี เดียวกัน

2. ข้อมูลตั้งต้นระดับความเสี่ยง 82 อุปกรณ์ของ MoPH¶

ตั้งแต่แกะกล่อง โมดูลมาพร้อม ชั้นความเสี่ยงเครื่องมือ (device class) ของเครื่องมือแพทย์ 82 ประเภท ที่ตั้งต้นจากเอกสารแนวทางจากแหล่งที่เชื่อถือ ได้ของ MoPH — แนวทางประเมินระดับความเสี่ยงของเครื่องมือแพทย์ฯ (พ.ศ. 2564) จัดพิมพ์โดยกองวิศวกรรมการแพทย์, กรมสนับสนุนบริการสุขภาพ แต่ละชั้นความเสี่ยง มีระดับตามทางการ (สูง / กลาง / ต่ำ), ความถี่ PM เป็นเดือน และระยะเวลา PM ที่แนะนำเป็นชั่วโมง

ข้อมูลตั้งต้นเป็น noupdate="1" ดังนั้นการแก้ไขของโรงพยาบาล (การเพิ่ม อุปกรณ์ในพื้นที่, การปรับความถี่) จะคงอยู่ตลอดการอัปเกรดโมดูล

3. ลำดับการประเมินความเสี่ยงสามขั้นบนครุภัณฑ์¶

maintenance.equipment ทุกชิ้นจะได้แท็บ Risk Assessment (HA) พร้อม เส้นทางการจำแนกสามทาง:

1. การกำหนดทับ (override) อย่างชัดเจน — วิจารณญาณของวิศวกร (ตรวจสอบได้)
2. ชั้นความเสี่ยงเครื่องมือ (device class) ของ MoPH — เชื่อมโยงชั้นจาก ข้อมูลตั้งต้น; ระดับความเสี่ยง + ความถี่จะถ่ายทอดมาโดยอัตโนมัติ
3. เวิร์กชีต EM-score — สำหรับครุภัณฑ์ที่ไม่อยู่ในรายการ ใช้สไลเดอร์ สี่ตัว (Function + Application + Maintenance + History) คำนวณตามโมเดล WHO Fennigkoh-Smith คะแนน ≤12 จะตัดออกจาก PM; 13–14→ ต่ำ, 1×/ปี; 15–18→ กลาง, 2×/ปี; ≥19→ สูง, 3×/ปี

เส้นทางที่เลือกจะถูกบันทึกใน roots_ha_risk_tier_source เพื่อให้ภาคผนวก ข ของรายงานสามารถพิสูจน์ที่มาของครุภัณฑ์แต่ละบรรทัดได้

4. วิซาร์ดสร้างด้วยคลิกเดียว¶

Maintenance → Reporting → Generate HA Annual PM Report:

1. เลือกปีงบประมาณ + หน่วยงาน
2. วิซาร์ดแสดงช่วงเวลาที่จับคู่ได้ + จำนวนครุภัณฑ์ที่อยู่ในขอบเขตแบบสด
3. คลิก Generate → ร่างรายงานที่เติมข้อมูลครบถ้วนจะถูกสร้างขึ้นโดยมีหนึ่ง บรรทัดต่อครุภัณฑ์หนึ่งชิ้น, pm_planned_count คำนวณจากความถี่, pm_actual_count นับจาก maintenance.request แบบ preventive ที่ปิดแล้ว ภายในกรอบปีงบประมาณ
4. วิศวกรตรวจสอบบรรทัด เติมเหตุผลข้อยกเว้นสำหรับรายการที่ยังไม่เสร็จ แล้ว submit

5. การล็อกเมื่อ submit เพื่อปกป้องได้ในการตรวจสอบ¶

action_submit() สร้างสแน็ปช็อต JSON ที่ไม่เปลี่ยนแปลง ซึ่งบรรจุข้อมูลที่ denormalised ของทุกบรรทัด, ตารางชั้นความเสี่ยงเครื่องมือ (device class) ของ MoPH ฉบับเต็ม ณ ขณะ submit และลายนิ้วมือ paperformat เทมเพลต QWeb อ่านจากสแน็ปช็อตสำหรับรายงานที่ submit/archive แล้ว — การพิมพ์ซ้ำของ ผู้ตรวจประเมินยังคง เหมือนกันทุกไบต์ แม้หลายปีต่อมา แม้ว่าข้อมูลครุภัณฑ์ หรือตาราง MoPH จะเปลี่ยนไป

การเขียน/ลบบรรทัดหลัง submit จะยก UserError การ Reset-to-Draft (เฉพาะผู้จัดการ) จะล้างสแน็ปช็อตและปลดล็อกเพื่อแก้ไขใหม่

6. ลายเซ็นอิเล็กทรอนิกส์ผ่านบริดจ์ Q4 sign_oca¶

ปุ่ม Send for Signature บนรายงานที่ submit แล้วจะสร้าง sign.oca.request พร้อมผู้ลงนามสามคน — หัวหน้า BME, หัวหน้าวิศวกรรม, ผู้อำนวยการโรงพยาบาล การตรวจสอบก่อนเริ่มจะปฏิเสธเมื่อช่องผู้ลงนามใดว่างเปล่า หรือไม่มีพาร์ตเนอร์เชื่อมโยง การลงนามจะเกิดขึ้นในระบบสำหรับผู้ลงนามภายใน หรือผ่านอีเมลพอร์ทัลสำหรับผู้อำนวยการ

เมื่อทั้งสามคนลงนาม การขยาย super _check_signed ของ Q5.9 จะเขียน PDF ที่ลงนามแล้วไปยัง roots_signed_pdf และโพสต์ไปยังแชตเตอร์ (chatter) ป้ายในส่วนหัวจะเปลี่ยนจาก 🟡 รอลงนาม เป็น 🟢 ลงนามครบ สถานะยังคง เป็น submitted — การลงนามเป็นแง่มุมคู่ขนาน ไม่ใช่การเปลี่ยนสถานะ (ตรงกับ การตัดสินใจ OQ3 ของลายเซ็นอิเล็กทรอนิกส์ Q4)

7. PDF รูปแบบราชการไทย¶

เทมเพลต QWeb เรนเดอร์ 7 ส่วน, A4 แนวตั้ง, TH Sarabun:

1. ปก — หน่วยงาน, ปีงบประมาณ, ช่วงเวลา, เลขอ้างอิง, สถานะ
2. บทสรุปผู้บริหาร — ครุภัณฑ์ทั้งหมด, จำนวนตามระดับความเสี่ยง, PM ตามแผน เทียบกับทำจริง, % การปฏิบัติตามแผน
3. ตารางครุภัณฑ์ + ผลการบำรุงรักษา — รายละเอียดต่อครุภัณฑ์ 11 คอลัมน์
4. รายการครุภัณฑ์ที่ไม่ได้ทำตามแผน — ข้อยกเว้นพร้อมเหตุผล (เรนเดอร์ เฉพาะเมื่อมีบรรทัดที่เป็น fail/not_done)
5. ภาคผนวก ก — ตารางการจำแนก 82 อุปกรณ์ของ MoPH
6. ภาคผนวก ข — เวิร์กชีต EM-score สำหรับครุภัณฑ์ที่ใช้เส้นทาง EM (เรนเดอร์เฉพาะเมื่อมีกรณีนี้)
7. หน้าลงนาม — กล่องลายเซ็นว่างสไตล์กระดาษเมื่อยังไม่ลงนาม; แบนเนอร์ 🟢 ลงนามครบ เมื่อตั้งค่า PDF ที่ลงนามแล้ว

เมื่อใดควรใช้โมดูลนี้¶

• จำเป็นสำหรับการรับรองคุณภาพ HA Thailand ผู้ตรวจประเมินจะขอเอกสารนี้ ในวันแรกของการเยี่ยมประเมิน HA
• ใช้คู่กับรายงานการตรวจสอบครุภัณฑ์ ปจป. ที่มีอยู่ ทั้งสองรวมกันครอบคลุม สิ่งประดิษฐ์ด้านการปฏิบัติตามข้อกำหนดสิ้นปีทั้งสองอย่างที่โรงพยาบาลรัฐไทย ต้องจัดทำ — หลักฐานทะเบียนครุภัณฑ์ (ปจป.) และหลักฐาน PM (HA ประจำปี)
• แทนที่การกระทบยอด Excel ด้วยมือ 2–4 สัปดาห์ ต่อปี ต่อหน่วยงาน

แหล่งที่เชื่อถือได้¶

แนวทางประเมินระดับความเสี่ยงของเครื่องมือแพทย์ที่ต้องการการบำรุงรักษา และกำหนดความถี่ในการตรวจสอบและบำรุงรักษาเชิงป้องกันตามรอบเวลา (พ.ศ. 2564) — กองวิศวกรรมการแพทย์, กรมสนับสนุนบริการสุขภาพ, กระทรวงสาธารณสุข, พัฒนาร่วมกับบริษัท อาร์เอฟเอส (รามาธิบดี / ม.มหิดล) และ ECRI APAC

Dependency ของโมดูล¶

License: LGPL-3 ครอบ AGPL-3 แบบ transitive (sign_oca ผ่าน Q4) รูปแบบขอบเขตเดียวกันกับ Q2/Q3/Q4

ขั้นตอนถัดไป¶

• เริ่มต้นใช้งาน — รายงานแรกใน 5 นาที
• การกำหนดค่า — การตั้งค่าระดับความเสี่ยง + การแก้ไข MoPH
• เวิร์กโฟลว์ — วงจรชีวิต + การลงนาม + การปฏิเสธ
• การออกรายงาน — กายวิภาคของ PDF + วิธีพิมพ์ซ้ำ