Skip to content
Markdownllms.txt

สุขภาพฐานข้อมูล 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 ของหน้าที่แสดงอยู่ (ปรับตัวกรองหรือเปลี่ยนหน้าเพื่อส่งออกช่วงย้อนหลัง)

หน้าตั้งค่าธนาคาร วันหยุด สุขภาพระบบ และประวัติการใช้งานภาพที่ 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ภาพที่ 2: หน้าจอเข้าสู่ระบบ WattDee ซึ่งทีมแพลตฟอร์มใช้เข้าถึงสิทธิ์ระดับองค์กรเจ้าของแพลตฟอร์ม


5. การใช้งานคู่มือผู้ดูแลแพลตฟอร์มร่วมกับ AI Assistants และ MCP ​

คู่มือผู้ดูแลแพลตฟอร์มเผยแพร่แยกต่างหากที่ https://admin-docs.wattdee.com (ไม่รวมอยู่ในคู่มือฝั่งลูกค้า docs.wattdee.com) พร้อมช่องทางสำหรับ AI Tools:

ช่องทางที่อยู่ / คำสั่งรายละเอียด
Admin /llms.txthttps://admin-docs.wattdee.com/llms.txtดัชนี URL และสรุปคู่มือผู้ดูแลแพลตฟอร์มทั้งภาษาไทยและอังกฤษ
Admin /llms-full.txthttps://admin-docs.wattdee.com/llms-full.txtเนื้อหาคู่มือผู้ดูแลแพลตฟอร์มฉบับเต็มในไฟล์เดียว (หรือ /th/llms-full.txt, /en/llms-full.txt)
Admin Remote HTTP MCPhttps://admin-docs.wattdee.com/api/mcpEndpoint JSON-RPC 2.0 สำหรับเครื่องมือ search_wattdee_admin_manual, get_wattdee_admin_guide และ get_role_capabilities (ครบทั้ง 3 ระดับรวม platform)
Admin Local MCP Serverbun run docs:admin:mcpรัน MCP Server แบบ Local สำหรับทีมวิศวกรแพลตฟอร์ม
json
{
  "mcpServers": {
    "wattdee-admin-docs": {
      "command": "bun",
      "args": ["run", "docs:admin:mcp"],
      "cwd": "/path/to/AMR"
    }
  }
}

คู่มือผู้ดูแลแพลตฟอร์ม WattDee (Internal Operations)