SheetDee Gym Membership คู่มือการติดตั้ง
⏱ ติดตั้งประมาณ 10–15 นาที · ไม่ต้องเขียนโค้ด

ติดตั้ง SheetDee Gym Membership บน Google ของคุณเอง

ระบบสมาชิกยิม ฟิตเนส และสตูดิโอ ทำงานบน Google Sheets + Google Apps Script ในบัญชี Google ของยิมเอง ข้อมูลสมาชิกและรายรับอยู่ในไฟล์ของคุณ ไม่มีค่าบริการรายเดือน ไม่จำกัดจำนวนสมาชิก

👤บัญชี Googleบัญชีของยิม 1 บัญชี (เจ้าของข้อมูล)
💻คอมพิวเตอร์ใช้ตอนติดตั้ง หลังจากนั้นใช้มือถือได้
📄ไฟล์ 3 ไฟล์Code.gs · Index.html · appsscript.json
🏋️ข้อมูลยิมแพ็กเกจ ราคา ตารางคลาส · เครื่องสแกน QR USB (ไม่บังคับ)
📑 สารบัญ
ส่วนที่ 1

ติดตั้งบน Google

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

1

เริ่มต้น

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

ไฟล์นี้คือ “ฐานข้อมูลยิม” เก็บสมาชิก แพ็กเกจ การชำระเงิน เช็คอิน คลาส การจอง และนัด PT

  1. เข้า sheets.new ด้วยบัญชี Google ที่จะเป็นเจ้าของระบบ (แนะนำบัญชีของกิจการ ไม่ใช่บัญชีส่วนตัวของพนักงาน)
  2. ตั้งชื่อไฟล์ เช่น สมาชิกยิม ของเรา
⚠ ข้อมูลสมาชิกเป็นข้อมูลส่วนบุคคล

อย่าแชร์ไฟล์ชีตให้ผู้อื่น — พนักงานและเทรนเนอร์ใช้งานผ่านเว็บแอปด้วยบัญชีของตนเอง ส่วนสมาชิกเห็นเฉพาะบัตรของตัวเองผ่านลิงก์ลับ

2

ใส่ระบบ

วางไฟล์ Code.gs, Index.html และ appsscript.json

  1. ในไฟล์ชีต ไปที่ ส่วนขยาย›Apps Script (Extensions › Apps Script)
  2. ตั้งชื่อโปรเจกต์เป็น SheetDee Gym Membership
  3. เปิดไฟล์ Code.gs กด Ctrl+A ลบโค้ดเดิม แล้ววางเนื้อหาไฟล์ Code.gs ที่ได้รับทั้งไฟล์
  4. กด + ข้างคำว่า “ไฟล์” › HTML ตั้งชื่อ Index (ไม่ต้องพิมพ์ .html) ลบเนื้อหาเดิม แล้ววางเนื้อหา Index.html
  5. ⚙ การตั้งค่าโปรเจกต์ › ติ๊ก แสดงไฟล์ Manifest “appsscript.json” ในเครื่องมือแก้ไข แล้วเปิด appsscript.json วางเนื้อหาจากไฟล์ที่ได้รับแทนทั้งหมด
  6. กด Ctrl+S บันทึก
✓ ตรวจชื่อไฟล์

ต้องมี Code.gs, Index.html, appsscript.json — ชื่อ Index ต้องตรงทุกตัวอักษร

⚠ วางให้ครบทั้งไฟล์

ถ้าคัดลอกไม่ครบจะขึ้น “SyntaxError” ตอนบันทึก ให้คัดลอกใหม่ทั้งไฟล์

3

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

รันฟังก์ชัน setup

  1. เลือกฟังก์ชัน setup ในแถบเครื่องมือด้านบน แล้วกด ▶ เรียกใช้ (Run)
  2. ครั้งแรก Google จะขออนุญาตสิทธิ์ ทำตามขั้นตอนที่ 4 แล้วรันอีกครั้งถ้าจำเป็น
  3. รอจนบันทึกการดำเนินการขึ้นว่า “ติดตั้ง SheetDee Gym Membership เรียบร้อย”
