เมื่อไหร่ใช้คู่มือนี้: เปิดให้ กิจการอื่น/คนละเจ้าของ หรืออยากแยกข้อมูลเด็ดขาด · ถ้าแค่เพิ่มสาขาของร้านเดิม ให้ใช้ "คู่มือเปิดสาขาใหม่" แทน (ง่ายกว่ามาก)
กฎความปลอดภัย: รหัสผ่านฐานข้อมูล และคีย์ service_role / secret ห้ามใส่ในไฟล์เว็บและห้ามส่งให้ใครหรือแชตกับใคร · ใส่ในไฟล์เว็บได้เฉพาะ Project URL และคีย์ชนิด publishable / anon เท่านั้น
0เตรียมของ
- บัญชีอีเมลของร้านใหม่ (ใช้สมัคร Supabase และเว็บโฮสต์ — เปิด 2 ชั้น 2FA ให้ทุกบัญชี)
- ชื่อร้าน · โลโก้ (รูปจัตุรัส PNG อย่างน้อย 512×512 ตั้งชื่อ
logo.png) · รายชื่อสาขา สินค้า พนักงาน
- โฟลเดอร์
stock (ไฟล์ระบบ) ที่คัดลอกมาเป็นของร้านใหม่ — คัดลอกไปไว้อีกที่ ก่อนแก้ ไม่แก้ทับของร้านเดิม
1สร้างฐานข้อมูล (Supabase)
- เข้า supabase.com → สมัคร/ล็อกอิน → New project → ตั้งชื่อ เลือกภูมิภาคใกล้ไทย (Singapore) → ตั้ง Database Password (จดเก็บเอง ไม่ต้องใช้ในเว็บ)
- รอโปรเจกต์สร้างเสร็จ (ประมาณ 1–2 นาที)
- แผนฟรีมีข้อจำกัด: โปรเจกต์ที่ไม่มีคนใช้นานราว 1 สัปดาห์จะถูกพักอัตโนมัติ และมีโควตาจำกัด — ร้านที่ใช้งานจริงทุกวันควรพิจารณาแผนชำระเงิน
2สร้างตารางและระบบทั้งหมด (รัน SQL)
- ใน Supabase ไปที่ SQL Editor → New query
- เปิดไฟล์
supabase/_all_in_order.sql ด้วย Notepad → คัดลอกทั้งไฟล์ → วาง → กด Run (ไฟล์เดียวรวมทุกอย่างแล้ว ตั้งแต่ตาราง สิทธิ์ ลงเวลา เงินเดือน เช็คลิสต์ ใบสั่งซื้อ แจ้งเตือน และนำเข้า/ส่งออก)
- ถ้าขึ้น error เรื่อง
pg_cron หรือ pg_net: ไป Database → Extensions เปิด pg_cron และ pg_net แล้วรันใหม่ (รันซ้ำได้ ไม่ซ้ำซ้อน)
- ไฟล์รวมมีวันนักขัตฤกษ์ไทยปี 2569 ด้วย ถ้าร้านใหม่ไม่ต้องการ ลบวันที่ออกทีหลังที่ ลงเวลา → จัดการ
3ตั้งค่าการล็อกอิน
- Authentication → Providers → Email: ปิด "Confirm email" (ถ้ายังไม่ตั้งอีเมลส่งของตัวเอง ไม่งั้นสมัครแล้วระบบส่งอีเมลยืนยันไม่ได้)
- ระบบไม่ส่งอีเมลลืมรหัสผ่าน: ผู้ดูแลกดปุ่ม 🔑 รหัสผ่าน ที่เมนู ผู้ใช้และสิทธิ์ เพื่อตั้งรหัสใหม่ให้พนักงาน (ต้องรัน patch26 ซึ่งรวมอยู่ใน _all_in_order.sql แล้ว)
- หลังได้ที่อยู่เว็บในขั้น 6 กลับมาตั้ง Authentication → URL Configuration → Site URL เป็นที่อยู่เว็บใหม่
4เอา URL และคีย์ไปใส่ในไฟล์เว็บ
- Supabase → Project Settings → API (หรือ API Keys): คัดลอก Project URL (รูปแบบ https://xxxx.supabase.co) และคีย์ชนิด publishable (หรือ anon public)
- เปิด
index.html ด้วย Notepad/VS Code ค้นหา SB_URL และ SB_KEY → วางค่าใหม่แทน (2 บรรทัด)
- ห้ามใช้คีย์ service_role หรือ secret ที่นี่เด็ดขาด
5เปลี่ยนชื่อร้านและโลโก้
- ใช้ Find & Replace (VS Code: Ctrl+H) แทนคำว่า
Kawa Matcha Teahouse เป็นชื่อร้านใหม่ ในไฟล์ index.html, manual*.html, manifest.webmanifest · แทน Kawa Stock (ชื่อสั้นบนไอคอนมือถือ) ใน index.html และ manifest.webmanifest
- แทนที่ไฟล์
logo.png ด้วยโลโก้ร้านใหม่ (ชื่อเดิม) · สร้าง PDF คู่มือใหม่ถ้าต้องการ (เปิดคู่มือ → พิมพ์ → บันทึกเป็น PDF)
- รันสคริปต์ปั๊มเวอร์ชัน:
powershell -ExecutionPolicy Bypass -File tools\bump-version.ps1
- ปุ่ม "สร้าง 4 สาขาตามรายการร้าน" ที่ขึ้นตอนยังไม่มีสาขา เป็นรายการของร้านเดิม อย่ากด — ให้ใช้ขั้น 7 นำเข้าข้อมูลของร้านใหม่แทน
6ขึ้นเว็บ (Deploy)
- รวมไฟล์ที่ต้องอัปโหลดไว้ในโฟลเดอร์เดียว (เช่น
deploy): index.html, sw.js, logo.png, manifest.webmanifest, manual*.html และ PDF คู่มือ
- Netlify: app.netlify.com → Add new site → Deploy manually → ลากโฟลเดอร์ลงไป ได้ที่อยู่ https อัตโนมัติ (ตั้งชื่อเว็บใหม่ได้ที่ Site configuration) — ต้องเป็น https เพื่อให้กล้อง ตำแหน่ง และแจ้งเตือนมือถือทำงาน
- ทางเลือก: GitHub Pages / โฮสต์อื่นที่รองรับไฟล์ static
- เปิดเว็บบนมือถือ ต้องเห็นหน้าเข้าสู่ระบบพร้อมโลโก้ใหม่ · แล้วกลับไปตั้ง Site URL ที่ขั้น 3
- การอัปเดตครั้งต่อไป: แก้ไฟล์ → รัน bump-version → อัปโหลดโฟลเดอร์ซ้ำ (เครื่องที่เปิดค้างโหลดหน้าใหม่เองภายในไม่กี่นาที)
7สร้างผู้ดูแลและนำเข้าข้อมูลตั้งต้น
- เปิดเว็บ → สมัครใช้งาน ด้วยอีเมลเจ้าของร้าน — บัญชีแรกของระบบเป็นผู้ดูแลอัตโนมัติ (สมัครเป็นคนแรกเสมอ)
- เปิดใช้ใบอนุญาต: ☰ → ตั้งค่า → 🔑 ใบอนุญาตและแพ็กเกจ → กรอกคีย์
KW-… ที่ได้จากผู้ขาย → เปิดใช้งาน (ต้องมีอินเทอร์เน็ต) · ฟังก์ชันที่ยังไม่ได้สมัครจะถูกล็อก 🔒 สมัครแพ็กเกจหรือซื้อฟีเจอร์เสริมได้ที่หน้าเดียวกัน (สแกน QR โอนเงิน แนบสลิป รอผู้ขายอนุมัติ) · คีย์ผูกกับระบบนี้ 1 ระบบ ย้ายระบบต้องแจ้งผู้ขาย
- เตรียมข้อมูล: เปิด
data-template/kawa-new-system-data.xlsx แก้ชีต branches (ชื่อสาขา) products (สินค้าของร้านใหม่ — คอลัมน์ branch_id ต้องตรงกับ id ในชีต branches) holidays และ checklist_items ตามที่ต้องการ ห้ามแก้คอลัมน์ id
- เว็บ → ☰ → ตั้งค่า → สำรองและจัดการข้อมูล → ⬆ นำเข้า Excel/CSV/JSON → เลือกไฟล์ → ดูตัวอย่าง (ควรเป็น "เพิ่มใหม่") → ติ๊กทุกตาราง → ยืนยัน
- ถ้าไม่อยากทำผ่านไฟล์ ใช้ ☰ → + เพิ่มสาขา และ + เพิ่มสินค้าที่หน้าเว็บแทนได้
8ตั้งสาขา พนักงาน และกฎ
- ทำตาม คู่มือเปิดสาขาใหม่ ขั้น 2–6: พิกัดร้าน เวลาเปิด-ปิด วันปิด เช็คลิสต์ พนักงานและอัตราค่าจ้าง ทดสอบ
- ปรับ กฎการหักเงิน ให้ตรงกับร้านใหม่ที่ ตั้งค่า → กฎระเบียบและการหักเงิน (ค่าตั้งต้นเป็นกฎของร้านเดิม ตรวจให้ตรงก่อนใช้จ่ายเงินเดือนจริง)
- ส่งคู่มือพนักงาน (ลิงก์ในเมนู ☰) ให้พนักงาน
9ส่วนเสริม (ทำหรือไม่ทำก็ได้)
- แจ้งเตือนบนมือถือ (Push): ทำตาม
PUSH-SETUP.md — ก่อนรัน tools\setup-push.ps1 ให้แก้บรรทัด $ref = '...' เป็น Project ref ของโปรเจกต์ใหม่ (ส่วนหน้า .supabase.co ของ Project URL)
- แจ้งเตือน LINE/อีเมล: สร้างสถานการณ์ใน Make ของร้านใหม่ แล้ววาง Webhook ที่ ☰ → แจ้งเตือน LINE
10ความปลอดภัยก่อนใช้งานจริง
- มีผู้ดูแล อย่างน้อย 2 คน (กันล็อกตัวเองออก) และเปิด 2FA ที่ Supabase และเว็บโฮสต์
- เพิ่มพนักงานครบแล้ว ปิดการสมัครเอง: Supabase → Authentication → Sign In / Providers → ปิด "Allow new users to sign up" (เปิดเฉพาะตอนจะเพิ่มคนใหม่)
- สำรองข้อมูลทั้งระบบทุกสัปดาห์ (ระบบเตือนแถบแดงให้) เก็บไฟล์ไว้ที่ปลอดภัย
- ระบบเงินเดือนเป็นเครื่องมือช่วยคำนวณ ไม่คิดประกันสังคม/ภาษี และไม่ใช่คำปรึกษากฎหมายแรงงาน
✔เช็คลิสต์เปิดระบบใหม่
| # | งาน | เสร็จ |
| 1 | สร้างโปรเจกต์ Supabase | ☐ |
| 2 | รัน _all_in_order.sql ไม่ขึ้น error | ☐ |
| 3 | ปิด Confirm email (Authentication → Providers → Email) เพื่อไม่ให้ระบบพยายามส่งอีเมลตอนสมัคร | ☐ |
| 4 | ใส่ SB_URL / SB_KEY (publishable) ใน index.html | ☐ |
| 5 | เปลี่ยนชื่อร้าน โลโก้ ชื่อบนไอคอนมือถือ | ☐ |
| 6 | อัปโหลดขึ้นเว็บ (https) และตั้ง Site URL | ☐ |
| 7 | สมัครบัญชีแรก (ผู้ดูแล) · เปิดใช้คีย์ใบอนุญาต · นำเข้าข้อมูลตั้งต้น | ☐ |
| 8 | ตั้งพิกัด เวลา เช็คลิสต์ พนักงาน กฎหัก | ☐ |
| 9 | ทดสอบลงเวลา เช็คลิสต์ สต๊อก ด้วยบัญชีพนักงาน | ☐ |
| 10 | ผู้ดูแล ≥ 2 คน · เปิด 2FA · ปิดสมัครเอง · สำรองข้อมูล | ☐ |
ติดปัญหาตรงไหน คัดลอกข้อความ error (ไม่ต้องส่งรหัสผ่านหรือคีย์ลับ) แล้วถามได้เลย