คู่มือการติดตั้ง Jabphap FixTrack

📑 สารบัญ

ส่วนที่ 1

ติดตั้งบน Google

ทำครั้งเดียวบนคอมพิวเตอร์ ประมาณ 10 นาที

เริ่มต้น

สร้างไฟล์ Google Sheets ใหม่

ไฟล์นี้คือ “ฐานข้อมูล” ของระบบ เก็บเรื่องแจ้งซ่อม/ร้องเรียน ประวัติการดำเนินงาน หมวดหมู่ และรายชื่อเจ้าหน้าที่

เข้า sheets.new ด้วยบัญชี Google ที่ต้องการให้เป็นเจ้าของระบบ
คลิกชื่อไฟล์มุมซ้ายบน แล้วตั้งชื่อ เช่น FixTrack แจ้งซ่อม-ร้องเรียน

💡 บัญชีไหนติดตั้ง บัญชีนั้นเป็นเจ้าของ

รูปภาพที่ผู้แจ้งแนบจะเก็บใน Google Drive ของบัญชีนี้ (โฟลเดอร์ “FixTrack - รูปภาพแจ้งซ่อม”) และอีเมลแจ้งความคืบหน้าส่งจากบัญชีนี้

ใส่ระบบ

วางไฟล์ทั้ง 3 ไฟล์ใน Apps Script

ไฟล์ที่ได้รับ	หน้าที่
`Code.gs`	โค้ดฝั่งเซิร์ฟเวอร์ (เลขติดตาม อัปโหลดรูป แจ้งเตือนอีเมล/LINE)
`Index.html`	หน้าเว็บทั้งหมด — แจ้งเรื่อง ติดตามสถานะ และหน้าเจ้าหน้าที่
`appsscript.json`	ตั้งค่าโปรเจกต์ (เขตเวลา สิทธิ์ เว็บแอป)

ในไฟล์ชีต ไปที่เมนู ส่วนขยาย›Apps Script
เปลี่ยนชื่อโปรเจกต์ (มุมซ้ายบน) เป็น Jabphap FixTrack
เปิดไฟล์ Code.gs กด Ctrl+A ลบโค้ดเดิม แล้ววางเนื้อหาจากไฟล์ Code.gs ที่ได้รับทั้งไฟล์
กดปุ่ม ＋ ข้างคำว่า “ไฟล์” › HTML ตั้งชื่อว่า Index (ไม่ต้องพิมพ์ .html) ลบเนื้อหาเดิม แล้ววางเนื้อหาจาก Index.html
ไปที่ ⚙ การตั้งค่าโปรเจกต์ ติ๊ก “แสดงไฟล์ Manifest ‘appsscript.json’ ในเครื่องมือแก้ไข” กลับมาหน้า เครื่องมือแก้ไข เปิด appsscript.json แล้ววางทับด้วยไฟล์ที่ได้รับ
กด Ctrl+S บันทึกทุกไฟล์

⚠ ชื่อไฟล์ HTML ต้องเป็น Index ตัว I ใหญ่

ถ้าตั้งชื่อผิด เปิดเว็บแอปแล้วจะขึ้นข้อความ “ไม่พบไฟล์ HTML ที่ชื่อ Index”

สร้างฐานข้อมูล

รันฟังก์ชัน setup (ครั้งเดียว)

ในแถบเครื่องมือด้านบน เลือกฟังก์ชัน setup จากรายการ แล้วกด ▶ เรียกใช้
ครั้งแรก Google จะขอสิทธิ์ ทำตามขั้นตอนถัดไป (ข้อ 4) แล้วระบบจะรันต่อเอง
ดูที่ บันทึกการดำเนินการ ด้านล่าง จะมีข้อความติดตั้งสำเร็จ และ รหัสผู้ดูแล (PIN) 6 หลัก — จดไว้

✅ ติดตั้ง แจ้งซ่อม/ร้องเรียนออนไลน์ เรียบร้อย รหัสผู้ดูแล (PIN) เริ่มต้น: 4xxxxx ← จดไว้ แล้วเปลี่ยนได้ที่หน้า ตั้งค่า ขั้นต่อไป: ทำให้ใช้งานได้ › การทำให้ใช้งานได้รายการใหม่ › เว็บแอป