สร้างชีต14 ชีตพร้อมหัวตาราง

Settings · Users · Plans · Members · Memberships · Payments · Checkins · Classes · Bookings · PTSessions · Reminders · Counters · Audit

ข้อมูลตัวอย่างยิมจำลอง

สมาชิก 42 คน หลายสถานะ แพ็กเกจ 9 แบบ คลาส 13 รอบ/สัปดาห์ เทรนเนอร์ 3 คน เช็คอิน 30 วัน

ทริกเกอร์แจ้งต่ออายุทุกวัน 10:00

ส่งถึงสมาชิกที่ใกล้หมดอายุ (ปิด/เปลี่ยนเวลาได้)

หลังติดตั้ง ไฟล์ชีตจะมีเมนู 🏋️ Gym Membership ใช้รัน setup ซ้ำ (ไม่ลบข้อมูลเดิม) แสดงลิงก์เว็บแอป รีเซ็ต PIN ผู้ดูแล และล้างข้อมูลตัวอย่าง

4

ความปลอดภัย

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

  1. หน้าต่าง “ต้องมีการให้สิทธิ์” กด ตรวจสอบสิทธิ์ แล้วเลือกบัญชีของคุณ
  2. หน้า “Google ยังไม่ได้ยืนยันแอปนี้” กด ขั้นสูง › ไปที่ SheetDee Gym Membership (ไม่ปลอดภัย) — เป็นข้อความปกติของสคริปต์ที่ติดตั้งเอง
  3. ตรวจรายการสิทธิ์แล้วกด อนุญาต
หน้าต่างขออนุญาตสิทธิ์ของ Google Apps Script
หน้าต่างขอสิทธิ์ — กด “ตรวจสอบสิทธิ์” แล้วเลือกบัญชี (ชื่อโปรเจกต์ของคุณจะเป็น SheetDee Gym Membership)
หน้าเตือน Google ยังไม่ได้ยืนยันแอป
คลิก “ขั้นสูง” แล้วเลือก “ไปที่ … (ไม่ปลอดภัย)”
สิทธิ์ที่ขอใช้ทำอะไร
ดู แก้ไข สร้าง สเปรดชีตอ่าน/เขียนข้อมูลสมาชิก แพ็กเกจ เช็คอิน คลาส ในไฟล์ชีตนี้
ดู แก้ไข สร้าง ไฟล์ใน Google ไดรฟ์บันทึกใบเสร็จ PDF
แสดงเนื้อหาในแอป Googleเมนู 🏋️ Gym Membership บนไฟล์ชีต
จัดการทริกเกอร์ตั้งเวลาแจ้งเตือนต่ออายุทุกวัน
ส่งอีเมลในนามคุณส่งลิงก์บัตรสมาชิก ใบเสร็จ และแจ้งเตือนต่ออายุ
เชื่อมต่อบริการภายนอกส่งข้อความผ่าน LINE Messaging API (เมื่อเปิดใช้เท่านั้น)
ดูอีเมลหลักของบัญชี Googleตรวจว่าผู้รันฟังก์ชันผู้ดูแล (ติดตั้ง / รีเซ็ตรหัสผ่าน) เป็นเจ้าของไฟล์ — กันไม่ให้ผู้เปิดเว็บแอปเรียกใช้ได้
5

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

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

  1. มุมขวาบน กด การทำให้ใช้งานได้›การทำให้ใช้งานได้รายการใหม่
  2. กดรูปเฟือง ⚙ ข้าง “เลือกประเภท” › เว็บแอป
  3. เรียกใช้ในฐานะ = ฉัน · ผู้ที่มีสิทธิ์เข้าถึง = ทุกคน แล้วกด ทำให้ใช้งานได้
  4. คัดลอก URL ของเว็บแอป (ลงท้าย /exec) เก็บเป็นบุ๊กมาร์ก และส่งให้ผู้ใช้ (บนมือถือกด “เพิ่มไปยังหน้าจอหลัก”)
