แผน Q2 — roots_hemms_spare_parts (Final 1.0)¶

เวอร์ชันแผน: Final 1.1 — Q2.1–Q2.8 commit แล้ว 2026-05-22 อนุมัติ: 2026-05-22 Module ID: roots_hemms_spare_parts Layer: 3 (เลนส์โรงพยาบาล) — ห่อหุ้มโมดูล OCA Layer 2 maintenance_stock สถานะ: Q2.1–Q2.8 ✅ commit แล้ว | Q2.9–Q2.11 ค้างอยู่

0. บทสรุปผู้บริหาร¶

สิ่งที่เราสร้าง: โมดูลอะไหล่สไตล์โรงพยาบาลบนฐานของ OCA maintenance_stock ซึ่ง (a) ให้ maintenance.equipment แต่ละตัวมี เทมเพลตอะไหล่ที่กรองได้, (b) สร้างร่าง stock.picking อัตโนมัติ เมื่อ PM cron สร้างคำขอ, และ © ให้ช่างเทคนิคมีมุมมองเฉพาะ "My Open Requests" เพื่อติดตาม picking ที่ค้างอยู่ของตน พร้อม เลข Stock Request แบบรันนิ่ง

ทำไม: OCA maintenance_stock ให้ลิงก์ picking↔request แต่ จงใจเว้นช่องว่างสามจุดที่สำคัญต่อ UX ของโรงพยาบาล — ไม่มีเทมเพลตการใช้สิ้นเปลือง, ไม่มีการสร้าง picking อัตโนมัติ, ไม่มี การติดตามแบบงานซ่อมบำรุง เราเติมเต็มทั้งสามจุดที่ Layer 3

ความพยายาม: 11 commit / ~3 เซสชันพัฒนา, เป้าหมายการทดสอบ 26 รายการ, เอกสาร 5 หน้า

ชัยชนะหลัก (จัดลำดับตามผลกระทบ):

1. ⭐ สร้างร่าง picking อัตโนมัติบน PM cron (Q2.6) — ช่างคลิก Validate ไม่ใช่ New
2. ⭐ มุมมอง My Open Requests (Q2.8) — ติดตามแบบบริการตนเองด้วย Running No SR/2026/00001
3. ⭐ ตัวกรองชนิด PM บนเทมเพลต (Q2.4) — เฉพาะอะไหล่ที่เกี่ยวข้องตามชนิดงานซ่อมบำรุง

License: LGPL-3 เหนือ dependency แบบ AGPL-3 — เข้ากันได้ที่การแจกจ่าย

สถานะของคำถามที่ยังเปิด: ไม่มีเหลือ (ล็อกทั้งหมดใน §2)

1. วัตถุประสงค์¶

ช่างเทคนิค BME ของโรงพยาบาลจำเป็นต้องรู้ว่า เครื่องมือแพทย์ชิ้นหนึ่ง ๆ อาจต้องใช้อะไหล่ใดระหว่างการซ่อม/PM — แล้วติดตามแต่ละคำขอจนเสร็จสิ้น — โดยไม่ต้องท่องจำ SKU หรือถามวิศวกรอาวุโส โมดูลนี้ มอบเทมเพลตอะไหล่ที่กำหนดค่าได้ให้ข้อมูลหลักของเครื่องมือแพทย์ ซึ่ง ไหลเข้าสู่ร่าง picking โดยอัตโนมัติเมื่อเปิดคำขอซ่อมบำรุง พร้อม มุมมองติดตามเฉพาะเพื่อติดตามผล

ขอบเขต — ที่รวม¶