กลับไปดูไฟล์ชีต จะมีชีตใหม่: Tickets Updates Categories Staff Settings Logs พร้อมข้อมูลตัวอย่าง

ไม่อยากได้ข้อมูลตัวอย่าง?

รัน setupWithoutSampleData แทน setup (ทำก่อนครั้งแรกเท่านั้น) หรือลบแถวตัวอย่างในชีตทิ้งภายหลังได้

ลืมรหัสผู้ดูแล?

รันฟังก์ชัน resetAdminPin แล้วดูรหัสใหม่ในบันทึกการดำเนินการ

ความปลอดภัย

อนุญาตสิทธิ์ให้สคริปต์

สคริปต์ทำงานในบัญชีของคุณเอง Google จึงให้ยืนยันสิทธิ์ก่อนใช้งานครั้งแรก

หน้าต่าง “ต้องมีการให้สิทธิ์” กด ตรวจสอบสิทธิ์ แล้วเลือกบัญชี Google ของคุณ
ถ้าเจอ “Google ยังไม่ได้ยืนยันแอปนี้” กด ขั้นสูง › ไปที่ Jabphap FixTrack (ไม่ปลอดภัย) — เป็นปกติของสคริปต์ที่เขียนใช้เอง
ติ๊ก เลือกทั้งหมด แล้วกด ดำเนินการต่อ

หน้าต่างขอสิทธิ์ กด ตรวจสอบสิทธิ์ — หน้าต่างขอสิทธิ์ กด **ตรวจสอบสิทธิ์**

กด ขั้นสูง แล้วเลือก ไปที่โปรเจกต์ (ไม่ปลอดภัย) — กด **ขั้นสูง** แล้วเลือก **ไปที่โปรเจกต์ (ไม่ปลอดภัย)**

สิทธิ์ที่ระบบขอ และเหตุผล

สิทธิ์	ใช้ทำอะไร
ดู แก้ไข สร้าง ลบ สเปรดชีต	บันทึกเรื่องและความคืบหน้า
ดู แก้ไข สร้าง ลบไฟล์ใน Google ไดรฟ์	เก็บรูปภาพประกอบที่ผู้แจ้งแนบ
ส่งอีเมลในนามของคุณ	แจ้งเลขติดตามและความคืบหน้าให้ผู้แจ้ง และแจ้งเจ้าหน้าที่เมื่อมีเรื่องใหม่
เชื่อมต่อบริการภายนอก	ส่งแจ้งเตือนเข้า LINE ผ่าน LINE Messaging API (ถ้าตั้งค่า)
ดูอีเมลหลักของบัญชี Google	ตรวจว่าผู้รันฟังก์ชันผู้ดูแล (ติดตั้ง / รีเซ็ตรหัสผ่าน) เป็นเจ้าของไฟล์ — กันไม่ให้ผู้เปิดเว็บแอปเรียกใช้ได้

เปิดให้ใช้งาน

เผยแพร่เป็นเว็บแอป

มุมขวาบน กด ทำให้ใช้งานได้›การทำให้ใช้งานได้รายการใหม่
กดรูปเฟือง ⚙ ข้าง “เลือกประเภท” แล้วเลือก เว็บแอป
ตั้งค่า เรียกใช้ในฐานะ: ฉัน และ ผู้ที่มีสิทธิ์เข้าถึง: ทุกคน — เพื่อให้ผู้แจ้ง (ลูกบ้าน นักเรียน พนักงาน ประชาชน) แจ้งเรื่องได้โดยไม่ต้องล็อกอิน (หน้าเจ้าหน้าที่ยังต้องใช้รหัส PIN)
กด ทำให้ใช้งานได้ แล้วคัดลอก URL ของเว็บแอป (ลงท้ายด้วย /exec)

