เอกสารภายในสำหรับทีมแพลตฟอร์ม
คู่มือนี้อธิบายสิทธิ์และการดำเนินงานเฉพาะองค์กรเจ้าของแพลตฟอร์ม (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 เพื่อป้องกันการรบกวนข้ามองค์กร:
org.admin: สร้าง/ลบบริษัทผู้พัฒนา เปลี่ยนประเภทองค์กร ตั้งค่าขีดจำกัดมิเตอร์ ย้ายผู้ใช้ข้ามองค์กร และเปิดดู ประวัติระบบ (Audit Log)ftrate.write: ประกาศและแก้ไขอัตรา ค่า Ft รายเดือนholiday.write: เติมและแก้ไข ปฏิทินวันหยุดราชการ ประจำปีbank.write: จัดการ บัญชีธนาคารรับชำระ (ทั้งบัญชีกลางและบัญชีแยกตามผู้พัฒนา)vpn.manage: สร้าง/แก้ไข/เปิด-ปิด โปรไฟล์ VPN (WireGuard, IPsec, OpenVPN) และผูกมิเตอร์เข้ากับท่อ VPNmeter.identity.override: แก้ Serial Number มิเตอร์ ด้วยเหตุผลบังคับ และยืนยัน การสับเปลี่ยนมิเตอร์ที่ HES ตรวจพบ รวมถึงการเปลี่ยนไฟล์ลงนามลูกค้าที่ถูกล็อก409 Conflict
2. การตรวจสอบตารางสิทธิ์ (GET /api/permissions และหน้า Settings)
- คลิก การตั้งค่า (Settings) > เลือกองค์กร (เช่น
Advanced Grid, บริษัทผู้พัฒนา หรือบริษัทลูกค้า) - เปิดแท็บ ผู้ใช้และสิทธิ์ (People & access) แล้วคลิก สิทธิ์ตามบทบาท (Role permissions)
- ตารางนี้แสดงผลแบบ อ่านอย่างเดียว โดยดึงข้อมูลตรงจาก
backend-api/src/auth/policy.tsผ่านGET /api/permissionsเพื่อตรวจสอบสิทธิ์ที่เซิร์ฟเวอร์บังคับใช้จริงของทุกบทบาทในองค์กรระดับแพลตฟอร์ม ระดับผู้พัฒนา และระดับลูกค้า
ภาพที่ 1: หน้าจอตารางสิทธิ์ตามบทบาท (Role permissions) แบบอ่านอย่างเดียว
