Skip to content
Markdownllms.txt

เอกสารภายในสำหรับทีมแพลตฟอร์ม

คู่มือนี้อธิบายสิทธิ์และการดำเนินงานเฉพาะองค์กรเจ้าของแพลตฟอร์ม (SUPER_ADMIN / org_avg_super) เท่านั้น

บทบาทและการกำกับดูแลแพลตฟอร์ม (Platform Roles & Governance) ​

ผู้ที่เกี่ยวข้อง: ผู้ดูแลแพลตฟอร์ม (Platform ADMIN) ทีมปฏิบัติการส่วนกลาง (Platform SERVICE)


1. โครงสร้างสิทธิ์ระดับแพลตฟอร์ม (SUPER_ADMIN) ​

ในระบบ WattDee บัญชีภายใต้บริษัทเจ้าของแพลตฟอร์ม (Advanced Grid Co., Ltd., รหัสองค์กร org_avg_super, ประเภท SUPER_ADMIN) มีขอบเขตการมองเห็นข้ามทุกบริษัทผู้พัฒนาและทุกบริษัทลูกค้า (tierOf(authCtx) === 'platform') โดยแบ่งหน้าที่ออกเป็น 2 บทบาทที่กำหนดได้ในระดับแพลตฟอร์ม (ROLES_ASSIGNABLE.platform):

บทบาทชื่อที่แสดงในหน้าจอจำนวนสิทธิ์ขอบเขตและหน้าที่ความรับผิดชอบ
ADMINผู้ดูแลแพลตฟอร์ม (Platform administrator)33 / 33สิทธิ์สูงสุดทั้งระบบ ครอบคลุมทุกองค์กร ทุกไซต์ ทุกมิเตอร์ และข้อมูลอ้างอิงกลาง (org.admin, ftrate.write, holiday.write, bank.write, vpn.manage, meter.identity.override, policy.read, invoice.*, telemetry.*)
SERVICEทีมปฏิบัติการส่วนกลาง (Central operations team)9 / 33ดูแลมิเตอร์และการสื่อสารของ ทุกไซต์ในแพลตฟอร์ม: ดูรายชื่อองค์กร, ลงทะเบียน/แก้ไข/สับเปลี่ยนมิเตอร์ (meter.write), ทดสอบเชื่อมต่อและสั่งอ่านค่า (meter.command), ดู IP/พอร์ต/ซิม (meter.network.read), ซ่อมแซมข้อมูล 15 นาที (telemetry.sync), ดูเหตุผลคุณภาพข้อมูล (telemetry.quality.read), จัดการแจ้งเตือน (alert.manage), ดูรายงานเทียบบิลคู่ขนาน (invoice.compare), และดูอัตรา Ft/วันหยุด (reference.read) (ไม่สามารถจัดการผู้ใช้ แก้ไขค่าอ้างอิง ตั้งค่า VPN แก้ Serial หรือออก/อนุมัติใบแจ้งหนี้)

สิ่งที่สงวนสิทธิ์ไว้เฉพาะ Platform ADMIN เท่านั้น

แม้ Developer ADMIN จะมีสิทธิ์บริหารบริษัทและลูกค้าของตนเองได้เกือบครบวงจร แต่ความสามารถด้านโครงสร้างพื้นฐานและการกำกับดูแลกลาง 6 รายการ ต่อไปนี้ถูกสงวนไว้เฉพาะ Platform ADMIN เพื่อป้องกันการรบกวนข้ามองค์กร:

  1. org.admin: สร้าง/ลบบริษัทผู้พัฒนา เปลี่ยนประเภทองค์กร ตั้งค่าขีดจำกัดมิเตอร์ ย้ายผู้ใช้ข้ามองค์กร และเปิดดู ประวัติระบบ (Audit Log)
  2. ftrate.write: ประกาศและแก้ไขอัตรา ค่า Ft รายเดือน
  3. holiday.write: เติมและแก้ไข ปฏิทินวันหยุดราชการ ประจำปี
  4. bank.write: จัดการ บัญชีธนาคารรับชำระ (ทั้งบัญชีกลางและบัญชีแยกตามผู้พัฒนา)
  5. vpn.manage: สร้าง/แก้ไข/เปิด-ปิด โปรไฟล์ VPN (WireGuard, IPsec, OpenVPN) และผูกมิเตอร์เข้ากับท่อ VPN
  6. meter.identity.override: แก้ Serial Number มิเตอร์ ด้วยเหตุผลบังคับ และยืนยัน การสับเปลี่ยนมิเตอร์ที่ HES ตรวจพบ รวมถึงการเปลี่ยนไฟล์ลงนามลูกค้าที่ถูกล็อก 409 Conflict

2. การตรวจสอบตารางสิทธิ์ (GET /api/permissions และหน้า Settings) ​

  1. คลิก การตั้งค่า (Settings) > เลือกองค์กร (เช่น Advanced Grid, บริษัทผู้พัฒนา หรือบริษัทลูกค้า)
  2. เปิดแท็บ ผู้ใช้และสิทธิ์ (People & access) แล้วคลิก สิทธิ์ตามบทบาท (Role permissions)
  3. ตารางนี้แสดงผลแบบ อ่านอย่างเดียว โดยดึงข้อมูลตรงจาก backend-api/src/auth/policy.ts ผ่าน GET /api/permissions เพื่อตรวจสอบสิทธิ์ที่เซิร์ฟเวอร์บังคับใช้จริงของทุกบทบาทในองค์กรระดับแพลตฟอร์ม ระดับผู้พัฒนา และระดับลูกค้า

ตารางสิทธิ์ตามบทบาทในหน้าการตั้งค่าภาพที่ 1: หน้าจอตารางสิทธิ์ตามบทบาท (Role permissions) แบบอ่านอย่างเดียว


ขั้นตอนถัดไป ​

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