# คู่มือการใช้งานระบบ WattDee (ภาษาไทย) ## คู่มือการใช้งาน WattDee (ภาษาไทย) Source: https://docs.wattdee.com/th/ ::: warning การอัปเดต UAT คู่มือนี้อธิบายระบบรุ่นที่จะอัปเดต หน้าจอหรือการทำงานบางส่วนอาจแตกต่างจากระบบ UAT ปัจจุบัน :::
WattDee LogoWattDee Operations Manual

คู่มือการใช้งานระบบ WattDee ฉบับภาษาไทย

คู่มือปฏิบัติการสำหรับผู้ดูแลแพลตฟอร์ม ผู้พัฒนาโครงการ ทีม O&M ฝ่ายบัญชี และลูกค้าผู้รับซื้อไฟฟ้า ครอบคลุมตั้งแต่การตั้งค่ามิเตอร์ DLMS/COSEM ตรวจข้อมูลโหลดโปรไฟล์ 15 นาที ซ่อมแซม VEE จนถึงการออกบิล PEA TOU และอนุมัติ 3 ขั้นตอน

หน้าแดชบอร์ดภาพรวมพลังงาน แถบสุขภาพมิเตอร์ กราฟ TOU และคิวงานในระบบ WattDee
01 DLMS Meter & VPN ลงทะเบียนมิเตอร์แบบ US-1.19 ให้ HES อ่าน Serial จากเครื่องจริง ตั้งค่า CT/VT และผูกโปรไฟล์ VPN
02 15-Minute VEE Profile ติดตามโหลดโปรไฟล์ราย 15 นาทีตามเวลาไทย ไม่ใส่เลข 0 ปลอม ซ่อมแซมช่องว่าง VEE และดึงข้อมูลย้อนหลัง
03 3-Stage TOU Invoice ออกบิล PEA TOU ตามค่า Ft ประจำเดือนที่ยืนยันแล้ว ผ่านขั้นตอน DRAFT → CHECKED → APPROVED
04 Off-Taker Countersign ลูกค้าผู้รับซื้อไฟฟ้าเข้าดูกราฟพลังงานและลงนามรับทราบใบแจ้งหนี้สถานะ APPROVED ในพอร์ทัลลูกค้า
## ทางลัดตามบทบาท (Quick Role Lookup) เลือกคู่มือให้ตรงกับหน้าที่ของคุณในองค์กร: | บทบาทในระบบ | หน้าที่และงานหลัก | คู่มือที่เกี่ยวข้อง | | :--- | :--- | :--- | | **Platform Admin** (ผู้ดูแลแพลตฟอร์ม) | ภาพรวมพอร์ตโฟลิโอทุกผู้พัฒนา สร้างบริษัทผู้พัฒนา ตั้งค่าอัตราค่าไฟฟ้า TOU ค่า Ft รายเดือน บัญชีธนาคาร วันหยุด สุขภาพฐานข้อมูล และ Audit Log | [คู่มือผู้ดูแลแพลตฟอร์ม](./03-platform-admin-guide) | | **Solar Developer** (ผู้ดูแลบริษัทผู้พัฒนา) | แก้ไขโปรไฟล์และลายเซ็นบริษัท เพิ่มบริษัทลูกค้า (Off-taker) สร้างไซต์และสัญญา PPA ลงทะเบียนมิเตอร์แบบ US-1.19 ประสานผู้ดูแลแพลตฟอร์มเพื่อตั้งค่า VPN และสร้างบัญชีทีมงาน | [คู่มือผู้พัฒนาโครงการ](./04-developer-admin-guide) | | **Service & Operator** (ทีมปฏิบัติการ / O&M / ผู้ควบคุม) | มอนิเตอร์สถานะมิเตอร์ทั่วพอร์ต ทดสอบการเชื่อมต่อ HES สับเปลี่ยนมิเตอร์ วิเคราะห์ข้อมูล 15 นาที เติมข้อมูล VEE ดึงข้อมูลย้อนหลัง (Backfill) และเทียบช่วงเวลา | [คู่มือมิเตอร์และข้อมูลพลังงาน](./05-meter-and-telemetry-guide) | | **Accounting** (ฝ่ายบัญชี) | คำนวณและออกใบแจ้งหนี้ TOU PPA ตามรอบบิล กระบวนการตรวจสอบและอนุมัติ 3 ขั้นตอน การจัดการข้อมูลล่าช้า และการส่งออก PDF/Excel | [คู่มือการวางบิลและอนุมัติ](./06-billing-and-approval-guide) | | **Customer Off-taker** (ลูกค้าผู้รับซื้อไฟฟ้า) | เข้าสู่ระบบ ดูภาพรวมพลังงานของไซต์ตนเอง อ่านกราฟ TOU จัดการผู้ใช้ฝั่งลูกค้า และลงนามรับทราบใบแจ้งหนี้ที่อนุมัติแล้ว | [คู่มือพอร์ทัลลูกค้า](./07-customer-portal-guide) · [บทบาทและสิทธิ์](./01-roles-and-permissions) | | **Troubleshooting & AI** (แก้ไขปัญหาและ AI) | แก้ปัญหา Error ค่า Ft 422, รอบบิลล็อก, AccessDenied, Rate Limit 429, มิเตอร์ขาดการติดต่อ และการใช้งาน `llms.txt` / MCP | [การแก้ไขปัญหาและคำถามที่พบบ่อย](./08-troubleshooting-faq) | ## ลำดับหัวข้อในคู่มือทั้ง 8 บท
บทที่ 01 บทบาทและสิทธิ์การใช้งาน ทำความเข้าใจโครงสร้าง ประเภทองค์กร × บทบาท และวิธีดูตารางสิทธิ์แบบอ่านอย่างเดียวในระบบ บทที่ 02 การเข้าสู่ระบบและจัดการบัญชีผู้ใช้ การลงชื่อเข้าใช้ ตัวสลับบริษัทลูกค้า ค้นหาด่วน ศูนย์การแจ้งเตือน ภาษา/ธีม และการเปลี่ยนรหัสผ่าน บทที่ 03 คู่มือผู้ดูแลแพลตฟอร์ม (Platform Admin) แดชบอร์ดภาพรวม การสร้างบริษัทผู้พัฒนา อัตราค่าไฟและค่า Ft บัญชีธนาคาร วันหยุด สุขภาพฐานข้อมูล และ Audit Log บทที่ 04 คู่มือผู้ดูแลบริษัทผู้พัฒนา (Developer Admin) โปรไฟล์และลายเซ็นบริษัท การเพิ่มลูกค้า ไซต์และสัญญา PPA การลงทะเบียนมิเตอร์ การจัดการ VPN และผู้ใช้ บทที่ 05 คู่มือมิเตอร์และข้อมูลพลังงาน (Meter & Telemetry) มอนิเตอร์มิเตอร์ การวินิจฉัย HES การสับเปลี่ยนมิเตอร์ กราฟและตาราง 15 นาที VEE Backfill และเปรียบเทียบช่วงเวลา บทที่ 06 คู่มือการวางบิลและอนุมัติ 3 ขั้นตอน การออกใบแจ้งหนี้ TOU การตรวจสอบทางเทคนิค การอนุมัติ การลงนามฝั่งลูกค้า และการจัดการรอบบิล บทที่ 07 คู่มือพอร์ทัลลูกค้า (Customer Portal) ประสบการณ์การใช้งานฝั่งผู้รับซื้อไฟฟ้า การดูกราฟพลังงาน การตรวจสอบเอกสารที่อนุมัติแล้ว และการลงนามรับทราบ (Countersign) บทที่ 08 การแก้ไขปัญหา คำถามที่พบบ่อย และการเชื่อมต่อ AI แนวทางแก้ Error ยอดนิยม (เช่น ค่า Ft 422, รหัสผ่าน, มิเตอร์) และการใช้ llms.txt / MCP ร่วมกับ AI
::: info หมายเหตุสำหรับผู้ใช้ AI Assistant และ MCP สามารถเข้าถึงดัชนีเอกสารแบบข้อความล้วนได้ที่ /llms.txt ไฟล์รวมภาษาไทยฉบับเต็มได้ที่ /th/llms-full.txt หรือเปิดใช้ MCP Server ด้วยคำสั่ง `bun run docs:mcp` หากต้องการอ่านคู่มือฉบับภาษาอังกฤษให้เปิดที่ [English Manual (`/en/`)](/en/) :::
--- ## บทบาทและสิทธิ์การใช้งาน Source: https://docs.wattdee.com/th/01-roles-and-permissions ::: warning การอัปเดต UAT คู่มือนี้อธิบายระบบรุ่นที่จะอัปเดต หน้าจอหรือการทำงานบางส่วนอาจแตกต่างจากระบบ UAT ปัจจุบัน ::: # บทบาทและสิทธิ์การใช้งาน (Roles & Permissions) **ผู้ที่เกี่ยวข้อง:** ทุกบทบาท ผู้ดูแลแพลตฟอร์ม ผู้ดูแลบริษัทผู้พัฒนา ผู้ดูแลฝั่งลูกค้า **สิ่งที่ต้องเตรียมก่อนเริ่ม:** - มีบัญชีผู้ใช้ที่ผู้ดูแลระบบสร้างให้แล้ว (ระบบปิดการสมัครสมาชิกด้วยตนเองเพื่อความปลอดภัย) - หากต้องการเปิดดูตารางสิทธิ์ภายในระบบ ต้องมีสิทธิ์ผู้ดูแล (`ผู้ดูแลแพลตฟอร์ม`, `ผู้ดูแลบริษัท` หรือ `ผู้ดูแลฝั่งลูกค้า`) --- ## หลักการทำงานของสิทธิ์: ประเภทบริษัท × บทบาท ในระบบ WattDee **ไม่มีการกำหนดสิทธิ์แยกรายไซต์** สิทธิ์ของทุกคนเกิดจาก 2 ปัจจัยร่วมกันเสมอ คือ: 1. **ประเภทองค์กร (Organization Tier)** ที่บัญชีนั้นสังกัดอยู่: กำหนด **ขอบเขตบริษัทและไซต์** ที่มองเห็นได้ 2. **บทบาทในองค์กร (Role)**: กำหนด **การทำงาน** ที่ทำได้ภายในขอบเขตนั้น ::: warning ข้อควรระวังสำคัญเกี่ยวกับชื่อบทบาท ชื่อบทบาท `ADMIN` ในแต่ละระดับองค์กร **มีสิทธิ์ไม่เท่ากัน** - `ADMIN` ของ **เจ้าของแพลตฟอร์ม** คือ **ผู้ดูแลแพลตฟอร์ม** (ควบคุมทุกบริษัท ทุกไซต์ และค่าอ้างอิงทั้งระบบ) - `ADMIN` ของ **บริษัทผู้พัฒนา** คือ **ผู้ดูแลบริษัท** (จัดการทีมงาน ลูกค้า ไซต์ และมิเตอร์เฉพาะของบริษัทตนเอง) - `ADMIN` ของ **บริษัทลูกค้า** คือ **ผู้ดูแลฝั่งลูกค้า** (จัดการพนักงานในบริษัทตนเอง และลงนามรับใบแจ้งหนี้เท่านั้น ไม่สามารถแก้ไขมิเตอร์ สัญญา หรือออกบิลได้) ::: --- ## ขอบเขตการเข้าถึงตามประเภทองค์กร (3 ระดับ) | ประเภทองค์กรในระบบ | ชื่อที่แสดงในหน้าจอ | ไซต์ที่เข้าถึงได้ | หน้าที่หลักในแพลตฟอร์ม | | :--- | :--- | :--- | :--- | | **Platform Owner** (`SUPER_ADMIN`) | **เจ้าของแพลตฟอร์ม** | **ทุกบริษัทลูกค้าและทุกไซต์ในระบบ** | บริหารผู้พัฒนาทั้งหมด ตั้งค่าอัตราค่าไฟ/Ft วันหยุด บัญชีธนาคาร โปรไฟล์ VPN และดูแลระบบส่วนกลาง | | **Solar Developer** (`DEVELOPER`) | **ผู้พัฒนาโครงการ** | **เฉพาะไซต์ที่บริษัทตนเป็นผู้พัฒนา** และบริษัทลูกค้าของตนเอง | เพิ่มลูกค้า สร้างไซต์ กำหนดสัญญา PPA ลงทะเบียนมิเตอร์ ดูแล O&M และออก/ตรวจสอบ/อนุมัติใบแจ้งหนี้ | | **Customer Company** (`OFFTAKER`) | **บริษัทลูกค้า** | **เฉพาะไซต์ที่บริษัทตนเป็นผู้รับซื้อไฟฟ้า** | ติดตามพลังงานแสงอาทิตย์ ตรวจสอบใบแจ้งหนี้ที่อนุมัติแล้ว และลงนามรับใบแจ้งหนี้ | --- ## ตารางบทบาททั้งหมดแยกตามประเภทองค์กร ### 1. องค์กรระดับเจ้าของแพลตฟอร์ม (Platform Owner) | บทบาท (รหัส) | ชื่อบทบาทในหน้าจอ | ระดับสิทธิ์ | สิ่งที่ทำได้ | | :--- | :--- | :--- | :--- | | `ADMIN` | **ผู้ดูแลแพลตฟอร์ม** | ผู้ดูแล (`Manage`) | สิทธิ์สูงสุดทั้งระบบ: สร้าง/ลบ/เปลี่ยนประเภทบริษัท กำหนดขีดจำกัดมิเตอร์ จัดการผู้ใช้ทุกองค์กร ตั้งค่าอัตราค่าไฟฟ้า ประกาศค่า Ft รายเดือน แก้ไขปฏิทินวันหยุด จัดการบัญชีธนาคาร สร้าง/ผูกโปรไฟล์ VPN แก้ไข Serial มิเตอร์และยืนยันการสับเปลี่ยนมิเตอร์ ออกบิลก่อนสิ้นรอบ ตรวจสอบสุขภาพฐานข้อมูล และดูประวัติระบบ (Audit Log) | | `SERVICE` | **ทีมปฏิบัติการส่วนกลาง** | ปฏิบัติการ (`Operate`) | ดูแลมิเตอร์และการสื่อสารของ **ทุกไซต์ในระบบ**: ลงทะเบียน/แก้ไข/สับเปลี่ยนมิเตอร์ ทดสอบการเชื่อมต่อและสั่งอ่านค่าทันที ดู IP/พอร์ต/ซิม ประมวลผลข้อมูลโหลดย้อนหลัง ดูสาเหตุคุณภาพข้อมูล 15 นาที รับทราบ/เลื่อน/มอบหมายการแจ้งเตือน ดูรายงานเทียบบิลคู่ขนาน และดูอัตรา Ft/วันหยุด *(ไม่สามารถจัดการผู้ใช้ แก้ไขค่าอ้างอิง หรืออนุมัติใบแจ้งหนี้)* | ### 2. องค์กรระดับผู้พัฒนาโครงการโซลาร์ (Solar Developer) | บทบาท (รหัส) | ชื่อบทบาทในหน้าจอ | ระดับสิทธิ์ | สิ่งที่ทำได้ | | :--- | :--- | :--- | :--- | | `ADMIN` | **ผู้ดูแลบริษัท** | ผู้ดูแล (`Manage`) | แก้ไขข้อมูลบริษัท อัปโหลดโลโก้และลายเซ็น เพิ่ม/แก้ไข/ลบบริษัทลูกค้าและผู้ใช้ของลูกค้า จัดการทีมงานภายในบริษัทตนเอง สร้าง/แก้ไขไซต์และสัญญา PPA จัดการมิเตอร์และแก้ไขข้อมูลโหลดย้อนหลัง จัดการแจ้งเตือน และทำรายการใบแจ้งหนี้ได้ครบทุกขั้นตอน รวมถึงออกบิลก่อนสิ้นรอบ *(ยกเว้นงานส่วนกลาง เช่น สร้างบริษัทผู้พัฒนา ตั้งค่า Ft/วันหยุด/บัญชีธนาคาร จัดการ VPN และแก้ Serial มิเตอร์ที่ต้องให้ผู้ดูแลแพลตฟอร์มดำเนินการ)* | | `SERVICE` | **วิศวกร O&M** | ปฏิบัติการ (`Operate`) | ลงทะเบียน/แก้ไข/สับเปลี่ยนมิเตอร์ ทดสอบการเชื่อมต่อและสั่งอ่านค่าทันที ดู IP/พอร์ต/ซิม ประมวลผลและเติมข้อมูลโหลดย้อนหลัง (VEE/CSV) ดูสาเหตุคุณภาพข้อมูล รับทราบ/มอบหมายแจ้งเตือน และทำหน้าที่ **ตรวจสอบทางเทคนิคใบแจ้งหนี้ (ขั้นที่ 2)** รวมถึงดูรายงานเทียบบิลคู่ขนาน *(ไม่สามารถสร้างหรืออนุมัติใบแจ้งหนี้)* | | `ACCOUNTING` | **ฝ่ายบัญชี** | บิลและรายงาน (`Billing`) | ดูใบแจ้งหนี้ฉบับร่างและฉบับอนุมัติ สร้างและคำนวณบิลใหม่ **อนุมัติใบแจ้งหนี้ (ขั้นที่ 3)** ยกเลิกใบแจ้งหนี้พร้อมเหตุผล ลบใบแจ้งหนี้ฉบับร่าง ดูรายงานเทียบบิลคู่ขนาน ดูอัตรา Ft/วันหยุด และดูบัญชีธนาคารรับชำระ *(ตามกฎการอนุมัติ 3 ขั้นตอน ผู้ตรวจสอบขั้นที่ 2 และผู้อนุมัติขั้นที่ 3 ต้องไม่ใช่บุคคลเดียวกัน)* | | `OPERATOR` | **ผู้ควบคุมระบบ** | ปฏิบัติการ (`Operate`) | ตรวจสอบมิเตอร์และกราฟการผลิต ทดสอบการเชื่อมต่อและสั่งอ่านค่าทันที ดู IP/พอร์ต/ซิม ดูสาเหตุคุณภาพข้อมูล 15 นาที ส่งและรับทราบ/เลื่อน/มอบหมายการแจ้งเตือน และดูอัตรา Ft/วันหยุด *(ไม่สามารถเพิ่ม/แก้ไข/ลบมิเตอร์ หรือแก้ไข/นำเข้าข้อมูล 15 นาที)* | ### 3. องค์กรระดับบริษัทลูกค้าผู้รับซื้อไฟฟ้า (Customer Company / Off-taker) | บทบาท (รหัส) | ชื่อบทบาทในหน้าจอ | ระดับสิทธิ์ | สิ่งที่ทำได้ | | :--- | :--- | :--- | :--- | | `ADMIN` | **ผู้ดูแลฝั่งลูกค้า** | ผู้ดูแล (`Manage`) | แก้ไขข้อมูลบริษัทของตนเอง อัปโหลดโลโก้และลายเซ็นฝั่งลูกค้า เพิ่ม/แก้ไข/ระงับผู้ใช้ภายในบริษัทลูกค้าของตนเอง ดูอีเมลและบทบาทของเพื่อนร่วมงาน ดูตารางสิทธิ์ และดูใบแจ้งหนี้ที่ **อนุมัติแล้ว (APPROVED)** พร้อมลงนามรับใบแจ้งหนี้ในนามลูกค้า *(ไม่เห็นใบแจ้งหนี้ฉบับร่างก่อนอนุมัติ)* | | `CUSTOMER` | **ตัวแทนลูกค้า** | บิลและรายงาน (`Billing`) | ดูใบแจ้งหนี้ที่ **อนุมัติแล้ว (APPROVED)** และลงนามรับใบแจ้งหนี้ในนามลูกค้า ดูภาพรวมไซต์และกราฟพลังงานของบริษัท *(ไม่เห็นเมนูการตั้งค่าและไม่เห็นอีเมล/บทบาทของเพื่อนร่วมงาน)* | | `READER` | **ดูอย่างเดียว** | ดูอย่างเดียว (`Read only`) | ดูแดชบอร์ด มอนิเตอร์มิเตอร์ และดูข้อมูล/กราฟ 15 นาทีของไซต์บริษัทตนเองเท่านั้น *(ไม่มีเมนูประวัติการวางบิล ไม่มีเมนูการตั้งค่า และแก้ไขข้อมูลใดๆ ไม่ได้)* | --- ## วิธีเปิดดูตารางสิทธิ์ตามบทบาทในระบบ ผู้ดูแลระบบทุกองค์กรสามารถตรวจสอบตารางสิทธิ์แบบละเอียดได้ตลอดเวลาจากหน้า **สิทธิ์ตามบทบาท** ซึ่งดึงข้อมูลตรงจากนโยบายความปลอดภัยของเซิร์ฟเวอร์ (ไม่สามารถแก้ไขจากหน้าเว็บได้ เพื่อป้องกันการกำหนดสิทธิ์คลาดเคลื่อน): 1. คลิกเมนู **การตั้งค่า (Settings)** ในแถบนำทางด้านซ้าย 2. เลือกบริษัทที่ต้องการตรวจสอบ (หากคุณเป็นผู้ดูแลบริษัทผู้พัฒนา ระบบจะเปิดหน้าบริษัทของคุณให้อัตโนมัติ) 3. คลิกแท็บ **ผู้ใช้และสิทธิ์ (People & access)** 4. ที่ปุ่มสลับด้านบน ให้คลิก **สิทธิ์ตามบทบาท (Role permissions)** 5. ระบบจะแสดงตารางสิทธิ์แบ่งตามหมวดหมู่ (**บุคคลและองค์กร**, **ไซต์และมิเตอร์**, **บิลและใบแจ้งหนี้**, **ข้อมูลอ้างอิงทั้งระบบ**) พร้อมไฮไลต์คอลัมน์ **บทบาทของคุณ** และสรุปจำนวนสิทธิ์ที่แต่ละบทบาทได้รับ (เช่น `26 / 26` หรือ `7 / 26`) ![ตารางสิทธิ์ตามบทบาทในหน้าการตั้งค่า](/screenshots/th/27-settings-permission-matrix.png) *ภาพที่ 1: หน้าจอตารางสิทธิ์ตามบทบาท (Role permissions) แบบอ่านอย่างเดียว แยกตามประเภทบริษัท* ::: tip สิ่งที่ถูกซ่อนจากองค์กรระดับผู้พัฒนาและลูกค้า ในแท็บสิทธิ์ตามบทบาทของบริษัทผู้พัฒนาและบริษัทลูกค้า สิทธิ์ส่วนกลางอย่างการสร้างบริษัทผู้พัฒนา การประกาศอัตรา Ft การแก้ปฏิทินวันหยุด และบัญชีธนาคาร จะไม่แสดงในตาราง โดยมีข้อความแจ้งด้านล่างว่าเป็นสิทธิ์เฉพาะ **ผู้ดูแลแพลตฟอร์ม** เท่านั้น ::: --- ## ขั้นตอนถัดไป - [การเข้าสู่ระบบ การนำทาง และบัญชีผู้ใช้](./02-login-and-account) - [คู่มือผู้ดูแลแพลตฟอร์ม (Platform Admin)](./03-platform-admin-guide) - [คู่มือผู้ดูแลบริษัทผู้พัฒนา (Developer Admin)](./04-developer-admin-guide) --- ## การเข้าสู่ระบบและจัดการบัญชีผู้ใช้ Source: https://docs.wattdee.com/th/02-login-and-account ::: warning การอัปเดต UAT คู่มือนี้อธิบายระบบรุ่นที่จะอัปเดต หน้าจอหรือการทำงานบางส่วนอาจแตกต่างจากระบบ UAT ปัจจุบัน ::: # การเข้าสู่ระบบ การนำทาง และบัญชีผู้ใช้ **ผู้ที่เกี่ยวข้อง:** ทุกบทบาท ผู้ดูแลแพลตฟอร์ม ผู้ดูแลบริษัทผู้พัฒนา ทีมปฏิบัติการ ฝ่ายบัญชี ลูกค้าผู้รับซื้อไฟฟ้า **สิ่งที่ต้องเตรียมก่อนเริ่ม:** - อีเมลสำหรับเข้าสู่ระบบ และรหัสผ่านเริ่มต้น (หรือรหัสผ่านชั่วคราว) ที่ผู้ดูแลบริษัทหรือผู้ดูแลแพลตฟอร์มส่งให้ - เบราว์เซอร์สมัยใหม่ที่เปิดใช้งาน Cookie และ JavaScript --- ## 1. การเข้าสู่ระบบ (Sign In) ระบบ WattDee ปิดการสมัครสมาชิกด้วยตนเองเพื่อความปลอดภัย บัญชีผู้ใช้ทุกบัญชีจะต้องถูกสร้างโดยผู้ดูแลระบบที่ได้รับสิทธิ์เท่านั้น 1. เปิดหน้าเว็บไซต์ระบบ WattDee (หากเปิดผ่านลิงก์เฉพาะ เช่น หน้าบิลหรือหน้ามิเตอร์ ระบบจะพาคุณกลับไปยังหน้านั้นทันทีหลังเข้าสู่ระบบสำเร็จ) 2. ที่มุมขวาบนของหน้าเข้าสู่ระบบ คุณสามารถคลิก **English / ไทย** เพื่อสลับภาษา หรือคลิกไอคอนพระจันทร์/พระอาทิตย์ เพื่อสลับ **โหมดสว่าง / โหมดมืด** ได้ก่อนเข้าสู่ระบบ 3. กรอก **อีเมล (Email)** และ **รหัสผ่าน (Password)** ของบัญชีบริษัทคุณ (กดไอคอนรูปตาด้านขวาเพื่อแสดงหรือซ่อนรหัสผ่าน) 4. คลิกปุ่ม **เข้าสู่ระบบ (Sign in)** ![หน้าจอเข้าสู่ระบบ WattDee](/screenshots/th/01-login-page.png) *ภาพที่ 1: หน้าจอเข้าสู่ระบบ WattDee พร้อมปุ่มเปลี่ยนภาษาและโหมดแสดงผล* ::: warning ข้อควรทราบด้านความปลอดภัยของเซสชัน (Session & Rate Limit) - **อายุเซสชัน 12 ชั่วโมง:** การเข้าสู่ระบบ 1 ครั้งมีอายุใช้งาน **12 ชั่วโมง** (ระบบต่ออายุให้อัตโนมัติระหว่างที่ใช้งานอยู่) หากครบกำหนดหรือออกจากระบบ จะต้องเข้าสู่ระบบใหม่อีกครั้ง - **การจำกัดความถี่ในการเข้าสู่ระบบ (Rate Limit):** หากกรอกรหัสผ่านผิดหรือส่งคำขอเข้าสู่ระบบซ้ำติดกันหลายครั้งในช่วงเวลาสั้นๆ ระบบจะระงับการเข้าสู่ระบบชั่วคราวและแจ้งเตือน `มีการเข้าสู่ระบบหลายครั้งเกินไป กรุณาลองใหม่ภายหลัง` ให้รอสักครู่แล้วลองใหม่อีกครั้ง - **บัญชีที่ถูกระงับ (Suspended):** หากผู้ดูแลระงับบัญชีของคุณ ระบบจะตัดเซสชันทันทีและไม่อนุญาตให้เข้าสู่ระบบจนกว่าจะถูกเปิดใช้งานอีกครั้ง ::: --- ## 2. การใช้งานแถบด้านบน: ตัวสลับบริษัทและค้นหาด่วน แถบด้านบน (Top Navigation Bar) ช่วยให้คุณกำหนดขอบเขตข้อมูลที่กำลังดู และกระโดดไปยังบริษัท ไซต์ หรือมิเตอร์ที่ต้องการได้อย่างรวดเร็ว ### ตัวสลับกลุ่มบริษัท / ผู้พัฒนาโครงการ (Portfolio Switcher) 1. คลิกปุ่มตัวเลือกบริเวณมุมซ้ายบนของแถบด้านบน (ข้างโลโก้ WattDee): - **ผู้ดูแลแพลตฟอร์ม / ทีมส่วนกลาง:** จะเห็นตัวเลือก **ทุกผู้พัฒนาโครงการ (All developers)** หรือรายชื่อบริษัทผู้พัฒนาโครงการเพื่อกรองข้อมูลทั้งระบบ - **ผู้พัฒนาโครงการ:** จะเห็นตัวเลือก **ทุกบริษัทลูกค้า (All customers)** หรือรายชื่อบริษัทลูกค้าแต่ละราย พร้อมจำนวน `(X ไซต์ · Y มิเตอร์)` - **ลูกค้าที่มีบริษัทเดียว:** จะแสดงชื่อบริษัท จำนวนไซต์/มิเตอร์ และจุดสีเขียวแบบอ่านอย่างเดียว (ไม่ต้องสลับ) 2. หากรายการมีมากกว่า 8 บริษัท จะมีช่อง **ค้นหา (Search)** ภายในเมนูดรอปดาวน์ให้พิมพ์กรองได้ทันที 3. การเปลี่ยนตัวเลือกในแถบนี้จะอัปเดตขอบเขตของหน้า **แดชบอร์ด** และ **มอนิเตอร์มิเตอร์** ไปพร้อมกัน *(เมื่ออยู่ในหน้า **การตั้งค่า** แถบนี้จะแสดงลิงก์กลับไปยังรายชื่อ **บริษัท** แทน)* ### ช่องค้นหาด่วน (Global Search) 1. คลิกที่ช่อง **ค้นหาบริษัท ไซต์ มิเตอร์ (Search companies, sites, meters)** บนแถบด้านบน 2. พิมพ์ชื่อบริษัท ชื่อไซต์ รหัสไซต์ หรือหมายเลข Serial ของมิเตอร์ 3. ระบบจะจัดกลุ่มผลลัพธ์แบบลำดับชั้น (**บริษัท > ไซต์ > มิเตอร์**) เฉพาะรายการที่คุณมีสิทธิ์เข้าถึง 4. ใช้ปุ่มลูกศรขึ้น/ลงแล้วกด `Enter` หรือคลิกที่รายการเพื่อเปิดหน้านั้นทันที *(หากเปิดค้นหาขณะอยู่ในหน้า **การตั้งค่า** การคลิกผลลัพธ์จะเปิดหน้าตั้งค่าของรายการนั้นโดยตรง)* ![แถบนำทางด้านบน ตัวสลับกลุ่มลูกค้า และช่องค้นหาด่วน](/screenshots/th/03-navbar-group-search.png) *ภาพที่ 2: แถบด้านบนแสดงปุ่มย่อแถบนำทาง ตัวสลับบริษัทลูกค้า และช่องค้นหาบริษัท/ไซต์/มิเตอร์* --- ## 3. ศูนย์การแจ้งเตือน (Notification Center) ไอคอนรูปกระดิ่งบริเวณมุมขวาบนจะแสดงตัวเลขจำนวนการแจ้งเตือนที่ยังไม่ได้แก้ไข (แสดง `9+` หากมีมากกว่า 9 รายการ) 1. คลิกไอคอน **กระดิ่ง (การแจ้งเตือน)** เพื่อเปิดหน้าต่างแจ้งเตือน 2. ใช้แท็บกรอง 3 มุมมอง: - **ใหม่ (New):** การแจ้งเตือนที่ยังเปิดอยู่ - **วิกฤต (Critical):** เฉพาะเหตุการณ์ระดับวิกฤตที่ควรตรวจก่อน - **ทั้งหมด (All):** รวมรายการที่รับทราบหรือเลื่อนการแจ้งเตือนไว้แล้ว 3. ในแต่ละรายการ คุณสามารถคลิก **ดูมิเตอร์ (View meter)** เพื่อเปิดดูมิเตอร์ต้นทาง หรือคลิก **เปิดศูนย์การแจ้งเตือน (Open alert workspace)** ด้านล่างเพื่อเข้าสู่หน้าประวัติและการจัดการแจ้งเตือนเต็มรูปแบบ 4. สำหรับบทบาทที่มีสิทธิ์จัดการแจ้งเตือน (`alert.manage` เช่น ผู้ดูแล, วิศวกร O&M, ผู้ควบคุมระบบ): - คลิก **รับทราบ (Acknowledge)** เพื่อบันทึกว่ามีผู้รับเรื่องแล้ว หรือคลิก **รับทราบทั้งหมด (Acknowledge all)** ด้านบน - คลิก **จัดการ (Manage)** เพื่อ **เลื่อนการแจ้งเตือน (Snooze)** ได้ `1 ชม.`, `8 ชม.` หรือ `24 ชม.`, **มอบหมายให้ (Assign to)** เพื่อนร่วมงานในองค์กรเดียวกัน และเขียน **บันทึก (Note)** ความคืบหน้า (ไม่เกิน 500 ตัวอักษร) แล้วกด **บันทึก** ![ศูนย์การแจ้งเตือนในแถบด้านบน](/screenshots/th/04-notification-center.png) *ภาพที่ 3: ศูนย์การแจ้งเตือน แสดงตัวกรอง ใหม่/วิกฤต/ทั้งหมด ปุ่มรับทราบ การเลื่อน และมอบหมายงาน* --- ## 4. แถบนำทางด้านซ้ายและเมนูบัญชีผู้ใช้ (User Menu) ### แถบนำทางด้านซ้าย (Sidebar) - กลุ่ม **การปฏิบัติการ (Operations)** ประกอบด้วย: - **แดชบอร์ด (Dashboard):** ภาพรวมพลังงาน แถบสุขภาพมิเตอร์ และงานที่ต้องดำเนินการ - **มอนิเตอร์มิเตอร์ (Meter Monitoring):** ตารางสถานะมิเตอร์ พื้นที่ งานซ่อมบำรุง และศูนย์แจ้งเตือน - **ประวัติการวางบิล (Billing History):** *(แสดงเฉพาะบทบาทที่มีสิทธิ์ดูใบแจ้งหนี้ เช่น ฝ่ายบัญชี, วิศวกร O&M, ผู้ดูแล และตัวแทนลูกค้า; บทบาท `ดูอย่างเดียว` จะไม่เห็นเมนูนี้)* - ส่วน **การตั้งค่า (Settings):** *(แสดงเฉพาะผู้ที่มีสิทธิ์เข้าถึงการตั้งค่า)* คลิกเพื่อกางเมนูย่อย เช่น **บริษัท**, **การคิดบิล/อัตรา**, **ธนาคาร**, **วันหยุด**, **ฐานข้อมูล/ระบบ**, **ประวัติระบบ** (เฉพาะเมนูที่บทบาทของคุณมีสิทธิ์) - คุณสามารถคลิกปุ่มขีดสามขีดบนแถบด้านบนเพื่อ **ย่อ / ขยายแถบนำทาง** ได้ตลอดเวลา ### เมนูบัญชีผู้ใช้ (ด้านล่างของแถบนำทาง) คลิกที่ชื่อและบทบาทของคุณบริเวณมุมซ้ายล่างของแถบนำทางเพื่อเปิดเมนูบัญชีผู้ใช้: 1. ตรวจสอบข้อมูลยืนยันตัวตน: ชื่อ-นามสกุล, อีเมล, ป้ายบทบาท, รหัสบัญชี, องค์กร และขอบเขตบริษัทลูกค้าที่กำลังดู 2. เปลี่ยน **ภาษา (Language)** ระหว่าง **ไทย** และ **English** ได้ทันทีโดยไม่ต้องออกจากระบบ 3. เปลี่ยน **ธีม (Theme)** ระหว่าง **สว่าง (Light)**, **มืด (Dark)** และ **ตามระบบ (System)** 4. ใช้ทางลัด **ภาพรวมบริษัทของฉัน** (สำหรับผู้ใช้ทั่วไปที่ไม่มีเมนูการตั้งค่า) หรือ **การตั้งค่า** 5. คลิก **เปลี่ยนรหัสผ่าน (Change password)** หรือ **ออกจากระบบ (Sign out)** --- ## 5. การเปลี่ยนรหัสผ่านด้วยตนเอง (Change Password) คุณสามารถเปลี่ยนรหัสผ่านของตนเองได้ตลอดเวลา และควรเปลี่ยนทันทีเมื่อได้รับรหัสผ่านชั่วคราวครั้งแรก 1. คลิกชื่อบัญชีของคุณที่มุมซ้ายล่างของแถบนำทาง แล้วเลือก **เปลี่ยนรหัสผ่าน** 2. กรอก **รหัสผ่านปัจจุบัน** 3. กรอก **รหัสผ่านใหม่** และ **ยืนยันรหัสผ่านใหม่** 4. ตรวจสอบรายการ **เกณฑ์ความปลอดภัยมาตรฐาน** ด้านล่างให้ขึ้นเครื่องหมายถูกสีเขียวครบทั้ง 5 ข้อ: - ความยาวอย่างน้อย 8 ตัวอักษร - มีตัวพิมพ์ใหญ่อย่างน้อย 1 ตัว (`A–Z`) - มีตัวพิมพ์เล็กอย่างน้อย 1 ตัว (`a–z`) - มีตัวเลขอย่างน้อย 1 ตัว (`0–9`) - มีสัญลักษณ์หรืออักขระพิเศษอย่างน้อย 1 ตัว (`!@#$%^&*` ฯลฯ) - รหัสผ่านใหม่ต้องไม่ซ้ำกับรหัสผ่านปัจจุบัน และช่องยืนยันต้องตรงกัน 5. คลิกปุ่ม **ยืนยันเปลี่ยนรหัสผ่าน** ![เมนูบัญชีผู้ใช้และหน้าต่างเปลี่ยนรหัสผ่าน](/screenshots/th/05-user-menu-password.png) *ภาพที่ 4: เมนูบัญชีผู้ใช้ที่ด้านล่างแถบนำทาง พร้อมตัวเลือกภาษา ธีม และการเปลี่ยนรหัสผ่าน* ::: warning ผลต่ออุปกรณ์อื่นเมื่อเปลี่ยนหรือรีเซ็ตรหัสผ่าน - **เมื่อคุณเปลี่ยนรหัสผ่านเอง:** ระบบจะยังคงเซสชันบนเบราว์เซอร์ปัจจุบันไว้ให้ใช้งานต่อได้ทันที แต่จะ **บังคับออกจากระบบบนอุปกรณ์และเบราว์เซอร์อื่นทั้งหมด** โดยอัตโนมัติ เพื่อป้องกันกรณีสงสัยว่าบัญชีรั่วไหล - **เมื่อผู้ดูแลระบบกดรีเซ็ตรหัสผ่านให้คุณ (Admin Password Reset):** ระบบจะ **ยกเลิกเซสชันของคุณบนทุกอุปกรณ์ทันที** คุณต้องนำรหัสผ่านใหม่หรือรหัสผ่านชั่วคราวที่ได้รับมาเข้าสู่ระบบใหม่ แล้วเปลี่ยนรหัสผ่านเป็นของตนเองทันที ::: --- ## ขั้นตอนถัดไป - [ดูรายละเอียดสิทธิ์ของแต่ละบทบาท](./01-roles-and-permissions) - [สำหรับผู้ดูแลแพลตฟอร์ม: คู่มือการตั้งค่าระบบส่วนกลาง](./03-platform-admin-guide) - [สำหรับผู้ดูแลบริษัทผู้พัฒนา: คู่มือตั้งค่าลูกค้า ไซต์ และมิเตอร์](./04-developer-admin-guide) - [สำหรับทีมปฏิบัติการ: คู่มือมอนิเตอร์มิเตอร์และวิเคราะห์ข้อมูล](./05-meter-and-telemetry-guide) --- ## คู่มือผู้ดูแลแพลตฟอร์ม (Platform Admin) Source: https://docs.wattdee.com/th/03-platform-admin-guide ::: warning การอัปเดต UAT คู่มือนี้อธิบายระบบรุ่นที่จะอัปเดต หน้าจอหรือการทำงานบางส่วนอาจแตกต่างจากระบบ UAT ปัจจุบัน ::: # คู่มือผู้ดูแลแพลตฟอร์ม (Platform Admin Guide) **ผู้ที่เกี่ยวข้อง:** ผู้ดูแลแพลตฟอร์ม (Platform ADMIN) ทีมปฏิบัติการส่วนกลาง (Platform SERVICE - เฉพาะส่วนที่ได้รับสิทธิ์) **สิ่งที่ต้องเตรียมก่อนเริ่ม:** - บัญชีผู้ใช้สังกัดองค์กรเจ้าของแพลตฟอร์ม (`Advanced Grid Co., Ltd.`) ในบทบาท **ผู้ดูแลแพลตฟอร์ม** - ข้อมูลบริษัทผู้พัฒนาโครงการ (ชื่อไทย/อังกฤษ, เลขผู้เสียภาษี 13 หลัก) และประกาศอัตราค่า Ft / วันหยุดราชการประจำปี --- ## 1. แดชบอร์ดภาพรวมทั้งพอร์ตโฟลิโอ (Solar Portfolio) เมื่อเข้าสู่ระบบ หน้าแรกคือ **แดชบอร์ด (Dashboard)** ซึ่งรวบรวมสถานะของทุกผู้พัฒนาและทุกไซต์ไว้ในหน้าเดียว: 1. **เลือกขอบเขตที่แถบด้านบน:** ใช้ตัวสลับ **ทุกผู้พัฒนาโครงการ (All developers)** เพื่อดูภาพรวมทั้งหมด หรือเลือกเฉพาะบริษัทผู้พัฒนาโครงการที่ต้องการตรวจสอบ 2. **ตรวจสอบแถบสุขภาพมิเตอร์และระบบ (Health Strip):** ดูสัดส่วนมิเตอร์ `ออนไลน์`, `ขาดการติดต่อ`, `ยังไม่ส่งข้อมูล`, `มิเตอร์มีแจ้งเตือน` และสถานะความล่าช้าของการประมวลผลข้อมูล HES (คลิกแต่ละป้ายเพื่อเปิดรายการมิเตอร์ที่มีปัญหาได้ทันที) 3. **อ่านการ์ด KPI 4 ช่อง:** - **พลังงานผลิตวันนี้ (kWh)** พร้อมสัดส่วน Peak / Off-Peak / Holiday และเปอร์เซ็นต์เทียบกับเมื่อวานในช่วงเวลาเดียวกัน - **มูลค่าผลิตวันนี้ (บาท)** *(หมายเหตุ: หากขอบเขตที่เลือกมีหลายไซต์ที่ใช้อัตราค่าไฟต่างกัน ระบบจะแสดง `-` เพื่อไม่ให้ตัวเลขคลาดเคลื่อนจากการเฉลี่ย)* - **พลังงานสะสมเดือนนี้ (kWh)** และมูลค่าสะสม - **กำลังผลิตติดตั้งรวม (kWp)** และจำนวนไซต์ที่เปิดใช้งาน 4. **ตรวจคิวงานด้านขวา (ต้องดำเนินการ / Action Queue):** - หากรอบเดือนปัจจุบันยังไม่มีการยืนยันอัตรา **ค่า Ft** ระบบจะแสดงรายการ **ยืนยันค่า Ft ของรอบ YYYY-MM** ให้คลิกเพื่อกรอกและยืนยันอัตราได้ทันทีจากหน้าแดชบอร์ด - แสดงการแจ้งเตือนมิเตอร์ล่าสุด ใบแจ้งหนี้ที่รอตรวจสอบ/รออนุมัติ และพลังงานที่เข้ามาหลังปิดรอบบิล 5. **วิเคราะห์กราฟการผลิตพลังงานและรายชื่อไซต์:** สลับมุมมองกราฟได้ทั้ง **วัน** (เส้นโหลด 15 นาที เทียบเส้นประ **ประมาณการ** ท้องฟ้าโปร่ง), **เดือน** (แท่งรายวัน) และ **ปี** (แท่งรายเดือน) พร้อมคลิกที่แท่งกราฟเพื่อเจาะลึก (Drill-down) และกด **ดูตารางสรุป TOU วัน/เดือน** หรือสลับตารางไซต์ระหว่าง **ตาราง** กับ **การ์ด** ![หน้าแดชบอร์ดภาพรวมพอร์ตโฟลิโอของผู้ดูแลแพลตฟอร์ม](/screenshots/th/02-dashboard-overview.png) *ภาพที่ 1: แดชบอร์ดภาพรวมพลังงาน แถบสุขภาพมิเตอร์ กราฟ TOU และคิวงานที่ต้องดำเนินการ* --- ## 2. การจัดการรายชื่อบริษัทและการสร้างบริษัทผู้พัฒนา ผู้ดูแลแพลตฟอร์มเป็นบทบาทเดียวที่สามารถสร้างบริษัทผู้พัฒนาโครงการ ลบบริษัท เปลี่ยนประเภทองค์กร และกำหนดขีดจำกัดจำนวนมิเตอร์ได้ ### การค้นหาและเปิดดูรายชื่อบริษัท 1. คลิก **การตั้งค่า (Settings)** > **บริษัท (Companies)** ในแถบนำทางด้านซ้าย 2. ใช้ช่อง **ค้นหาบริษัท (Search companies)** เพื่อกรองตามชื่อหรือรหัสบริษัท 3. รายชื่อบริษัทจะแบ่งเป็น 3 กลุ่มหลัก: - **ผู้ดูแลแพลตฟอร์ม (Platform administration)** - **บริษัทผู้พัฒนา (Developer companies)** - **ลูกค้าที่ยังไม่มีผู้ดูแล (Unassigned customers)** ![หน้ารายชื่อบริษัทในเมนูการตั้งค่า](/screenshots/th/20-settings-companies-directory.png) *ภาพที่ 2: หน้าจัดการรายชื่อบริษัท แยกตามระดับองค์กร พร้อมปุ่มเพิ่มบริษัทผู้พัฒนา* ### ขั้นตอนการสร้างบริษัทผู้พัฒนาโครงการใหม่ 1. ในหน้า **การตั้งค่า > บริษัท** คลิกปุ่ม **เพิ่มบริษัทผู้พัฒนา (Add developer company)** 2. กรอก **ชื่อบริษัท (ภาษาไทย)** และ **ชื่อบริษัท (ภาษาอังกฤษ)** *(จำเป็น)* 3. ตรวจสอบ **ประเภทองค์กร (Organization type)** ให้เป็น **ผู้พัฒนาโครงการโซลาร์ (Solar developer)** 4. กรอกข้อมูลสำหรับใบกำกับภาษีและใบแจ้งหนี้: **เลขประจำตัวผู้เสียภาษี (13 หลัก)**, **เบอร์โทรศัพท์**, **อีเมลสำหรับวางบิล** และ **ที่อยู่สำนักงานใหญ่** 5. หากมีข้อมูลแล้ว สามารถกรอก **ชื่อ-นามสกุลผู้มีอำนาจลงนาม**, **ตำแหน่งผู้ลงนาม** และอัปโหลด **ภาพลายเซ็น (PNG พื้นหลังโปร่งใส)** กับ **โลโก้บริษัท** ได้ทันที 6. คลิก **เพิ่มบริษัท (Add company)** เพื่อบันทึก ![หน้าต่างสร้างบริษัทผู้พัฒนาใหม่](/screenshots/th/21-settings-create-developer-modal.png) *ภาพที่ 3: แบบฟอร์มสร้างบริษัทผู้พัฒนาใหม่ พร้อมช่องข้อมูลภาษีและลายเซ็นดิจิทัล* ### การตั้งค่าขีดจำกัดมิเตอร์ (Meter Limit) และสร้างผู้ดูแลคนแรกให้บริษัท 1. คลิกเข้าไปที่บริษัทผู้พัฒนาที่สร้างไว้ แล้วเปิดแท็บ **ข้อมูลบริษัท (Company information)** > คลิก **แก้ไขข้อมูลบริษัท (Edit company profile)** 2. ปรับ **ขีดจำกัดมิเตอร์ที่ใช้งาน (Active meter limit)** (ค่าเริ่มต้น `100,000` มิเตอร์ต่อบริษัท; ไม่นับรวมมิเตอร์ที่ปิดใช้งาน) แล้วกด **บันทึกข้อมูล** 3. ไปที่แท็บ **ผู้ใช้และสิทธิ์ (People & access)** ของบริษัทผู้พัฒนานั้น แล้วคลิก **เพิ่มผู้ใช้ (Add user)** เพื่อสร้างบัญชี **ผู้ดูแลบริษัท (Company administrator)** คนแรกให้ทีมผู้พัฒนาสามารถเข้าไปจัดการลูกค้า ไซต์ และพนักงานของตนเองได้ ::: tip การลบบริษัทและข้อมูลใบแจ้งหนี้ หากจำเป็นต้องกด **ลบบริษัท (Delete company)** ใบแจ้งหนี้ที่เคยออกไปแล้วจะยังคงถูกเก็บรักษาไว้ไม่เปลี่ยนแปลง ::: --- ## 3. การจัดการโครงสร้างอัตราค่าไฟฟ้าและอัตราค่า Ft รายเดือน เฉพาะ **ผู้ดูแลแพลตฟอร์ม** เท่านั้นที่ประกาศ/แก้ไขอัตราค่า Ft รายเดือนได้ (สิทธิ์ `ftrate.write`) 1. ในแถบนำทางด้านซ้าย ภายใต้ **การตั้งค่า** คลิก **การคิดบิล/อัตรา (Billing & tariffs)** ### แท็บที่ 1: โครงสร้างอัตราค่าไฟฟ้า (Tariffs) 1. ตรวจสอบแถบ **กติกาการคำนวณบิลที่ใช้อยู่ปัจจุบัน** (วันตัดรอบบิล ทศนิยมหน่วยไฟ/อัตรา/จำนวนเงิน และค่าปรับ Power Factor) 2. คลิก **เพิ่มอัตรา (Add tariff)** หรือคลิก **แก้ไข (Edit)** บนอัตราที่ต้องการ (เช่น อัตรา PEA TOU) 3. กำหนด **ประเภทอัตรา (Tariff Category)**, **วันที่เริ่มต้น/สิ้นสุด**, อัตรา **Peak / Off-Peak / วันหยุด**, **ค่าบริการ**, และ **ประเภทบิล** (`รวมค่า Ft` หรือ `ไม่รวมค่า Ft`) 4. คลิก **ตั้งค่าการคำนวณบิลขั้นสูง** เพื่อปรับค่าสำหรับสัญญาที่ใช้อัตรานี้: - **วันตัดรอบบิล (1–28)** *(เช่น `25` หมายถึงรอบวันที่ 25 ถึง 24 ของเดือนถัดไป)* - **ครบกำหนดชำระ (0–120 วันหลังตัดรอบ)** - **ทศนิยมหน่วยไฟ (`0–4`) / อัตรา (`2–6`) / จำนวนเงิน (`0–4`)** - **ค่าปรับ Power Factor (กฟภ.)**: เปิด/ปิด เกณฑ์ขั้นต่ำ (มาตรฐาน `0.85`) และอัตราค่าปรับ (มาตรฐาน `56.07` บาท/kVAR) 5. คลิก **บันทึก** หรือกด **CSV** เพื่อส่งออกตารางอัตราค่าไฟทั้งหมด ::: warning วันตัดรอบบิลจะถูกล็อกเมื่อไซต์มีใบแจ้งหนี้แล้ว ไซต์ที่เคยออกใบแจ้งหนี้แล้ว (ยกเว้นใบที่ถูกตีกลับ `REJECTED`) จะไม่สามารถเปลี่ยน **วันตัดรอบบิล** ได้ เพื่อป้องกันงวดบิลซ้อนทับหรือขาดช่วง โดยระบบจะยังคงอัปเดตเงื่อนไขอื่นให้และแจ้งเตือนรายชื่อไซต์ที่คงวันตัดรอบเดิมไว้ ::: ### แท็บที่ 2: อัตราค่า Ft รายเดือน (Monthly Ft rates) 1. สลับไปยังแท็บ **อัตราค่า Ft รายเดือน** 2. คลิกปุ่ม **ประกาศอัตราค่า Ft (Publish Ft rate)** (หรือกด **แก้ไข** ในแถวเดือนที่ต้องการ) 3. ระบุ **รอบบิล (Billing Month)** ในรูปแบบ `YYYY-MM` เช่น `2026-10` 4. กรอก **อัตราค่า Ft (บาท/kWh)** (รองรับค่าตั้งแต่ `-2.0000` ถึง `10.0000` เช่น `0.3972`) 5. คลิก **บันทึกอัตราค่า Ft (Save Ft rate)** ![หน้าตั้งค่าโครงสร้างอัตราค่าไฟฟ้าและอัตราค่า Ft รายเดือน](/screenshots/th/29-settings-tariff-ft-rates.png) *ภาพที่ 4: หน้าการคิดบิล/อัตรา แสดงแท็บโครงสร้างอัตราค่าไฟฟ้าและแท็บอัตราค่า Ft รายเดือน* ::: warning ห้ามออกใบแจ้งหนี้โดยไม่มีอัตราค่า Ft ระบบจะ **ปฏิเสธการคำนวณใบแจ้งหนี้ (Error 422)** สำหรับเดือนที่ยังไม่ได้ประกาศอัตราค่า Ft โดยเด็ดขาด ผู้ดูแลแพลตฟอร์มควรประกาศหรือยืนยันค่า Ft ประจำเดือนล่วงหน้าก่อนวันตัดรอบบิล ::: --- ## 4. บัญชีธนาคาร ปฏิทินวันหยุด สุขภาพฐานข้อมูล และประวัติระบบ ### การตั้งค่าบัญชีธนาคารรับชำระ (`การตั้งค่า > ธนาคาร`) 1. คลิก **ธนาคาร (Bank accounts)** ใต้เมนูการตั้งค่า 2. คลิก **เพิ่มบัญชีธนาคาร (Add bank account)** (หรือ **แก้ไข** รายการเดิม) 3. กรอก **ชื่อธนาคาร**, **สาขา**, เลือก **ผู้ขาย (Seller)** (*ส่วนกลางใช้ร่วมทุกผู้ขาย* หรือระบุบริษัทผู้พัฒนาเฉพาะราย เพื่อให้ใบแจ้งหนี้พิมพ์บัญชีของบริษัทผู้ขายรายนั้นโดยตรง), **ชื่อบัญชี**, **เลขที่บัญชี** และ **เลขพร้อมเพย์ / QR** 4. กด **เพิ่มบัญชี / บันทึก** ### ปฏิทินวันหยุดราชการ (`การตั้งค่า > วันหยุด`) พลังงานไฟฟ้าที่ผลิตได้ในวันหยุดเสาร์-อาทิตย์ และวันที่อยู่ในปฏิทินวันหยุดนี้จะถูกจัดเข้า **อัตรา C (วันหยุด / Holiday Rate)** โดยอัตโนมัติ 1. คลิก **วันหยุด (Holidays)** ใต้เมนูการตั้งค่า 2. **วิธีเพิ่มอัตโนมัติรายปี:** เลือกปีที่ช่อง **เติมวันหยุดราชการประจำปีอัตโนมัติ (ตามประกาศ กฟภ./กฟน.)** แล้วคลิก **เติมวันหยุดประจำปีอัตโนมัติ** (รองรับปี 2025–2027) 3. **วิธีเพิ่มเฉพาะวัน:** เลือก **วันที่วันหยุด (YYYY-MM-DD)** กรอกชื่อวันหยุด (ไม่บังคับ) แล้วคลิก **เพิ่มวันหยุด** ### สุขภาพฐานข้อมูลและระบบ (`การตั้งค่า > ฐานข้อมูล/ระบบ`) *(เข้าดูได้ทั้ง `ผู้ดูแลแพลตฟอร์ม` และ `ทีมปฏิบัติการส่วนกลาง` หรือบทบาทที่มีสิทธิ์ `meter.network.read`)* 1. คลิก **ฐานข้อมูล/ระบบ (Database & system)** เพื่อตรวจสอบ: - **ขนาดฐานข้อมูลรวม** และเวอร์ชัน PostgreSQL - **ตารางเก็บข้อมูลรายเดือน (Monthly partitions)**: สถานะ `พร้อมใช้งาน` หรือ `ต้องขยายพาร์ทิชัน` พร้อมขนาดและจำนวนแถวของแต่ละตารางรายเดือน - **การซิงค์ข้อมูลจากมิเตอร์ (HES)**: ความล่าช้าในการประมวลผล (`วินาที`) และจำนวนมิเตอร์ที่รอซิงค์เกิน 1 ชั่วโมง - **จำนวนข้อมูลในระบบทั้งหมด**: โครงการ มิเตอร์ ใบแจ้งหนี้ และประวัติระบบ 2. คลิก **รีเฟรชสถานะ** เพื่อดึงข้อมูลล่าสุด ### ประวัติการใช้งานและแก้ไขระบบ (`การตั้งค่า > ประวัติระบบ`) *(สงวนสิทธิ์เฉพาะ **ผู้ดูแลแพลตฟอร์ม** ที่มีสิทธิ์ `org.admin`)* 1. คลิก **ประวัติระบบ (Audit log)** ใต้เมนูการตั้งค่า 2. กรองข้อมูลได้ตามต้องการ: - ช่อง **ค้นหาประวัติการใช้งาน** (กิจกรรม รหัส หรือรายละเอียด) - ช่อง **กรองตามอีเมลผู้ดำเนินการ** - **หมวดหมู่:** `ทุกหมวดหมู่`, `ข้อมูลมิเตอร์`, `ใบแจ้งหนี้`, `สัญญา PPA`, `อุปกรณ์มิเตอร์` - ช่วงวันที่ **ตั้งแต่** – **ถึง** 3. คลิก **ส่งออกหน้าปัจจุบัน (Export current page)** เพื่อดาวน์โหลดไฟล์ CSV *(ส่งออกเฉพาะรายการในหน้าที่แสดงอยู่ ให้ใช้ตัวกรองและเปลี่ยนหน้าเพื่อดึงประวัติย้อนหลัง)* ![หน้าตั้งค่าธนาคาร วันหยุด สุขภาพระบบ และประวัติการใช้งาน](/screenshots/th/30-settings-bank-holiday-system-audit.png) *ภาพที่ 5: ตัวอย่างหน้าจอการจัดการข้อมูลอ้างอิงและตรวจสอบระบบส่วนกลาง (ธนาคาร วันหยุด ฐานข้อมูล และ Audit Log)* --- ## 5. สิทธิ์เฉพาะผู้ดูแลแพลตฟอร์มในงานมิเตอร์และ VPN แม้ทีมผู้พัฒนาจะจัดการไซต์และมิเตอร์ของตนเองได้ แต่ยังมี 2 งานสำคัญที่สงวนสิทธิ์ไว้ให้ **ผู้ดูแลแพลตฟอร์ม** ดูแลความปลอดภัยของข้อมูลข้ามองค์กร: 1. **จัดการโปรไฟล์ VPN และผูกมิเตอร์ (`vpn.manage`):** สร้าง แก้ไข เปิด/ปิด โปรไฟล์ WireGuard/IPsec/OpenVPN และผูกมิเตอร์ในแท็บ **การเชื่อมต่อ (Connectivity)** ของไซต์ 2. **แก้ไข Serial มิเตอร์และยืนยันการสับเปลี่ยนมิเตอร์ที่ HES ตรวจพบ (`meter.identity.override`):** เมื่อมิเตอร์ใหม่ยังไม่ได้รับ Serial หรือ HES ตรวจพบ Serial ไม่ตรง/ซ้ำกับมิเตอร์อื่น ผู้ดูแลแพลตฟอร์มเป็นผู้ตรวจสอบป้ายชื่อหน้างานแล้วกด **แก้ Serial** หรือ **ยืนยันการสับเปลี่ยน** พร้อมระบุเหตุผล (อย่างน้อย 5 ตัวอักษร) ลง Audit Log --- ## ขั้นตอนถัดไป - [คู่มือผู้ดูแลบริษัทผู้พัฒนา: การจัดการลูกค้า ไซต์ และมิเตอร์](./04-developer-admin-guide) - [คู่มือมิเตอร์และข้อมูลพลังงาน: การมอนิเตอร์และ VEE](./05-meter-and-telemetry-guide) - [คู่มือการวางบิลและการอนุมัติ 3 ขั้นตอน](./06-billing-and-approval-guide) --- ## คู่มือผู้ดูแลบริษัทผู้พัฒนา (Developer Admin) Source: https://docs.wattdee.com/th/04-developer-admin-guide ::: warning การอัปเดต UAT คู่มือนี้อธิบายระบบรุ่นที่จะอัปเดต หน้าจอหรือการทำงานบางส่วนอาจแตกต่างจากระบบ UAT ปัจจุบัน ::: # คู่มือผู้ดูแลบริษัทผู้พัฒนาโครงการ (Developer Admin Guide) **ผู้ที่เกี่ยวข้อง:** ผู้ดูแลบริษัทผู้พัฒนา (Developer ADMIN) ผู้ดูแลแพลตฟอร์ม (ช่วยดำเนินการส่วน VPN และยืนยัน Serial) **สิ่งที่ต้องเตรียมก่อนเริ่ม:** - บัญชี **ผู้ดูแลบริษัท (Company administrator)** ของบริษัทผู้พัฒนาโครงการที่ผู้ดูแลแพลตฟอร์มสร้างให้แล้ว - ข้อมูลนิติบุคคลของบริษัทตนเอง (เลขผู้เสียภาษี 13 หลัก, ที่อยู่ออกใบกำกับภาษี, โลโก้ และไฟล์ลายเซ็นผู้มีอำนาจแบบ PNG พื้นหลังโปร่งใส) - ข้อมูลบริษัทลูกค้า (Off-taker), เงื่อนไขสัญญา PPA (อัตราค่าไฟ, ส่วนลด, วันตัดรอบ, เครดิตเทอม) และข้อมูลเครือข่าย/CT/VT ของมิเตอร์ --- ## 1. การตั้งค่าโปรไฟล์บริษัท โลโก้ และลายเซ็นดิจิทัล เมื่อคุณคลิกเมนู **การตั้งค่า (Settings)** ในแถบด้านซ้าย ระบบจะพาเข้าสู่พื้นที่ทำงานของบริษัทผู้พัฒนาของคุณโดยตรง 1. เปิดแท็บ **ข้อมูลบริษัท (Company information)** 2. คลิกปุ่ม **แก้ไขข้อมูลบริษัท (Edit company profile)** 3. ตรวจสอบและกรอกข้อมูลที่จะแสดงบนใบแจ้งหนี้และใบกำกับภาษี: - **ชื่อบริษัท (ภาษาไทย / ภาษาอังกฤษ)** - **เลขประจำตัวผู้เสียภาษี (13 หลัก)** - **เบอร์โทรศัพท์ (แสดงบนใบแจ้งหนี้)** และ **อีเมลสำหรับวางบิล** - **ที่อยู่สำนักงานใหญ่ (แสดงบนใบกำกับภาษี)** 4. ในหัวข้อ **ผู้มีอำนาจลงนามและลายเซ็นดิจิทัล**: - กรอก **ชื่อและนามสกุลผู้มีอำนาจลงนาม** และ **ตำแหน่งผู้ลงนาม** - คลิก **อัปโหลดภาพลายเซ็น (PNG/JPG)** *(แนะนำไฟล์ PNG พื้นหลังโปร่งใสเพื่อให้พิมพ์บนใบแจ้งหนี้ PDF ได้สวยงาม)* - คลิก **อัปโหลดภาพโลโก้** เพื่ออัปโหลดโลโก้บริษัท (รองรับ PNG, JPG, WebP) 5. คลิก **บันทึกข้อมูล (Save changes)** ![หน้าแก้ไขข้อมูลบริษัท ลายเซ็น และโลโก้](/screenshots/th/24-settings-company-profile-signature.png) *ภาพที่ 1: หน้าต่างแก้ไขข้อมูลบริษัทผู้พัฒนา พร้อมส่วนอัปโหลดลายเซ็นผู้มีอำนาจและโลโก้* ::: info ช่องข้อมูลที่ถูกล็อกโดยส่วนกลาง **ประเภทองค์กร (Organization type)** และ **ขีดจำกัดมิเตอร์ที่ใช้งาน (Active meter limit)** จะถูกกำหนดและปรับแก้โดย **ผู้ดูแลแพลตฟอร์ม** เท่านั้น ::: --- ## 2. การเพิ่มและจัดการบริษัทลูกค้า (Off-taker Customers) 1. ในหน้า **การตั้งค่า** ของบริษัทผู้พัฒนา คลิกแท็บ **บริษัทลูกค้า (Customer companies)** 2. คลิกปุ่ม **เพิ่มบริษัทลูกค้า (Add customer company)** 3. กรอกข้อมูลในขั้นตอน **1. บริษัท (Company)**: - **ชื่อบริษัทลูกค้า (ภาษาไทย หรือ อังกฤษ)** *(จำเป็น)* - **เลขประจำตัวผู้เสียภาษี (13 หลัก)**, **เบอร์โทรศัพท์ติดต่อ** และ **ที่อยู่สถานประกอบการ / ที่อยู่จดทะเบียน** 4. เลือกขั้นตอนถัดไปตามความพร้อมของหน้างาน: - **บันทึกและเพิ่มไซต์ (Save and add a site):** บันทึกบริษัทลูกค้าแล้วเข้าสู่ตัวช่วยสร้างไซต์และสัญญา PPA ทันที *(ยังไม่ต้องสร้างบัญชีให้ลูกค้าทันทีก็ได้ สามารถเชิญภายหลังได้)* - **บันทึกและเชิญผู้ดูแลของลูกค้า (Save and invite customer admin):** เข้าสู่ขั้นตอน **2. ผู้ดูแล (ไม่บังคับ)** เพื่อสร้างบัญชี **ผู้ดูแลฝั่งลูกค้า (Customer administrator)** คนแรก (กรอกชื่อ-นามสกุล อีเมล และกำหนดรหัสผ่านหรือเว้นว่างเพื่อสุ่มอัตโนมัติ ซึ่งระบบจะแสดงรหัสผ่านชั่วคราวให้คัดลอกเพียงครั้งเดียว) จากนั้นคลิก **ดำเนินการตั้งค่าต่อ (Continue setup)** เพื่อไปเพิ่มไซต์ต่อ ![แท็บบริษัทลูกค้าและหน้าต่างเพิ่มบริษัทลูกค้า](/screenshots/th/22-settings-developer-customers.png) *ภาพที่ 2: แท็บบริษัทลูกค้าภายใต้บริษัทผู้พัฒนา แสดงรายชื่อผู้รับซื้อไฟฟ้าและปุ่มเพิ่มบริษัทลูกค้า* --- ## 3. ตัวช่วยสร้างไซต์ สัญญา PPA และการลงทะเบียนมิเตอร์ คุณสามารถเพิ่มไซต์ได้จากแท็บ **ไซต์ในพอร์ต (Portfolio sites)** ของบริษัทผู้พัฒนา หรือเข้าไปในบริษัทลูกค้าแล้วคลิก **เพิ่มไซต์ (Add site)** ระบบจะเปิดขั้นตอนแนะนำ 3 ขั้นคือ **1. ไซต์และ PPA** → **2. มิเตอร์** → **3. ตรวจสอบ** ### ขั้นตอนที่ 1: สร้างไซต์และกำหนดสัญญา PPA 1. หากเปิดจากพอร์ตโฟลิโอรวม ให้เลือก **บริษัทลูกค้า / ผู้รับซื้อไฟฟ้า** ที่เป็นเจ้าของไซต์นั้น *(หากยังไม่มีลูกค้า สามารถคลิก **เพิ่มบริษัทลูกค้า** จากหน้านี้ได้ทันที)* 2. กรอกข้อมูลไซต์: - **ชื่อไซต์ (Site name)** *(จำเป็น)* - **กำลังติดตั้ง (kWp)** *(เช่น `500.00`, ใช้คำนวณเทียบประมาณการท้องฟ้าโปร่งบนกราฟ)* 3. กำหนดเงื่อนไขสัญญา PPA: - **ส่วนลดตามสัญญา (%)** (`0–100%`) - **วันตัดรอบบิล (`1–28`)** *(ค่าเริ่มต้นคือวันที่ `25`)* - **กำหนดชำระหลังตัดรอบ (วัน)** (`0–120` วัน, ค่าเริ่มต้น `30`) - **อัตราค่าไฟฟ้า (Tariff)** *(จำเป็น)* และสามารถกรอก **Peak กำหนดเอง (บาท/kWh)** / **Off-peak กำหนดเอง (บาท/kWh)** หากสัญญาใช้เรตเฉพาะที่ไม่ตรงกับตารางมาตรฐาน 4. คลิก **บันทึกและเพิ่มมิเตอร์ (Save and add meter)** ![หน้าตั้งค่าไซต์และเงื่อนไขสัญญา PPA](/screenshots/th/23-settings-customer-sites-contract.png) *ภาพที่ 3: การตั้งค่าไซต์และเงื่อนไขสัญญา PPA (อัตรา On-peak, Off-peak, ค่า Demand, ส่วนลด, วันตัดรอบ)* ::: tip แก้ไขไซต์หรือสัญญา PPA ภายหลัง / คัดลอกเงื่อนไขไปไซต์ถัดไป - **แก้ไขภายหลัง:** เปิดไซต์ > แท็บ **PPA** > คลิก **แก้ไขไซต์และ PPA** เพื่อปรับชื่อไซต์ กำลังติดตั้ง ตารางอัตรา PEA TOU รวมถึง **ค่าความต้องการพลังไฟฟ้า (บาท/kW)** *(การย้ายไซต์ไปบริษัทลูกค้าอื่นทำได้เฉพาะผู้ดูแลแพลตฟอร์ม และวันตัดรอบบิลจะแก้ไขไม่ได้เมื่อไซต์มีใบแจ้งหนี้แล้ว)* - **เพิ่มหลายไซต์ต่อเนื่อง:** ในขั้นตอนที่ 3 เมื่อกด **เพิ่มไซต์ถัดไปของลูกค้านี้ (Add next site for this customer)** ระบบจะคัดลอกเงื่อนไข PPA จากไซต์ก่อนหน้ามาเติมให้อัตโนมัติ ::: ### ขั้นตอนที่ 2: ลงทะเบียนมิเตอร์ (US-1.19: ไม่ต้องกรอก Serial เอง) 1. ในขั้นตอน **2. มิเตอร์** (หรือเข้าไปที่ไซต์ > แท็บ **มิเตอร์**) คลิก **เพิ่มมิเตอร์ (Add meter)** 2. กรอกข้อมูลการเชื่อมต่อและการวัดพลังงาน: - **รุ่นมิเตอร์ (Model):** `Saral 305`, `Premier 550` หรือ `Prometer 100` - **ที่อยู่ IP / โฮสต์ (Host)** และ **พอร์ต (Port)** *(ค่าเริ่มต้น `4059`)* - **ประเภทการเชื่อมต่อ (Connection):** `Public fixed IP`, `Private APN (SIM)` หรือ `VPN (Mikrotik)` *(หากใช้ VPN จะผูกโปรไฟล์ได้หลังบันทึก)* - **รูปแบบการสื่อสาร (Interface):** - **HDLC:** ใช้เมื่อมิเตอร์ต่อผ่านโมเด็ม 4G หรือตัวแปลงสัญญาณ - **WRAPPER:** ใช้เมื่อเสียบสาย LAN เข้าที่ตัวมิเตอร์โดยตรง (เช่น Prometer 100 ผ่าน Ethernet) - *หากไม่แน่ใจ ให้เลือก `HDLC` ก่อน แล้วกดทดสอบการเชื่อมต่อ ถ้าเชื่อมต่อถึงแต่มิเตอร์ไม่ตอบ ให้สลับเป็น `WRAPPER`* - **รอบการอ่าน (Poll interval):** `15 นาที`, `1 ชั่วโมง`, `6 ชั่วโมง` หรือ `24 ชั่วโมง` - **อัตราทดหม้อแปลงและตัวคูณ (CT/VT):** กรอก `CT Primary (A)`, `CT Secondary (A)`, `VT Primary (V)`, `VT Secondary (V)` ระบบจะคำนวณ **Multiplier** ให้อัตโนมัติ (เช่น `CT 1000/5 · VT 22000/110` = `×40000.0000`) - **จุดวัดพลังงาน (Reading Side):** - `Primary Side (แรงสูง / ตัวคูณหัวมิเตอร์แล้ว)`: มิเตอร์คูณ CT/VT มาแล้ว - `Secondary Side (แรงต่ำ / ต้องคูณ Multiplier)`: ระบบจะนำค่าที่อ่านได้มาคูณกับ Multiplier 3. ในโหมดตั้งค่าแนะนำ ให้ติ๊กเลือก **เริ่มอ่านค่าทันทีหลังบันทึก (Start reading right after saving)** เพื่อเปิดใช้งานใน HES และทดสอบการเชื่อมต่ออัตโนมัติ (หากเพิ่มนอกตัวช่วยตั้งค่า ให้กดปุ่ม **เปิดใช้งานใน HES** แล้วพิมพ์รหัส/Serial เพื่อยืนยัน จากนั้นกด **ทดสอบการเชื่อมต่อ**) 4. คลิก **บันทึกมิเตอร์ (Save meter)** 5. กด **ถัดไป: ตรวจสอบ** เพื่อเข้าสู่ขั้นตอน **3. ตรวจสอบ (Check)** ซึ่งจะสรุปความพร้อมของ PPA จำนวน `มิเตอร์ที่มีข้อมูล / ลงทะเบียน` และเตือนหากลูกค้ายังไม่มีบัญชีผู้ใช้งานฝั่งลูกค้า ![หน้าจอลงทะเบียนและตั้งค่ามิเตอร์ในไซต์](/screenshots/th/28-settings-site-meter-setup.png) *ภาพที่ 4: รายการมิเตอร์ของไซต์และแบบฟอร์มลงทะเบียนมิเตอร์ด้วย IP/Port, Interface และ CT/VT* ::: info ข้อสำคัญเกี่ยวกับ Serial Number และรหัสผ่านมิเตอร์ (US-1.19) - **ไม่ต้องกรอก Serial Number ในแบบฟอร์มเพิ่มมิเตอร์:** ระบบ HES จะอ่าน Serial Number จากตัวมิเตอร์จริงในการเชื่อมต่อสำเร็จครั้งแรก ระหว่างนั้นมิเตอร์จะแสดงสถานะ `รอ HES อ่าน Serial จากมิเตอร์ - ยังไม่ส่งเข้าบิล` เพื่อป้องกันการออกบิลผิดตัว - **รหัสผ่าน LLS Password ของมิเตอร์:** ห้ามกรอกผ่านหน้าเว็บ ให้ตั้งค่าที่เครื่อง HES (ไฟล์ secret รายรุ่นหรือ secrets file รายมิเตอร์) หากลืมตั้งค่า ระบบจะแจ้งเตือน `config_error` เมื่อทดสอบการเชื่อมต่อ - **กรณีพบ Serial ซ้ำ หรือสงสัยสับเปลี่ยนมิเตอร์:** หาก HES อ่านพบ Serial ไม่ตรงหรือชนกับมิเตอร์อื่น ระบบจะกักข้อมูลไม่ให้เข้าบิล และแสดงป้าย `ยืนยันตัวตนมิเตอร์ไม่สำเร็จ` (หรือ `Serial ซ้ำ` / `สงสัยสับเปลี่ยนมิเตอร์` ในมุมมองแพลตฟอร์ม) โปรดประสานงาน **ผู้ดูแลแพลตฟอร์ม** ตรวจสอบป้ายชื่อหน้างานแล้วกด **แก้ Serial** หรือ **ยืนยันการสับเปลี่ยน** พร้อมระบุเหตุผลอย่างน้อย 5 ตัวอักษร ::: --- ## 4. โปรไฟล์ VPN และการกำหนดให้มิเตอร์ (VPN Profiles & Connectivity) ระบบรองรับการเชื่อมต่อ VPN 3 โปรโตคอล ได้แก่ **WireGuard**, **IPsec** และ **OpenVPN** โดยใช้ร่วมกันได้ทุกไซต์ของบริษัทผู้พัฒนา ::: warning สิทธิ์ในการจัดการ VPN (`vpn.manage`) การสร้าง แก้ไข เปิด/ปิด ลบโปรไฟล์ VPN และการผูกมิเตอร์กับโปรไฟล์ VPN ในแท็บ **การเชื่อมต่อ (Connectivity)** ของไซต์ เป็นสิทธิ์ของ **ผู้ดูแลแพลตฟอร์ม (Platform Admin)** ทีมผู้พัฒนาสามารถแจ้งค่าตั้งค่า VPN ให้ผู้ดูแลแพลตฟอร์มบันทึก และตรวจสอบสถานะการเชื่อมต่อของไซต์ได้จากแท็บ **การเชื่อมต่อ** ::: ### ขั้นตอนการตั้งค่าโปรไฟล์ VPN (โดยผู้ดูแลแพลตฟอร์มในพื้นที่ของบริษัทผู้พัฒนา) 1. เปิดบริษัทผู้พัฒนาใน **การตั้งค่า** > คลิกแท็บ **โปรไฟล์ VPN (VPN profiles)** 2. คลิก **เพิ่มโปรไฟล์ VPN (Add VPN profile)** (หรือเลือกโปรไฟล์เดิมแล้วคลิก **แก้ไขการตั้งค่า**) 3. *(ทางเลือก)* สำหรับ **WireGuard** หรือ **OpenVPN** สามารถคลิก **นำเข้าการตั้งค่า (Import configuration)** เพื่อวางไฟล์คอนฟิกแล้วกด **ตรวจสอบการตั้งค่าที่นำเข้า** เพื่อเติมข้อมูลอัตโนมัติ 4. กรอก **รายละเอียดการเชื่อมต่อ**: - **ชื่อการเชื่อมต่อ** และเลือก **โปรโตคอล** (`WireGuard`, `IPsec`, `OpenVPN`) - **สำหรับ WireGuard (เลือกโหมดการเชื่อมต่อ / Connection mode):** - **เราเชื่อมต่อไปหาหน้างาน (`dial`):** ใช้เมื่อเราเตอร์ที่ไซต์มี Public IPv4 คงที่ โดยให้กรอก **ที่อยู่ IPv4 ของปลายทาง (Peer IPv4)** และ **พอร์ตปลายทาง** (เช่น `51820`) - **หน้างานเชื่อมต่อเข้ามาหาเรา (`listen`):** ใช้เมื่อหน้างานใช้ซิม **4G / CGNAT** ที่ไม่มี Public IP โดยไม่ต้องกรอก IP ปลายทาง แต่ให้ระบุ **พอร์ต UDP ของเซิร์ฟเวอร์** (`1024–65535` เช่น `51821`) และ **ต้องเปิดพอร์ต UDP นี้ใน Firewall ของเซิร์ฟเวอร์** - **เครือข่ายมิเตอร์ที่อนุญาต (Allowed meter networks CIDR):** เช่น `10.10.0.0/24` *(IP ของมิเตอร์ที่จะผูกเข้ากับ VPN นี้ต้องอยู่ในช่วง CIDR ที่ระบุ)* - กรอกค่าเฉพาะโปรโตคอล: เช่น `Local tunnel address (CIDR)`, `Peer public key`, `Keepalive (วินาที)` สำหรับ WireGuard; `IKEv2/IKEv1`, `PSK` หรือ `ใบรับรอง PEM` สำหรับ IPsec; `CA/Client Cert/Private Key (PEM)` และ `TLS Crypt` สำหรับ OpenVPN - หากแก้ไขโปรไฟล์เดิมและต้องการหมุนเวียนกุญแจ ให้ติ๊ก **เปลี่ยนข้อมูลยืนยันตัวตน (Replace credentials)** 5. คลิก **บันทึกการเชื่อมต่อ VPN (Save VPN connection)** และตรวจสถานะจนเปลี่ยนเป็น **เชื่อมต่อ VPN แล้ว (Tunnel established)** (หรือ `ระบบ VPN พร้อมทำงาน / Runner ready`) ### การกำหนด VPN ให้มิเตอร์ในไซต์ 1. เปิดไซต์ที่ต้องการ > คลิกแท็บ **การเชื่อมต่อ (Connectivity)** 2. เลือกโปรไฟล์ VPN ที่ต้องการด้านบน > เลือกมิเตอร์ในช่อง **มิเตอร์ HES (HES meter)** แล้วคลิก **กำหนด VPN ให้มิเตอร์ (Assign meter)** 3. หากต้องการยกเลิกการผูก ให้คลิก **ยกเลิก (Unassign)** *(คำเตือน: การยกเลิกการผูกจะทำให้ HES หยุดอ่านค่ามิเตอร์นั้นผ่าน VPN ทันที)* ![หน้าจัดการโปรไฟล์ VPN ของบริษัทผู้พัฒนา](/screenshots/th/25-settings-company-vpn.png) *ภาพที่ 5: แท็บโปรไฟล์ VPN แสดงรายการโปรไฟล์ สถานะการเชื่อมต่อ และแบบฟอร์มตั้งค่า WireGuard / IPsec / OpenVPN* --- ## 5. การจัดการทีมงานและผู้ใช้ของลูกค้า (People & Access) ผู้ดูแลบริษัทผู้พัฒนาสามารถจัดการผู้ใช้ทั้งภายใน **บริษัทผู้พัฒนาของตนเอง** และภายใน **บริษัทลูกค้าของตนเอง** (แท็บ **ผู้ใช้และสิทธิ์** ของบริษัทนั้นๆ) 1. เปิดแท็บ **ผู้ใช้และสิทธิ์ (People & access)** ของบริษัทที่ต้องการเพิ่มผู้ใช้ 2. คลิกปุ่ม **เพิ่มผู้ใช้ (Add user)** 3. ตรวจสอบ **สังกัด (Organization)** (หรือเลือกสังกัดหากเป็นหน้าเพิ่มผู้ใช้ส่วนกลางของบริษัท) 4. กรอก **ชื่อ-นามสกุล (Full name)** และ **อีเมล (Email)** 5. เลือก **บทบาท (Role)** ที่เหมาะสมกับหน้าที่: - ใน **บริษัทผู้พัฒนา:** `ผู้ดูแลบริษัท`, `วิศวกร O&M`, `ฝ่ายบัญชี` หรือ `ผู้ควบคุมระบบ` - ใน **บริษัทลูกค้า:** `ผู้ดูแลฝั่งลูกค้า`, `ตัวแทนลูกค้า` หรือ `ดูอย่างเดียว` - *กล่อง **เข้าถึงได้ (Access)** จะแสดงรายชื่อไซต์ทั้งหมดที่บัญชีนี้จะมองเห็นให้ตรวจสอบทันทีก่อนบันทึก* 6. กำหนด **รหัสผ่านเข้าสู่ระบบ**: คลิก **สุ่มรหัสผ่านปลอดภัย** หรือตั้งเองให้ครบเกณฑ์ 5 ข้อ หรือเว้นว่างเพื่อสร้างรหัสผ่านชั่วคราวให้อัตโนมัติ (แสดงเพียงครั้งเดียวหลังบันทึก) 7. คลิก **เพิ่มผู้ใช้ (Add user)** ### การดูแลบัญชีผู้ใช้ที่มีอยู่ - **ดูไซต์ที่เข้าถึง (View site access):** ตรวจรายชื่อไซต์ทั้งหมดที่ผู้ใช้นี้เข้าถึงได้ตามสังกัดบริษัท - **แก้ไขผู้ใช้และรีเซ็ตรหัสผ่าน (Reset password):** คลิกไอคอนดินสอ > กรอกรหัสผ่านใหม่หรือเว้นว่างเพื่อสุ่ม แล้วคลิก **ตั้งรหัสผ่านใหม่ (Reset password)** *(ผู้ใช้จะถูกออกจากระบบทุกอุปกรณ์ทันที)* - **ระงับบัญชี (Suspend account):** คลิกไอคอนปิดบัญชีเพื่อระงับการเข้าสู่ระบบทันทีโดยยังเก็บประวัติเดิมไว้ และสามารถกดเปิดใช้งานใหม่ภายหลังได้ - **ลบบัญชีถาวร (Delete account permanently):** อยู่ภายในหน้าแก้ไขผู้ใช้ ใช้เมื่อต้องการลบบัญชีถาวรเท่านั้น ![หน้าจัดการผู้ใช้และบทบาทของบริษัท](/screenshots/th/26-settings-company-people-roles.png) *ภาพที่ 6: หน้าผู้ใช้และสิทธิ์ แสดงรายชื่อทีมงาน บทบาท สถานะใช้งาน และปุ่มตรวจสอบไซต์ที่เข้าถึงได้* ::: warning กฎป้องกันข้อผิดพลาดของระบบผู้ใช้ - คุณ **ไม่สามารถเปลี่ยนบทบาทหรือระงับบัญชีของตัวเองได้** เพื่อป้องกันการยกระดับสิทธิ์หรือล็อกตัวเองออกจากระบบ - ระบบไม่อนุญาตให้ลดบทบาท ลบ หรือระงับ **ผู้ดูแลคนสุดท้ายที่ยังใช้งานอยู่** ของบริษัทใดๆ - การย้ายผู้ใช้ที่สร้างไว้แล้วข้ามไปยังบริษัทอื่น ทำได้โดย **ผู้ดูแลแพลตฟอร์ม** เท่านั้น ::: --- ## ขั้นตอนถัดไป - [คู่มือมิเตอร์และข้อมูลพลังงาน: การมอนิเตอร์ ทดสอบ HES และซ่อมแซมข้อมูล](./05-meter-and-telemetry-guide) - [คู่มือการวางบิลและการอนุมัติ 3 ขั้นตอน](./06-billing-and-approval-guide) --- ## คู่มือมิเตอร์และข้อมูลพลังงาน (Meter & Telemetry) Source: https://docs.wattdee.com/th/05-meter-and-telemetry-guide ::: warning การอัปเดต UAT คู่มือนี้อธิบายระบบรุ่นที่จะอัปเดต หน้าจอหรือการทำงานบางส่วนอาจแตกต่างจากระบบ UAT ปัจจุบัน ::: # คู่มือการมอนิเตอร์มิเตอร์และข้อมูลพลังงาน (Meter & Telemetry Guide) **ผู้ที่เกี่ยวข้อง:** ทีมปฏิบัติการส่วนกลาง (Platform SERVICE) วิศวกร O&M (Developer SERVICE) ผู้ควบคุมระบบ (OPERATOR) ผู้ดูแลบริษัท (ADMIN) ลูกค้าผู้รับซื้อไฟฟ้า (ดูอย่างเดียว) **สิ่งที่ต้องเตรียมก่อนเริ่ม:** - มีไซต์และมิเตอร์ลงทะเบียนในระบบแล้ว - สำหรับการทดสอบการเชื่อมต่อ สั่งอ่านค่าทันที และดึงข้อมูลย้อนหลัง (Backfill) จำเป็นต้องมีสิทธิ์ `meter.command` และบริการ HES กำลังทำงานอยู่ - สำหรับการเติมข้อมูล VEE แก้ไขค่าอ่าน หรือนำเข้า CSV จำเป็นต้องมีสิทธิ์ `telemetry.sync` (ผู้ดูแล หรือ วิศวกร O&M) --- ## 1. มอนิเตอร์มิเตอร์ทั้งพอร์ต (Fleet Monitoring) เปิดเมนู **มอนิเตอร์มิเตอร์ (Meter Monitoring)** จากแถบนำทางด้านซ้าย เพื่อติดตามสุขภาพอุปกรณ์ทั้งหมดโดยเรียง **มิเตอร์ที่มีปัญหาขึ้นก่อนเสมอ** ### มุมมองหลัก 4 แท็บด้านบน 1. **มิเตอร์ (Meters):** ตารางรวมมิเตอร์ทั้งหมด แสดงสถานะ ไซต์ บริษัทลูกค้า ข้อมูลล่าสุด และจำนวนการแจ้งเตือน (คลิกหัวคอลัมน์เพื่อเรียงลำดับ และคลิกที่แถวเพื่อเปิดหน้าข้อมูลมิเตอร์นั้น) - **ตัวกรองสถานะแบบปุ่มชิป:** คลิกกรอง **ขาดการติดต่อ (Offline)** *(ไม่ส่งข้อมูลเกิน 1 ชม. หรือ HES แจ้งปัญหา)*, **ยังไม่ส่งข้อมูล / ไม่ผูก HES (Not reporting / not linked)**, **มีแจ้งเตือน (With alarms)**, หรือ **ไซต์ยังไม่มีมิเตอร์ (Sites without a meter)** - **ตัวเลือก "ดูเป็น (View as)":** สลับมุมมองระหว่างตาราง **ผู้พัฒนาโครงการ** *(เฉพาะระดับแพลตฟอร์ม)*, **บริษัทลูกค้า (Offtakers)** และ **ไซต์ / มิเตอร์** - **ช่องค้นหา:** พิมพ์ชื่อไซต์ บริษัทลูกค้า Serial มิเตอร์ รุ่น รหัสไซต์ (เช่น `1-00012`) หรือ `IP:Port` 2. **พื้นที่ (Regions):** การ์ดสรุปสถานะมิเตอร์แยกตาม **จังหวัดและภูมิภาค** แสดงกำลังผลิตรวม (kWp) พิกัด GPS และแถบ **อัตราออนไลน์ (%)** (คลิกการ์ดจังหวัดเพื่อกรองตารางมิเตอร์ด้านล่าง) 3. **ซ่อมบำรุง (Maintenance):** รายงานประวัติ **สลับเปลี่ยนมิเตอร์ / ซ่อมบำรุง / สอบเทียบ / ตรวจเช็คหน้างาน** กรองตามประเภทงาน ส่งออกเป็น CSV และคลิก **บันทึกงานซ่อมบำรุง (Log maintenance)** *(สิทธิ์ `meter.write`)* เพื่อจดบันทึกงานภาคสนาม 4. **การแจ้งเตือน (Alerts):** แบ่งเป็น **การแจ้งเตือนปัจจุบัน (Active alerts)** *(รับทราบ / เลื่อน / มอบหมาย / จดบันทึก)* และ **ประวัติเหตุการณ์ (Event history)** *(กรองตามระดับ `วิกฤต / เฝ้าระวัง / ทั่วไป` และช่วงวันที่เวลาไทย ค่าเริ่มต้น 30 วันย้อนหลัง พร้อมส่งออก CSV)* ![หน้าจอมอนิเตอร์มิเตอร์ทั้งพอร์ตโฟลิโอ](/screenshots/th/06-meter-monitoring-fleet.png) *ภาพที่ 1: หน้ามอนิเตอร์มิเตอร์ แสดงแท็บมุมมอง ชิปตัวกรองสถานะ และตารางเรียงลำดับมิเตอร์ที่มีปัญหาขึ้นก่อน* --- ## 2. การเจาะลึก: ภาพรวมบริษัท → ภาพรวมไซต์ → รายละเอียดมิเตอร์ ### ภาพรวมบริษัท (Company Overview) คลิกชื่อบริษัทลูกค้าจากตัวสลับมุมมองหรือหน้าค้นหา เพื่อดู: - **ช่วงเวลาพลังงาน:** เลือก `วันนี้`, `7 วันที่ผ่านมา`, `เดือนนี้` หรือ `กำหนดเอง` (สูงสุด 93 วัน) - **KPI 4 ช่อง:** พลังงานในช่วงที่เลือก (kWh), มิเตอร์ที่ติดต่อล่าสุด (`ส่งข้อมูล / ใช้งาน`), ไซต์ที่ต้องตรวจสอบ และไซต์ทั้งหมด - **สิ่งที่ต้องตรวจสอบ (Needs attention):** แจ้งเตือนไซต์ที่ยังไม่มี PPA ไม่มีมิเตอร์ หรือมิเตอร์เงียบผิดปกติ พร้อมการ์ดสรุปสถานะบิลและตารางรายชื่อไซต์ที่ส่งออก CSV ได้ ![ภาพรวมบริษัทลูกค้า](/screenshots/th/07-meter-company-overview.png) *ภาพที่ 2: หน้าภาพรวมบริษัท แสดงแนวโน้มพลังงานรายวัน งานที่ต้องตรวจสอบ และรายชื่อไซต์ในสังกัด* ### ภาพรวมไซต์ (Site Overview) คลิกชื่อไซต์เพื่อเปิดดูพื้นที่ทำงานของไซต์: - **ภาพรวม (Overview):** กำลังติดตั้ง (kWp), มิเตอร์ที่ลงทะเบียน, เวลาติดต่อล่าสุด, กราฟพลังงาน 7 วันที่ผ่านมา และรายชื่อมิเตอร์ในไซต์ - **ข้อมูลพลังงาน (Data):** เปิดตารางและกราฟ 15 นาทีของไซต์นี้โดยตรง - **มิเตอร์ (Meters):** รายการมิเตอร์และปุ่มจัดการอุปกรณ์ (ในโหมดตั้งค่า) - **PPA:** รายละเอียดสัญญาและเงื่อนไขบิล - **การเชื่อมต่อ (Connectivity):** การกำหนดโปรไฟล์ VPN ของไซต์ ![ภาพรวมไซต์และมิเตอร์ในไซต์](/screenshots/th/08-meter-site-overview.png) *ภาพที่ 3: หน้าภาพรวมไซต์ แสดงตัวชี้วัดหลัก กราฟพลังงาน 7 วัน และรายการมิเตอร์ประจำไซต์* ### การตรวจสอบและวินิจฉัยมิเตอร์รายเครื่อง (Meter Detail & Diagnostics) เมื่อคลิกเข้าไปที่มิเตอร์ใดๆ จะพบแท็บ **ข้อมูลพลังงาน (Energy data)** และ **การตรวจสอบ (Diagnostics)** (ในโหมดตั้งค่าจะเป็น **ตั้งค่ามิเตอร์ / Configuration** และ **การตรวจสอบ / Diagnostics**): 1. ดูกล่องสถานะด้านบนสุดซึ่งสรุป **เหตุผลที่มิเตอร์อยู่ในสถานะนั้น** และ **ข้อผิดพลาดล่าสุด** จาก HES 2. ในส่วน **คำสั่ง (Commands)** *(สิทธิ์ `meter.command`)*: - คลิก **ทดสอบการเชื่อมต่อ (Test connection):** ส่งคำสั่งให้ HES ติดต่อไปยังมิเตอร์จริงเพื่อตรวจการเชื่อมต่อ TCP/DLMS และรหัสผ่าน LLS โดยจะแสดงผลลัพธ์พร้อมเวลาตอบสนอง (`ms`) หรือคำแนะนำแก้ไขปัญหา เช่น - `config_error`: ยังไม่ได้ตั้งรหัสผ่าน LLS บนเครื่อง HES - `auth_failed`: มิเตอร์ปฏิเสธรหัสผ่าน LLS ให้ตรวจรหัสผ่านบนเครื่อง HES - `หมดเวลา session / operation was canceled`: ต่อถึงแต่มิเตอร์ไม่ตอบ มักเกิดจากเลือก Interface (`HDLC` / `WRAPPER`) ไม่ตรง - `poll_timeout / connect_failed`: ติดต่อไม่ได้ ให้ตรวจ IP/Port, เครือข่าย/VPN และไฟเลี้ยงมิเตอร์ - คลิก **อ่านค่าทันที (Read now):** สั่งให้อ่านค่าล่าสุดจากมิเตอร์ทันที 3. ตรวจสอบตาราง **ค่าล่าสุดจากมิเตอร์** (kW, kWh สะสม, PF, แรงดัน V, กระแส A), **การสื่อสารกับ HES**, **การตั้งค่ามิเตอร์** *(หากพบคำเตือน `ตัวคูณไม่เท่ากับ CT × VT` หรือ `ฝั่งที่อ่านเป็น UNKNOWN` ต้องแก้ไขให้ถูกต้องก่อนออกบิล)* และ **เหตุการณ์ล่าสุดจาก HES** ![รายละเอียดและการตรวจสอบสถานะมิเตอร์](/screenshots/th/09-meter-detail-status.png) *ภาพที่ 4: หน้าการตรวจสอบมิเตอร์ แสดงปุ่มทดสอบการเชื่อมต่อ อ่านค่าทันที ค่าล่าสุด และข้อมูลการสื่อสาร HES* --- ## 3. การสับเปลี่ยนมิเตอร์ระหว่างรอบบิล (Mid-Cycle Swap, SOW §79) เมื่อจำเป็นต้องถอดเปลี่ยนมิเตอร์หน้างาน (เช่น ชำรุด หรือส่งสอบเทียบตามรอบ กฟภ.) **ห้ามลบมิเตอร์เดิม** ให้ใช้ฟังก์ชัน **สับเปลี่ยน** เพื่อรักษาประวัติการวัดและป้องกันการคิดค่าไฟซ้ำซ้อน: 1. เปิดหน้าไซต์ใน **การตั้งค่า** > แท็บ **มิเตอร์** (ต้องมีสิทธิ์ `meter.write`) 2. ที่แถวของมิเตอร์เดิมที่กำลังใช้งานอยู่ คลิกปุ่ม **สับเปลี่ยน (Replace)** 3. กำหนด **วันและเวลาที่มีผลสับเปลี่ยน (Effective swap date and time)** ให้ตรงกับเวลาถอดเปลี่ยนจริงหน้างาน *(ระบบจะบันทึก `activeTo` เพื่อหยุดนำข้อมูลหลังเวลานั้นมาคิดซ้ำ)* 4. เลือก **มิเตอร์ทดแทนในไซต์นี้** *(หากยังไม่ได้ลงทะเบียนมิเตอร์ใหม่ ให้เลือก "ปลดประจำการอย่างเดียว" แล้วค่อยลงทะเบียนมิเตอร์ใหม่ภายหลัง)* 5. กรอก **เหตุผลการสับเปลี่ยน (Audit Reason)** แล้วคลิก **ยืนยันการสับเปลี่ยน (Confirm replacement)** ::: warning ต้องเปิดใช้งานมิเตอร์ทดแทนใน HES แยกต่างหากหลังสับเปลี่ยน การสับเปลี่ยนมิเตอร์ **ไม่ได้เปิดใช้งานมิเตอร์ทดแทนใน HES ให้อัตโนมัติ** หลังสับเปลี่ยนเสร็จ ให้คลิกปุ่ม **เปิดใช้งานใน HES (Activate in HES)** บนแถบแจ้งเตือนสีเหลือง (หรือที่แถวของมิเตอร์ทดแทน) แล้วพิมพ์ Serial/ID ยืนยันเพื่อให้ HES เริ่มอ่านค่ามิเตอร์ใหม่ นอกจากนี้ **ห้ามสับเปลี่ยนย้อนหลังเข้าไปในเดือนที่ออกใบแจ้งหนี้สถานะ CHECKED หรือ APPROVED แล้ว** ::: --- ## 4. การดูข้อมูลและวิเคราะห์โหลดโปรไฟล์ 15 นาที (View Data / Analytics) คุณสามารถเปิดหน้านี้ได้จาก `/view-data` (เลือก **ไซต์** และ **มิเตอร์** หรือ **รวมทั้งไซต์**) หรือจากแท็บ **ข้อมูลพลังงาน (Data)** ของไซต์/มิเตอร์โดยตรง เวลาทั้งหมดในหน้านี้อ้างอิง **เวลาประเทศไทย (Asia/Bangkok, UTC+7)** ### การใช้งานบันไดช่วงเวลา (Zoom Ladder) 1. **แถบนำทางช่วงเวลา:** คลิกสลับระดับความละเอียดได้ทันทีบนแถบด้านบน: - **ปี (e.g. `2026`):** แสดงแท่งพลังงาน **รายเดือน** ทั้ง 12 เดือน (คลิกแท่งเดือนเพื่อเจาะดูรายวันของเดือนนั้น) - **เดือน (e.g. `พฤศจิกายน`):** แสดงแท่งพลังงาน **รายวัน** (คลิกแท่งวันเพื่อเจาะดูข้อมูล **ราย 15 นาที** ของวันนั้น) - **วัน (e.g. `จ. 16`):** แสดงเส้นกราฟและตาราง **ราย 15 นาที (00:00–24:00)** พร้อมแถบ **Day Strip** ด้านบนสำหรับสลับไปดูวันอื่นในเดือนเดียวกันได้ในคลิกเดียว - **ช่วงวันที่ (Date range):** เลือกช่วงวันที่เอง หรือใช้ปุ่มลัด (`7 วันล่าสุด`, `30 วันล่าสุด`, `เดือนนี้`, `เดือนที่แล้ว`) และเลือกความละเอียดได้ (`15 นาที` สำหรับช่วงไม่เกิน 7 วัน, `รายชั่วโมง` ไม่เกิน 14 วัน, `รายวัน` ไม่เกิน 366 วัน, `รายเดือน`) 2. **ปุ่มลัดเพิ่มเติม:** ใช้ลูกศร `<` / `>` เพื่อเลื่อนทีละช่วง, คลิก **วันนี้**, **เมื่อวาน**, หรือ **ข้อมูลล่าสุด** เพื่อกระโดดไปยังวันล่าสุดที่มีข้อมูลจากมิเตอร์ 3. **สลับหน่วยกราฟ:** สลับระหว่าง **พลังงาน kWh** และ **กำลัง kW / สูงสุด kW** ### การอ่านกราฟและตารางข้อมูล 15 นาที - **ช่วงอัตรา TOU:** พื้นหลังแสดงสีแยกตามช่วงเวลา (`พีค` จ–ศ 09:00–22:00, `ออฟพีค` จ–ศ 22:00–09:00, `วันหยุด` เสาร์-อาทิตย์และวันหยุดราชการ) - **สถานะ `รอข้อมูล` (เส้นลายทแยง):** ช่วงเวลาล่าสุดที่ยังไม่ถึงกำหนดเวลาอ่านค่าจาก HES ระบบจะรีเฟรชให้อัตโนมัติ - **สถานะ `ไม่มีข้อมูลจากมิเตอร์` (แถวไฮไลต์สีส้ม):** ช่วงที่ขาดการติดต่อ ระบบจะพับรวมช่วงที่หายต่อเนื่องให้เห็นชัดเจนและ **ไม่เติมเลข `0` ปลอม** เด็ดขาด - **ป้ายคุณภาพข้อมูล:** `ค่าประมาณ` (ส่วนแบ่งจากยอดรวมช่วงขาดการติดต่อ หรือข้อมูล VEE) และ `รอตรวจสอบ` (มิเตอร์รายงานเหตุผิดปกติ) โดยบทบาทที่มีสิทธิ์ `telemetry.quality.read` จะเห็นคำอธิบายต้นทางใน Tooltip - **ข้อมูลรายเฟสและแยกตามมิเตอร์:** เมื่อดูแบบ **รวมทั้งไซต์** ที่มีหลายมิเตอร์ จะเห็นแท่งสัดส่วนพลังงานแยกตามมิเตอร์ และเมื่อเลือกดู **มิเตอร์เดียว** ตารางจะแสดงค่า **PF**, **แรงดัน (V L1–L3)** และ **กระแส (A L1–L3)** เพิ่มเติม (หากมิเตอร์ส่งค่ามา) - **การส่งออก:** คลิก **ส่งออก CSV** (ไฟล์ UTF-8 พร้อม BOM เปิดใน Excel ภาษาไทยไม่เพี้ยน) หรือ **พิมพ์ A4** ![หน้าจอข้อมูลและวิเคราะห์โหลดโปรไฟล์ 15 นาที](/screenshots/th/10-view-data-telemetry.png) *ภาพที่ 5: หน้าดูข้อมูล/วิเคราะห์ แสดงบันไดช่วงเวลา Day Strip เส้นกราฟ TOU ราย 15 นาที สรุปยอด และตารางข้อมูล* --- ## 5. เครื่องมือคุณภาพข้อมูล การซ่อมแซม VEE, Backfill และเทียบช่วงเวลา คลิกปุ่ม **เครื่องมือข้อมูล (Data Tools)** บริเวณมุมขวาบนของแถบควบคุมในหน้าดูข้อมูลเพื่อเข้าถึง 3 เครื่องมือสำคัญ: ### 1) ตรวจและแก้ไขข้อมูล (Data Quality & VEE Repair) ทุกคนสามารถเปิดดูความครบถ้วนได้ ส่วนการแก้ไข (3 ปุ่มด้านล่าง) สงวนสิทธิ์เฉพาะผู้ที่มี `telemetry.sync` (**ผู้ดูแล** และ **วิศวกร O&M**): - **รายงานความครบถ้วน:** แสดงเปอร์เซ็นต์ความครบถ้วน (`%`), จำนวนช่วง 15 นาทีที่มีข้อมูลเทียบกับที่คาดหวัง และสัดส่วนแยกตามแหล่งที่มา (**อ่านจากมิเตอร์อัตโนมัติ**, **เติมด้วยค่าประมาณอัตโนมัติ**, **แก้ไขด้วยมือ / นำเข้าไฟล์ CSV**) - **เติมช่วงที่ขาดหายอัตโนมัติ (Auto-fill missing intervals):** 1. เลือกมิเตอร์และวิธีคำนวณ: - **LINEAR** (*เฉลี่ยเชื่อมระหว่างจุดก่อนหน้าและจุดถัดไป*): แนะนำเมื่อข้อมูลขาดช่วงสั้นๆ - **ROLLING_AVG** (*ค่าเฉลี่ยย้อนหลังจากช่วงเวลาเดียวกันของวันก่อนหน้า*, อ้างอิงย้อนหลังสูงสุด 7 วัน) 2. คลิก **เริ่มเติมข้อมูลอัตโนมัติ** *(ระบบเติมเฉพาะช่องที่ว่างอยู่ ไม่เขียนทับข้อมูลจริง และติดป้ายกำกับเป็น `ค่าประมาณ`; เติมได้ครั้งละไม่เกิน 31 วัน)* - **แก้ไขค่าอ่านรายเวลา (Manual reading edit):** 1. เลือกมิเตอร์ และกำหนดวันเวลาที่ลงท้ายด้วย `:00`, `:15`, `:30` หรือ `:45` 2. กรอก **พลังงานไฟฟ้า (kWh)**, **กำลังไฟฟ้าเฉลี่ย (kW)** *(เว้น `0` เพื่อให้คำนวณ `kWh × 4` อัตโนมัติ)*, **kVAR** และ **เหตุผลในการแก้ไขข้อมูล** *(อย่างน้อย 3 ตัวอักษร)* 3. คลิก **บันทึกค่าที่แก้ไข** (ระบบบันทึกค่าเดิม–ค่าใหม่และชื่อผู้แก้ไขในตารางประวัติแก้ไข) - **นำเข้าไฟล์ CSV (CSV import):** 1. เลือกมิเตอร์ และระบุว่าข้อมูลในไฟล์ **เป็นหน่วยสุทธิแล้ว** หรือ **เป็นค่าดิบจากมิเตอร์ (ให้ระบบคูณ CT/VT อัตโนมัติ)** 2. อัปโหลดไฟล์ `.csv` หรือวางข้อความที่มีหัวตาราง `timestamp,active_energy_kwh,active_power_kw,reactive_power_kvar` (สูงสุด 5,000 แถวต่อครั้ง) พร้อมระบุหมายเหตุแล้วกด **นำเข้าข้อมูล** ![แผงตรวจสอบความครบถ้วนและเครื่องมือ VEE](/screenshots/th/11-view-data-quality-vee.png) *ภาพที่ 6: แผงตรวจและแก้ไขข้อมูล (Data Quality & VEE) แสดงแถบความครบถ้วน แหล่งที่มาข้อมูล และปุ่มเติม/แก้/นำเข้า CSV* ::: warning ข้อจำกัดการล็อกรอบบิล (Billing Period Lock) การเติมค่า VEE การแก้ไขค่าอ่านด้วยมือ และการนำเข้า CSV **ไม่สามารถดำเนินการในเดือนที่มีใบแจ้งหนี้สถานะ `CHECKED` (ตรวจแล้ว) หรือ `APPROVED` (อนุมัติแล้ว)** หากจำเป็นต้องแก้ไขข้อมูลในเดือนนั้น ต้องแจ้งฝ่ายบัญชีให้ส่งคืนหรือยกเลิกใบแจ้งหนี้นั้นก่อน ::: ### 2) ดึงข้อมูลย้อนหลังจากมิเตอร์ (Backfill from Meter) *(สำหรับบทบาทที่มีสิทธิ์ `meter.command`)* ใช้สั่งให้ HES อ่านหน่วยความจำโหลดโปรไฟล์ 15 นาที (`DLMS Profile Generic 1.0.99.1.0.255`) จากตัวมิเตอร์จริงย้อนหลัง: 1. เปิด **เครื่องมือข้อมูล** > **ดึงข้อมูลย้อนหลังจากมิเตอร์** 2. เลือกมิเตอร์ที่ต้องการ (เลือกได้หลายตัวพร้อมกัน) และกำหนด **ช่วงวันที่** ตามเวลาประเทศไทย *(ดึงได้ครั้งละไม่เกิน **31 วัน** และต้องไม่เกินวันนี้)* 3. ตรวจสอบสรุปจำนวนช่วงเวลา แล้วคลิก **ส่งคำขอ** 4. ระบบจะส่งคำสั่งเข้าคิว HES โดยแบ่งอ่านทีละช่วง 7 วัน และแสดงสถานะสด (`กำลังส่งคำสั่ง` → `รอคิว HES` → `กำลังอ่านโปรไฟล์` → `เสร็จ`) สามารถปิดหน้าต่างได้ระหว่างรอคำสั่งทำงาน ::: warning ผลของการดึงข้อมูลย้อนหลังต่อใบแจ้งหนี้ฉบับร่าง ข้อมูลที่ดึงได้ใหม่จากมิเตอร์จะ **เขียนทับข้อมูลเดิมในช่วงเวลานั้น** หากเดือนนั้นมีใบแจ้งหนี้ฉบับร่าง (`DRAFT`) อยู่แล้ว ใบแจ้งหนี้จะถูกติดธงว่าข้อมูลเปลี่ยนแปลงและต้องกดคำนวณบิลใหม่อีกครั้ง (ส่วนเดือนที่ `CHECKED`/`APPROVED` แล้ว ระบบจะพักข้อมูลที่เปลี่ยนแปลงไว้ในคิวข้อมูลล่าช้า) ::: ### 3) เปรียบเทียบช่วงเวลา (Compare Periods) 1. เปิด **เครื่องมือข้อมูล** > **เปรียบเทียบช่วงเวลา** 2. เลือกช่วงเปรียบเทียบด่วน (**เดือนนี้ เทียบ เดือนก่อน**, **7 วันล่าสุด เทียบ 7 วันก่อน**, **ปีนี้ เทียบ ปีก่อน**) หรือกำหนดวันที่ของ **ช่วงที่ 1** และ **ช่วงที่ 2** ด้วยตนเอง 3. ตรวจสอบการ์ดผลต่าง **พลังงานไฟฟ้ารวม (kWh)**, **Peak kW** และตารางเปรียบเทียบแยกตามช่วง **On-Peak**, **Off-Peak**, **วันหยุด** พร้อมเปอร์เซ็นต์ความเปลี่ยนแปลง ![แผงเปรียบเทียบการใช้พลังงานระหว่าง 2 ช่วงเวลา](/screenshots/th/12-view-data-period-compare.png) *ภาพที่ 7: แผงเปรียบเทียบช่วงเวลา แสดงผลต่างพลังงานรวม Peak Demand และตารางแยกช่วง TOU* --- ## ขั้นตอนถัดไป - [คู่มือการวางบิลและการอนุมัติ 3 ขั้นตอน](./06-billing-and-approval-guide) - [ย้อนกลับไปดูสิทธิ์ของแต่ละบทบาท](./01-roles-and-permissions) --- ## คู่มือการออกบิล TOU และขั้นตอนอนุมัติ 3 ระดับ Source: https://docs.wattdee.com/th/06-billing-and-approval-guide ::: warning การอัปเดต UAT คู่มือนี้อธิบายระบบรุ่นที่จะอัปเดต หน้าจอหรือการทำงานบางส่วนอาจแตกต่างจากระบบ UAT ปัจจุบัน ::: # คู่มือการออกบิล TOU และขั้นตอนอนุมัติ 3 ระดับ ระบบออกบิลและวางบิลของ WattDee (`/billing`) คำนวณค่าไฟฟ้าตามสัญญาซื้อขายไฟฟ้าภาคเอกชน (Private Solar PPA) จากข้อมูลโหลดโปรไฟล์ราย 15 นาทีของมิเตอร์อัจฉริยะ ภายใต้กฎช่วงเวลา Time-of-Use (TOU) ของการไฟฟ้าส่วนภูมิภาค (กฟภ. / PEA) พร้อมระบบตรวจสอบและอนุมัติ 3 ระดับ (**Draft → Checked → Approved**) เพื่อความโปร่งใส ตรวจสอบย้อนหลังได้ และเป็นไปตามหลักการควบคุมภายใน ::: info สิทธิ์การใช้งานหน้า `/billing` การเข้าใช้งานหน้า **ระบบวางบิล & ออกใบแจ้งหนี้ PPA** ต้องมีสิทธิ์ `invoice.view` (ดูรายละเอียดบทบาทและสิทธิ์ได้ที่ [บทบาทและสิทธิ์การใช้งาน](./01-roles-and-permissions)): - **ทีมผู้พัฒนาโครงการ / แพลตฟอร์ม** (`Platform ADMIN`, `Developer ADMIN`, `SERVICE`, `ACCOUNTING`): เข้าถึงมุมมองจัดการบิลเต็มรูปแบบและเวิร์กโฟลว์อนุมัติ 3 ระดับ - **ฝั่งลูกค้า / ผู้รับซื้อไฟฟ้า** (`Customer ADMIN`, `CUSTOMER`): ระบบจะแสดงมุมมองพอร์ทัลลูกค้าสำหรับใบแจ้งหนี้ที่ `APPROVED` แล้วเท่านั้น (ดู [คู่มือพอร์ทัลลูกค้า](./07-customer-portal-guide)) - **บทบาท `OPERATOR` และ `READER`**: ไม่มีสิทธิ์ `invoice.view` หากเปิดหน้า `/billing` โดยตรงจะพบหน้า **สิทธิ์การเข้าถึงไม่เพียงพอ (`AccessDenied`)** ::: --- ## 1. ภาพรวมหน้าจอและการสลับมุมมอง (Table และ Stage Board) เมื่อเข้าเมนู **Billing** (`/billing`) จากแถบด้านซ้าย ผู้ใช้งานสามารถเลือกดูและจัดการใบแจ้งหนี้ได้ 2 รูปแบบหลัก: ### ส่วนควบคุมและตัวกรองด้านบน 1. **รอบบิล (Billing Period)**: เลือก **เดือน** และ **ปี** ที่ต้องการจัดการ โดยด้านบนจะแสดงช่วงวันที่จริงของรอบบิลนั้นตามวันตัดรอบของสัญญา เช่น `1 ต.ค. – 31 ต.ค.` หรือ `25 ก.ย. – 24 ต.ค.` (หากสัญญาตั้งวันตัดรอบเป็นวันที่ 25) 2. **ค้นหา (Search)**: ค้นหาตามชื่อไซต์ รหัสไซต์ ชื่อบริษัทลูกค้า หรือเลขที่ใบแจ้งหนี้ 3. **ตัวกรองสถานะใบแจ้งหนี้ (Invoice Status)**: - **ทั้งหมด (All stages)** - **1. รอสร้างบิล (Missing bills)**: ไซต์ที่ใช้งานอยู่แต่ยังไม่มีใบแจ้งหนี้ในรอบบิลนี้ - **2. แบบร่าง (Draft)**: คำนวณและบันทึกแบบร่างแล้ว รอฝ่ายปฏิบัติการ/วิศวกร (`Service`) ตรวจสอบ - **3. ตรวจแล้ว (Checked)**: ผ่านการตรวจสอบข้อมูลมิเตอร์ Stage 2 แล้ว รอฝ่ายบัญชีอนุมัติ - **4. อนุมัติแล้ว (Approved)**: ออกเป็นใบแจ้งหนี้อย่างเป็นทางการพร้อมรหัสอ้างอิงใบแจ้งหนี้แล้ว - **5. ยกเลิกแล้ว (Voided)**: ใบแจ้งหนี้ที่ถูกยกเลิก (`REJECTED`) พร้อมเหตุผลและสามารถกด **ออกบิลใหม่** ได้ 4. **เครื่องมือเพิ่มเติม (More tools)**: เปิดเครื่องมือ **เทียบค่าไฟ PPA กับ กฟภ.** และ **ออกบิลกรณีข้อมูลมิเตอร์ไม่ครบ (Fallback)** ### มุมมอง 1: ตารางรวม (Table View) ตารางรวมจัดกลุ่มไซต์ตามบริษัทลูกค้า (พับ/กางกลุ่มบริษัทได้ พร้อมสรุปจำนวนไซต์ในแต่ละสเตจ เช่น `รอสร้าง · ร่าง · ตรวจแล้ว · อนุมัติ · ยกเลิก`) รองรับการติ๊กเลือกหลายรายการเพื่อ **สร้างบิลเป็นชุด** หรือ **ลงนามอนุมัติเป็นชุด** ![ตารางรวมใบแจ้งหนี้ประจำเดือนแสดงสถานะแต่ละสเตจและยอดรวมสุทธิ](/screenshots/th/13-billing-overview-table.png) ### มุมมอง 2: บอร์ดสเตจ 5 ขั้นตอน (Stage Board / Kanban) เมื่อสลับมุมมองเป็น **บอร์ดสเตจ** และเลือก **บริษัทลูกค้า** ระบบจะแสดงคอลัมน์ 5 สเตจเรียงตามลำดับการทำงาน: 1. **1. รอสร้างบิล** (`ยังไม่ได้คำนวณบิลรอบนี้`) 2. **2. แบบร่าง (Draft)** (`รอฝ่าย Service ตรวจรับรอง`) 3. **3. ตรวจแล้ว (Checked)** (`รอฝ่ายบัญชีลงนามอนุมัติ`) 4. **4. อนุมัติแล้ว (Approved)** (`ลงนามเรียบร้อย / รอลูกค้าชำระ`) 5. **5. ยกเลิกแล้ว (Voided)** (`ยกเลิก / สามารถออกบิลใหม่`) คุณสามารถคลิกการ์ดเพื่อเปิดหน้าต่างรายละเอียด ลากพื้นที่ว่างเพื่อเลื่อนบอร์ดซ้าย-ขวา หรือลากการ์ดข้ามคอลัมน์เพื่อเปลี่ยนสถานะได้ (ระบบจะบังคับกติกา 3 ระดับอัตโนมัติ เช่น ห้ามลากข้ามจาก `Draft` ไป `Approved` โดยไม่ผ่าน `Checked`) ![บอร์ดสเตจ 5 ขั้นตอนสำหรับการติดตามและลากเปลี่ยนสถานะใบแจ้งหนี้](/screenshots/th/14-billing-kanban-board.png) --- ## 2. เกณฑ์รอบบิล เวลาอ้างอิงกรุงเทพฯ (UTC+7) และการออกบิลก่อนสิ้นรอบ เพื่อให้ยอดพลังงานในใบแจ้งหนี้ตรงกับรีจิสเตอร์สิ้นเดือนของมิเตอร์จริง ระบบตัดรอบเวลาทั้งหมดตามโซนเวลา **`Asia/Bangkok` (`UTC+7`)** (ประเทศไทยไม่มี Daylight Saving Time): - **วันตัดรอบมาตรฐาน (`billingCycleDay = 1`)**: รอบบิล `YYYY-MM` ครอบคลุมตั้งแต่ `วันที่ 1 เวลา 00:00:00+07:00` (รวม) จนถึง `วันที่ 1 ของเดือนถัดไป เวลา 00:00:00+07:00` (ไม่รวม) เช่น รอบ `2026-10` คือ `01/10/2026 00:00` ถึง `31/10/2026 23:59:59` เวลาไทย - **วันตัดรอบข้ามเดือน (`billingCycleDay = 2..28`)**: หากสัญญากำหนดวันตัดรอบเป็นวันที่ `d` (เช่น `d = 25`) รอบบิล `2026-10` จะครอบคลุมตั้งแต่ `2026-09-25 00:00:00+07:00` (รวม) ถึง `2026-10-25 00:00:00+07:00` (ไม่รวม) - **ใบแจ้งหนี้รอบแรกของไซต์ใหม่ (`activeFrom`)**: หากมิเตอร์ทุกตัวในไซต์เพิ่งติดตั้งและเริ่มใช้งาน (`activeFrom`) ระหว่างรอบบิล ระบบจะบันทึกจุดเริ่มต้นของรอบบิลเป็นวันเวลา `activeFrom` ของมิเตอร์ตัวแรก เพื่อให้ใบแจ้งหนี้แรกแสดงช่วงวันที่ใช้งานจริงและไม่นับช่วงก่อนติดตั้งเป็นข้อมูลขาดหายในการตรวจ Stage 2 - **วันครบกำหนดชำระ (`dueDate`)**: คำนวณจากวันที่สิ้นสุดรอบบิลบวกด้วยจำนวนวันเครดิตในสัญญา (`paymentTermDays` ค่าเริ่มต้น `30` วัน) เวลา `23:59:59+07:00` เช่น รอบ `2026-10` ที่ตัดรอบวันที่ `25 ต.ค.` และเครดิต `30 วัน` จะครบกำหนดชำระวันที่ `24 พ.ย.` ::: warning กติกาการออกบิลก่อนสิ้นรอบ (Open-Period Guard) โดยปกติระบบจะอนุญาตให้ออกใบแจ้งหนี้ได้ **หลังจากรอบบิลสิ้นสุดแล้วเท่านั้น** (`endDate <= เวลาปัจจุบัน`): - หากพยายามออกบิลสำหรับรอบบิลที่ยังไม่เริ่ม ระบบจะปฏิเสธด้วยรหัส **`422`** - หากพยายามออกบิลระหว่างที่รอบบิลยังไม่จบ ระบบจะปฏิเสธด้วยรหัส **`422`** ยกเว้นผู้ใช้งานที่มีสิทธิ์ **`invoice.issueEarly`** (`Developer ADMIN` หรือ `Platform ADMIN`) กดยืนยันในหน้าต่าง **"รอบบิลยังไม่สิ้นสุด"** ซึ่งจะแสดงจำนวนวันที่ผ่านมาแล้วเทียบกับจำนวนวันทั้งหมดของรอบบิล (เช่น `18/31 วัน`) ก่อนอนุญาตให้ออกบิลล่วงหน้า ::: --- ## 3. การตรวจสอบอัตราค่า Ft และปฏิทินวันหยุดก่อนออกบิล ### 3.1 การยืนยันอัตราค่าไฟฟ้าผันแปร (Ft Rate) อัตราค่า Ft ตามประกาศของคณะกรรมการกำกับกิจการพลังงาน (กกพ.) เป็นตารางอ้างอิงกลางที่ใช้ร่วมกันทุกโครงการ ดังนั้นจึงกำหนดได้เฉพาะ **Platform Administrator** (`ftrate.write`) เท่านั้น: 1. หากเดือนที่เลือกยังไม่ได้ยืนยันอัตรา Ft หน้า Billing จะแสดงแถบแจ้งเตือนสีเหลือง **"ต้องยืนยันอัตรา Ft"** 2. คลิกปุ่ม **ยืนยันอัตรา Ft** เพื่อเปิดหน้าต่าง **ยืนยันอัตราค่าไฟฟ้าผันแปร (Ft) ประจำรอบบิล** (หรือตั้งค่าได้ที่เมนู **การตั้งค่า → การคิดบิล/อัตรา**) 3. ตรวจสอบรอบบิล (`YYYY-MM`) และกรอก **อัตรา Ft (บาท/หน่วย)** ในช่วง `-2.0000` ถึง `10.0000` บาท/หน่วย (ระบบอาจแสดงอัตราของเดือนล่าสุดเป็นข้อมูลอ้างอิง แต่จะไม่เติมค่าอัตโนมัติหากเดือนนั้นยังไม่มีบันทึก) 4. กด **ยืนยันอัตรา Ft ประจำรอบบิล** เพื่อบันทึก ::: danger ข้อควรระวังเรื่องอัตรา Ft - หากยังไม่มีอัตรา Ft ของรอบบิลนั้นในฐานข้อมูล การกดคำนวณหรือสร้างใบแจ้งหนี้จริงจะถูกปฏิเสธด้วยรหัส **`422`** ทันที (ระบบจะไม่สมมติอัตรา Ft ให้ใบแจ้งหนี้ทางการเงิน) - เมื่อมีใบแจ้งหนี้อย่างน้อย 1 ฉบับในเดือนนั้นเข้าสู่สถานะ `CHECKED` หรือ `APPROVED` แล้ว **อัตรา Ft ของเดือนนั้นจะถูกล็อก** ไม่สามารถแก้ไขได้อีก ::: ### 3.2 ปฏิทินวันหยุดราชการ (Public Holidays) Platform Administrator สามารถจัดการวันหยุดราชการประจำปีได้ที่ **การตั้งค่า → วันหยุด (`Holiday`)** (รองรับการเติมวันหยุดอัตโนมัติจากตาราง กฟภ. หรือเพิ่มวันหยุดพิเศษ/วันหยุดชดเชยด้วยตนเอง) วันหยุดทั้งหมดในตารางจะถูกประเมินตามวันที่ในเวลาไทย (`Asia/Bangkok`) เพื่อคิดค่าไฟในอัตรา `Holiday Off-Peak` ตลอด 24 ชั่วโมง --- ## 4. กติกาการคิดค่าไฟ TOU สูตรคำนวณ และการปัดเศษ (พร้อมตัวอย่างตัวเลขจริง) ### 4.1 ช่วงเวลา Time-of-Use (TOU) ตามประกาศ กฟภ. (เวลาไทย UTC+7) | ช่วงอัตรา (TOU Period) | วันในสัปดาห์ | ช่วงเวลา (24 ชม.) | อัตราที่ใช้คำนวณ | | :--- | :--- | :--- | :--- | | **On-Peak** | จันทร์ – ศุกร์ | `09:00:00 – 21:59:59` | อัตรา On-Peak ตามสัญญา | | **Off-Peak** | จันทร์ – ศุกร์ | `22:00:00 – 08:59:59` | อัตรา Off-Peak ตามสัญญา | | **Holiday & Weekend Off-Peak** | เสาร์ – อาทิตย์ และวันหยุดราชการ | `00:00:00 – 23:59:59` | **อัตรา Off-Peak** ตามสัญญา | ### 4.2 การรวมข้อมูลหลายมิเตอร์และการสับเปลี่ยนมิเตอร์ระหว่างรอบ (Multi-Meter & Mid-Cycle Swap) 1. **การตัดช่วงเวลาใช้งาน (`activeFrom` / `activeTo`)**: ข้อมูลราย 15 นาทีของมิเตอร์แต่ละตัวจะถูกกรองเฉพาะช่วงที่มิเตอร์ตัวนั้นใช้งานจริง (`activeFrom <= timestamp < activeTo`) เพื่อป้องกันข้อมูลทดสอบหรือข้อมูลค้างหลังปลดมิเตอร์รั่วไหลเข้าบิล 2. **พลังงานรวม (`totalEnergyKwh`)**: นำหน่วยพลังงาน (kWh) จากทุกมิเตอร์ที่ใช้งานในรอบบิลมารวมกัน 3. **ความต้องการพลังไฟฟ้าสูงสุด (`demandPeakKw`)**: คำนวณจาก **ผลรวมกำลังไฟฟ้า (kW) ของทุกมิเตอร์ที่ทำงานพร้อมกัน ณ ช่วงเวลา 15 นาทีเดียวกัน** แล้วจึงหาค่าสูงสุดตลอดทั้งรอบบิล (`max_t Σ P_m(t)`) ไม่ใช่การนำค่าสูงสุดของแต่ละมิเตอร์มาหาค่าสูงสุดแยกกัน (เช่น หากมิเตอร์ A จ่าย 400 kW พร้อมกับมิเตอร์ B ที่จ่าย 1,600 kW ในช่วง 15 นาทีเดียวกัน ค่า Peak Demand ของไซต์คือ 2,000 kW) โดยระบบจะเก็บค่า `demandOnPeakKw` และ `demandOffPeakKw` ไว้อ้างอิงด้วย แต่ค่า Demand Charge (หากมี) จะคิดจาก `demandPeakKw` สูงสุดทั้งรอบบิล 4. **เอกสารแนบตารางสับเปลี่ยนมิเตอร์**: หากในรอบบิลมีมิเตอร์มากกว่า 1 เครื่อง ระบบจะบันทึก `meterId = null` บนหัวบิลและสร้าง **หน้า 2 (Attached Meter Replacement Schedule)** แนบท้าย PDF แสดงสัดส่วน kWh, Peak kW และช่วงเวลาใช้งานของแต่ละมิเตอร์ ### 4.3 ลำดับสูตรคำนวณและกติกาการปัดเศษ (Half-Up Per-Line Rounding) ระบบคำนวณด้วยเลขทศนิยมความแม่นยำสูง (`BigNumber`) และปัดเศษแบบ **Half-Up (`ROUND_HALF_UP`) ในทุกบรรทัด** เพื่อให้ตัวเลขแต่ละบรรทัดที่พิมพ์บนใบแจ้งหนี้บวกลบกันได้ตรงถึงระดับสตางค์: 1. **ปริมาณหน่วยและพลังไฟฟ้า**: - ปัดเศษ `energyOnPeakKwh`, `energyOffPeakKwh`, `energyHolidayOffPeakKwh` เป็นทศนิยม **2 ตำแหน่ง** (ค่าเริ่มต้น ปรับได้ 0–4 ตำแหน่งตามสัญญา) - `totalEnergyKwh` = ผลรวมของทั้ง 3 บรรทัดที่ปัดเศษแล้ว - ปัดเศษ `demandPeakKw` และ `peakKvar` เป็นทศนิยม **3 ตำแหน่ง** 2. **ค่าพลังงานฐานและค่าพลังไฟฟ้าสูงสุด**: - `onPeakAmount` = `round_2(energyOnPeakKwh × onPeakRate)` - `offPeakAmount` = `round_2(energyOffPeakKwh × offPeakRate)` - `holidayOffPeakAmount` = `round_2(energyHolidayOffPeakKwh × offPeakRate)` - `baseEnergyAmountThb` = `onPeakAmount + offPeakAmount + holidayOffPeakAmount` - `demandAmountThb` = `round_2(demandPeakKw × demandRateKw)` (สัญญา Private Solar PPA ทั่วไปมักกำหนด `demandRateKw = 0.0000`) 3. **ค่าไฟฟ้าผันแปร (Ft)**: - `ftTotalAmountThb` = `round_2(totalEnergyKwh × ftRateThb)` 4. **ส่วนลดตามสัญญา PPA (`discountAmountThb`)**: - ตรวจสอบเงื่อนไขวันเริ่มและวันหมดอายุส่วนลด (`discountStartDate` – `discountExpiryDate`) เทียบกับเดือนรอบบิล - ส่วนลดคิดจาก **`(ค่าพลังงานไฟฟ้าฐาน + ค่า Ft)` เท่านั้น** โดย**ไม่นำค่าพลังไฟฟ้าสูงสุด (Demand) และค่าปรับ PF มารวมลดราคา**: - `discountAmountThb` = `round_2((baseEnergyAmountThb + ftTotalAmountThb) × (discountPercent / 100))` 5. **ค่าปรับเพาเวอร์แฟกเตอร์ (PF Penalty: ตัวเลือกตามสัญญา)**: - ใช้เมื่อสัญญาเปิดใช้งาน `pfPenaltyEnabled = true` และ `demandPeakKw > 0` และ `peakKvar > 0` - ค่าเกณฑ์มาตรฐาน `pfThreshold = 0.85` (เทียบเท่า `tan(arccos(0.85)) = 0.6197`) - กิโลวาร์ที่อนุญาต: `allowanceKvar = demandPeakKw × tanPhi` - หาก `peakKvar > allowanceKvar`: - กิโลวาร์ส่วนเกิน: `excessKvar = round_2(peakKvar - allowanceKvar)` - ค่าปรับ PF: `pfPenaltyAmountThb` = `round_2(excessKvar × pfPenaltyRateThb)` (ค่าเริ่มต้น `56.07` บาท/kVAR) 6. **ยอดก่อนภาษี ภาษีมูลค่าเพิ่ม 7% และยอดชำระสุทธิ**: - `netSubtotal` = `baseEnergyAmountThb + ftTotalAmountThb - discountAmountThb + demandAmountThb + pfPenaltyAmountThb` - `vatAmountThb` = `round_2(netSubtotal × 0.07)` - `totalPayableThb` = `netSubtotal + vatAmountThb` ### 4.4 ตัวอย่างการคำนวณทีละขั้น (Worked Examples) #### ตัวอย่างที่ 1: สัญญา Solar PPA มาตรฐาน (คิดเฉพาะพลังงาน + Ft + ส่วนลด 15% + VAT 7%) สมมติข้อมูลรอบบิล `2026-10`: - พลังงาน **On-Peak**: `10,000.00 kWh` @ `4.1839` บาท/kWh - พลังงาน **Off-Peak**: `5,000.00 kWh` @ `2.6037` บาท/kWh - พลังงาน **Holiday Off-Peak**: `2,000.00 kWh` @ `2.6037` บาท/kWh - **Peak Demand**: `120.000 kW` @ `0.0000` บาท/kW (ไม่คิดค่า Demand) | ปิดค่าปรับ PF - อัตรา **Ft**: `0.3972` บาท/kWh | **ส่วนลดสัญญา PPA**: `15.00%` | ขั้นตอน | รายการ | สูตรคำนวณและวิธีปัดเศษ | จำนวนเงิน (บาท) | | :--- | :--- | :--- | ---: | | 1 | ค่าไฟ On-Peak | `10,000.00 × 4.1839 = 41,839.00` | `41,839.00` | | 2 | ค่าไฟ Off-Peak | `5,000.00 × 2.6037 = 13,018.50` | `13,018.50` | | 3 | ค่าไฟ Holiday Off-Peak | `2,000.00 × 2.6037 = 5,207.40` | `5,207.40` | | 4 | **ค่าพลังงานไฟฟ้าฐาน (Base Energy)** | `41,839.00 + 13,018.50 + 5,207.40` | **`60,064.90`** | | 5 | **ค่า Ft รวม (`17,000.00 kWh`)** | `17,000.00 × 0.3972 = 6,752.40` | **`6,752.40`** | | 6 | รวมค่าพลังงาน + Ft (ฐานคำนวณส่วนลด) | `60,064.90 + 6,752.40` | `66,817.30` | | 7 | **หักส่วนลดสัญญา PPA `15.00%`** | `66,817.30 × 0.15 = 10,022.595` (ปัด Half-Up) | **`-10,022.60`** | | 8 | **ยอดก่อนภาษีมูลค่าเพิ่ม (Net Subtotal)** | `66,817.30 - 10,022.60` | **`56,794.70`** | | 9 | **ภาษีมูลค่าเพิ่ม (VAT 7%)** | `56,794.70 × 0.07 = 3,975.629` (ปัด Half-Up) | **`3,975.63`** | | 10 | **ยอดชำระทั้งสิ้น (Total Payable)** | `56,794.70 + 3,975.63` | **`60,770.33`** | #### ตัวอย่างที่ 2: กรณีสัญญามีค่า Demand Charge และค่าปรับ Power Factor (PF Penalty) ใช้ข้อมูลพลังงานและ Ft เดียวกับตัวอย่างที่ 1 แต่เพิ่ม: - **Peak Demand**: `120.000 kW` @ `132.9300` บาท/kW - **Peak kVAR**: `100.000 kVAR` (เปิดค่าปรับ PF ที่เกณฑ์ `0.85`, อัตรา `56.07` บาท/kVAR) 1. **ส่วนลดสัญญา PPA 15%** ยังคงเป็น **`-10,022.60` บาท** เท่าเดิม เพราะส่วนลดคิดเฉพาะ `(ค่าพลังงานฐาน + Ft)` เท่านั้น 2. **ค่า Demand Charge**: `120.000 × 132.9300` = **`15,951.60` บาท** 3. **ค่าปรับ PF Penalty**: - กิโลวาร์ที่อนุญาต (`tanPhi = 0.6197`): `120.000 × 0.6197 = 74.364 kVAR` - กิโลวาร์ส่วนเกิน: `round_2(100.000 - 74.364) = 25.64 kVAR` - ค่าปรับ PF: `round_2(25.64 × 56.07) = round_2(1,437.6348)` = **`1,437.63` บาท** 4. **ยอดก่อนภาษี**: `60,064.90 + 6,752.40 - 10,022.60 + 15,951.60 + 1,437.63` = **`74,183.93` บาท** 5. **VAT 7%**: `round_2(74,183.93 × 0.07) = round_2(5,192.8751)` = **`5,192.88` บาท** 6. **ยอดชำระทั้งสิ้น**: `74,183.93 + 5,192.88` = **`79,376.81` บาท** --- ## 5. ขั้นตอนที่ 1: การสร้างใบแจ้งหนี้ฉบับร่าง (`DRAFT`) และโหมดข้อมูลไม่ครบ สิทธิ์ที่ใช้งานได้: `invoice.generate` (`Developer ADMIN`, `Developer ACCOUNTING`, `Platform ADMIN`) ### การสร้างบิลเดี่ยวหรือสร้างบิลเป็นชุด (Batch Generation) 1. เลือกรอบบิล (เดือน/ปี) ที่ต้องการ และยืนยันว่าตั้งค่าอัตรา Ft ของเดือนนั้นเรียบร้อยแล้ว 2. **แบบรายไซต์**: คลิกปุ่ม **สร้างบิล** (หรือ **ออกบิลใหม่** สำหรับไซต์ที่ถูกยกเลิก) ที่แถวของไซต์หรือบนการ์ด Kanban 3. **แบบหลายไซต์พร้อมกัน**: ติ๊กช่องเลือกหน้าไซต์ที่ต้องการในสถานะ **รอสร้างบิล / ยกเลิกแล้ว** (หรือติ๊กเลือกทั้งบริษัทลูกค้า) จากนั้นกดปุ่ม **สร้างบิล X ใบ** ในแถบด้านล่าง 4. ตรวจสอบรายชื่อไซต์และบริษัทในหน้าต่างยืนยัน **ตรวจรายการบิลก่อนสร้าง** แล้วกดยืนยันเพื่อสร้างฉบับร่าง (`DRAFT`) ![หน้าต่างยืนยันรายการไซต์และบริษัทก่อนกดสร้างใบแจ้งหนี้แบบร่าง](/screenshots/th/15-billing-generate-modal.png) ::: tip การดึงข้อมูลย้อนหลังอัตโนมัติก่อนคำนวณ ทุกครั้งที่สั่งสร้างบิลในโหมดปกติ (`AUTO`) ระบบจะประมวลผลข้อมูลจาก `hes.meter_readings` ในรอบบิลนั้นซ้ำให้อัตโนมัติ (`refreshProjection`) เพื่อให้ข้อมูลที่ HES เพิ่งดึงย้อนหลังได้หลังสัญญาณ 4G/VPN ขาดหายถูกนำมาคำนวณครบถ้วน หากต้องการ **คำนวณบิลฉบับร่างใหม่** สำหรับบิลสถานะ `DRAFT` หรือ `CHECKED` เลขที่ใบแจ้งหนี้เดิมจะถูกคงไว้ เพิ่มเลข `revision` และรีเซ็ตสถานะกลับเป็น `DRAFT` เพื่อให้ฝ่าย Service ตรวจสอบใหม่ (ส่วนบิลที่ `APPROVED` แล้วจะไม่ถูกเขียนทับ) หากต้องการลบฉบับร่างทิ้ง สามารถกด **ลบแบบร่าง** ได้เฉพาะสถานะ **`DRAFT`** เท่านั้น ::: ### การออกบิลกรณีข้อมูลมิเตอร์ไม่ครบ (Fallback / Manual Billing) กรณีมิเตอร์ขัดข้องหรือสื่อสารไม่ได้เป็นเวลานานในรอบบิล: 1. คลิก **เครื่องมือเพิ่มเติม (More tools) → ออกบิลกรณีข้อมูลมิเตอร์ไม่ครบ** 2. เลือก **โครงการ** และ **วิธีคำนวณหน่วยไฟฟ้า**: - **ใช้ค่าเฉลี่ยย้อนหลังอัตโนมัติ (`ROLLING_AVG`)**: เฉลี่ยค่า `On-Peak`, `Off-Peak`, `Holiday`, `Peak Demand kW` และ `Peak kVAR` จากใบแจ้งหนี้ที่ไม่ถูกยกเลิกล่าสุดไม่เกิน 3 รอบบิล - **กรอกหน่วยไฟฟ้าที่จดจากหน้างานด้วยตัวเอง (`MANUAL`)**: กรอกค่า kWh แยกตามช่วงเวลา, Peak kW และ Peak kVAR จากหน้าจอมิเตอร์จริง - **ใช้ข้อมูล 15 นาทีเท่าที่มี (`AUTO`)** 3. กด **คำนวณและสร้างใบแจ้งหนี้** เพื่อบันทึกเป็น `DRAFT` --- ## 6. ขั้นตอนที่ 2: การตรวจรับรองทางเทคนิค (`DRAFT → CHECKED`) สิทธิ์ที่ใช้งานได้: `invoice.check` (`Developer ADMIN`, `Developer SERVICE`, `Platform ADMIN`) คลิกที่ใบแจ้งหนี้เพื่อเปิดหน้าต่างรายละเอียดฉบับร่าง (`Invoice Detail`) หรือกดปุ่ม **ตรวจบิล** บนตาราง/การ์ด Kanban ![หน้ารายละเอียดใบแจ้งหนี้สถานะแบบร่าง (DRAFT) พร้อมผลคำนวณและการตรวจสอบ](/screenshots/th/16-billing-invoice-detail-draft.png) เมื่อกด **ตรวจบิล (`DRAFT → CHECKED`)** ระบบจะรันชุดตรวจสอบอัตโนมัติ **Stage 2 Telemetry & Multiplier Audit** ทั้ง 6 ด้าน: 1. **การตรวจสอบ CT/VT Multiplier & ด้านการวัด (`Reading Side`)**: ตรวจว่า `readingSide` ไม่เป็น `UNKNOWN`, มิเตอร์ผ่านการยืนยันตัวตน (Identity) จาก HES แล้ว, ค่า `multiplierRatio` อยู่ในเกณฑ์ `[0.001, 1000000]` และคลาดเคลื่อนจาก `(CT Ratio × VT Ratio)` ไม่เกิน **5%** 2. **ความครบถ้วนของข้อมูลโหลดโปรไฟล์ 15 นาที (`Coverage`)**: เทียบจำนวนช่วงเวลาจริงกับที่คาดหวัง (`>= 95%` ผ่าน, `< 95%` หรือ `< 80%` เตือน `WARNING`, `0` ช่วงเวลา ไม่ผ่าน `FAILED`) 3. **ความต่อเนื่องเมื่อมีการสับเปลี่ยนมิเตอร์ (`Swap Continuity`)**: ตรวจว่าไม่มีข้อมูลซ้ำซ้อนทับซ้อนเวลาเดียวกันระหว่างมิเตอร์เก่าที่ปลด (`activeTo`) กับมิเตอร์ใหม่ 4. **ความสมเหตุสมผลทางกายภาพ (`Sanity`)**: ตรวจว่าไม่มีค่า kWh ติดลบ (`FAILED` หากพบ) และตรวจว่า Peak Demand ไม่เกิน **125%** ของกำลังผลิตติดตั้ง `kWp` (`WARNING` หากเกิน) 5. **เทียบหน่วยกับเลขอ่านมิเตอร์สะสม (`Register Reconciliation`)**: เทียบผลรวมพลังงานราย 15 นาทีกับผลต่างเลขอ่านสะสมต้นรอบ–ท้ายรอบของมิเตอร์ (และรายงานจำนวนช่วงเวลาที่ประมาณค่าจากช่วงสัญญาณขาดหาย `ESTIMATED`) 6. **เกณฑ์คุณภาพข้อมูล 15 นาทีจาก HES (`Interval Quality`)**: (แสดงเมื่อเปิดใช้งานโหมดตรวจสอบธงสถานะ HES หรือระบบป้องกันค่าผิดปกติ `PLAUSIBILITY_GUARD`) แสดงรายการช่วงเวลาที่ต้องตรวจทานก่อนอนุมัติ หากทุกหัวข้อไม่มีสถานะ `FAILED` ใบแจ้งหนี้จะเปลี่ยนเป็น **`CHECKED` (ตรวจแล้ว)** พร้อมบันทึก `checkedByServiceUserId`, `checkedAt` และรายงานผล Audit ในใบแจ้งหนี้ ::: info การล็อกรอบบิล (Period Lock) ทันทีที่ใบแจ้งหนี้เข้าสู่สถานะ `CHECKED` หรือ `APPROVED` ระบบจะล็อกข้อมูล `load_profile_15min` ของโครงการในช่วงเวลารอบบิลนั้น หากมีข้อมูลย้อนหลังส่งเข้ามาเพิ่มภายหลัง ข้อมูลดังกล่าวจะถูกแยกเก็บใน `late_intervals` โดยไม่แก้ตัวเลขของใบแจ้งหนี้ที่ตรวจรับรองแล้ว (ดูวิธีจัดการใน [การแก้ไขปัญหาเรื่องรอบบิลถูกล็อกและ Late Intervals](./08-troubleshooting-faq)) ::: --- ## 7. ขั้นตอนที่ 3: การอนุมัติขั้นสุดท้ายโดยฝ่ายบัญชี (`CHECKED → APPROVED`) สิทธิ์ที่ใช้งานได้: `invoice.approve` (`Developer ADMIN`, `Developer ACCOUNTING`, `Platform ADMIN`) ![หน้ารายละเอียดใบแจ้งหนี้สถานะตรวจแล้ว (CHECKED) พร้อมปุ่มลงนามอนุมัติของฝ่ายบัญชี](/screenshots/th/17-billing-invoice-detail-checked.png) 1. ตรวจสอบข้อมูลใบแจ้งหนี้สถานะ **`ตรวจแล้ว (CHECKED)`** และรายงาน Audit (ดูปุ่ม `ดูรายงานตรวจสอบ` ได้จากเมนู ⋮ หรือหน้าต่างรายละเอียด) 2. คลิก **ลงนามอนุมัติ (`Approve`)** (หรือเลือกหลายรายการในแท็บ `3. ตรวจแล้ว` เพื่ออนุมัติเป็นชุด) 3. ตรวจสอบยอดชำระสุทธิและผู้ตรวจรับรองในหน้าต่าง **ยืนยันการลงนามอนุมัติใบแจ้งหนี้ (Final Approval)** แล้วกด **ยืนยันและลงนามดิจิทัล** ### กฎเหล็กของการอนุมัติขั้นที่ 3 - **ห้ามข้ามขั้นตอน**: ไม่สามารถอนุมัติบิลจาก `DRAFT` เป็น `APPROVED` โดยตรงได้ ต้องผ่าน Stage 2 `CHECKED` ก่อนเสมอ - **การแบ่งแยกหน้าที่ (Segregation of Duties / SoD)**: **ผู้ตรวจรับรอง (`CHECKED`) และผู้อนุมัติ (`APPROVED`) ต้องเป็นคนละคนกัน** แม้จะเป็นผู้ใช้ระดับ `ADMIN` ก็ตาม หากผู้ใช้คนเดียวกับผู้ตรวจ Stage 2 พยายามกดอนุมัติ ระบบจะแสดงป้าย **`ติดเงื่อนไข SoD`** และปฏิเสธคำสั่ง - **รหัสอ้างอิงใบแจ้งหนี้ (`Invoice Reference Code`)**: ระบบจะสร้างแฮช SHA-256 รูปแบบ `SIG_AVG_<อักขระฐานสิบหก 32 ตัว>` จาก `invoiceNumber|totalPayableThb|billingMonth|checkedByServiceUserId` และพิมพ์ในแถบ Audit ด้านล่างของเอกสาร PDF ในชื่อ **`รหัสอ้างอิงใบแจ้งหนี้` / `Invoice reference code`** - **บันทึกภาพข้อมูลคู่สัญญา (`issuedSnapshot`)**: ขณะอนุมัติ ระบบจะบันทึกชื่อ ที่อยู่ เลขประจำตัวผู้เสียภาษี ลายเซ็นบริษัท และบัญชีธนาคารรับชำระเงิน ณ เวลานั้นลงในใบแจ้งหนี้ เพื่อไม่ให้การแก้ไขข้อมูลบริษัทในอนาคตเปลี่ยนแปลงเอกสารใบกำกับภาษีที่ออกไปแล้ว - **เผยแพร่สู่พอร์ทัลลูกค้า**: ใบแจ้งหนี้จะถูกล็อกถาวร (แก้ไขตัวเลขไม่ได้) และปรากฏในหน้า **Customer Billing** ให้ฝั่งผู้รับซื้อไฟฟ้าดาวน์โหลดและลงนามรับทราบได้ทันที --- ## 8. การพรีวิว PDF ส่งออกเอกสาร ยกเลิกบิล (Void) และติดตามการรับชำระเงิน ### 8.1 การพรีวิวและการส่งออกเอกสาร (PDF / ใบวางบิล / Excel / Word) คลิก **ดูตัวอย่าง PDF (`พรีวิว PDF`)** เพื่อเปิดหน้าต่างพรีวิวเอกสาร A4: ![รายละเอียดใบแจ้งหนี้ที่อนุมัติแล้วและปุ่มดูตัวอย่าง PDF ด้านล่าง](/screenshots/th/18-billing-invoice-pdf-preview.png) - **ลายน้ำตามสถานะ**: ฉบับที่ยังไม่อนุมัติ (`DRAFT`/`CHECKED`) จะมีลายน้ำทแยงว่า **`ร่าง – ยังไม่อนุมัติ / DRAFT – NOT APPROVED`**; ฉบับที่ยกเลิกจะมีลายน้ำ **`ยกเลิก / VOID`**; และฉบับที่ `APPROVED` แล้วจึงแสดง **`ต้นฉบับ / Original`** - **สลับดูฉบับลงนามแล้ว**: เมื่อลูกค้าอัปโหลดเอกสารลงนามกลับมาแล้ว สามารถสลับแท็บระหว่าง **ต้นฉบับระบบ (`System PDF`)** และ **เอกสารลงนามแล้ว (`Signed PDF`)** ได้ในหน้าต่างเดียวกัน - **ความปลอดภัยของภาพลายเซ็น (`Private Signature Previews`)**: ภาพลายเซ็นผู้มีอำนาจของบริษัทและภาพลายเซ็นลูกค้าถูกจัดเก็บแบบส่วนตัว (`private/signatures/...`) และเปิดดูผ่าน API ที่ตรวจสอบสิทธิ์ผู้ใช้โดยตรง (`Cache-Control: private, no-store`) ไม่เปิดลิงก์ไฟล์สาธารณะ - **ความครบถ้วนของข้อมูลนิติบุคคล**: ก่อนส่งออก PDF/Excel/Word ระบบจะตรวจสอบว่าทั้งผู้ขายและผู้ซื้อมี **ชื่อบริษัท เลขประจำตัวผู้เสียภาษี 13 หลัก และที่อยู่** ครบถ้วน หากขาดข้อมูลจะปฏิเสธด้วยรหัส **`422`** (ต้องเติมให้ครบใน **Settings** ก่อนออกเอกสาร) - **รูปแบบที่รองรับ**: `PDF` (ใบแจ้งหนี้/ใบกำกับภาษี A4), `ใบวางบิล (Billing Notice PDF)` (รายฉบับหรือรวมหลายฉบับ), `Excel (.xlsx)` (พร้อมตารางโหลดโปรไฟล์ราย 15 นาที), และ `Word (.docx)` (รายงานผู้บริหาร) ### 8.2 การยกเลิกใบแจ้งหนี้ (`Void`) และการออกบิลใหม่ (`Reissue`) หากพบข้อผิดพลาดหลังออกบิล (สามารถยกเลิกได้ทั้งสถานะ `DRAFT`, `CHECKED` หรือ `APPROVED` โดยผู้มีสิทธิ์ `invoice.void`): 1. เปิดเมนู `⋮` ของรายการนั้นแล้วเลือก **ยกเลิกบิล (`Void`)** 2. กรอก **เหตุผลในการยกเลิกใบแจ้งหนี้** (บังคับระบุอย่างน้อย 3 ตัวอักษร) แล้วกด **ยืนยันยกเลิกใบแจ้งหนี้** 3. บิลเดิมจะเปลี่ยนเป็น **`REJECTED` (`ยกเลิกแล้ว`)** พร้อมบันทึกผู้ยกเลิก เวลา และเหตุผลไว้เป็นหลักฐานถาวร (ไม่สามารถกู้คืนหรือลบออกจากระบบได้) และหากมีข้อมูลค้างใน `late_intervals` ระบบจะนำกลับเข้า `load_profile_15min` ให้อัตโนมัติ จากนั้นกด **ออกบิลใหม่** เพื่อสร้างเลขที่ใบแจ้งหนี้ฉบับใหม่ทดแทน ### 8.3 การอัปเดตสถานะชำระเงินและส่งอีเมลแจ้งหนี้ - **บันทึกสถานะการรับชำระเงิน**: คลิกป้ายสถานะการชำระเงิน (`รอชำระ` / `ชำระแล้ว` / `ชำระบางส่วน` / `เกินกำหนด`) ที่แถวบิลหรือบนการ์ดเพื่อระบุสถานะ (`UNPAID`, `PAID`, `PARTIAL`, `OVERDUE`), ยอดเงินที่รับชำระ, วันครบกำหนด และเลขที่อ้างอิงการโอนเงิน (เช่น `TRF-20261028-0091`) - **ส่งอีเมลแจ้งหนี้**: เปิดเมนู `⋮ → ส่งอีเมล` (หรือไอคอนซองจดหมาย) เพื่อส่งใบแจ้งหนี้ไปยังอีเมลแผนกบัญชีของลูกค้าพร้อมบันทึกประวัติการส่ง --- ## 9. รายงานเปรียบเทียบค่าไฟฟ้า (Tariff Comparison) และการเทียบบิลคู่ขนาน ### 9.1 รายงานเปรียบเทียบค่าไฟฟ้า PPA กับอัตรา กฟภ. (`Rate Comparison`) 1. ในหน้า Billing คลิก **เครื่องมือเพิ่มเติม → เทียบค่าไฟ PPA กับ กฟภ.** (หรือจากแถบเครื่องมือเสริม) 2. เลือกโครงการที่ต้องการ ระบบจะคำนวณจากข้อมูลโหลดโปรไฟล์ราย 15 นาทีชุดเดียวกันเทียบ 3 รูปแบบ: - **สัญญา PPA ปัจจุบัน (`PPA Contract`)**: อัตราตามสัญญาพร้อมส่วนลด PPA - **อัตรา TOU มาตรฐาน กฟภ. (`PEA Standard TOU`)**: ส่วนลด `0%` - **อัตราคงที่อ้างอิง (`Fixed Flat Rate Benchmark`)**: ค่าเฉลี่ยระหว่าง On-Peak และ Off-Peak (ไม่มีส่วนลดและไม่มีค่า Demand) 3. หน้าต่างจะสรุป **ยอดประหยัดค่าไฟสุทธิ (บาท)** และ **เปอร์เซ็นต์ที่ประหยัดได้ (%)** เทียบกับอัตรา กฟภ. ::: warning แถบแจ้งเตือนค่าเริ่มต้น Ft `0.3972` บาท/หน่วย ในรายงานเปรียบเทียบ หากรอบบิล `YYYY-MM` ที่เลือกยังไม่ได้ตั้งค่า Ft ในฐานข้อมูล รายงานเปรียบเทียบความคุ้มค่าจะยังคงแสดงผลให้ดูเบื้องต้นโดยใช้ค่าสำรอง **`0.3972` บาท/หน่วย** พร้อมแสดงแถบแจ้งเตือนสีเหลือง: > *"เดือน YYYY-MM ยังไม่ได้ตั้งค่า Ft ในระบบ: ใช้ค่าเริ่มต้น 0.3972 บาท/หน่วย สำหรับการเปรียบเทียบเบื้องต้น"* (แตกต่างจากการคำนวณ/ออกใบแจ้งหนี้จริงซึ่งจะปฏิเสธด้วยรหัส `422` จนกว่าจะบันทึกอัตรา Ft ที่ยืนยันแล้ว) ::: ![หน้าต่างรายงานเปรียบเทียบค่าไฟฟ้าตามสัญญา PPA กับอัตราปกติ กฟภ. และแถบแจ้งเตือนค่าเริ่มต้น Ft](/screenshots/th/19-billing-tariff-comparison.png) ### 9.2 รายงานเทียบบิลคู่ขนาน (Parallel Run: `invoice.compare`) สำหรับผู้ดูแลหรือทีมปฏิบัติการที่มีสิทธิ์ `invoice.compare` สามารถเปิดเมนู `⋮ → เทียบข้อมูลมิเตอร์` เพื่อเทียบผลคำนวณบิลจาก **ข้อมูลค่าสะสมปัจจุบัน (Readings Projection)** กับ **ข้อมูลราย 15 นาทีโดยตรงจาก HES (HES Intervals)** แยกตามมิเตอร์และช่วงเวลา TOU แบบอ่านอย่างเดียว พร้อมรายการช่วงเวลาที่ยังไม่ผ่านเงื่อนไขอนุมัติอัตโนมัติ (หากเปิดใช้งานโหมดตรวจสอบคุณภาพข้อมูล HES) --- ## คู่มือพอร์ทัลลูกค้า (ผู้รับซื้อไฟฟ้า) Source: https://docs.wattdee.com/th/07-customer-portal-guide ::: warning การอัปเดต UAT คู่มือนี้อธิบายระบบรุ่นที่จะอัปเดต หน้าจอหรือการทำงานบางส่วนอาจแตกต่างจากระบบ UAT ปัจจุบัน ::: # คู่มือการใช้งานพอร์ทัลลูกค้า (Customer Portal Guide) พอร์ทัลลูกค้าของ WattDee ออกแบบมาสำหรับองค์กรผู้รับซื้อไฟฟ้า (**Off-Taker / Customer Tier**) เพื่อติดตามการผลิตไฟฟ้าพลังงานแสงอาทิตย์แบบเรียลไทม์ ตรวจสอบผลประหยัดค่าไฟฟ้าเมื่อเทียบกับอัตรา กฟภ. ตรวจสอบเอกสารใบแจ้งหนี้อย่างเป็นทางการ และลงนามรับทราบใบแจ้งหนี้ (Countersign) ได้ในที่เดียว --- ## 1. บทบาทและขอบเขตสิทธิ์ของผู้ใช้งานฝั่งลูกค้า สิทธิ์การเข้าใช้งานในพอร์ทัลลูกค้าขึ้นอยู่กับบทบาทที่ได้รับภายใต้บริษัทลูกค้าของคุณ (ดูรายละเอียดเพิ่มเติมที่ [บทบาทและสิทธิ์การใช้งาน](./01-roles-and-permissions)): | บทบาท | หน้าหลักและกราฟ 15 นาที | สถานะมิเตอร์ | ดูใบแจ้งหนี้ (`APPROVED`) | ลงนามรับทราบ (`Countersign`) | จัดการผู้ใช้และข้อมูลบริษัท | | :--- | :---: | :---: | :---: | :---: | :---: | | **ผู้ดูแลฝั่งลูกค้า (`ADMIN`)** | เข้าถึงได้ | เข้าถึงได้ (ไม่เห็น IP ภายใน) | เข้าถึงได้ | เข้าถึงได้ | เข้าถึงได้ (จัดการทีมงานและลายเซ็นบริษัท) | | **ตัวแทนลูกค้า (`CUSTOMER`)** | เข้าถึงได้ | เข้าถึงได้ (ไม่เห็น IP ภายใน) | เข้าถึงได้ | เข้าถึงได้ | ไม่มีสิทธิ์ | | **ดูอย่างเดียว (`READER`)** | เข้าถึงได้ | เข้าถึงได้ (ไม่เห็น IP ภายใน) | ไม่มีสิทธิ์ (เข้า `/billing` ไม่ได้) | ไม่มีสิทธิ์ | ไม่มีสิทธิ์ | ::: info ความเป็นส่วนตัวของระบบและการแยกเอกสารภายใน - **เฉพาะใบแจ้งหนี้ที่อนุมัติแล้ว (`APPROVED`)**: ฝั่งลูกค้าจะเห็นเฉพาะใบแจ้งหนี้ที่ผ่านการตรวจและลงนามอนุมัติจากผู้จำหน่ายไฟฟ้าแล้วเท่านั้น เอกสารฉบับร่าง (`DRAFT`), ขั้นตอนตรวจ (`CHECKED`), รายงานตรวจสอบภายใน และใบแจ้งหนี้ที่ถูกยกเลิก (`REJECTED`) จะไม่แสดงในพอร์ทัลลูกค้า - **ซ่อนข้อมูลเครือข่ายภายในของเกตเวย์ HES**: เพื่อความปลอดภัยของโครงสร้างพื้นฐาน ผู้ใช้ฝั่งลูกค้าทุกบทบาท (รวมถึง `ADMIN`) จะไม่เห็น IP Address, พอร์ต TCP, หมายเลข SIM, สถานะรหัสผ่าน DLMS หรือปุ่มสั่งอ่าน/Backfill มิเตอร์โดยตรง ::: --- ## 2. หน้าหลักลูกค้า: แดชบอร์ดพลังงานแสงอาทิตย์และผลประหยัด เมื่อลงชื่อเข้าใช้ด้วยบัญชีฝั่งลูกค้า ระบบจะเปิดหน้า **ภาพรวมพลังงานและผลประหยัดค่าไฟ** (`/`) ซึ่งแสดงข้อมูลสรุปของบริษัทและโครงการในสังกัด: 1. **ส่วนหัวและตัวเลือกวันที่**: - แสดงชื่อบริษัทลูกค้า ป้าย **ส่วนลดค่าไฟ PPA (%)** และสถานะภาพรวมของมิเตอร์ (เช่น `ระบบผลิตไฟฟ้าทำงานปกติ` หรือ `มิเตอร์ออนไลน์ X/Y โครงการ`) - ใช้ตัวเลือกวันที่ (**DatePicker**) มุมขวาบนเพื่อย้อนดูกราฟและยอดผลิตรายวันในอดีต - ปุ่มลัด **ภาพรวมบริษัท** และ **ดูใบแจ้งหนี้ทั้งหมด** (`/billing` สำหรับ `ADMIN` และ `CUSTOMER`) 2. **แถบแจ้งเตือนใบแจ้งหนี้รอบล่าสุด (Latest Statement Banner)**: - แสดงใบแจ้งหนี้รอบล่าสุดที่อนุมัติแล้ว พร้อมเลขที่เอกสาร (`#INV-...`), ยอดชำระสุทธิรวม VAT 7%, พลังงานไฟฟ้ารวม (kWh) และสถานะการลงนาม (`ลงนามรับทราบแล้ว` หรือ `รอการลงนามยืนยันจากผู้รับซื้อ`) - คลิก **ตรวจสอบและลงนามใบแจ้งหนี้** เพื่อไปยังหน้าใบแจ้งหนี้ทันที 3. **การ์ดตัวชี้วัดหลัก 4 รายการ (KPI Cards)**: - **พลังงานแสงอาทิตย์สะสมเดือนนี้ (kWh)**: แสดงหน่วยผลิตสะสมพร้อมแถบสัดส่วนช่วงเวลา `Peak`, `Off`, `Hol` - **ค่าไฟฟ้า PPA สุทธิสะสมเดือนนี้ (บาท)**: แสดงค่าไฟ PPA (ก่อน VAT) เทียบกับยอดอัตรา กฟภ. ปกติที่ขีดฆ่าไว้ - **ผลประหยัดค่าไฟสะสมเดือนนี้ (บาท)**: ส่วนต่างที่ประหยัดได้จริงเมื่อเทียบกับอัตรา PEA TOU พร้อมยอดประหยัดของวันที่เลือก - **พลังงานแสงอาทิตย์วันนี้ (kWh)**: ปริมาณผลิตวันนี้ ค่าไฟ PPA วันนี้ และกำลังผลิตสูงสุด (Peak kW) 4. **กราฟการใช้พลังงานแสงอาทิตย์ราย 15 นาที**: - แสดงเส้นกำลังการผลิตราย 15 นาทีแยกสีตามช่วงอัตรา (`On-Peak 09:00–22:00 น. จันทร์–ศุกร์`, `Off-Peak`, และ `วันหยุด Holiday`) - ช่วงที่ขาดข้อมูลจากมิเตอร์จะแสดงเป็น **เส้นขาด (`null` gap)** ตามจริง โดยไม่เติมเลขศูนย์หลอก - คลิก **วิเคราะห์ข้อมูลเชิงลึก** เพื่อดูตารางและกราฟรายละเอียดในหน้า `/view-data` 5. **การ์ดข้อมูลสัญญาซื้อขายไฟฟ้า (PPA) และจุดติดตั้งมิเตอร์**: - แสดงขนาดติดตั้ง (`kWp`), หมายเลขซีเรียลมิเตอร์, และป้ายสถานะการเชื่อมต่อ (`ออนไลน์ปกติ`, `การสื่อสารขัดข้อง`, `รอเชื่อมต่อครั้งแรก`, `ไม่เปิดใช้งาน`) - ตารางเทียบ **อัตราค่าไฟฟ้าตามสัญญา PPA หลังหักส่วนลด** กับอัตราฐาน กฟภ. ทั้ง 3 ช่วง (`On-Peak`, `Off-Peak`, `วันหยุด`) - คลิก **ดูสถานะมิเตอร์** หรือ **กราฟรายวัน/เดือน** เพื่อเจาะลึกข้อมูลรายไซต์ (อ่านเพิ่มเติมที่ [คู่มือการติดตามมิเตอร์และข้อมูลโทรมาตร](./05-meter-and-telemetry-guide)) ![หน้าหลักพอร์ทัลลูกค้าแสดง KPI ผลประหยัด กราฟ 15 นาที และสถานะมิเตอร์ประจำโครงการ](/screenshots/th/31-customer-dashboard-and-meter.png) --- ## 3. การตรวจสอบใบแจ้งหนี้และดาวน์โหลดเอกสาร (`/billing`) ผู้ใช้บทบาท **`ADMIN`** และ **`CUSTOMER`** สามารถเปิดหน้า **ใบแจ้งหนี้และประวัติการชำระค่าไฟฟ้า** (`/billing`) เพื่อตรวจสอบและจัดการเอกสารได้ตามขั้นตอนต่อไปนี้: ### 3.1 การกรองและตรวจสอบการ์ดสรุปสถานะ 1. ใช้ตัวกรองด้านบนเพื่อเลือก **ปีรอบบิล**, **โครงการ** (กรณีมีหลายไซต์) หรือพิมพ์ **ค้นหาเลขที่ใบแจ้งหนี้ / เดือน** 2. ตรวจสอบการ์ดสรุป 3 ช่องด้านบน: - **ใบแจ้งหนี้ที่ออกแล้วทั้งหมด** - **ลงนามยืนยันรับทราบแล้ว** - **รอการลงนามจากผู้รับซื้อ** ### 3.2 การอ่านการ์ดรายละเอียดใบแจ้งหนี้ (Spotlight Statement Card) คลิกที่แถวใดก็ได้ในตาราง **ประวัติใบแจ้งหนี้ย้อนหลัง** ด้านล่าง เพื่อแสดงรายละเอียดฉบับเต็มบนการ์ดด้านบน: - **ฝั่งซ้าย (สรุปปริมาณการใช้พลังงานไฟฟ้า TOU)**: แยกหน่วย `On-Peak`, `Off-Peak`, `วันหยุด (Holiday / เสาร์–อาทิตย์)`, `ความต้องการพลังไฟฟ้าสูงสุด (Peak Demand kW)` และ `รวมปริมาณพลังงานไฟฟ้าทั้งสิ้น (kWh)` - **ฝั่งขวา (รายละเอียดการคำนวณค่าไฟฟ้า, บาท)**: แสดงค่าพลังงานไฟฟ้าฐาน, ค่าไฟฟ้าผันแปร `Ft` พร้อมอัตราต่อหน่วย, ยอดหักส่วนลดตามสัญญา PPA (คำนวณจากค่าพลังงาน + Ft ตามเกณฑ์ใน [คู่มือการออกบิล TOU](./06-billing-and-approval-guide)), `VAT 7%` และ `ยอดชำระสุทธิรวมภาษีมูลค่าเพิ่ม` - **แถบอ้างอิงด้านล่าง**: แสดงสถานะการลงนามและ **`รหัสอ้างอิงใบแจ้งหนี้`** (`SIG_AVG_...`) เพื่อใช้ตรวจสอบความถูกต้องตรงกับเอกสาร PDF ### 3.3 การพรีวิวและดาวน์โหลดเอกสาร ที่มุมขวาล่างของการ์ด Spotlight (หรือปุ่มท้ายแถวในตารางประวัติ) คุณสามารถเลือกดำเนินการได้ดังนี้: 1. **พรีวิวใบแจ้งหนี้ (PDF)**: เปิดดูเอกสาร A4 ในหน้าต่างป๊อปอัป พร้อมตัวสลับดู **ต้นฉบับระบบ (`System PDF`)** และ **เอกสารลงนามแล้ว (`Signed PDF`)** (หากอัปโหลดแล้ว) 2. **ดาวน์โหลดใบแจ้งหนี้ (PDF)**: ดาวน์โหลดใบแจ้งหนี้ / ใบกำกับภาษี (ฉบับ A4 มาตรฐาน กฟภ.) 3. **ดาวน์โหลดใบวางบิล (PDF)**: ดาวน์โหลดเอกสารใบวางบิล (`Billing Notice`) 4. **ตารางคำนวณ (Excel)**: ดาวน์โหลดไฟล์ `.xlsx` ที่มีข้อมูลโหลดโปรไฟล์ราย 15 นาทีให้ฝ่ายบัญชีตรวจสอบซ้ำได้ทุกช่วงเวลา 5. **เอกสาร (Word)**: ดาวน์โหลดรายงานสรุปผู้บริหารรูปแบบ `.docx` 6. **เปิดดู PDF ที่ลงนามแล้ว**: เปิดดูหรือดาวน์โหลดไฟล์ที่ลูกค้าลงนามอัปโหลดกลับเข้าระบบแล้ว ![หน้าใบแจ้งหนี้ฝั่งลูกค้าแสดงรายละเอียด TOU ยอดชำระ รหัสอ้างอิง และปุ่มลงนามรับทราบ](/screenshots/th/32-customer-billing-and-countersign.png) --- ## 4. ขั้นตอนการลงนามรับทราบใบแจ้งหนี้ (Countersigning) สำหรับใบแจ้งหนี้สถานะ `APPROVED` ที่ขึ้นป้าย **รอการลงนามผู้รับซื้อ** คุณสามารถลงนามรับทราบได้ **2 วิธี** (ต้องใช้สิทธิ์ `invoice.countersign` ของบทบาท `Customer ADMIN` หรือ `CUSTOMER`): ### วิธีที่ 1: อัปโหลดไฟล์ PDF ที่ลงนามแล้ว (`Upload Countersigned PDF`) เหมาะสำหรับองค์กรที่ต้องการพิมพ์เอกสารไปประทับตราบริษัทและลงนามจริง หรือลงนามอิเล็กทรอนิกส์บนไฟล์ PDF ภายนอก: 1. คลิก **ดาวน์โหลดใบแจ้งหนี้ (PDF)** และให้ผู้มีอำนาจลงนาม / ประทับตราบนเอกสาร 2. กลับมาที่หน้ารายการหรือการ์ดใบแจ้งหนี้ คลิกปุ่ม **อัปโหลด PDF ที่ลงนามแล้ว** (หรือ **ลงนาม** ในตารางประวัติ) 3. กรอก **ชื่อผู้มีอำนาจลงนาม (ในนามผู้รับซื้อไฟฟ้า)** 4. เลือกไฟล์ **`.pdf`** ที่ลงนามแล้ว (**ขนาดไม่เกิน 15 MB** ระบบตรวจสอบลายเซ็นไฟล์ `%PDF` อัตโนมัติ) 5. กด **บันทึกและอัปโหลด**: ระบบจะอัปเดตสถานะเป็น **ลงนามรับทราบแล้ว** ทันที ### วิธีที่ 2: แนบภาพลายเซ็นผู้รับซื้อไฟฟ้า (`Attach Customer Signature Image`) เหมาะสำหรับลงนามเพื่อฝังภาพลายเซ็นลงบนเอกสาร PDF ของระบบโดยตรง: 1. คลิกปุ่ม **แนบลายเซ็นผู้รับซื้อ** บนการ์ด Spotlight (หรือเมนูของตาราง) 2. กรอก **ชื่อผู้ลงนามในนามผู้รับซื้อไฟฟ้า** 3. เลือกไฟล์ภาพลายเซ็น (**แนะนำไฟล์ `.png` พื้นหลังโปร่งใส** รองรับ `.png`, `.jpg`, `.webp` ขนาดไม่เกิน **2 MB**) 4. ตรวจสอบภาพตัวอย่างในกล่อง **Customer Signature Preview** (ภาพลายเซ็นถูกจัดเก็บเป็นไฟล์ส่วนตัวและดึงมาแสดงผ่าน API ที่ตรวจสอบสิทธิ์ผู้ใช้เท่านั้น ไม่ใช้ลิงก์สาธารณะ) 5. กด **บันทึกลายเซ็น**: ภาพลายเซ็นและชื่อผู้ลงนามจะถูกนำไปพิมพ์ในช่อง **"ในนามผู้ซื้อ / Customer Signature"** บนไฟล์ PDF ใบแจ้งหนี้โดยอัตโนมัติ ::: warning กติกาการแก้ไขหลังลงนามรับทราบแล้ว เมื่อฝ่ายผู้รับซื้อไฟฟ้าได้อัปโหลด PDF ที่ลงนามแล้วหรือภาพลายเซ็นเข้าสู่ระบบแล้ว **ไฟล์ดังกล่าวจะถูกล็อกถาวร** เพื่อป้องกันการแก้ไขย้อนหลัง (หากผู้ใช้ฝั่งลูกค้าหรือผู้พัฒนาพยายามอัปโหลดทับ ระบบจะปฏิเสธด้วยรหัส `409 Conflict`) หากจำเป็นต้องเปลี่ยนไฟล์เนื่องจากอัปโหลดผิดฉบับ กรุณาติดต่อ **Platform Super Administrator** เพื่อดำเนินการเปลี่ยนให้เป็นกรณีพิเศษ ::: --- ## 5. การจัดการบัญชีผู้ใช้ฝั่งลูกค้าและการเปลี่ยนรหัสผ่าน - **ผู้ดูแลฝั่งลูกค้า (`Customer ADMIN`)**: สามารถเข้าหน้า **การตั้งค่า (Settings)** เพื่อเพิ่ม แก้ไข หรือระงับบัญชีเพื่อนร่วมงานในบริษัท (`CUSTOMER` และ `READER`) ตั้งค่าข้อมูลนิติบุคคล (เช่น เลขประจำตัวผู้เสียภาษี 13 หลักและที่อยู่สำหรับใบกำกับภาษี) รวมถึงอัปโหลดภาพลายเซ็นองค์กรได้ - **ผู้ใช้งานทุกคน**: สามารถเปลี่ยนรหัสผ่านของตนเองได้ตลอดเวลาโดยคลิกที่ชื่อบัญชีมุมซ้ายล่างของแถบเมนู → **เปลี่ยนรหัสผ่าน (`Change password`)** (เมื่อเปลี่ยนรหัสผ่าน ระบบจะออกจากระบบบนอุปกรณ์อื่นทั้งหมดเพื่อความปลอดภัยอัตโนมัติ) หากพบปัญหาในการเข้าสู่ระบบหรือการดาวน์โหลดเอกสาร ดูแนวทางแก้ไขเพิ่มเติมได้ที่ [การแก้ไขปัญหาและคำถามที่พบบ่อย](./08-troubleshooting-faq) --- ## การแก้ไขปัญหา คำถามที่พบบ่อย และการเชื่อมต่อ AI Source: https://docs.wattdee.com/th/08-troubleshooting-faq ::: warning การอัปเดต UAT คู่มือนี้อธิบายระบบรุ่นที่จะอัปเดต หน้าจอหรือการทำงานบางส่วนอาจแตกต่างจากระบบ UAT ปัจจุบัน ::: # การแก้ไขปัญหา คำถามที่พบบ่อย และการเชื่อมต่อ AI คู่มือนี้รวบรวมปัญหาที่พบบ่อยในการออกบิล การควบคุมสิทธิ์ การเข้าสู่ระบบ การเชื่อมต่อมิเตอร์ วิธีแก้ไขทีละขั้นตอน รวมถึงวิธีใช้งานคู่มือ WattDee ร่วมกับ AI Assistants และ Agents --- ## 1. Error `422`: ไม่มีอัตราค่า Ft สำหรับรอบบิลเมื่อกดสร้างใบแจ้งหนี้ ### อาการที่พบ - ระบบปฏิเสธการคำนวณหรือสร้างใบแจ้งหนี้ด้วยข้อความ: `No Ft (Fuel Adjustment Tariff) rate is on record for YYYY-MM. Refusing to generate: billing would require inventing a rate.` (HTTP **`422`**) - ด้านบนของหน้า `/billing` หรือส่วนงานที่ต้องทำบน Dashboard แสดงแถบแจ้งเตือน **"ต้องยืนยันอัตรา Ft (`Ft verification required`)"** ### สาเหตุ 1. ระบบไม่อนุญาตให้สมมติอัตรา Ft สำหรับการออกใบแจ้งหนี้ทางการเงินจริง หากยังไม่มีบันทึกอัตรา Ft ตามประกาศ กกพ. ประจำเดือน `YYYY-MM` ในฐานข้อมูล การออกบิลจะถูกระงับทันที 2. มีเพียง **Platform Administrator** (สิทธิ์ `ftrate.write`) เท่านั้นที่กำหนดหรือแก้ไขอัตรา Ft ได้ บัญชีฝั่งผู้พัฒนา (`Developer ADMIN` / `ACCOUNTING`) ไม่สามารถตั้งค่า Ft เองได้ ### วิธีแก้ไขทีละขั้นตอน 1. ให้ **Platform Administrator** ลงชื่อเข้าใช้และไปที่หน้า `/billing` แล้วคลิก **ยืนยันอัตรา Ft** ในแถบเตือนสีเหลือง (หรือไปที่ **การตั้งค่า → การคิดบิล/อัตรา**) 2. ตรวจสอบเดือนรอบบิล (`YYYY-MM`) และกรอก **อัตรา Ft (บาท/หน่วย)** ตามประกาศ กกพ. (ในช่วง `-2.0000` ถึง `10.0000`) 3. กด **ยืนยันอัตรา Ft ประจำรอบบิล** จากนั้นกลับมาที่ `/billing` เพื่อสร้างใบแจ้งหนี้ตามปกติ (รายละเอียดเพิ่มเติมดูที่ [คู่มือการออกบิล TOU](./06-billing-and-approval-guide)) ::: tip เหตุใดหน้า "เทียบค่าไฟ PPA กับ กฟภ." จึงยังคำนวณได้แม้ยังไม่ตั้งค่า Ft? หน้าต่าง **เทียบค่าไฟ PPA กับ กฟภ.** (`/api/billing/rate-comparison`) เป็นเพียงการประมาณการเปรียบเทียบเบื้องต้น หากเดือนนั้นยังไม่มีอัตรา Ft ระบบจะใช้ค่าเริ่มต้น **`0.3972` บาท/หน่วย** ชั่วคราวพร้อมแสดง **แถบแจ้งเตือนสีเหลือง** ด้านบนเพื่อเตือนให้ผู้ใช้งานทราบว่าตัวเลขดังกล่าวยังไม่ใช่ค่า Ft ที่ยืนยันแล้ว ![แถบแจ้งเตือนค่าเริ่มต้น Ft 0.3972 บาท/หน่วย ในหน้าต่างเปรียบเทียบค่าไฟฟ้า](/screenshots/th/19-billing-tariff-comparison.png) ::: --- ## 2. Error `422`: รอบบิลยังไม่สิ้นสุด (`Open Billing Period` กับสิทธิ์ `invoice.issueEarly`) ### อาการที่พบ - เมื่อกด **สร้างบิล** ก่อนวันสิ้นสุดรอบบิล (โดยเฉพาะผู้ใช้บทบาท `ACCOUNTING`) ระบบแจ้งเตือน: `Billing period YYYY-MM has not ended (X/Y days elapsed)...` (HTTP **`422`**) หรือ *"รอบบิล ... ยังไม่สิ้นสุด - ออกใบแจ้งหนี้ได้หลังสิ้นรอบ หรือให้ผู้ดูแลระบบของบริษัทออกก่อนสิ้นรอบ"* ### สาเหตุ - ตามกติกาธุรกิจ (BL-1) ใบแจ้งหนี้รายเดือนต้องคำนวณหลังจากรอบบิลปิดสมบูรณ์แล้ว (ตาม `billingCycleDay` ในเวลา `Asia/Bangkok UTC+7`) เพื่อป้องกันการออกบิลที่ขาดข้อมูลช่วงปลายเดือน - เฉพาะผู้ที่มีสิทธิ์ **`invoice.issueEarly`** (`Developer ADMIN` และ `Platform ADMIN`) เท่านั้นที่ยืนยันการออกบิลก่อนสิ้นรอบได้ ส่วน `Developer ACCOUNTING` ต้องรอให้พ้นวันตัดรอบก่อน (และไม่อนุญาตให้ออกบิลสำหรับเดือนในอนาคตที่ยังไม่เริ่มโดยเด็ดขาด) ### วิธีแก้ไขทีละขั้นตอน 1. หากเป็นรอบบิลปัจจุบันที่ยังไม่ครบกำหนดตัดรอบ ให้รอจนพ้นเวลา `00:00` น. ของวันตัดรอบถัดไปแล้วจึงกด **สร้างบิล** 2. หากจำเป็นต้องออกบิลปิดยอดกลางเดือน (เช่น ปิดสัญญาหรือทดสอบระบบ) ให้ **Developer ADMIN** หรือ **Platform ADMIN** กด **สร้างบิล** และยืนยันในหน้าต่าง **"รอบบิลยังไม่สิ้นสุด"** โดยกด **ออกก่อนสิ้นรอบ** --- ## 3. เหตุใดผู้ตรวจบิล (`CHECKED`) และผู้อนุมัติ (`APPROVED`) ต้องเป็นคนละคนกัน ### อาการที่พบ - บนการ์ด Kanban หรือตารางรวม ปุ่มอนุมัติเปลี่ยนเป็นป้าย **`ติดเงื่อนไข SoD`** (ไอคอนโล่ล็อก) หรือพบข้อความแจ้งเตือน: `Segregation of duties violation: The accounting approver cannot be the same user who performed the technical service check.` ### สาเหตุ ระบบบังคับใช้หลักการควบคุมภายในแบบ **Dual Control / Segregation of Duties (`checker ≠ approver`)**: 1. บัญชีผู้ใช้ที่กดตรวจรับรองทางเทคนิค Stage 2 (`checkedByServiceUserId`) **ไม่สามารถ** กดอนุมัติขั้นสุดท้าย Stage 3 (`APPROVED`) บนใบแจ้งหนี้ฉบับเดียวกันได้ **แม้ว่าผู้ใช้นั้นจะเป็น `ADMIN` ที่มีสิทธิ์ทั้งสองขั้นก็ตาม** 2. ใบแจ้งหนี้ไม่สามารถข้ามจาก `DRAFT` เป็น `APPROVED` โดยไม่ผ่าน `CHECKED` ได้ ### วิธีแก้ไขทีละขั้นตอน 1. ให้วิศวกรปฏิบัติการ (`SERVICE`) หรือผู้ดูแลระบบคนที่ 1 ตรวจรับรองขั้นที่ 2 (`DRAFT → CHECKED`) 2. ให้เจ้าหน้าที่ฝ่ายบัญชี (`ACCOUNTING`) หรือผู้ดูแลระบบ **อีกคนหนึ่ง** ลงชื่อเข้าใช้ด้วยบัญชีของตนเองเพื่อกด **ลงนามอนุมัติ (`CHECKED → APPROVED`)** --- ## 4. รอบบิลถูกล็อกและมีข้อมูลพลังงานเข้ามาหลังปิดรอบ (`Locked Period` และ `late_intervals`) ### อาการที่พบ - ในส่วน **ต้องดำเนินการ (Action Queue)** บนหน้า Dashboard แสดงรายการ: `พลังงานเข้ามาหลังปิดรอบบิล X ไซต์ (Y kWh ยังไม่อยู่ในใบแจ้งหนี้)` - หรือไม่สามารถสับเปลี่ยนมิเตอร์/รันประมวลผลข้อมูลย้อนหลังทับเดือนที่ออกบิลไปแล้วได้ ### สาเหตุ 1. ทันทีที่ใบแจ้งหนี้เข้าสู่สถานะ **`CHECKED`** หรือ **`APPROVED`** ช่วงเวลาของใบแจ้งหนี้นั้น (`[billingPeriodStart, billingPeriodEnd)`) จะ **ถูกล็อก (`Period Lock`)** เพื่อรับประกันว่าข้อมูลโหลดโปรไฟล์ 15 นาที (`load_profile_15min`) ในฐานข้อมูลจะตรงกับตัวเลขที่พิมพ์บนใบแจ้งหนี้เสมอ 2. หากมิเตอร์เพิ่งส่งข้อมูลย้อนหลังเข้ามาหลังสัญญาณขาดหาย (Backfill) หรือมีการแก้ไขค่าอ่านในช่วงเวลาที่ล็อกไว้ ระบบประมวลผลจะ **ไม่เขียนทับ** `load_profile_15min` แต่จะแยกข้อมูลใหม่/ที่เปลี่ยนแปลงไปเก็บในตาราง **`late_intervals`** และรายงานผลรวมแยกตามช่วง TOU และ Peak Demand ให้เห็นทันที ### วิธีแก้ไขทีละขั้นตอน 1. ตรวจสอบปริมาณหน่วยไฟที่เข้ามาทีหลังบน Dashboard (Action Queue) หรือเรียกดูรายละเอียดผ่าน API `GET /api/billing/late-intervals` 2. ตัดสินใจตามสถานะของใบแจ้งหนี้: - **กรณีบิลยังอยู่ในสถานะ `CHECKED` (ยังไม่ได้อนุมัติส่งลูกค้า)**: ให้สั่งคำนวณบิลใหม่ (หรือเปลี่ยนสถานะกลับเป็น `DRAFT`) ระบบจะนำข้อมูลจาก `late_intervals` มาเขียนลง `load_profile_15min` ให้อัตโนมัติใน Transaction เดียวกัน จากนั้นให้ตรวจรับรอง Stage 2 และอนุมัติ Stage 3 ใหม่อีกครั้ง - **กรณีบิลอยู่ในสถานะ `APPROVED` แล้ว**: หากยอดพลังงานที่ตกหล่นมีนัยสำคัญและต้องออกบิลใหม่ ให้กด **ยกเลิกบิล (`Void`)** พร้อมระบุเหตุผล (ระบบจะนำ `late_intervals` กลับมาอัปเดตให้ทันที) แล้วกด **ออกบิลใหม่ (`Reissue`)** เพื่อสร้างใบแจ้งหนี้ฉบับใหม่ที่รวมหน่วยครบถ้วน --- ## 5. เหตุใด `READER` และ `OPERATOR` เข้า `/billing` ไม่ได้ และทำไม `READER` ไม่เห็น IP มิเตอร์ ### สาเหตุที่เข้าหน้า `/billing` ไม่ได้ (`AccessDenied`) สิทธิ์ใน WattDee ถูกกำหนดจาก **ประเภทองค์กร × บทบาท (`Tier × Role`)** ไม่ได้ดูจากชื่อบทบาทเพียงอย่างเดียว (ดูตารางเต็มที่ [บทบาทและสิทธิ์การใช้งาน](./01-roles-and-permissions)): - การเปิดหน้า `/billing` ต้องมีสิทธิ์ **`invoice.view`** - **`Customer READER` (ดูอย่างเดียว)**: มีไว้ดูกราฟการผลิตและสถานะมิเตอร์เท่านั้น ไม่มีสิทธิ์ด้านเอกสารการเงินหรือการตั้งค่าใดๆ - **`Developer OPERATOR` (ผู้ควบคุมระบบ)**: มีไว้เฝ้าระวังมิเตอร์ ทดสอบการเชื่อมต่อ และจัดการการแจ้งเตือน ไม่เกี่ยวข้องกับการออกบิล - หากบัญชีทั้งสองพยายามเข้า `/billing` โดยตรง หน้าเว็บจะแสดงหน้า **`ไม่มีสิทธิ์เข้าถึงข้อมูลการเรียกเก็บเงิน (Billing)` (`AccessDenied`)** ### สาเหตุที่ `READER` (และผู้ใช้ฝั่งลูกค้า) ไม่เห็น IP Address ของมิเตอร์ - การดู IP Address, พอร์ต, หมายเลข SIM และรายละเอียดเครือข่ายเกตเวย์ของมิเตอร์ต้องมีสิทธิ์ **`meter.network.read`** - บทบาทฝั่งลูกค้าทั้งหมด (`Customer ADMIN`, `CUSTOMER`, `READER`) รวมถึง `Developer ACCOUNTING` **ไม่ได้รับสิทธิ์ `meter.network.read`** เพื่อป้องกันการเปิดเผยโครงสร้าง VPN/SIM ภายใน - ทั้ง Backend API (`stripMeterNetworkFields`) และหน้า UI จะตัดข้อมูล `ipAddress`, `port`, `simCardId` และ `lastError` ของเกตเวย์ออกโดยอัตโนมัติ ### วิธีแก้ไข หากผู้ใช้งานจำเป็นต้องตรวจดูใบแจ้งหนี้หรือข้อมูลเครือข่าย ให้ติดต่อ **ผู้ดูแลองค์กร (Organization Admin)** เพื่อปรับบทบาทให้เหมาะสม (เช่น เปลี่ยนจาก `READER` เป็น `CUSTOMER` เพื่อดูและลงนามใบแจ้งหนี้ หรือเปลี่ยนเป็น `SERVICE`/`OPERATOR` สำหรับทีมเทคนิคฝั่งผู้พัฒนา) --- ## 6. ติดจำกัดความถี่การเข้าสู่ระบบ (`429`) และวิธีรีเซ็ตรหัสผ่านเมื่อลืมรหัสผ่าน ![หน้าเข้าสู่ระบบ WattDee พร้อมการแจ้งเตือนเมื่อรหัสผ่านผิดหรือเข้าสู่ระบบถี่เกินกำหนด](/screenshots/th/01-login-page.png) ### กรณีขึ้นข้อความ "มีการเข้าสู่ระบบหลายครั้งเกินไป" (`429 Too Many Requests`) - **สาเหตุ**: ในโหมดใช้งานจริง (Production) ระบบยืนยันตัวตน (BetterAuth) จำกัดความถี่ในการพยายามลงชื่อเข้าใช้ไม่เกิน **ประมาณ 3 ครั้งภายใน 10 วินาทีต่อ IP Address** เพื่อป้องกันการเดารหัสผ่าน - **วิธีแก้ไข**: 1. หยุดกดปุ่มเข้าสู่ระบบและรออย่างน้อย **10–15 วินาที** ก่อนลองใหม่อีกครั้ง 2. ตรวจสอบภาษาของแป้นพิมพ์ ปุ่ม Caps Lock และตัวสะกดของอีเมลให้ถูกต้อง ### กรณีลืมรหัสผ่านเข้าสู่ระบบ (ไม่มีลิงก์ "ลืมรหัสผ่าน" หรือ "สมัครสมาชิก") - **สาเหตุ**: WattDee ปิดการสมัครสมาชิกสาธารณะและปิดการรีเซ็ตรหัสผ่านเองโดยไม่มีการยืนยันตัวตน เพื่อความปลอดภัยของข้อมูลหลายองค์กร (Multi-Tenant Security) มีเพียงผู้ดูแลระบบขององค์กรเท่านั้นที่รีเซ็ตให้ได้ - **วิธีรีเซ็ตรหัสผ่านโดยผู้ดูแล (`Admin Reset Password`)**: 1. ติดต่อ **ผู้ดูแลบริษัท (`Company ADMIN` / `Developer ADMIN`)** หรือ **Platform Administrator** 2. ให้ผู้ดูแลเข้าไปที่ **การตั้งค่า → บริษัท → ผู้ใช้และสิทธิ์ (`People & access`)** แล้วกดไอคอน **แก้ไข (`Edit`)** ที่ชื่อของคุณ 3. ในหัวข้อ **ตั้งรหัสผ่านใหม่ (`Reset password`)** ผู้ดูแลสามารถพิมพ์รหัสผ่านใหม่ที่ตรงตามเกณฑ์ความปลอดภัย (ยาวอย่างน้อย 8 ตัวอักษร มี `A-Z`, `a-z`, `0-9` และอักขระพิเศษ `!@#$%&*`) หรือ **เว้นว่างไว้เพื่อสุ่มรหัสผ่านชั่วคราว (แสดงครั้งเดียว)** แล้วกด **ตั้งรหัสผ่านใหม่** 4. ระบบจะออกจากระบบบนอุปกรณ์เดิมทั้งหมดโดยอัตโนมัติ เมื่อได้รหัสผ่านใหม่และลงชื่อเข้าใช้แล้ว แนะนำให้เปลี่ยนเป็นรหัสผ่านส่วนตัวทันทีที่ **เมนูบัญชีมุมซ้ายล่าง → เปลี่ยนรหัสผ่าน** --- ## 7. มิเตอร์แสดงสถานะ `ขาดการติดต่อ` (`Offline`): วิธีตรวจ VPN และ `ทดสอบการเชื่อมต่อ` มิเตอร์จะถูกจัดอยู่ในสถานะ **`ขาดการติดต่อ (Offline)`** เมื่อไม่ได้ส่งข้อมูลเข้ามามากกว่า **1 ชั่วโมง (`60 นาที`)** หรือเมื่อ HES แจ้งสถานะขัดข้อง (`commLostAt` / `verification_failed` / `inactive`) ให้ตรวจสอบตามลำดับต่อไปนี้ (ต้องมีสิทธิ์ `meter.command`, `meter.network.read` หรือ `vpn.manage`; ดูเพิ่มเติมที่ [คู่มือการติดตามมิเตอร์และข้อมูลโทรมาตร](./05-meter-and-telemetry-guide)): 1. **ตรวจสถานะการเปิดใช้งานใน HES**: - เปิดหน้า **การตั้งค่า → ไซต์ → มิเตอร์** แล้วดูแท็กสถานะ หากขึ้นว่า **`ปิดใน HES - ไม่ถูกอ่านค่า`** หรือ **`HES รอตรวจสอบ`** ให้ตรวจสอบว่าตั้งค่าเรียบร้อยแล้วกดปุ่ม **เปิดใช้งานใน HES (`Activate in HES`)** 2. **ตรวจสอบการเชื่อมต่อ VPN (กรณีเชื่อมต่อแบบ `VPN (Mikrotik)`)**: - ให้ `Platform ADMIN` เข้าที่ **การตั้งค่า → บริษัทผู้พัฒนา → โปรไฟล์ VPN (`VPN profiles`)** และกด **อัปเดตสถานะ (`Refresh status`)** - ตรวจสอบว่าสถานะท่อ VPN เป็น **`เชื่อมต่อ VPN แล้ว` (`tunnel_up`)** (หากขึ้น `controller_offline`, `runner_error`, `pending` หรือ `disabled` ต้องตรวจสอบอุปกรณ์ Mikrotik / อินเทอร์เน็ตหน้างาน) - ตรวจสอบว่าได้ผูกมิเตอร์เข้ากับโปรไฟล์ VPN ที่ถูกต้อง และ IP ของมิเตอร์อยู่ในช่วง `allowed_ips` 3. **กดปุ่ม `ทดสอบการเชื่อมต่อ` (`Test connection`)**: - เปิดแผงรายละเอียดมิเตอร์ในหน้า `/meter` (แท็บการตรวจสอบ) หรือในหน้าตั้งค่ามิเตอร์ แล้วกด **ทดสอบการเชื่อมต่อ** จากนั้นอ่านคำอธิบายผลจาก HES: - `config_error` / ยังไม่มีรหัสผ่าน LLS: ต้องตั้งค่า LLS Password บนเครื่อง HES และรีสตาร์ทบริการ HES - `auth_failed`: มิเตอร์ปฏิเสธรหัสผ่าน LLS ให้ตรวจว่ารหัสผ่านบน HES ตรงกับที่ตั้งบนตัวมิเตอร์ - `operation was canceled` (หมดเวลา session): เชื่อมต่อ TCP ได้แต่มิเตอร์ไม่ตอบ มักเกิดจากเลือก Interface ผิดระหว่าง **`HDLC`** (ผ่านโมเด็ม 4G/ตัวแปลงสัญญาณ) กับ **`WRAPPER`** (เสียบสาย LAN ตรงที่ตัวมิเตอร์) - `connect_failed` / `poll_timeout`: ติดต่อ IP/พอร์ต (ค่าเริ่มต้น `4059`) ไม่ได้ ให้เช็กไฟเลี้ยงมิเตอร์ สัญญาณซิม 4G/APN ท่อ VPN และการ Forward พอร์ต - `protocol_error`: ตรวจสอบรุ่นมิเตอร์ (`Saral 305`, `Premier 550`, `Prometer 100`) และ Interface ให้ตรงกับอุปกรณ์จริง 4. **กู้คืนข้อมูลช่วงที่ขาดหาย**: - เมื่อ `ทดสอบการเชื่อมต่อ` ผ่านแล้ว ให้กด **อ่านค่าทันที (`Read now`)** หรือสั่ง **Backfill** (ดึงย้อนหลังได้สูงสุด 31 วันต่อคำสั่ง) เพื่อให้ HES ดึงโหลดโปรไฟล์ที่เก็บอยู่ในหน่วยความจำมิเตอร์กลับมาคำนวณ --- ## 8. การใช้งานคู่มือ WattDee ร่วมกับ AI Assistants และ Agents คู่มือผู้ใช้งาน WattDee เผยแพร่อยู่ที่ **`https://docs.wattdee.com`** พร้อมช่องทางมาตรฐานสำหรับ AI Assistants, LLM และ Coding Agents ดังนี้: | ช่องทาง | ที่อยู่ / คำสั่ง | เหมาะสำหรับ | | :--- | :--- | :--- | | **ดัชนีเอกสารสำหรับ AI (`/llms.txt`)** | `https://docs.wattdee.com/llms.txt` | ให้ AI Agent อ่านสารบัญ URL และสรุปเนื้อหาของคู่มือทุกหน้า (ทั้งไทยและอังกฤษ) เพื่อค้นหาหน้าที่เกี่ยวข้องได้อย่างรวดเร็ว | | **คู่มือฉบับเต็มในไฟล์เดียว (`/llms-full.txt`)** | `https://docs.wattdee.com/llms-full.txt` | ดาวน์โหลดหรือส่งให้ AI อ่านเนื้อหา Markdown ทั้งหมดของคู่มือทั้ง 2 ภาษาในครั้งเดียว (หรือเลือกเฉพาะภาษาได้ที่ `/th/llms-full.txt` และ `/en/llms-full.txt`) | | **MCP Server สำหรับเครื่องมือ AI** | `bun run docs:mcp` | เชื่อมต่อ Model Context Protocol (MCP) เข้ากับ Claude Desktop, Cursor หรือ Antigravity พร้อมเครื่องมือ `search_wattdee_manual`, `get_wattdee_guide` และ `get_role_capabilities` | ### ตัวอย่างการตั้งค่า `bun run docs:mcp` ใน MCP Client ในโฟลเดอร์หลักของโปรเจกต์ AMR สามารถเรียกใช้งานเซิร์ฟเวอร์ MCP ของเอกสารคู่มือผ่านคำสั่ง: ```bash bun run docs:mcp ``` หรือเพิ่มรายการในไฟล์ตั้งค่า MCP Client ของคุณ (ปรับพาธให้ตรงกับเครื่องที่รัน): ```json { "mcpServers": { "wattdee-docs": { "command": "bun", "args": ["run", "docs:mcp"], "cwd": "/path/to/AMR" } } } ``` ::: tip ตัวอย่างคำถามที่ถาม AI Assistant ได้ทันทีหลังเชื่อมต่อ - *"ตรวจสอบสูตรคำนวณส่วนลด PPA และภาษีมูลค่าเพิ่ม 7% ในคู่มือ WattDee ให้หน่อย"* - *"ลูกค้าขึ้นหน้า AccessDenied ตอนเข้า /billing ต้องปรับสิทธิ์อย่างไรตามคู่มือ?"* - *"สรุปขั้นตอนแก้ปัญหาเมื่อเจอ Error 422 ไม่มีอัตรา Ft หรือรอบบิลยังไม่สิ้นสุด"* :::