---
title: บทบาทและการกำกับดูแลแพลตฟอร์ม
description: โครงสร้างสิทธิ์องค์กรเจ้าของแพลตฟอร์ม (SUPER_ADMIN) ความแตกต่างระหว่าง Platform ADMIN (33 สิทธิ์) และ Platform SERVICE (9 สิทธิ์) และการตรวจสอบตารางสิทธิ์ข้ามองค์กร
---
::: warning เอกสารภายในสำหรับทีมแพลตฟอร์ม
คู่มือนี้อธิบายสิทธิ์และการดำเนินงานเฉพาะองค์กรเจ้าของแพลตฟอร์ม (`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 หรือออก/อนุมัติใบแจ้งหนี้)* |
::: warning สิ่งที่สงวนสิทธิ์ไว้เฉพาะ 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) แบบอ่านอย่างเดียว*
---
## ขั้นตอนถัดไป
- [บทที่ 02: การสร้างบริษัทผู้พัฒนา โควตามิเตอร์ และการดูแลองค์กร](./02-developer-and-tenant-onboarding)
- [บทที่ 03: อัตราค่าไฟ ค่า Ft ธนาคาร และปฏิทินวันหยุด](./03-global-tariffs-ft-and-reference-data)