• Vendor OCA maintenance_stock (ข้อกำหนดเบื้องต้น Layer 2)
• โมเดลใหม่ hemms.equipment.spare.line (o2m บน maintenance.equipment)
• roots_is_critical_spare + roots_name_th บน product.template
• name_get สองภาษาเพื่อให้ค้นหาชื่อทั้ง EN และ TH ได้
• qty_available แบบ inline + ป้ายระดับวิกฤตในมุมมองเทมเพลต
• แพร่ระดับความวิกฤตของเครื่องมือแพทย์ (สีแดง) → line roots_is_critical โดยอัตโนมัติ
• กิจกรรมแจ้งสต็อกต่ำสำหรับอะไหล่วิกฤต
• สร้างร่าง picking อัตโนมัติ บน PM cron, กรองตามชนิดของคำขอ
• ร่าง picking ยังคงแก้ไขได้เต็มที่ (เพิ่ม / ลบ / เปลี่ยนจำนวน) จนกว่าจะ validate — ยืนยันในพฤติกรรม Q2.6
• ปุ่มสถิติสรุปอะไหล่บนฟอร์มเครื่องมือแพทย์
• เลขรันนิ่ง Stock Request roots_request_no ผ่าน ir.sequence รหัส hemms.stock.request (prefix กำหนดค่าได้ผ่าน UI, ค่าเริ่มต้น SR/%(year)s/ padding 5 → SR/2026/00001)
• มุมมองติดตาม Stock Request (List / Form / Kanban) พร้อมฟิลด์คำนวณ เปิด/ค้าง — หน้าเริ่มต้น = "My Open Requests"
• ปุ่มสถิติ "Pending Items" บนฟอร์ม maintenance.request

ขอบเขต — ที่ตัดออก (เลื่อนออกไป)¶

• ❌ ปักหมุด "Used last time" (F4) — Q3
• ❌ ฝัง move-line แบบหน้าเดียวในฟอร์มคำขอ (S5) — Q3
• ❌ วิซาร์ด "Copy from similar equipment" (S6) — Q3
• ❌ ตัวป้องกันความเข้ากันได้ผ่าน product brand m2m (S4) — Q3
• ❌ จองสต็อกอัตโนมัติเมื่อเปลี่ยน stage (A2) — Q3
• ❌ คืน picking อัตโนมัติเมื่อยกเลิกคำขอ (A3) — Q3
• ❌ ติดตามที่มาของ line "manual vs template" — Q3 analytics
• ❌ เรียนรู้จำนวนอัตโนมัติ (A5), แจ้งเตือนต้นทุนแผนก (A7) — Q4+
• ❌ การกำหนดเส้นทางหลายคลัง, ระบบอัตโนมัติ PO

2. การตัดสินใจด้านการออกแบบ (ล็อกแล้ว)¶

3. โมเดลข้อมูล¶

maintenance.equipment (inherit)
  ├─ roots_auto_generate_picking (Boolean, default by allow_consumptions)
  ├─ roots_spare_line_ids (o2m → hemms.equipment.spare.line)
  └─ roots_spare_line_count (Integer, computed)

hemms.equipment.spare.line (NEW)
  ├─ equipment_id (m2o → maintenance.equipment, ondelete=cascade)
  ├─ product_id (m2o → product.product, ondelete=restrict)
  ├─ default_qty (Float, default 1.0)
  ├─ kind_ids (m2m → maintenance.kind)         ⭐ filter axis
  ├─ position_note (Char)
  ├─ roots_is_critical (Boolean, computed+stored, writable)
  ├─ qty_available (Float, related, readonly)
  └─ sequence (Integer)

product.template (inherit)
  ├─ roots_is_critical_spare (Boolean)
  └─ roots_name_th (Char)

stock.picking (inherit — Stock Request tracking)
  ├─ roots_request_no (Char, readonly, copy=False, index=True, tracking=True)
  ├─ roots_is_open (Boolean, computed+stored)
  ├─ roots_pending_line_count (Integer, computed)
  ├─ roots_qty_progress (Float, computed)        sum(quantity)/sum(uom_qty)*100
  ├─ roots_pending_qty_total (Float, computed)
  └─ roots_scheduled_overdue (Boolean, computed)

ir.sequence (data record, NOT hardcoded)
  ├─ code   : "hemms.stock.request"
  ├─ name   : "HEMMS Stock Request"
  ├─ prefix : "SR/%(year)s/"
  ├─ padding: 5
  └─ company_id: False

4. แผนการพัฒนา (11 ขั้นตอน)¶

Dependencies: maintenance_stock (OCA — ต้อง vendor), roots_hemms_pm, roots_hemms_asset_master, roots_hemms_criticality, stock, mail

5. ข้อกำหนดมุมมอง (รายละเอียด Q2.8)¶

5.1 โครงสร้างเมนู¶

Maintenance
└─ Operations
   └─ Stock Requests (ใบเบิก)
      ├─ My Open Requests          ← default landing (D7)
      ├─ All My Requests
      ├─ Team Open
      └─ Backorders
└─ Configuration
   └─ Stock Request Sequence       ← ir.sequence shortcut

5.2 มุมมอง List (ค่าเริ่มต้น = My Open Requests)¶