เมนู ทำให้ใช้งานได้ › การทำให้ใช้งานได้รายการใหม่ — เมนู **ทำให้ใช้งานได้ › การทำให้ใช้งานได้รายการใหม่**

เลือกประเภท เว็บแอป — เลือกประเภท **เว็บแอป**

ตั้งค่า เรียกใช้ในฐานะ: ฉัน · ผู้มีสิทธิ์เข้าถึง: ทุกคน — ตั้งค่า **เรียกใช้ในฐานะ: ฉัน** · **ผู้มีสิทธิ์เข้าถึง: ทุกคน**

คัดลอก URL ของเว็บแอป ไว้ใช้งาน — คัดลอก **URL ของเว็บแอป** ไว้ใช้งาน

⚠ เลือก “ทุกคน” ไม่ใช่ “ทุกคนที่มีบัญชี Google”

ถ้าเลือก “ทุกคนที่มีบัญชี Google” ผู้แจ้งต้องล็อกอิน Google ก่อน

พร้อมใช้งาน

ตั้งค่าหมวดหมู่ แล้วเปิดลิงก์ให้ผู้แจ้ง

เปิด URL?page=admin ใส่รหัสผู้ดูแล
ไปที่ ตั้งค่า ใส่ชื่อหน่วยงาน รายการสถานที่ (เช่น อาคาร/ชั้น/ห้องเรียน) อีเมลรับแจ้งเรื่องใหม่
แก้ หมวดหมู่ และ SLA ให้ตรงกับงาน และเพิ่ม เจ้าหน้าที่/ช่าง แล้วกดบันทึก
(ไม่บังคับ) ตั้งค่า แจ้งเตือนผ่าน LINE — ดูหัวข้อ “ตั้งค่า LINE” ในคู่มือการใช้งาน
ทำ QR ของ URL /exec ติดในลิฟต์ บอร์ดประกาศ ห้องเรียน หรือส่งในกลุ่ม LINE

หน้าเข้าสู่ระบบเจ้าหน้าที่ (?page=admin) — หน้าเข้าสู่ระบบเจ้าหน้าที่ (`?page=admin`)

ก่อนเริ่มใช้จริง

เช็กลิสต์ก่อนเปิดใช้งาน

ติ๊กไว้ได้ ระบบจะจำในเบราว์เซอร์นี้

ตั้งชื่อหน่วยงานและรายการสถานที่ตั้งค่า › ข้อมูลหน่วยงานแก้หมวดหมู่และ SLASLA ใช้คำนวณกำหนดเสร็จและแจ้งเกินกำหนดเพิ่มรายชื่อเจ้าหน้าที่/ช่างใช้มอบหมายงานใส่อีเมล (และ/หรือ LINE) รับแจ้งเรื่องใหม่ทดสอบด้วยปุ่ม “ส่งข้อความทดสอบ”ลบเรื่องตัวอย่างในชีต Tickets และ Updatesลบทั้งแถว เก็บแถวหัวตารางเปลี่ยนรหัสผู้ดูแลตั้งค่า › เปลี่ยนรหัสผู้ดูแล

0/6

ดูแลระบบ

อัปเดตเป็นเวอร์ชันใหม่

วางทับไฟล์ Code.gs และ Index ด้วยไฟล์เวอร์ชันใหม่ แล้วบันทึก
รัน setup อีกครั้ง — ระบบจะเพิ่มคอลัมน์/ชีตที่ขาด โดยไม่ลบข้อมูลเดิม และไม่เปลี่ยนรหัสผู้ดูแล
ไปที่ ทำให้ใช้งานได้›จัดการการทำให้ใช้งานได้ กดดินสอ ✏ เลือก เวอร์ชัน: เวอร์ชันใหม่ แล้วกด ทำให้ใช้งานได้ — URL เดิมใช้ต่อได้

สำรองข้อมูล

ทำสำเนาไฟล์ชีตได้ทุกเมื่อที่ ไฟล์›ทำสำเนา หรือดาวน์โหลดเป็น Excel

อ้างอิง

โครงสร้างชีตในฐานข้อมูล

