--- title: สุขภาพฐานข้อมูล Audit Log และงานซัพพอร์ต description: การตรวจสอบสุขภาพฐานข้อมูล PostgreSQL พาร์ทิชันรายเดือน ความล่าช้า HES ประวัติระบบ Audit Log การย้ายภาพลายเซ็น และการเชื่อมต่อ AI / MCP ระดับแพลตฟอร์ม --- # สุขภาพฐานข้อมูล Audit Log การย้ายลายเซ็น และปฏิบัติการซัพพอร์ต **ผู้ที่เกี่ยวข้อง:** ผู้ดูแลแพลตฟอร์ม (Platform ADMIN) ทีมปฏิบัติการส่วนกลาง (Platform SERVICE - แท็บฐานข้อมูล/ระบบ) --- ## 1. สุขภาพฐานข้อมูลและพาร์ทิชันรายเดือน (`การตั้งค่า > ฐานข้อมูล/ระบบ`) *(เข้าดูได้ทั้ง `Platform ADMIN` และ `Platform SERVICE` รวมถึงบทบาทที่มีสิทธิ์ `meter.network.read`)* 1. คลิก **การตั้งค่า (Settings)** > **ฐานข้อมูล/ระบบ (Database & system)** 2. ตรวจสอบตัวชี้วัดสุขภาพโครงสร้างพื้นฐาน: - **ขนาดฐานข้อมูลรวม** และเวอร์ชัน PostgreSQL - **ตารางเก็บข้อมูลรายเดือน (Monthly partitions ของ `load_profile_15min`)**: ตรวจดูสถานะ `พร้อมใช้งาน` หรือ `ต้องขยายพาร์ทิชัน` พร้อมขนาดและจำนวนแถวของแต่ละเดือน *(หากพาร์ทิชันใกล้เต็มปี ควรสร้างพาร์ทิชันล่วงหน้าก่อนเข้าสู่เดือนใหม่ผ่านเครื่องมือดูแลฐานข้อมูล `bun run --cwd backend-api db:partitions`)* - **การซิงค์ข้อมูลจากมิเตอร์ (HES)**: ความล่าช้าในการประมวลผล (`วินาที`) และจำนวนมิเตอร์ที่รอซิงค์เกิน 1 ชั่วโมง - **จำนวนข้อมูลในระบบทั้งหมด**: โครงการ มิเตอร์ ใบแจ้งหนี้ และประวัติระบบ 3. คลิก **รีเฟรชสถานะ** เพื่อดึงตัวเลขล่าสุด (หรือเรียกตรวจ readiness จาก `/api/health/ready`) --- ## 2. ประวัติการใช้งานและแก้ไขระบบ (`การตั้งค่า > ประวัติระบบ`) *(สงวนสิทธิ์เฉพาะ **Platform ADMIN** ที่มีสิทธิ์ `org.admin`)* 1. คลิก **ประวัติระบบ (Audit log)** ใต้เมนูการตั้งค่า 2. กรองเหตุการณ์ทั้งระบบได้ตามต้องการ: - ช่อง **ค้นหาประวัติการใช้งาน** (กิจกรรม รหัสอ้างอิง หรือรายละเอียด) - ช่อง **กรองตามอีเมลผู้ดำเนินการ** - **หมวดหมู่:** `ทุกหมวดหมู่`, `ข้อมูลมิเตอร์`, `ใบแจ้งหนี้`, `สัญญา PPA`, `อุปกรณ์มิเตอร์` - ช่วงวันที่ **ตั้งแต่** ถึง **ถึง** 3. คลิก **ส่งออกหน้าปัจจุบัน (Export current page)** เพื่อดาวน์โหลด CSV ของหน้าที่แสดงอยู่ (ปรับตัวกรองหรือเปลี่ยนหน้าเพื่อส่งออกช่วงย้อนหลัง) ![หน้าตั้งค่าธนาคาร วันหยุด สุขภาพระบบ และประวัติการใช้งาน](/screenshots/th/30-settings-bank-holiday-system-audit.png) *ภาพที่ 1: หน้าจอจัดการระบบส่วนกลาง รวมถึงแท็บฐานข้อมูล/ระบบ และ Audit Log* --- ## 3. การย้ายไฟล์ภาพลายเซ็นสู่คลังเก็บส่วนตัว (Private Signature Migration) ภาพลายเซ็นผู้มีอำนาจของบริษัทผู้พัฒนาและลายเซ็นรับทราบของลูกค้าทั้งหมดจัดเก็บแบบส่วนตัวภายใต้ `private/signatures/` และดึงผ่าน Endpoint ที่ตรวจสอบสิทธิ์ผู้ใช้โดยตรง (`Cache-Control: private, no-store`) หากพบบริษัทหรือใบแจ้งหนี้รุ่นเก่าที่ยังอ้างอิงคีย์ใน `public/signatures/` ให้รันชุดคำสั่งย้ายไฟล์จาก `backend-api/`: 1. **สำรวจรายการคีย์เก่า (Dry-run, ไม่แก้ข้อมูล):** ```bash bun run db:migrate:signatures ``` 2. **คัดลอกสู่คลังเก็บส่วนตัว ตรวจความถูกต้อง และอัปเดตฐานข้อมูล:** ```bash bun run db:migrate:signatures --apply ``` 3. **ทดสอบพรีวิวลายเซ็นและส่งออก PDF/Excel/Word** สำหรับองค์กรที่ย้ายแล้ว 4. *(เมื่อตรวจสอบสมบูรณ์แล้วเท่านั้น)* **ลบไฟล์ลายเซ็นเก่าที่ยังค้างอยู่ใน `public/`:** ```bash bun run db:migrate:signatures --purge ``` --- ## 4. งานช่วยเหลือผู้พัฒนาและลูกค้า (Support Escalations) - **เปลี่ยนไฟล์ลงนามลูกค้าที่ถูกล็อก `409 Conflict`:** เมื่อผู้รับซื้อไฟฟ้าหรือผู้พัฒนาอัปโหลดไฟล์ PDF ลงนามหรือภาพลายเซ็นผิดฉบับแล้ว ระบบจะล็อกเพื่อความปลอดภัย มีเพียง **Platform ADMIN** เท่านั้นที่สามารถช่วยเหลือเปลี่ยนฉบับใหม่ให้ได้หลังตรวจสอบหลักฐานยืนยันจากทั้งสองฝ่าย - **กู้คืนการเข้าถึงเมื่อ Company ADMIN ทั้งบริษัทถูกล็อก:** หากผู้ดูแลบริษัทผู้พัฒนาติดล็อกหรือลืมรหัสผ่านพร้อมกันหมด ให้ `Platform ADMIN` เข้าไปรีเซ็ตรหัสผ่านชั่วคราวในแท็บ **ผู้ใช้และสิทธิ์** ของบริษัทนั้น - **ตรวจคำร้องขอเพิ่ม `Active meter limit` หรือออกบิลก่อนสิ้นรอบ (`invoice.issueEarly`):** ตรวจสอบสถานะการเชื่อมต่อมิเตอร์และรอบบิลของไซต์ก่อนดำเนินการ ![หน้าจอเข้าสู่ระบบ WattDee](/screenshots/th/01-login-page.png) *ภาพที่ 2: หน้าจอเข้าสู่ระบบ WattDee ซึ่งทีมแพลตฟอร์มใช้เข้าถึงสิทธิ์ระดับองค์กรเจ้าของแพลตฟอร์ม* --- ## 5. การใช้งานคู่มือผู้ดูแลแพลตฟอร์มร่วมกับ AI Assistants และ MCP คู่มือผู้ดูแลแพลตฟอร์มเผยแพร่แยกต่างหากที่ **`https://admin-docs.wattdee.com`** (ไม่รวมอยู่ในคู่มือฝั่งลูกค้า `docs.wattdee.com`) พร้อมช่องทางสำหรับ AI Tools: | ช่องทาง | ที่อยู่ / คำสั่ง | รายละเอียด | | :--- | :--- | :--- | | **Admin `/llms.txt`** | `https://admin-docs.wattdee.com/llms.txt` | ดัชนี URL และสรุปคู่มือผู้ดูแลแพลตฟอร์มทั้งภาษาไทยและอังกฤษ | | **Admin `/llms-full.txt`** | `https://admin-docs.wattdee.com/llms-full.txt` | เนื้อหาคู่มือผู้ดูแลแพลตฟอร์มฉบับเต็มในไฟล์เดียว (หรือ `/th/llms-full.txt`, `/en/llms-full.txt`) | | **Admin Remote HTTP MCP** | `https://admin-docs.wattdee.com/api/mcp` | Endpoint JSON-RPC 2.0 สำหรับเครื่องมือ `search_wattdee_admin_manual`, `get_wattdee_admin_guide` และ `get_role_capabilities` (ครบทั้ง 3 ระดับรวม `platform`) | | **Admin Local MCP Server** | `bun run docs:admin:mcp` | รัน MCP Server แบบ Local สำหรับทีมวิศวกรแพลตฟอร์ม | ```json { "mcpServers": { "wattdee-admin-docs": { "command": "bun", "args": ["run", "docs:admin:mcp"], "cwd": "/path/to/AMR" } } } ```