gravity/ติดตามสถานะของวัสดุ-ครุภัณฑ์ ประจำปี/MASTER_PROMPT.md

MASTER_PROMPT.md - Enterprise Procurement, Asset & Software Lifecycle Management System (Version 3.0)

1. บทนำ (Introduction)

ระบบนี้คือ Enterprise Procurement, Asset & Software Lifecycle Management System สำหรับโรงพยาบาลและองค์กรขนาดใหญ่ ครอบคลุมการวางแผนงบประมาณ การจัดซื้อวัสดุ-ครุภัณฑ์ การบริหารซอฟต์แวร์แบบครบวงจร การบริหารสัญญาบำรุงรักษา (MA) และการติดตามสถานะ รวมถึง Audit Log ระดับฟิลด์ ระบบนี้จะต้องถูกพัฒนาในรูปแบบ Modern Web Application (PWA) และรองรับการขยายตัวเพื่อเชื่อมต่อกับ HIS, ERP, และ e-GP ในอนาคต

---

2. ข้อมูลทางเทคนิค (Tech Stack & Architecture)

• Backend: PHP 8.1+ (ใช้โครงสร้าง MVC หรือ Framework เช่น Laravel)
• Frontend: Bootstrap 5.3, HTML5, CSS3, JavaScript (ES6+), PWA
• Database: MySQL 8.0+
• Architecture: MVC (Model-View-Controller) รองรับ REST API

---

3. สารบัญโมดูลหลัก (Core Modules)

3.1. ระบบปีงบประมาณ (Budget Year System)

• รองรับการตั้งค่าปีงบประมาณและรอบการจัดซื้อ
• สามารถ คัดลอกแผนจัดซื้อจากปีงบประมาณเดิมไปยังปีใหม่ ได้อย่างสมบูรณ์ เพื่อลดภาระการคีย์ข้อมูลซ้ำ

3.2. ระบบแผนจัดซื้อวัสดุและครุภัณฑ์ (Procurement Planning)

• แบ่งแยกประเภทวัสดุ ครุภัณฑ์ และซอฟต์แวร์ ได้อย่างชัดเจน
• รองรับ Multi-Hospital หรือหลายหน่วยงานในระบบเดียว

3.3. ระบบ Workflow ที่กำหนดเองได้ (Customizable Workflow)

• ผู้ดูแลระบบสามารถตั้งค่า Status Workflow สำหรับการขออนุมัติ การสั่งซื้อ การรับของ ได้ตามรูปแบบองค์กร
• มี Status Timeline และ History เพื่อติดตามความคืบหน้าของแต่ละคำขอ

3.4. ระบบบริหารวงจรชีวิตซอฟต์แวร์ (Software License Management)

เมื่อเลือกประเภทการจัดซื้อเป็น ซอฟต์แวร์ (Software) จะต้องให้ระบุประเภท:

1. ซื้อขาด (Perpetual License):
   • ไม่มีการสร้างข้อมูลติดตามการต่ออายุ (ไม่มีแจ้งเตือนหมดอายุรายปี)
   • กำหนดวันรับประกัน (Warranty) ได้
   • บันทึกค่าบำรุงรักษา (Maintenance Agreement - MA) แยกได้ และผูก MA กับ License ในภายหลังได้
2. เช่าใช้/ต่ออายุ (Subscription / Annual License):
   • ระบบดึงข้อมูลอัตโนมัติ: เมื่อตั้งสถานะจัดซื้อสำเร็จ ข้อมูลจะถูกนำเข้าสู่โมดูล License อัตโนมัติ (ไม่ต้องคีย์ซ้ำ)
   • ข้อมูลที่บันทึก ได้แก่ รหัส, ชื่อซอฟต์แวร์, Vendor, Version, License Type, หน่วยงาน, ผู้รับผิดชอบ, ราคา, วันที่ซื้อ, วันเริ่มใช้งาน, วันหมดอายุ, จำนวน License
   • รูปแบบการต่ออายุ (Renewal Cycle): เลือกได้ว่าจะต่อ 1 ปี, 2 ปี, 3 ปี, 4 ปี, 5 ปี หรือกำหนดเอง (Custom)
   • การเปลี่ยนรอบการต่ออายุ: สามารถเปลี่ยนรอบในอนาคตได้ (เช่น จาก 1 ปีเปลี่ยนเป็น 3 ปี) ระบบต้องคำนวณวันหมดอายุใหม่ตามรอบล่าสุดอัตโนมัติ
   • ประวัติการต่ออายุ (Renewal History): เก็บประวัติทุกครั้งที่เกิดการต่ออายุหรือเปลี่ยนแปลงรอบ พร้อมทั้ง Audit Log เก็บค่าเก่า (Old Value) / ค่าใหม่ (New Value)
   • ระบบต่ออายุอัตโนมัติ (Auto-renewal log): กดต่ออายุเพียงคลิกเดียว ระบบจะคำนวณวันหมดอายุใหม่ ตั้งรอบแจ้งเตือน อัปเดต Dashboard และบันทึกประวัติทันที