เมนูการทำให้ใช้งานได้รายการใหม่
เมนู Deploy › New deployment
เลือกประเภทเป็นเว็บแอป
กดรูปเฟืองแล้วเลือก “เว็บแอป”
ตั้งค่าเว็บแอป
เรียกใช้ในฐานะ “ฉัน” · ผู้มีสิทธิ์เข้าถึง “ทุกคน” — ผู้ใช้ไม่ต้องมีบัญชี Google แต่ต้องล็อกอินด้วยชื่อผู้ใช้และ PIN ของระบบ
URL ของเว็บแอป
คัดลอก URL ของเว็บแอป (ลงท้าย /exec)
⚠ ทำไมเลือก “ทุกคน” แล้วยังปลอดภัย

ผู้ที่เปิดลิงก์จะเห็นแค่หน้าล็อกอิน ทุกคำสั่งตรวจสิทธิ์ที่เซิร์ฟเวอร์ ใส่ PIN ผิด 5 ครั้งล็อก 5 นาที และไฟล์ชีตยังเป็นของคุณคนเดียว (อย่าแชร์ไฟล์ชีตให้ผู้อื่น)

6

ใช้งานได้แล้ว

เข้าสู่ระบบครั้งแรกและเปลี่ยน PIN

  1. เปิด URL เว็บแอป ใส่ชื่อผู้ใช้ admin และ PIN 1234
  2. ระบบบังคับตั้ง PIN ใหม่ (ตัวเลข 4–8 หลัก ห้ามใช้ 1234 / 0000)
หน้าเข้าสู่ระบบ
หน้าเข้าสู่ระบบ — บนมือถือแสดงเฉพาะฟอร์ม
💡 ลืม PIN ผู้ดูแล

เปิดไฟล์ชีต › เมนู 🏋️ Gym Membership › 🔑 รีเซ็ต PIN ผู้ดูแล (admin) เป็น 1234 ส่วนผู้ใช้คนอื่นให้ผู้ดูแลรีเซ็ตในหน้าตั้งค่า › ผู้ใช้งาน

ส่วนที่ 2

ตั้งค่าก่อนใช้งานจริง

ทำผ่านเว็บแอปด้วยบัญชีผู้ดูแล — เมนู ตั้งค่า

7

ข้อมูลยิม

ข้อมูลยิม & กติกา

แท็บ ข้อมูลยิม: ชื่อ ที่อยู่ โทร เลขผู้เสียภาษี (พิมพ์บนใบเสร็จ) เวลาเปิด–ปิด อักษรนำรหัสสมาชิก/ใบเสร็จ ไม่นับเช็คอินซ้ำภายใน (ค่าเริ่มต้น 120 นาที — บัตรนับครั้งไม่ถูกตัดซ้ำ) ยกเลิกจองคลาสก่อนเริ่ม (ชั่วโมง) และเปิด/ปิดสิทธิ์ให้เคาน์เตอร์ “อนุญาตครั้งนี้” กับสมาชิกหมดอายุ

✓ ลิงก์บัตรสมาชิก

หน้าบัตร QR ใช้ URL ของเว็บแอปต่อท้าย ?card=โทเคน — ต้อง Deploy แบบผู้มีสิทธิ์เข้าถึง “ทุกคน” สมาชิกจึงเปิดได้โดยไม่ต้องล็อกอิน โทเคนสุ่มยาว 16 ตัวอักษร เดาไม่ได้ และกด “ออกบัตรใหม่” ได้เมื่อบัตรหาย/ถูกแชร์

8

แพ็กเกจ

ตั้งค่าแพ็กเกจและราคา

แท็บ แพ็กเกจ: รายช่วงเวลา (เข้าได้ไม่จำกัดตามจำนวนวัน + สิทธิ์พักสมาชิก) · บัตรนับครั้ง (จำนวนครั้ง + ใช้ภายในกี่วัน) · PT (จำนวนครั้งกับเทรนเนอร์ + ใช้ภายในกี่วัน) ปิดการขายแพ็กเกจเก่าได้โดยไม่กระทบสมาชิกที่ซื้อไปแล้ว