• ตัวกรองเริ่มต้น: state ∉ done/cancel AND ของฉัน
• จัดกลุ่มเริ่มต้นตาม: State
• การตกแต่ง: แถวเป็นสีแดงเมื่อ roots_scheduled_overdue=True

5.3 มุมมอง Form — แท็บ notebook "Pending Items"¶

• ตัวกรอง: แสดงเฉพาะ move ที่ state ∉ (done, cancel)
• ส่วนหัวแสดง roots_request_no อย่างเด่นชัด + ป้าย state + แถบความคืบหน้า

5.4 มุมมอง Kanban¶

• คอลัมน์ตาม state: Draft / Waiting / Ready / Partial / Done (ซ่อนคอลัมน์ Partial โดยค่าเริ่มต้น)
• การ์ด: ภาพย่อเครื่องมือแพทย์, request no, จำนวนรายการ, แถบความคืบหน้า, ป้ายเกินกำหนด

5.5 ตัวกรองค้นหา¶

• ☑ Mine (user_id=uid OR create_uid=uid)
• ☑ Open Only (state ∉ done, cancel)
• ☐ Overdue (scheduled_date < today AND roots_is_open)
• ☐ Backorders (backorder_id != False)
• ☐ Has Critical Spare (mapped("move_ids.product_id.roots_is_critical_spare") มี True)
• ☐ Scheduled This Week
• จัดกลุ่มตาม: State / Equipment / Kind / Scheduled Date

5.6 ปุ่มสถิติ "Pending Items" บน maintenance.request¶

เพิ่มปุ่มสถิติที่ 4 ข้าง 3 ปุ่มของ OCA (Picking list / Stock Moves / Product Moves):

[ Picking list ]  [ Stock Moves ]  [ Product Moves ]  [ Pending Items ⭐ ]
       3                8                              5

เปิดรายการของ stock.move ที่ picking_id.maintenance_request_id=request.id AND state ∉ done, cancel

6. ฟีเจอร์ UX ที่บันทึกไว้¶

7. กรณีทดสอบ (26)¶

Unit (test_spare_unit.py) — 9 การทดสอบ¶

Integration (test_spare_integration.py) — 17 การทดสอบ¶

Acceptance smoke (ทำด้วยมือ)¶

1. ตั้งค่าเครื่องช่วยหายใจ → ความวิกฤต=สีแดง → allow_consumptions=True → เพิ่ม 3 line เทมเพลต (Filter ×1 kind=Filter Replacement, Battery ×1 kind=Battery, Sensor ×1 kind=Calibration)
2. แนบ maintenance.plan kind=Filter Replacement, interval=3 เดือน
3. รัน PM cron ด้วยมือ
4. ตรวจสอบ: คำขออยู่ใน stage PM Scheduled; ร่าง picking แนบมาพร้อม roots_request_no=SR/2026/00001 มี เฉพาะ line Filter เท่านั้น
5. เปิดเมนู "My Open Requests" → เห็น SR/2026/00001 พร้อม progress 0%
6. เปิด picking → แท็บ "Pending Items" → เห็น line Filter ที่ Pending=1
7. เพิ่ม line Battery ที่ไม่ได้กำหนด → บันทึก → Pending=2
8. Validate → state=done → แถวหายไปจาก "My Open Requests"
9. ถ้าจำนวน Filter ต่ำกว่าขั้นต่ำ → กิจกรรมไปยัง BME Manager

8. คำถามที่ยังเปิด¶

ไม่มี ชื่อโมดูล, ขอบเขต, โมเดลข้อมูล, การตัดสินใจด้านการออกแบบ (D1–D8), รูปแบบ sequence, และมุมมองหน้าเริ่มต้น ยืนยันทั้งหมดเมื่อ 2026-05-22

9. รายการตรวจสอบเพื่อทำงานต่อ¶

เสร็จแล้ว (ณ 2026-05-22): Q2.1–Q2.8 commit ทั้งหมดบน main

เซสชันถัดไปเริ่มที่ Q2.9:

1. อ่านไฟล์นี้ (v1.1)
2. รันการทดสอบจาก §7 — implement tests/test_spare_unit.py + tests/test_spare_integration.py
3. commit เป็น test(spare): add unit + integration tests [Q2.9]
4. ดำเนินการต่อไปยัง Q2.10 (เอกสาร) และ Q2.11 (ข้อมูลสาธิต) เพื่อปิด Q2