3.5. Dashboard และ Analytics

• แดชบอร์ดแสดงสรุปแผนการจัดซื้อ, วัสดุ, ครุภัณฑ์
• Software Dashboard: แยกกราฟสถิติ License ซื้อขาด vs. Subscription, สถานะการต่ออายุ (ใกล้หมดอายุ, หมดอายุแล้ว, ต่ออายุแล้ว) จัดกลุ่มตามรอบระยะเวลาการต่ออายุ (1-5 ปี)

3.6. ระบบแจ้งเตือน (Notifications)

• ดึงข้อมูลอ้างอิงจาก วันหมดอายุล่าสุด + รอบการต่ออายุปัจจุบัน
• ส่งการแจ้งเตือนล่วงหน้าได้ตามตั้งค่า (เช่น 90 วัน, 60 วัน, 30 วัน)
• รองรับหลายช่องทาง: ในระบบ (In-App), Email, LINE Notify, Telegram

3.7. Audit Log และ Change History แบบละเอียด (Field-level)

• บันทึก ทุกการกระทำ ที่เกิดขึ้นในระบบ (เช่น สร้างรายการ, แก้ไข, เปลี่ยนรอบต่ออายุ, แนบไฟล์, ส่งอนุมัติ)
• ต้องเก็บข้อมูลอย่างน้อย:
  • วันที่และเวลา, ผู้ใช้งาน, โมดูล, รหัสอ้างอิง, ฟิลด์ที่เปลี่ยน, ค่าเดิม (Old Value), ค่าใหม่ (New Value), เหตุผล, IP Address, Browser, Session ID
• Version History & Diff View: มีหน้า Audit Viewer สำหรับเปรียบเทียบข้อมูลเวอร์ชันก่อนหน้าและหลังแก้ไข
• รองรับ Soft Delete และสามารถกู้คืนข้อมูล (Restore) ได้

3.8. ระบบสิทธิ์ผู้ใช้งาน (Role-Based Access Control - RBAC)

• กำหนดสิทธิ์แบบละเอียด (View, Create, Edit, Delete, Approve, Export)
• สามารถกำหนดตามสาขา/แผนก หรือ Role พื้นฐาน เช่น Admin, Manager, User

3.9. ระบบ Vendor Management และการจัดการเอกสาร

• ฐานข้อมูลผู้จัดจำหน่าย (Vendor)
• รองรับระบบสัญญาบำรุงรักษา (MA) และประกัน (Warranty Management)
• ระบบแนบไฟล์ (File Attachments): อัปโหลด ลบ หรือแก้ไขไฟล์แนบในทุกๆ รายการ (พร้อมบันทึก Audit Log)

3.10. ระบบนำเข้า/ส่งออกข้อมูลและ API (Data & API)

• รองรับการ Import ข้อมูลจาก Excel/CSV
• ส่งออกรายงาน (Export) เป็น Excel, PDF, CSV
• สร้าง REST API Endpoint เพื่อเตรียมพร้อมเชื่อมต่อกับระบบ HIS, ERP, e-GP และระบบคลังพัสดุในอนาคต

---

4. แผนภาพและโครงสร้างที่ต้องการเพิ่มเติม (Documentation & Architecture Diagrams)

เมื่อเริ่มพัฒนาระบบ ให้เตรียมข้อมูลเอกสาร (System Design) เหล่านี้ควบคู่ไปด้วย:

1. โครงสร้างฐานข้อมูล (Database Schema) & SQL Scripts
2. Data Dictionary
3. ER Diagram
4. Use Case Diagram
5. Sequence Diagram
6. Flowchart (โดยเฉพาะ Flow ของการจัดการ Subscription License)
7. Context Diagram
8. คู่มือติดตั้ง (Installation Manual) และ คู่มือการใช้งาน (User Manual)

---

5. UI/UX และการใช้งาน

• การออกแบบ UI/UX ต้องสวยงาม ใช้งานง่าย รองรับการแสดงผลทุกหน้าจอระดับ Production (Responsive 2026)
• มีระบบ Dark/Light Mode
• โครงสร้างเมนูที่จัดกลุ่มชัดเจน ไม่ซับซ้อน

เป้าหมาย (Objective): ระบบนี้ไม่เพียงแค่จัดการแผนจัดซื้อ แต่ต้องเป็น Enterprise Asset & Lifecycle Management เต็มรูปแบบที่สามารถบริหารความเสี่ยงเรื่องซอฟต์แวร์หมดอายุ และมีการตรวจสอบย้อนหลังทาง Audit Log ได้สมบูรณ์ 100%