ตั้งค่าแพ็กเกจ
แพ็กเกจตัวอย่าง 9 แบบ
9

คลาส

ตารางคลาสประจำสัปดาห์

แท็บ คลาส: ชื่อ วัน เวลา เทรนเนอร์ ห้อง ระดับ จำนวนที่รับ และสี — ระบบไม่ให้คลาสในห้องเดียวกันซ้อนเวลา และเทรนเนอร์รับนัด PT ทับเวลาสอนไม่ได้ (คลาสวันเดียวกันหลายวันให้เพิ่มทีละวัน)

ตั้งค่าคลาส
ตารางคลาสประจำสัปดาห์
10

เคาน์เตอร์

เครื่องสแกน QR และหน้าจอเคาน์เตอร์

  • เครื่องสแกน QR แบบ USB/บลูทูธ (ราคาหลักร้อย) ทำงานเหมือนคีย์บอร์ด — เปิดหน้า “เช็คอินหน้าเคาน์เตอร์” ให้ช่องสแกนมีเคอร์เซอร์ แล้วสแกนได้ทันที (ตั้งเครื่องให้ส่ง Enter ต่อท้าย)
  • กล้องมือถือ/แท็บเล็ต — ปุ่ม “ใช้กล้อง” ใช้ได้บน Chrome สำหรับ Android (BarcodeDetector) · iPhone ใช้เบอร์โทรหรือเครื่องสแกนแทน
  • บันทึกหน้าเว็บแอปเป็นบุ๊กมาร์ก/ไอคอนบนหน้าจอหลักของแท็บเล็ตเคาน์เตอร์
11

แจ้งเตือน

แจ้งเตือนต่ออายุ & LINE

แท็บ แจ้งเตือน: เปิดการส่งอัตโนมัติ เวลาส่ง แจ้งล่วงหน้ากี่วัน แม่แบบอีเมล ตัวแปร {name} {gym} {plan} {date} {days} {phone} {card} — ระบบส่งครั้งเดียวต่อรอบหมดอายุ และเฉพาะสมาชิกที่ยินยอม

ตั้งค่าแจ้งเตือน
ตั้งค่าแจ้งเตือนต่ออายุและ LINE

LINE (ไม่บังคับ): ใช้ LINE Official Account + Messaging API (LINE Notify ยุติบริการแล้ว) — สร้าง OA ที่ manager.line.biz เปิด Messaging API แล้วออก Channel access token ที่ LINE Developers Console · ส่งถึงสมาชิกที่เพิ่มเพื่อน OA และบันทึก userId (U…) · ใส่ Group ID เพื่อส่งสรุปให้ทีม · token เก็บใน Script Properties

⚠ โควตา

Gmail ส่งได้ประมาณ 100 ฉบับ/วัน (Workspace ~1,500) · LINE OA ฟรีมีโควตาข้อความต่อเดือน

12

เริ่มใช้งานจริง

ผู้ใช้ & ล้างข้อมูลตัวอย่าง

ผู้ใช้: เคาน์เตอร์ (เช็คอิน สมัคร ขาย จองคลาส) · เทรนเนอร์ (คลาส นัด PT ของตัวเอง ไม่เห็นรายรับ) · ผู้ดูแล (ทุกอย่าง)

ล้างข้อมูลตัวอย่าง: เปิดไฟล์ชีต › เมนู 🏋️ Gym Membership › 🧹 ล้างข้อมูลตัวอย่าง — ลบสมาชิก แพ็กเกจที่ขาย ใบเสร็จ เช็คอิน การจอง นัด PT และรีเซ็ตเลขที่ แต่เก็บการตั้งค่า แพ็กเกจ คลาส และผู้ดูแล บัญชีตัวอย่าง (praewa, coach.*) ถูกลบ — ตรวจคลาสที่ผูกกับเทรนเนอร์ตัวอย่างแล้วเปลี่ยนเป็นเทรนเนอร์จริง

