เอกสาร Waypoint
หน้าเว็บไซต์ หลังบ้าน

🚀 เริ่มต้นใช้งาน

ขั้นตอนติดตั้ง เข้าระบบครั้งแรก และเส้นทางทำงานพื้นฐาน

ความต้องการของระบบ

รายการขั้นต่ำแนะนำ
PHP8.08.3+
MySQL5.78.0+
Web ServerApache 2.4 (mod_rewrite) / NginxcPanel / DirectAdmin / MAMP / XAMPP
เบราว์เซอร์Chrome 90 / Safari 14 / Edge 90Chrome ล่าสุด
HTTPSไม่จำเป็น (localhost)จำเป็นถ้าใช้กล้องสแกน QR บน production

ติดตั้งครั้งแรก

  1. อัปโหลดไฟล์

    แตกไฟล์ waypoint-x.y.z.zip แล้วอัปโหลดเนื้อหาในโฟลเดอร์ waypoint/ ไปยังเว็บเซิร์ฟเวอร์ — จะวางที่ root ของโดเมน (public_html/) หรือโฟลเดอร์ย่อย (เช่น public_html/booking/) ก็ได้ ระบบตรวจหาที่อยู่ให้เอง

    ทดสอบในเครื่องด้วย MAMP: วางไว้ใน /Applications/MAMP/htdocs/waypoint/ แล้วเปิด http://localhost:8888/waypoint/
  2. เปิดตัวติดตั้ง

    เข้า https://โดเมนของคุณ/install/ (หรือเปิดหน้าเว็บครั้งแรก — install.php จะพาไปเอง)

  3. ทำตาม Wizard 4 ขั้นตอน
    • ตรวจสอบระบบ — PHP 8.0+, ส่วนขยาย (pdo_mysql, mbstring, curl, openssl…), สิทธิ์เขียนโฟลเดอร์ config/ uploads/ storage/ และลิงก์หน้าเว็บ (URL rewrite)
    • License Key — กรอกคีย์จาก madewithai.store ระบบตรวจสอบและผูกกับเซิร์ฟเวอร์นี้
    • ฐานข้อมูล — host / port / ชื่อ / user / password + ปุ่มทดสอบ (สร้างฐานข้อมูลให้หากยังไม่มี)
    • ตั้งค่า — ชื่อบริษัท, ที่อยู่เว็บไซต์ (ตรวจพบอัตโนมัติ), เลือกติดตั้งข้อมูลตัวอย่าง, สร้างบัญชีผู้ดูแลระบบ
    ติดตั้งสำเร็จ — ระบบสร้างตารางทั้งหมด อัปเดตเป็นเวอร์ชันล่าสุด บันทึก config/database.php, config/app.php และสร้างกุญแจเข้ารหัสใหม่ config/app_key.php · บัญชีตัวอย่างทั้งหมดถูกลบ เหลือเฉพาะ admin ที่คุณสร้าง
  4. ลบโฟลเดอร์ install/

    ตัวติดตั้งล็อกตัวเองหลังติดตั้ง (install/installed.lock) แต่ควรลบโฟลเดอร์ออกจากเซิร์ฟเวอร์

  5. ตั้งค่าต่อในหลังบ้าน

    จัดการระบบ → ตั้งค่า (ข้อมูลบริษัท / โลโก้) · การชำระเงิน · อีเมลแจ้งเตือน · สร้างสถานี เส้นทาง และเที่ยวรถของคุณ

nginx: หน้าเว็บลูกค้าเก็บในโฟลเดอร์ pages/ และ print/ แต่ URL อยู่ที่ root (เช่น /search.php) — Apache ใช้ .htaccess ที่แนบมาได้ทันที ส่วน nginx ให้เพิ่ม config ตาม README.md

โครงสร้างไฟล์

โฟลเดอร์เนื้อหา
index.phpหน้าแรกของเว็บไซต์
pages/หน้าเว็บลูกค้า — ค้นหา/จอง/ชำระเงิน/บัญชี/พัสดุ/ติดตามรถ (URL: /search.php…)
print/เอกสารพิมพ์ — ตั๋ว ใบเสร็จ ป้ายพัสดุ ป้ายสัมภาระ ใบรายชื่อผู้โดยสาร
admin/ระบบหลังบ้าน
api/API + Webhook (Stripe / Omise / GPS)
assets/CSS / JS / รูป / โลโก้
config/การตั้งค่าฐานข้อมูล ที่อยู่เว็บ กุญแจเข้ารหัส (ห้ามเข้าจากเว็บ)
includes/ · lang/โค้ดส่วนกลาง · ไฟล์ภาษา ไทย/อังกฤษ
database/schema + ไฟล์อัปเดตเวอร์ชัน (versions/)
uploads/ · storage/ไฟล์ที่อัปโหลด (โลโก้/สไลด์) · สลิปโอนเงิน (ไม่เปิดสาธารณะ)
docs/คู่มือการใช้งาน (หน้านี้)
install/ตัวติดตั้ง — ลบหลังติดตั้งเสร็จ

