สุขภาพฐานข้อมูล Audit Log การย้ายลายเซ็น และปฏิบัติการซัพพอร์ต
ผู้ที่เกี่ยวข้อง: ผู้ดูแลแพลตฟอร์ม (Platform ADMIN) ทีมปฏิบัติการส่วนกลาง (Platform SERVICE - แท็บฐานข้อมูล/ระบบ)
1. สุขภาพฐานข้อมูลและพาร์ทิชันรายเดือน (การตั้งค่า > ฐานข้อมูล/ระบบ)
(เข้าดูได้ทั้ง Platform ADMIN และ Platform SERVICE รวมถึงบทบาทที่มีสิทธิ์ meter.network.read)
- คลิก การตั้งค่า (Settings) > ฐานข้อมูล/ระบบ (Database & system)
- ตรวจสอบตัวชี้วัดสุขภาพโครงสร้างพื้นฐาน:
- ขนาดฐานข้อมูลรวม และเวอร์ชัน PostgreSQL
- ตารางเก็บข้อมูลรายเดือน (Monthly partitions ของ
load_profile_15min): ตรวจดูสถานะพร้อมใช้งานหรือต้องขยายพาร์ทิชันพร้อมขนาดและจำนวนแถวของแต่ละเดือน (หากพาร์ทิชันใกล้เต็มปี ควรสร้างพาร์ทิชันล่วงหน้าก่อนเข้าสู่เดือนใหม่ผ่านเครื่องมือดูแลฐานข้อมูลbun run --cwd backend-api db:partitions) - การซิงค์ข้อมูลจากมิเตอร์ (HES): ความล่าช้าในการประมวลผล (
วินาที) และจำนวนมิเตอร์ที่รอซิงค์เกิน 1 ชั่วโมง - จำนวนข้อมูลในระบบทั้งหมด: โครงการ มิเตอร์ ใบแจ้งหนี้ และประวัติระบบ
- คลิก รีเฟรชสถานะ เพื่อดึงตัวเลขล่าสุด (หรือเรียกตรวจ readiness จาก
/api/health/ready)
2. ประวัติการใช้งานและแก้ไขระบบ (การตั้งค่า > ประวัติระบบ)
(สงวนสิทธิ์เฉพาะ Platform ADMIN ที่มีสิทธิ์ org.admin)
- คลิก ประวัติระบบ (Audit log) ใต้เมนูการตั้งค่า
- กรองเหตุการณ์ทั้งระบบได้ตามต้องการ:
- ช่อง ค้นหาประวัติการใช้งาน (กิจกรรม รหัสอ้างอิง หรือรายละเอียด)
- ช่อง กรองตามอีเมลผู้ดำเนินการ
- หมวดหมู่:
ทุกหมวดหมู่,ข้อมูลมิเตอร์,ใบแจ้งหนี้,สัญญา PPA,อุปกรณ์มิเตอร์ - ช่วงวันที่ ตั้งแต่ ถึง ถึง
- คลิก ส่งออกหน้าปัจจุบัน (Export current page) เพื่อดาวน์โหลด CSV ของหน้าที่แสดงอยู่ (ปรับตัวกรองหรือเปลี่ยนหน้าเพื่อส่งออกช่วงย้อนหลัง)
ภาพที่ 1: หน้าจอจัดการระบบส่วนกลาง รวมถึงแท็บฐานข้อมูล/ระบบ และ Audit Log
3. การย้ายไฟล์ภาพลายเซ็นสู่คลังเก็บส่วนตัว (Private Signature Migration)
ภาพลายเซ็นผู้มีอำนาจของบริษัทผู้พัฒนาและลายเซ็นรับทราบของลูกค้าทั้งหมดจัดเก็บแบบส่วนตัวภายใต้ private/signatures/ และดึงผ่าน Endpoint ที่ตรวจสอบสิทธิ์ผู้ใช้โดยตรง (Cache-Control: private, no-store) หากพบบริษัทหรือใบแจ้งหนี้รุ่นเก่าที่ยังอ้างอิงคีย์ใน public/signatures/ ให้รันชุดคำสั่งย้ายไฟล์จาก backend-api/:
- สำรวจรายการคีย์เก่า (Dry-run, ไม่แก้ข้อมูล):bash
bun run db:migrate:signatures - คัดลอกสู่คลังเก็บส่วนตัว ตรวจความถูกต้อง และอัปเดตฐานข้อมูล:bash
bun run db:migrate:signatures --apply - ทดสอบพรีวิวลายเซ็นและส่งออก PDF/Excel/Word สำหรับองค์กรที่ย้ายแล้ว
- (เมื่อตรวจสอบสมบูรณ์แล้วเท่านั้น) ลบไฟล์ลายเซ็นเก่าที่ยังค้างอยู่ใน
public/:bashbun run db:migrate:signatures --purge
4. งานช่วยเหลือผู้พัฒนาและลูกค้า (Support Escalations)
- เปลี่ยนไฟล์ลงนามลูกค้าที่ถูกล็อก
409 Conflict: เมื่อผู้รับซื้อไฟฟ้าหรือผู้พัฒนาอัปโหลดไฟล์ PDF ลงนามหรือภาพลายเซ็นผิดฉบับแล้ว ระบบจะล็อกเพื่อความปลอดภัย มีเพียง Platform ADMIN เท่านั้นที่สามารถช่วยเหลือเปลี่ยนฉบับใหม่ให้ได้หลังตรวจสอบหลักฐานยืนยันจากทั้งสองฝ่าย - กู้คืนการเข้าถึงเมื่อ Company ADMIN ทั้งบริษัทถูกล็อก: หากผู้ดูแลบริษัทผู้พัฒนาติดล็อกหรือลืมรหัสผ่านพร้อมกันหมด ให้
Platform ADMINเข้าไปรีเซ็ตรหัสผ่านชั่วคราวในแท็บ ผู้ใช้และสิทธิ์ ของบริษัทนั้น - ตรวจคำร้องขอเพิ่ม
Active meter limitหรือออกบิลก่อนสิ้นรอบ (invoice.issueEarly): ตรวจสอบสถานะการเชื่อมต่อมิเตอร์และรอบบิลของไซต์ก่อนดำเนินการ
ภาพที่ 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 สำหรับทีมวิศวกรแพลตฟอร์ม |
{
"mcpServers": {
"wattdee-admin-docs": {
"command": "bun",
"args": ["run", "docs:admin:mcp"],
"cwd": "/path/to/AMR"
}
}
}