About / Methodology
หน้านี้อธิบายว่าฐานความรู้นี้จัดทำอย่างไร ครอบคลุมอะไร ไม่ครอบคลุมอะไร และจะอัปเดตต่ออย่างไร
วัตถุประสงค์
สร้างฐานความรู้กลางขององค์กรสำหรับพัฒนาแผนก Solar ภายใน เพื่อให้ผู้บริหารตัดสินใจได้บนข้อมูลที่ตรวจสอบได้ ให้ทีมงานมีมาตรฐานการทำงานร่วมกัน และลดการพึ่งพาผู้รับเหมาภายนอกอย่างมีแผน โดยไม่ลดทอนความปลอดภัยหรือคุณภาพทางวิศวกรรม
โครงสร้างเนื้อหา
| ส่วน | ครอบคลุม | ผู้อ่านหลัก |
|---|---|---|
| เริ่มต้นที่นี่ | คำถามที่ผู้บริหารต้องตอบได้ และเส้นทางเรียนรู้ตามบทบาท | ผู้บริหารและผู้เริ่มต้น |
| Part I — Foundation | พื้นฐานไฟฟ้า พื้นฐานโซลาร์ อุปกรณ์ และประเภทระบบ | ทุกบทบาท |
| Part II — Engineering | การสำรวจ การวิเคราะห์โหลด การออกแบบ และชุดแบบ | วิศวกรและผู้ตรวจแบบ |
| Part III — Project | วงจรชีวิตโครงการ ความรับผิดชอบ การก่อสร้าง และการส่งมอบ | ผู้จัดการโครงการและทีมหน้างาน |
| Part IV — Business | ต้นทุน การเงิน การจัดซื้อ สัญญา และการตั้งแผนก | ผู้บริหาร จัดซื้อ และการเงิน |
| Part V — Operation | การดูแลรักษา การติดตามผล การแก้ปัญหา และช่วงปลายอายุ | ทีมดูแลระบบ |
| Part VI — Reference | เครื่องมือคำนวณ เช็คลิสต์ แบบฟอร์ม กรณีศึกษา และคำศัพท์ | ทุกบทบาท |
หลักการเขียนที่ใช้
- ภาษาไทยเป็นหลัก โดยคงคำศัพท์เทคนิคภาษาอังกฤษไว้เมื่อจำเป็นต่อการค้นหาและการสื่อสารกับผู้ขาย
- อธิบายจากภาษาทั่วไปก่อน แล้วจึงลงรายละเอียดทางวิศวกรรม
- แยกให้ชัดระหว่างข้อเท็จจริง สมมติฐาน ตัวอย่าง กฎการตัดสินใจ และคำเตือน
- อธิบายข้อแลกเปลี่ยนแทนการประกาศว่าทางเลือกใดดีที่สุดเสมอ
- ให้ความสำคัญกับความปลอดภัยเหนือความสวยงามของหน้าเว็บ
- ไม่เปลี่ยนการกล่าวถึงผู้ขายให้กลายเป็นการรับรอง
สิ่งที่ฐานความรู้นี้จงใจไม่ทำ
- ไม่ระบุหมายเลขมาตรฐาน หมายเลขข้อกฎหมาย หรือเงื่อนไขของผู้ให้บริการไฟฟ้าแบบเจาะจง เพราะข้อมูลเหล่านี้เปลี่ยนได้และต่างกันตามพื้นที่ ต้องตรวจสอบจากประกาศฉบับล่าสุดทุกครั้ง
- ไม่ระบุราคาตลาดหรือราคาอุปกรณ์ ตัวเลขในเครื่องมือคำนวณเป็นค่าตั้งต้นให้ทดลองใช้เท่านั้น
- ไม่จัดอันดับหรือรับรองยี่ห้อใด ใช้หลักความเหมาะสมกับงานแทน
- ไม่แทนการตรวจสอบและรับรองโดยวิศวกรผู้มีใบอนุญาต เครื่องมือคำนวณทั้งหมดใช้เพื่อคัดกรองและหารือภายในเท่านั้น
- ไม่แสดงข้อมูลจำลองที่อาจถูกเข้าใจผิดว่าเป็นข้อมูลจริง ตัวเลขตัวอย่างทุกจุดถูกระบุไว้ว่าเป็นตัวอย่าง
- ไม่มีการอ้างอิงงานวิจัยหรือเอกสารที่ไม่ได้ตรวจสอบ จุดที่ต้องมีแหล่งอ้างอิงจะถูกทำเครื่องหมายไว้ให้องค์กรเติมเอง
ความปลอดภัยและความรับผิดชอบ
งานไฟฟ้า งานบนที่สูง และงานที่เกี่ยวข้องกับระบบกักเก็บพลังงาน มีความเสี่ยงต่อชีวิตและทรัพย์สิน ต้องดำเนินการโดยผู้มีคุณสมบัติ ภายใต้ระบบใบอนุญาตทำงานและมาตรการความปลอดภัยขององค์กร เนื้อหาในเว็บไซต์นี้เป็นแนวทางเพื่อการเรียนรู้และการวางแผน ไม่ใช่ขั้นตอนปฏิบัติงานที่ปลอดภัยของหน่วยงานใด
วิธีอัปเดตและขยายเนื้อหา
| ต้องการทำอะไร | แก้ที่ไฟล์ไหน | หมายเหตุ |
|---|---|---|
| แก้เนื้อหาของหน้า | pages/<ชื่อหน้า>.html | แก้เฉพาะภายใน <main> ส่วนเมนู สารบัญ และท้ายหน้าถูกสร้างอัตโนมัติ |
| เพิ่มหน้าใหม่ | data/nav.js และสร้างไฟล์ใน pages/ | คัดลอกโครงสร้างจากหน้าที่มีอยู่ แล้วเปลี่ยนค่า data-page ให้ตรงกับรหัสหน้าใน nav.js |
| เพิ่มคำศัพท์ | data/glossary.js | หน้า Glossary และคำอธิบายย่อในหน้าอื่นจะอัปเดตทันที |
| เพิ่มหรือแก้เครื่องมือคำนวณ | assets/js/calculators.js | ใช้รูปแบบ define({...}) เดียวกับตัวที่มีอยู่ แล้ววางจุดติดตั้งด้วย <div data-calc="รหัส"> |
| เพิ่มภาพประกอบ | assets/js/diagrams.js | เขียนฟังก์ชันที่คืนค่า SVG แล้วเรียกใช้ด้วย <figure class="diagram" data-diagram="รหัส"> |
| ปรับสีและรูปแบบ | assets/css/main.css | แก้ที่ตัวแปรสีในส่วนบนสุดของไฟล์ ระบบธีมมืดจะปรับตามอัตโนมัติ |
| อัปเดตดัชนีค้นหา | รัน tools/build_index.py | ต้องรันทุกครั้งหลังเพิ่มหรือแก้เนื้อหา เพื่อให้การค้นหาครอบคลุม |
สิ่งที่เพิ่มในเวอร์ชัน 2.0
เวอร์ชัน 2.0 ไม่ได้เขียนเนื้อหาวิศวกรรมใหม่ และไม่ได้ลบหน้าใดออก แต่เพิ่ม “ชั้นประสบการณ์ผู้ใช้” ทับของเดิม เพื่อให้ผู้เริ่มต้นหาทางเข้าได้ และวิศวกรยังเข้าถึงเอกสารเต็มได้ทันที
| สิ่งที่เพิ่ม | ช่วยใคร | ทำงานอย่างไร |
|---|---|---|
| หน้าเลือกจุดเริ่มต้น | ผู้เริ่มต้นและผู้ที่ไม่รู้ว่าจะเริ่มตรงไหน | เลือกบทบาท 1 ใน 4 แล้วระบบจัดลำดับการอ่านให้ หน้าเอกสารเดิมถูกย้ายไปที่ ภาพรวมเอกสารทั้งหมด โดยไม่มีเนื้อหาใดหายไป |
| เส้นทางการเรียนรู้ | ทุกบทบาท | แถบด้านบนบอกว่าคุณอยู่ขั้นที่เท่าไร และมีปุ่มไปขั้นถัดไปท้ายหน้า ออกจากเส้นทางได้ทุกเมื่อ |
| เวลาที่ใช้อ่านและระดับความยาก | ทุกบทบาท | คำนวณเวลาจากความยาวเนื้อหาจริงของหน้านั้น และแสดงระดับ ⭐ ถึง ⭐⭐⭐ พร้อมกลุ่มผู้อ่านที่เหมาะสม |
| กล่องสิ่งที่จะได้เรียนรู้ | ผู้เริ่มต้น | สรุปไว้ต้นหน้าว่าอ่านจบแล้วจะเข้าใจอะไรบ้าง |
| Beginner Note | ผู้เริ่มต้น | กล่องอธิบายแบบเปรียบเทียบในหน้าที่มีแนวคิดยาก โดยไม่แทรกกลางคำอธิบายทางวิศวกรรม |
| โหมดผู้เริ่มต้น | ผู้เริ่มต้น | ปุ่มตัวอักษร A บนแถบด้านบน เมื่อเปิดจะเติมคำอธิบายภาษาไทยต่อท้ายศัพท์อังกฤษครั้งแรกที่พบในหน้า และถอดออกได้ทันทีเมื่อปิด |
| ภาษาไทยที่เป็นธรรมชาติขึ้น | ทุกบทบาท | เปลี่ยนคำแปลที่แข็งเกินไปเป็นคำที่วิศวกรไทยใช้จริง เช่น On-Grid, Hybrid, MPPT, SPD, BOQ, Commissioning โดยไม่เปลี่ยนความหมายทางวิศวกรรม |
ทุกอย่างในเวอร์ชัน 2.0 เป็นชั้นเสริมที่ถอดออกได้ ข้อมูลอยู่ในไฟล์ data/page-meta.js, data/paths.js และ data/terms-easy.js ส่วนการทำงานอยู่ใน assets/js/enhance.js หากลบสี่ไฟล์นี้ออก เว็บไซต์จะกลับไปเป็นเวอร์ชัน 1.0 โดยเนื้อหาไม่เสียหาย
ข้อมูลเวอร์ชัน
แผนการพัฒนาต่อ
- เวอร์ชัน 1.5 — คลังกรณีศึกษาจากโครงการจริง ฐานข้อมูลการประเมินผู้ขาย และคลัง Datasheet
- เวอร์ชัน 2.0 — บันทึกโครงการและระบบควบคุมเอกสาร
- เวอร์ชัน 3.0 — ทะเบียนสินทรัพย์ หมายเลขเครื่อง และการบริหารการรับประกัน
- เวอร์ชัน 4.0 — การเชื่อมต่อข้อมูลติดตามผลและแดชบอร์ดตัวชี้วัด
- เวอร์ชัน 5.0 — ผู้ช่วยค้นหาความรู้และการบำรุงรักษาเชิงคาดการณ์
เวอร์ชัน 1.0 และ 2.0 จงใจไม่สร้างระบบบริหารทรัพยากรองค์กร แต่ออกแบบโครงสร้างรหัสหน้า โครงสร้างข้อมูล และที่อยู่ของไฟล์ให้ขยายต่อได้โดยไม่ต้องรื้อ
การเก็บข้อมูลของผู้ใช้
เว็บไซต์นี้ทำงานแบบออฟไลน์ทั้งหมด ไม่มีการเชื่อมต่อกับบริการภายนอก ไม่มีการเก็บสถิติการใช้งาน และไม่ส่งข้อมูลออกไปที่ใด ค่าที่คุณกรอกในเครื่องมือคำนวณ สถานะเช็คลิสต์ บุ๊กมาร์ก และการตั้งค่าธีม ถูกเก็บไว้ในหน่วยความจำของเบราว์เซอร์เครื่องนี้เท่านั้น และจะหายไปหากล้างข้อมูลเบราว์เซอร์
เบราว์เซอร์ถือว่าไฟล์แต่ละไฟล์เป็นคนละแหล่งที่มา จึงแยกที่เก็บข้อมูลออกจากกัน ทำให้ค่าที่บันทึกไว้ในหน้าหนึ่งอ่านไม่เจอในอีกหน้า เว็บไซต์นี้จึงเก็บค่าไว้สองที่พร้อมกัน คือที่เก็บข้อมูลของเบราว์เซอร์ และหน่วยความจำของแท็บ ผลคือธีม บุ๊กมาร์ก เช็คลิสต์ เส้นทางการเรียนรู้ และค่าที่กรอกในเครื่องมือคำนวณ จะคงอยู่ตลอดการเปลี่ยนหน้าภายในแท็บเดียวกัน
ข้อจำกัดที่เหลืออยู่คือ หากปิดแท็บแล้วเปิดใหม่ ค่าอาจไม่ถูกจำ หากต้องการให้จำข้ามการปิดเบราว์เซอร์ ให้เปิดเว็บไซต์ผ่านเซิร์ฟเวอร์ในเครื่องตามวิธีที่ระบุไว้ใน README