ชีต	เก็บข้อมูล
`Tickets`	เรื่องที่แจ้ง: เลขติดตาม ประเภท หมวด สถานที่ หัวข้อ รายละเอียด ความเร่งด่วน ผู้แจ้ง เบอร์ อีเมล รูป สถานะ ผู้รับผิดชอบ กำหนดเสร็จ คะแนน
`Updates`	ประวัติความคืบหน้า (แสดงต่อผู้แจ้ง หรือบันทึกภายใน)
`Categories`	หมวดหมู่ ประเภท และ SLA (ชั่วโมง)
`Staff`	รายชื่อเจ้าหน้าที่/ช่าง
`Settings`	การตั้งค่า (แก้ในหน้าเว็บ)
`Logs`	บันทึกเหตุการณ์

⚠ อย่าเปลี่ยนชื่อชีตหรือหัวคอลัมน์แถวแรก

แก้ไขข้อมูลในแถวได้ตามปกติ แต่ชื่อชีตและหัวคอลัมน์ระบบใช้อ้างอิง (สลับลำดับคอลัมน์ได้ เพิ่มคอลัมน์ของตัวเองต่อท้ายได้)

ช่วยเหลือ

คำถามที่พบบ่อย (การติดตั้ง)

ตั้งค่า LINE อย่างไร

สร้าง LINE Official Account › เปิด Messaging API ที่ developers.line.biz › คัดลอก Channel access token (long-lived) มาวางในหน้าตั้งค่า แล้วใส่ User ID ของคุณ (ดูได้ในหน้า Basic settings ของ channel) หรือ Group ID ของกลุ่มช่าง (เชิญบอทเข้ากลุ่ม) กด “ส่งข้อความทดสอบ” · token เก็บใน Script Properties ไม่ปรากฏในชีต

ทำไมรูปในหน้าเจ้าหน้าที่ไม่แสดง

รูปเป็นไฟล์ส่วนตัวใน Drive ของบัญชีที่ติดตั้ง ต้องล็อกอินบัญชีนั้นในเบราว์เซอร์ หรือกด “เปิดรูปภาพใน Drive”

เปิดเว็บแอปแล้วขึ้น “ยังไม่ได้ติดตั้งระบบ”

ยังไม่ได้รันฟังก์ชัน setup หรือรันแล้วแต่ไม่สำเร็จ — กลับไปที่ Apps Script เลือก setup แล้วกด ▶ เรียกใช้ จากนั้นรีเฟรชหน้าเว็บ

แก้โค้ด/อัปเดตแล้ว แต่หน้าเว็บยังเหมือนเดิม

ต้อง ทำให้ใช้งานได้เวอร์ชันใหม่ ทุกครั้ง (จัดการการทำให้ใช้งานได้ › ✏ › เวอร์ชันใหม่) ลิงก์ /exec จะแสดงเวอร์ชันล่าสุดที่ deploy เท่านั้น

ขึ้น “Google ยังไม่ได้ยืนยันแอปนี้” อันตรายไหม

ไม่อันตราย เป็นข้อความปกติของสคริปต์ที่สร้างใช้เองในบัญชีของคุณ โค้ดทั้งหมดอยู่ในโปรเจกต์ของคุณและเปิดอ่านได้ทุกบรรทัด

ส่งอีเมลได้วันละกี่ฉบับ

บัญชี Gmail ทั่วไปประมาณ 100 ฉบับ/วัน · Google Workspace ประมาณ 1,500 ฉบับ/วัน (นับรวมทุกสคริปต์ในบัญชี) ถ้าโควตาหมด ระบบยังบันทึกข้อมูลได้ปกติแต่จะไม่ส่งอีเมล

ข้อมูลเก็บที่ไหน ปลอดภัยไหม

ข้อมูลทั้งหมดอยู่ใน Google Sheets ของคุณเท่านั้น ผู้ขายไม่สามารถเข้าถึงได้ หน้าผู้ดูแลป้องกันด้วยรหัส PIN และหมดอายุการเข้าสู่ระบบใน 6 ชั่วโมง

ติดตั้ง Jabphap FixTrack