ย้ายสมาชิกเดิม: สมัครสมาชิกในระบบ แล้วขายแพ็กเกจโดยกำหนด “วันเริ่ม” และใส่ส่วนลดเต็มจำนวน (หมายเหตุ “ยกยอดจากระบบเดิม”) เพื่อให้วันหมดอายุตรงกับของเดิม

อ้างอิง

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

แก้ไขข้อมูลผ่านหน้าเว็บเท่านั้น ห้ามเปลี่ยนชื่อชีต หัวคอลัมน์ และคอลัมน์ id

ชีตเก็บอะไรคอลัมน์สำคัญ
Settingsการตั้งค่าgym_*, open/close_time, member_prefix, receipt_prefix, expiring_days, checkin_cooldown_min, booking_cancel_hours, allow_expired_override, remind_*
Usersผู้ใช้username, role (admin/staff/trainer), specialty, pt_rate
Plansแพ็กเกจcode, name, type, days, sessions, price, freeze_days
Membersสมาชิกmember_no, name, phone, email, health_note, qr_token, consent_reminder, last_checkin
Membershipsแพ็กเกจที่สมาชิกซื้อmember_id, type, start_date, end_date, sessions_left, freeze_from/to, freeze_used, status
Paymentsใบเสร็จreceipt_no, member_id, items, discount, amount, method, status
Checkinsการเข้าใช้at, member_id, method, result, reason, by
Classes · Bookings · PTSessionsคลาส การจอง นัด PTweekday, start, capacity · class_id, date, status · trainer_id, date, status
Reminders · Counters · Auditอื่น ๆประวัติแจ้งเตือน · เลขที่ · บันทึกการใช้งาน

ช่วยเหลือ

คำถามที่พบบ่อย

สมาชิกเปิดลิงก์บัตรแล้วขึ้นหน้าล็อกอิน Google

Deploy ให้ “ผู้มีสิทธิ์เข้าถึง = ทุกคน” และส่งลิงก์ที่ลงท้าย /exec?card=… (ไม่ใช่ /dev)

ใช้กล้องสแกนไม่ได้

การสแกนด้วยกล้องใช้ BarcodeDetector ซึ่งรองรับใน Chrome บน Android · บนคอมพิวเตอร์/iPhone ให้ใช้เครื่องสแกน USB หรือพิมพ์เบอร์โทร

สมาชิกต่ออายุก่อนหมด วันจะทับกันไหม

ไม่ทับ — แพ็กเกจรายช่วงเวลาใหม่เริ่มต่อจากวันหมดอายุเดิมอัตโนมัติ (เลือกวันเริ่มเองได้)

บัตรนับครั้งถูกตัดซ้ำเมื่อสแกนสองครั้ง?

ไม่ — เช็คอินซ้ำภายในเวลาที่ตั้ง (ค่าเริ่มต้น 120 นาที) จะขึ้น “เช็คอินแล้ววันนี้” และไม่ตัดครั้ง

คำนวณอัตราเลิก (churn) อย่างไร

สมาชิกที่หมดอายุในช่วง 30 วันล่าสุดและยังไม่ต่อ ÷ จำนวนสมาชิกที่ใช้งานอยู่เมื่อ 30 วันก่อน

เปิดลิงก์แล้วหน้าขาว / ไม่พบฟังก์ชัน doGet

วาง Code.gs ไม่ครบหรือไฟล์ HTML ไม่ได้ชื่อ Index แก้แล้ว Deploy เวอร์ชันใหม่

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

วางทับ Code.gs และ Index.html รัน setup อีกครั้ง (ไม่ลบข้อมูลเดิม) แล้ว Deploy › จัดการการทำให้ใช้งานได้ › ✎ › เวอร์ชันใหม่ — URL เดิมใช้ต่อได้

ใช้พร้อมกันหลายคนได้ไหม

ได้ ทุกการบันทึกใช้ LockService ป้องกันข้อมูลชนกัน เหมาะกับกิจการขนาดเล็ก–กลาง (ข้อมูลหลักหมื่นแถว)