เข้าระบบหลังบ้าน

  1. เปิด URL หลังบ้าน

    ไปที่ https://โดเมนของคุณ/admin/login.php

  2. กรอก username + password

    ใช้บัญชีผู้ดูแลระบบที่สร้างไว้ตอนติดตั้ง

    เคล็ดลับ: มีปุ่มสลับภาษาไทย/อังกฤษมุมขวาบนของหน้า login
  3. กด "เข้าสู่ระบบ"

    ถ้าสำเร็จจะ redirect ไปหน้า Dashboard

  4. เปลี่ยนรหัสผ่านครั้งแรก

    คลิก avatar มุมขวาบน → "เปลี่ยนรหัสผ่าน" — ตั้งรหัสผ่านใหม่อย่างน้อย 8 ตัวอักษร

5 ขั้นตอนแรกหลังเข้าระบบ

1️⃣ ตั้งค่าบริษัท

เมนู ตั้งค่าระบบ → กรอกชื่อบริษัท ที่อยู่ เบอร์โทร และอัปโหลด โลโก้ + Favicon

→ คู่มือตั้งค่าระบบ

2️⃣ ตั้งค่า PromptPay

ใน ตั้งค่า → การชำระเงิน ใส่หมายเลขพร้อมเพย์ (เบอร์ 10 หลัก หรือเลขบัตร 13 หลัก) — ใช้สร้าง QR Code จ่ายตั๋ว

3️⃣ เพิ่มสถานี + เส้นทาง

ไป เส้นทาง → "เพิ่มเส้นทาง" → ใส่ต้นทาง ปลายทาง และ จุดจอดกลางทาง (กิโลเมตรจากต้นทาง + เวลาที่ถึง)

→ คู่มือเส้นทาง

4️⃣ เพิ่มรถและประเภทรถ

ตั้งค่า ประเภทรถ (จำนวนที่นั่ง, ผังที่นั่ง 2-2/1-2, ราคา/กม.) แล้วเพิ่ม รถ แต่ละคัน (ทะเบียน + ประเภท)

5️⃣ สร้างเที่ยวรถ

เที่ยวรถ → "เพิ่มเที่ยว" → เลือกเส้นทาง รถ วัน เวลาออก เวลาถึง พนักงานขับ — ระบบจะเปิดให้ลูกค้าจองได้ทันที

6️⃣ ทดสอบจองดู

ไปหน้าเว็บไซต์ ค้นหาเที่ยวที่สร้าง ลองจองและชำระ — หรือใช้ "จองตั๋วใหม่" ในหลังบ้านจองให้ลูกค้าที่เคาน์เตอร์

Sidebar ฝั่งซ้ายแบ่งเป็น 5 หมวด:

🎫 ตั๋วโดยสาร

  • แดชบอร์ด — สถิติวันนี้ การจองล่าสุด เที่ยวรถถัดไป
  • การจอง — ดูทุกการจอง ค้นหา กรองตามสถานะ
  • จองตั๋วใหม่ — จองให้ลูกค้าที่เคาน์เตอร์
  • เที่ยวรถ — สร้าง แก้ไข เที่ยวเดินรถ
  • เส้นทาง — กำหนดเส้นทาง + จุดจอด

📦 รับส่งของ

  • พัสดุ — ดูพัสดุทั้งหมด ค้นหา
  • สแกนพัสดุ — สแกน QR ของพัสดุ (กล้อง/ไฟล์/พิมพ์)
  • ใบสรุปส่งของ — รายการพัสดุต่อเที่ยวรถ พิมพ์ให้คนขับ

🚌 รถและสาขา

  • สถานี — จุดจอด/สาขา
  • รถ — ทะเบียน ยี่ห้อ รุ่น
  • ประเภทรถ — VIP, ปรับอากาศ, พัดลม (ราคา/กม.)
  • สัมภาระ — จัดการใบปะติดกระเป๋า
  • ติดตามรถ — Live map + ETA
  • อุปกรณ์ GPS — ทะเบียน device + token

📊 จัดการเว็บไซต์ + ระบบ

  • เนื้อหาเว็บไซต์ — ประกาศ + Hero + ฟอนต์/สีหน้าบ้าน
  • อัปเดตระบบ — Version control + SQL migration
  • การชำระเงิน — รายการ payments
  • รายงาน — Hub รายงานต่างๆ
  • ผู้ใช้ระบบ — Admin/Staff accounts
  • ตั้งค่าระบบ — บริษัท Logo PromptPay ขนาดกระดาษ

Megamenu (มุมขวาบน)

คลิกที่ avatar + ชื่อมุมขวาบน — จะเปิด megamenu ที่มี:

ปุ่มใช้ทำอะไร
โปรไฟล์ดู/แก้ข้อมูลส่วนตัว
การจองshortcut ไปหน้าการจอง
การแสดงผลเปลี่ยนธีม ฟอนต์ ขนาด ภาษา
เปลี่ยนรหัสผ่านตั้งรหัสผ่านใหม่
ไอคอนshortcut ไป appearance (icon style)
ภาษาshortcut เลือกภาษา
ออกจากระบบLogout