1.1 เว็บนี้คืออะไร?

ThaibadTournaments.com คือแพลตฟอร์มจัดการการแข่งขันแบดมินตันแบบครบวงจร ตั้งแต่ผู้เล่นสมัครเข้าแข่ง ไปจนถึงการแสดงผลคะแนนสดผ่าน OBS

รูปที่ 1.1 — หน้าแรกของเว็บ thaibadtournaments.com

🎯 เป้าหมายหลัก

• นักกีฬา — ดูตารางการแข่ง, สมัครเข้าแข่ง, ชำระเงิน, รับ reminder ผ่าน LINE
• เจ้าของรายการ — สร้างทัวร์, จัดสาย, ป้อนคะแนนสด, ประกาศผลผ่าน OBS overlay
• ชมรม — รวมสมาชิก, จัดทัวร์ในนามชมรม, ออกแบบ banner
• กรรมการ/Staff — ใส่คะแนนสด, ตรวจสลิป, ยืนยันตัวตน

🧩 ฟีเจอร์เด่น

1.2 กลุ่มผู้ใช้ 5 ระดับ (Roles)

ระบบมีการแบ่งสิทธิ์ผู้ใช้ออกเป็น 5 ระดับ ดังตาราง:

1.3 4 สถานะของรายการแข่ง (Tournament Status)

รายการแข่งทุกรายการในระบบจะอยู่ในหนึ่งใน 4 สถานะนี้ ส่งผลต่อสิทธิ์การสมัครและการแสดงผล

📸 ตัวอย่างจริงในระบบทั้ง 4 สถานะ

เปิดรับสมัคร — รายการ "สนามกลางโอเพ่น #1"

ปิดรับสมัคร — รายการ "Test"

กำลังแข่งขัน — VENSON Kamphaengphet 2026

แข่งขันเสร็จสิ้น — Rotary Championship 2026

1.4 Flow การทำงานของระบบ

👥 มุมมองนักกีฬา (User)

[1] สมัครสมาชิก → [2] ผูก LINE → [3] ตั้งค่าโปรไฟล์ + ยืนยันตัวตน
                                        ↓
[4] ดูปฏิทินทัวร์ → [5] สมัครรายการ → [6] ชวนคู่ → [7] ชำระเงิน
                                                          ↓
[8] รอ reminder LINE → [9] เช็คอินวันแข่ง → [10] ดูคิว/คะแนนสด
                                                          ↓
                                            [11] รับรางวัล + ดูสถิติย้อนหลัง

🏆 มุมมองเจ้าของรายการ (Admin)

[1] สร้างรายการ → [2] กำหนด event/รุ่นอายุ → [3] ตั้งค่า Payment mode
        ↓
[4] เปิดรับสมัคร → [5] อนุมัติสลิป → [6] ปิดรับสมัคร
        ↓
[7] จัดสาย (Bracket) → [8] Schedule Planner → [9] พิมพ์ Scoresheet
        ↓
[10] เปลี่ยนสถานะ "กำลังแข่งขัน" → [11] ป้อนคะแนนสด
        ↓
[12] Auto-advance ทีมชนะ → [13] Broadcast LINE → [14] OBS overlay
        ↓
[15] เปลี่ยนสถานะ "เสร็จสิ้น" → [16] อัปโหลดรูป

🔗 ระบบที่ทำงานเบื้องหลัง (Cron + Webhook)

• cron_notify_matches.php — รันทุก 2-5 นาที ส่ง LINE reminder 30 นาที + 1 ชั่วโมงล่วงหน้า
• line_webhook.php — รับข้อความจาก LINE Bot, จัดการ state machine
• visitor_heartbeat.php — track session ทุก 30 วินาที
• error_monitor.php — จับ exception, ส่ง email แจ้ง admin (rate-limit 5/ชม.)

1.5 ทำความรู้จักหน้าตาเว็บ

🏠 หน้าแรก (Homepage)

รูปที่ 1.5.1 — หน้าแรกแสดง: รายการเด่น, ข่าวสาร, ปฏิทินใกล้เคียง

📅 ปฏิทินการแข่งขัน (calendar.php)

รูปที่ 1.5.2 — ดูทุกรายการในมุมมองปฏิทินรายเดือน + รายการที่เปิดรับสมัคร

สี dot บนปฏิทินบอกสถานะ:

• 🟢 เปิดรับสมัคร — สมัครได้
• 🟡 กำลังแข่งขัน — แข่งวันนี้/สัปดาห์นี้
• ⚫ แข่งขันเสร็จสิ้น — ดูผลย้อนหลัง

2.1 สมัครสมาชิกใหม่

การสมัครสมาชิกใช้เวลา ~2 นาที ทำได้ 3 ช่องทาง:

• 📝 สมัครด้วยฟอร์มปกติ (username + password)
• 🔵 สมัครผ่าน Google
• 🟢 สมัครผ่าน LINE

รูปที่ 2.1 — หน้า signup.php

ขั้นตอน (สมัครด้วยฟอร์ม)

1. เข้า thaibadtournaments.com/badminton/signup.php
2. กรอก username (a-z, 0-9, _ — ไม่มีช่องว่าง)
3. กรอก email (ระบบเช็ค MX DNS — ต้องใช้งานได้จริง)
4. กรอก password + ยืนยัน (อย่างน้อย 8 ตัว)
5. กรอก ชื่อจริง-นามสกุล ภาษาไทย
6. ยอมรับ Privacy Policy → กด "สมัครสมาชิก"

2.2 เข้าสู่ระบบ (Login)

รูปที่ 2.2 — หน้า login.php — มี 3 ช่องทาง

1. ใส่ username หรือ email (ระบบรับทั้งคู่)
2. ใส่ password → กด "ลงชื่อเข้าใช้"
3. หากมี 2FA เปิดอยู่ ระบบจะถามรหัส OTP 6 หลัก

🔐 ระบบความปลอดภัย

• Account Lockout — ใส่ password ผิด 5 ครั้ง ติดล็อก 15 นาที
• Rate limit — IP เดียวกัน login ได้ 20 ครั้ง/10 นาที
• CSRF protection — ทุก POST ต้องมี _csrf token

🔑 ลืมรหัสผ่าน

1. กด "ลืมรหัสผ่าน?"
2. ใส่ email ที่ลงทะเบียนไว้
3. เปิด email → กดลิงก์ reset (อายุ 1 ชม.)
4. ตั้ง password ใหม่

2.3 ผูกบัญชี LINE

การผูก LINE สำคัญมาก เพราะระบบจะส่ง reminder ก่อนแข่ง 30 นาที + 1 ชั่วโมง ผ่าน LINE

รูปที่ 2.3 — หน้า link_line.php แสดง QR + PIN 6 หลัก

วิธีผูก

1. Login เข้าระบบ → ไปที่ โปรไฟล์ → "ผูก LINE"
2. ระบบสร้าง PIN 6 หลัก (อายุ 15 นาที)
3. เพิ่มเพื่อน LINE Bot: @thaibadtournaments (สแกน QR)
4. พิมพ์ ลงทะเบียน 123456 ในแชท (แทน 123456 ด้วย PIN ของคุณ)
5. Bot ตอบกลับ "เชื่อมต่อสำเร็จ" → จบ

ยกเลิกการผูก

ไปที่ โปรไฟล์ → กดปุ่ม "ยกเลิกการผูก LINE" — ระบบจะลบ link และหยุดส่ง notification ทันที

2.4 ตั้งค่า 2FA (Two-Factor Authentication)

เปิด 2FA เพื่อความปลอดภัยขั้นสูง — ต้องใช้ Google Authenticator หรือ app TOTP อื่น

วิธีเปิด 2FA

1. ไปที่ โปรไฟล์ → แก้ไขข้อมูล → tab "ความปลอดภัย"
2. กด "เปิดใช้ 2FA"
3. สแกน QR code ด้วย Google Authenticator (หรือ Authy, 1Password)
4. กรอกรหัส 6 หลักจาก app → ยืนยัน
5. ระบบให้ backup codes 10 รหัส — บันทึกไว้ในที่ปลอดภัย

เวลา login ด้วย 2FA

1. ใส่ username + password ปกติ
2. ระบบพาไปหน้า verify_2fa.php
3. เปิด Authenticator → กรอกรหัส 6 หลัก → ผ่าน

2.5 ยืนยันตัวตน (Identity Verification)

ทัวร์บางรายการ (โดยเฉพาะ Association tournament รุ่นอายุ) บังคับให้ยืนยันตัวตนก่อนสมัคร เพื่อยืนยันอายุจริง

ขั้นตอน

1. ไปที่ โปรไฟล์ → "ยืนยันตัวตน"
2. อัปโหลดรูปบัตรประชาชน (ปิดเลข 4 ตัวท้ายได้)
3. กรอกข้อมูล: ชื่อ-นามสกุล, วันเกิด, เพศ (ต้องตรงกับบัตร)
4. กด "ส่งคำขอ" → รอแอดมินตรวจ (ปกติ 1-2 วันทำการ)

หลังยืนยันแล้ว

• โปรไฟล์ขึ้น badge "✓ ยืนยันแล้ว"
• สามารถสมัครรุ่นอายุได้
• หากไม่ผ่าน — แอดมินจะแจ้งเหตุผลผ่าน Inbox + LINE

2.6 ดูและแก้ไขโปรไฟล์

รูปที่ 2.6 — หน้าโปรไฟล์ profile.php

ส่วนประกอบ

• UID — รหัสประจำตัว 4 หลัก (เช่น UID0002) ใช้ในการเชิญคู่
• สถานะ LINE — แสดงว่าผูก LINE แล้วหรือยัง
• สถิติ Stats — จำนวนแข่ง, เหรียญทอง/เงิน/ทองแดง
• รายละเอียดผลงาน — ประวัติทัวร์ทั้งหมดที่เคยลงแข่ง

แก้ไขข้อมูล

รูปที่ 2.6.2 — edit_profile.php

แก้ไขได้ทันที (ไม่ต้อง OTP):

• รูปโปรไฟล์, เบอร์โทร, จังหวัด
• การตั้งค่าภาษา (TH/EN)

ต้องใช้ OTP ผ่าน email ก่อนเปลี่ยน:

• email, password, ชื่อ-นามสกุล, วันเกิด, เพศ

2.7 ดูปฏิทินการแข่งขัน

รูปที่ 2.7 — calendar.php — แสดงรายการแข่งทุกสถานะ

วิธีกรอง

• ตามจังหวัด — dropdown เลือกจังหวัด
• ตามเดือน — เลื่อนซ้าย/ขวา
• ตามสถานะ — สีของ pill บอกสถานะ

วิธีอ่านสีบนปฏิทิน

คลิกที่รายการเพื่อเข้าสู่หน้า match_detail.php?id=...

2.8 หน้ารายละเอียดรายการแข่ง (Match Detail Tabs)

หน้ารายการแข่ง match_detail.php?id=N มี 9 tabs ที่จะแสดง/ซ่อนตามสถานะของรายการ

รูปที่ 2.8 — Tab "รายละเอียดการแข่งขัน" (default)

📡 Tab "การแข่งสด" (Live)

เมื่อรายการอยู่สถานะ กำลังแข่งขัน และเปิด YouTube Live URL — จะมีปุ่ม "🔴 ดูการแข่งสด" แยกพิเศษ ฝัง YouTube embed

2.9 สมัครเข้าแข่ง

กดได้เมื่อรายการอยู่สถานะ เปิดรับสมัคร เท่านั้น

ขั้นตอน

1. เข้าหน้า match_detail.php?id=N
2. กดปุ่ม "สมัครเข้าแข่งขัน" (สีเขียว ขวามือ)
3. เลือก event ที่ต้องการ (เช่น ชายคู่, หญิงคู่, คู่ผสม)
4. เลือก รุ่นอายุ (ถ้ามี — บังคับยืนยันตัวตนก่อน)
5. กรอก ชื่อทีม (ค้นหาจากชื่อชมรมอัตโนมัติ)
6. ส่วน คู่ที่ 2: 3 ทางเลือก
   • 📨 ชวนผ่าน UID — กรอก UID ของคู่ → ระบบส่ง invite ใน Inbox + LINE
   • 🔍 ค้นหาด้วยชื่อ — autocomplete จาก search_users_by_name
   • ✍️ ใส่ชื่อ guest — สำหรับผู้ที่ไม่มีบัญชีในระบบ
7. กด "ส่งใบสมัคร"

2.10 ตอบรับการเชิญจากคู่

เมื่อมีคนชวนคุณ — คุณจะได้รับการแจ้งเตือน 2 ช่องทาง:

• 📥 Inbox ในระบบ (inbox.php)
• 📱 LINE (ถ้าผูก LINE ไว้)

รูปที่ 2.10 — Inbox แสดง invite จากคู่

ขั้นตอนตอบรับ

1. เปิด Inbox → คลิกที่ข้อความ "🎾 [ชื่อ] ชวนคุณลงแข่ง [ทัวร์]"
2. ระบบพาไป respond_invite.php?token=...
3. ตรวจข้อมูล: รายการ, event, คู่ของคุณ
4. กด "ยอมรับ" หรือ "ปฏิเสธ"
5. หากยอมรับ — ใบสมัครเข้าสถานะ "รอชำระเงิน" ทันที (คนชวนต้องชำระเอง หรือคุยกันเอง)

2.11 ชำระเงิน + อัปโหลดสลิป

ระบบรองรับ 3 โหมดการชำระ:

ขั้นตอนอัปโหลดสลิป

1. เข้าหน้า match_detail.php → tab "รายชื่อผู้สมัคร" → หาแถวของคุณ
2. กด "อัปโหลดสลิป"
3. เลือกรูปสลิป (JPG/PNG, ขนาด < 5 MB)
4. กด "ส่ง" → ระบบตรวจสลิป
   • SlipOK mode — ตรวจอัตโนมัติใน 5-10 วินาที → สถานะ "ผ่านชำระแล้ว"
   • Manual mode — รอแอดมินตรวจ (1-24 ชม.)

2.12 Inbox — กล่องข้อความ

ประเภทข้อความที่จะเข้า Inbox

• 🎾 คำเชิญจากคู่ — มีปุ่มตอบรับ/ปฏิเสธ
• 💰 สลิปได้รับอนุมัติ / ปฏิเสธ
• 📅 การเปลี่ยนแปลงตารางแข่ง — เปลี่ยนสนาม/เวลา
• 🆔 ผลการตรวจ identity
• 📢 ประกาศจากแอดมิน (broadcast)
• 🌅 Morning Broadcast — สรุปตารางวันแข่ง 06:00

เปิดข้อความ → ระบบ mark เป็น "read" อัตโนมัติ

2.13 ตั้งค่าการแจ้งเตือน

เปิด/ปิดการแจ้งเตือนแต่ละประเภทได้ใน notification_settings.php

ช่องทาง

• 📨 Email
• 📱 LINE (ต้องผูก LINE ก่อน)
• 📥 Inbox (ในระบบ)
• 🔔 Web Push (ผ่าน Service Worker — ต้อง grant permission ในเบราว์เซอร์)

ประเภทที่ตั้งค่าได้

ตั้งค่าได้ ต่อรายการแข่ง (per-tournament) ไม่ใช่ global เท่านั้น

2.14 ข่าวสาร (News)

รูปที่ 2.14 — หน้าข่าวสาร news.php

ข่าวสารโพสต์โดยแอดมิน — รวม:

• 📢 ประกาศจากระบบ
• 🏆 ข่าวการแข่งขัน
• 📝 บทความเกี่ยวกับแบดมินตัน

2.15 ค้นหารูปภาพด้วยใบหน้า (Photo Face Search)

การใช้งานที่วางแผนไว้

1. เข้าหน้า photo_search.php
2. อัปโหลด selfie (รูปหน้าตัวเอง 1 รูป)
3. เลือกรายการที่ต้องการค้นหารูป
4. ระบบส่ง embedding ไปยัง AI → match กับรูปทั้งหมดในรายการ
5. แสดงผล: รูปที่มีใบหน้าใกล้เคียง พร้อม similarity score
6. ดาวน์โหลดรูปที่ต้องการ

3.1 Admin Dashboard

รูปที่ 3.1 — หน้า admin.php — ศูนย์รวมการจัดการทั้งหมด

เมนูหลักใน Dashboard

• 🆕 สร้างรายการแข่งขัน
• 📋 รายการทั้งหมด — list ทุกทัวร์ พร้อมสถานะ + ปุ่มแก้ไข/Live Score
• 📰 จัดการข่าวสาร
• 📍 จัดการจังหวัด (calendar province)
• 👥 จัดการผู้ใช้
• 📊 Visitor Logs / Player Stats / Error Logs
• 📢 LINE Broadcast / Morning Broadcast
• 🆔 Verify Identity / Verify Slips
• 🔊 TTS Cache Management

3.2 สร้างรายการแข่งใหม่

ทำได้จาก Admin Dashboard → กดปุ่ม "+ สร้างรายการ"

ฟิลด์ที่ต้องกรอก

3.3 แก้ไขรายการแข่ง

รูปที่ 3.3 — edit_match.php — มี multi-section + sensitive changes

การเปลี่ยน "สถานะ"

เปลี่ยนผ่าน dropdown — มี 4 ค่า:

• เปิดรับสมัคร — เริ่มเปิดให้สมัคร
• ปิดรับสมัคร — หยุดการสมัคร ระหว่างจัดสาย
• กำลังแข่งขัน — เปิดระบบ live scoring + LINE reminder cron
• แข่งขันเสร็จสิ้น — ปิดการแก้ไขทั้งหมด เหลือแค่ upload รูป

3.4 ตั้งค่าระบบชำระเงิน (Payment Modes)

โหมด 1: Manual

• ไม่มีระบบ online — ผู้เล่นโอนเงินแล้วแจ้งแอดมินผ่าน Inbox/LINE
• แอดมินเข้าหน้า admin_verify_slips.php → กด "ผ่าน" ด้วยมือ

โหมด 2: Manual QR

• อัปโหลด QR code → ผู้เล่นสแกน → โอนเงิน → อัปโหลดสลิป
• แอดมินตรวจสลิปด้วยมือ

โหมด 3: SlipOK (อัตโนมัติ)

1. สมัคร SlipOK API ที่ slipok.com → ได้ branch_id + api_key
2. กรอกใน edit_match.php ที่ฟิลด์ slipok_branch_id + slipok_api_key
3. ผู้เล่นอัปโหลดสลิป → SlipOK ตรวจ: ยอดเงิน, ชื่อผู้รับ, trans_ref, duplicate check
4. ผ่าน → match_registrations.status='ผ่านชำระแล้ว', slip_auto_verified=1
5. ไม่ผ่าน → ตกมาให้แอดมินตรวจด้วยมือ

3.5 ตรวจสลิป Manual

หน้า admin_verify_slips.php — แสดงสลิปที่รอตรวจทั้งหมด

ขั้นตอน

1. ดูรูปสลิป (กดขยายได้)
2. เทียบกับ: ชื่อบัญชีรับโอน, ยอดเงิน, วันที่
3. กด "✓ อนุมัติ" → สถานะ "ผ่านชำระแล้ว"
4. หรือกด "✗ ปฏิเสธ" → ใส่เหตุผล (เช่น "ยอดไม่ตรง", "สลิปซ้ำ")
5. ระบบส่ง notification ไปยังผู้เล่น + คู่ผ่าน Inbox + LINE

3.6 ตั้งค่าสายแข่ง (Bracket Config)

หลังปิดรับสมัคร → ต้องจัดสายการแข่งก่อน

รูปแบบที่รองรับ

รูปที่ 3.6 — admin_manage_group.php — จัดกลุ่ม + คะแนน

3.7 Schedule Planner — วางตารางแข่ง

รูปที่ 3.7 — admin_schedule_planner.php — auto schedule

ฟีเจอร์

• Build pairings — สร้างคู่แข่งทุกคู่ใน group + knockout
• Auto-schedule — กระจายลงคอร์ท + เวลาแบบ optimal
• Manual override — drag-drop ปรับเองได้
• Save schedule — บันทึกเป็น JSON ใน order_of_play

Input parameters

• จำนวนคอร์ท (เช่น 4)
• เวลาเริ่ม - จบในแต่ละวัน
• ระยะเวลา/แมตช์ (เช่น 20 นาที)
• break time ระหว่างแมตช์ของผู้เล่นคนเดียวกัน (เช่น 30 นาที)

3.8 พิมพ์ใบลงคะแนน (Scoresheet)

รูปที่ 3.8 — admin_print_scoresheet.php — A4 Landscape

รูปแบบที่พิมพ์ได้

• Full referee sheet — 36-box format มาตรฐาน BWF
• Compact 2-match — 2 แมตช์ต่อหน้า สำหรับ group round

หน้า A4 Landscape — ทดสอบและปรับ margin เพื่อให้พิมพ์ตรงทุก browser (Chrome, Safari, Firefox)

3.9 ป้อนคะแนนสด (Live Scoring)

รูปที่ 3.9 — admin_live_match.php

วิธีป้อนคะแนน

1. เปิด admin_live_match.php?id=N
2. เลือกคู่ที่กำลังแข่งจากตาราง
3. กรอกคะแนนใน input field — รองรับหลายรูปแบบ:
   • 21 15 21 10 → auto-format เป็น 21-15, 21-10
   • 21-15 21-10 → คงรูปแบบ
   • 21-19 18-21 21-15 → 3 เซ็ต
4. กด "บันทึก" — ระบบ:
   • อัปเดต group_standings auto (W/D/L, set diff, point diff)
   • เรียก autoAdvanceKnockout() ถ้าเป็นแมตช์น็อกเอาต์ → ส่งทีมชนะไปรอบถัดไป
   • Broadcast ผ่าน match_order_api.php ให้ scoreboard + OBS อัปเดต

3.10 จัดการรอบน็อกเอาต์ (Knockout)

รูปที่ 3.10 — admin_manage_knockout.php

โครงสร้าง

ตาราง knockout_matches ใช้ symbolic reference:

• W1 = ผู้ชนะแมตช์ 1, L1 = ผู้แพ้แมตช์ 1
• WIN[3] = ผู้ชนะลำดับ 3, LOSE[5] = ผู้แพ้ลำดับ 5

เมื่อ admin ป้อนคะแนนแมตช์ที่ 1 → ระบบเรียก autoAdvanceKnockout() recursively walk tree → แทนที่ W1 ในแมตช์ลูก ด้วยชื่อทีมจริง

3.11 จัดการลำดับการแข่ง (Order of Play)

รูปที่ 3.11 — admin_manage_order.php

ทำได้

• แก้ court (สนาม)
• แก้ time_slot (เวลา)
• แก้ match_no (เลขคิว)
• เปลี่ยน ทีม หรือ score ด้วยมือ
• Reorder ทั้งหมดผ่าน match_order_api.php

3.12 Live Scoreboard (Kiosk Display)

หน้าจอแสดงผลขนาดใหญ่ — สำหรับ TV/Projector ในงานแข่ง

• admin_scoreboard.php — แสดงคิวปัจจุบัน + คะแนนสด
• admin_live_board.php — bracket viewer + standings

3.13 OBS Overlay — สำหรับ Live Streaming

ตั้งค่า OBS

1. เปิด OBS Studio
2. เพิ่ม Source: Browser Source
3. URL: https://thaibadtournaments.com/badminton/admin_obs_overlay.php?id=N&court=1
4. Width: 1920, Height: 1080
5. เลือก "Custom CSS" → ปรับสี/ขนาดตามต้องการ
6. กด "OK" → overlay จะแสดงทับวิดีโอแบบโปร่งใส

อ่านเพิ่มเติม: ไฟล์ OBS overlay.md ใน root

3.14 TTS เรียกคิว (Court Call)

ระบบเรียกชื่อนักกีฬาผ่าน Text-to-Speech

3 เครื่องมือ TTS

การเรียกใช้

1. เปิด tts_court_call.php?id=N บนเครื่องที่มีลำโพง/เครื่องเสียง
2. เลือกคิวที่ต้องการเรียก
3. กด "เรียก" — ระบบจะอ่าน "สนาม X เชิญทีม Y และ Z"

TTS Cache

ระบบ cache เสียงด้วย SHA256(text+voice).wav ใน /uploads/tts_cache/

• เสียงที่เรียกซ้ำใช้ cache ไม่เสีย API quota
• Precache — admin สามารถ batch generate เสียงชื่อนักกีฬาทั้งหมดก่อนวันแข่งใน admin_tts_cache.php

3.15 LINE Broadcast

รูปที่ 3.15 — admin_line_broadcast.php

การส่งข้อความหมู่

1. เลือก กลุ่มเป้าหมาย:
   • ทั้งหมด
   • ตามจังหวัด
   • ตามรายการแข่งที่สมัครไว้
   • ตามรุ่นอายุ/เพศ
2. เลือก รูปแบบ: Plain text หรือ Flex Message
3. เขียนข้อความ → Preview ก่อนส่ง
4. กด "ส่ง" → ระบบ multicast batch 500 UIDs/ครั้ง

3.16 Morning Broadcast (สรุปตารางวันแข่ง)

ส่งสรุปตารางการแข่งของผู้เล่นแต่ละคนตอน 06:00 ของวันแข่ง

วิธีตั้ง

1. เปิด admin_morning_broadcast.php
2. เลือกรายการ + วันที่
3. กด "ดู Preview" — ระบบรวบรวม matches ของผู้เล่นทุกคน, group ตาม user
4. กด "ส่งทันที" หรือ "ตั้งเวลาส่ง"

แต่ละผู้เล่นจะได้ 1 ข้อความเดียว สรุปทุกแมตช์ของตัวเอง (ไม่ซ้ำแม้สมัครหลายรุ่น)

การ Automate

ตั้ง cron job ใน server ให้รัน admin_morning_broadcast.php?auto=1&date=TODAY ตอน 06:00 ทุกวัน

3.17 ตรวจสอบการยืนยันตัวตน

รูปที่ 3.17 — admin_verify_identity.php

ขั้นตอน

1. ดูรูปบัตรประชาชนของผู้สมัคร (กดขยายได้)
2. เปรียบเทียบกับข้อมูลที่กรอก: ชื่อ, วันเกิด, เพศ
3. กด "✓ อนุมัติ" → ระบบ:
   • ตั้ง users.identity_verified = 1
   • ลบรูปบัตรประชาชนทันที (privacy-first)
   • ส่ง notification ผ่าน Inbox + LINE
4. หรือกด "✗ ปฏิเสธ" → ใส่เหตุผล (เช่น "รูปไม่ชัด", "ข้อมูลไม่ตรง")

3.18 จัดการผู้ใช้

รูปที่ 3.18 — manage_users.php

การจัดการ

• 🔍 ค้นหา user ตามชื่อ/email/UID
• 👤 ดูรายละเอียดเต็ม (สถานะ, LINE link, identity, สถิติ)
• 🔧 เปลี่ยน role (user/contributor/client_owner/staff_admin)
• 🔒 Force logout — ทุก session ถูก invalidate
• 🚫 Suspend — ระงับการใช้งานชั่วคราว
• 🗑️ Delete — ลบบัญชี (ถาวร — confirm 2 ครั้ง)

3.19 Visitor Analytics

รูปที่ 3.19 — admin_visitor_logs.php

ข้อมูลที่เก็บ

Metrics

• 📈 จำนวน unique sessions/วัน
• 📄 หน้าที่เปิดบ่อย
• ⏱️ Average session duration
• 📱 Device/Browser breakdown
• 🌍 Referrer (มาจากที่ไหน)

3.20 Error Log Viewer

รูปที่ 3.20 — admin_errors.php

การทำงาน

• lib/error_monitor.php จับ PHP errors + uncaught exceptions
• บันทึกลง errors_log table + /uploads/logs/errors.jsonl
• ถ้า level = fatal/error → ส่ง email alert (rate-limit 5/ชม.)

การใช้งานหน้านี้

• 📋 ดู error history พร้อม stack trace
• 🔍 Filter ตาม level / file / time range
• ✓ Mark as resolved
• 📧 Manual trigger email alert

3.21 Player Stats / Head-to-Head

รูปที่ 3.21 — admin_player_stats.php

ดูได้

• 📊 สถิติแมตช์: จำนวนแข่ง, ชนะ/แพ้, % win rate
• 🆚 Head-to-head — ค้นหา 2 ผู้เล่น → ดูสถิติคู่ปรับ
• 🏆 Ranking ตาม event/รุ่นอายุ
• 🎯 Best performance — ผู้ชนะที่ Top 10

3.22 จัดการลูกแบดมินตัน + Export

Shuttlecocks Tracker

รูปที่ 3.22 — admin_shuttlecocks.php — บันทึกลูกที่ใช้

• บันทึกจำนวนลูกที่ใช้ต่อแมตช์
• แสดงราคา + ยอดที่ผู้เล่นต้องชำระเพิ่ม
• ผู้เล่นเห็นข้อมูลใน tab "จำนวนลูกแบด" ของรายการ

Export Registrations

เข้า export_registrations.php?id=N → ดาวน์โหลด CSV/Excel ของผู้สมัครทั้งหมด

• ชื่อทีม, ชื่อสมาชิก, UID, เบอร์โทร, อีเมล, สถานะชำระเงิน, event

จังหวัดในปฏิทิน

admin_calendar_province.php — เพิ่ม/แก้ไขจังหวัดให้ตัวกรอง

4.1 สร้างชมรมใหม่

รูปที่ 4.1 — club_create.php

ฟิลด์ที่ต้องกรอก

• ชื่อชมรม (จะถูก slugify อัตโนมัติ + random suffix เพื่อกันชนกัน)
• จังหวัด
• โลโก้ (รูป square, แนะนำ 512x512)
• สีหลัก/รอง ของชมรม (ใช้ใน banner)
• ที่อยู่, เบอร์โทร, เลขประจำตัวผู้เสียภาษี
• คำอธิบาย (TinyMCE-style editor)

เมื่อสร้างเสร็จ — คุณเป็น club_member role=owner โดยอัตโนมัติ

4.2 ออกแบบ Banner ชมรม

Banner ปรากฏใน profile ชมรม, list ชมรม, และในรายการแข่งของชมรม

รูปแบบที่รองรับ (เก็บใน club_banner_designs)

ปรับแต่งข้อความ

• Font family (Sarabun, Mali, Kanit, Prompt)
• Font weight (300-900)
• Text shadow + letter spacing
• ตำแหน่ง icon (ซ้าย/กลาง/ขวา)
• Custom CSS field — แทรก CSS เพิ่มได้

4.3 จัดการสมาชิกชมรม

รูปที่ 4.3 — club_manage.php?id=N

การเชิญสมาชิก

1. แชร์ลิงก์ของชมรม (เช่น club_view.php?id=N) ให้สมาชิก
2. สมาชิกกด "สมัครเข้าร่วม" → สถานะ pending
3. เจ้าของชมรม approve/reject ในหน้า club_manage.php

Roles ในชมรม

• owner — สิทธิ์ทุกอย่าง (เปลี่ยน owner ได้ครั้งเดียว)
• admin — จัดการสมาชิก + สร้างทัวร์ในชมรม
• member — สมาชิกทั่วไป — ใช้ชื่อชมรมเวลาสมัครแข่งได้

4.4 หน้าโปรไฟล์ชมรม (Club View)

รูปที่ 4.4 — club_view.php — ใครก็เห็นได้

ส่วนประกอบ

• Header — banner design ของชมรม
• รายชื่อสมาชิก (filterable)
• ทัวร์ที่ชมรมจัด
• ทัวร์ที่สมาชิกชนะ
• สถิติชมรม — เหรียญรวม

4.5 Association Tournament Mode

โหมดพิเศษสำหรับทัวร์ระดับสมาคม — มีรุ่นอายุ + draw system แบบ BWF

ความต่างจาก Web Mode

Tabs ใน Association Mode

• ℹ️ Info — รายละเอียดทัวร์ + draw config
• 📋 Registrants — group ตามรุ่นอายุ + event
• 👥 Players — ข้อมูลผู้เล่น + ranking
• 🎯 Events — seed + draw settings
• 📊 Draws — สายที่สร้างขึ้น
• ⏰ Order — ลำดับการแข่ง

4.6 Bulk Import นักกีฬา (CSV)

สำหรับสมาคมที่ต้องลงทะเบียนนักกีฬาจำนวนมากจากระบบสมาคมเดิม

CSV Template

ขั้นตอน

1. เข้า assoc_bulk_import.php?id=N
2. ดาวน์โหลด template CSV
3. กรอกข้อมูล → save เป็น UTF-8 BOM (สำคัญ — รักษาภาษาไทย)
4. อัปโหลด → ระบบ preview 10 แถวแรก → confirm
5. ระบบสร้าง guest users + match_registrations

4B.1 Client Owner คือใคร?

Client Owner คือผู้ใช้ที่ได้รับ "สิทธิ์เจ้าของรายการ" เฉพาะรายการแข่งใดรายการหนึ่ง (ไม่ใช่ทั้งเว็บ)

ตัวอย่างสถานการณ์

• เจ้าของชมรม A จัดทัวร์ "ชมรม A Open #1" — เจ้าของชมรม = Client Owner ของรายการนี้
• ผู้จัดอิสระจัดทัวร์ของตัวเอง — เจ้าของระบบมอบสิทธิ์ Client Owner ให้
• หัวหน้าทีม Staff ในงานใหญ่ — ได้รับมอบสิทธิ์เฉพาะงานนั้น

วิธีรู้ว่าคุณเป็น Client Owner ของรายการไหน

เปิดหน้ารายการ — ถ้าเห็น แท็กสีฟ้าเขียนว่า:

แท็กนี้ขึ้นใต้ชื่อรายการ บอกชัดว่าคุณกำลังดูในฐานะเจ้าของรายการ

4B.2 เมื่อเปิด "หน้ารายละเอียดรายการ" จะเห็นอะไร?

เริ่มจากบนลงล่าง:

รูปที่ 4B.2 — หน้ารายการที่ Client Owner เห็น (พร้อมปุ่มจัดการพิเศษ)

ส่วนที่ "เพิ่มขึ้น" จากที่ user เห็น

ส่วนที่เห็น "เหมือนเดิม" กับ user

• หัวเรื่อง, วันแข่ง, สถานที่, Google Map
• โปสเตอร์รายการ + รายละเอียดการแข่ง
• แท็บเดียวกัน 9 แท็บ (รายละเอียด, กติกา, รายชื่อผู้สมัคร, ตารางแข่ง, รอบกลุ่ม, น็อกเอาต์, ผล, ลูกแบด, รูปภาพ)

4B.3 Tab "รายชื่อผู้สมัคร" — สิ่งที่ Client Owner ทำได้

นี่คือ tab ที่ Client Owner ใช้บ่อยที่สุด เพราะรวมงาน ดูผู้สมัคร + อนุมัติสลิป + ปรับสถานะ

ปุ่มและฟีเจอร์ที่เห็น (ที่ user ไม่เห็น)

4B.4 Tab "ตารางแข่งขัน" — สิ่งที่ Client Owner ทำได้

ปุ่ม/ฟีเจอร์เพิ่มจาก user

4B.5 Tab "รอบแบ่งกลุ่ม" + "รอบน็อกเอาต์"

Tab "รอบแบ่งกลุ่ม"

Tab "รอบน็อกเอาต์"

4B.6 Tab อื่น ๆ — สิ่งที่ Client Owner ทำได้

Tab "กติกา"

Tab "รูปภาพ"

Tab "จำนวนลูกแบด"

Tab "ผลการแข่งขัน"

Client Owner ไม่ มีปุ่มแก้ผล (ปุ่มนี้สำหรับ Staff Admin/System Owner เท่านั้น) — เห็นผลแบบ read-only หลังจบรายการ

4B.7 ตารางสรุป — Client Owner ทำอะไรได้ ทำอะไรไม่ได้

✅ Client Owner ทำได้

4B.8 ❌ Client Owner ทำไม่ได้ (ต้องใช้ Staff Admin / System Owner)

4B.9 วงจรการทำงานทั่วไปของ Client Owner

ลำดับการใช้งานทั่วไปจากเปิดสมัคร → จบรายการ:

📌 ก่อนเปิดรับสมัคร

1. เข้าหน้ารายการ → กด "แก้ไขข้อมูล"
2. ตั้งวันแข่ง, สถานที่, อัปโหลดโปสเตอร์, ใส่ Google Map
3. เลือก event ที่เปิด (ชายคู่, หญิงคู่ ฯลฯ)
4. ตั้งค่า payment_mode + แสกน QR code + ค่าธรรมเนียม
5. เปิด/ปิด tab visibility ตามต้องการ
6. กลับมาที่หน้ารายการ → เปลี่ยนสถานะเป็น เปิดรับสมัคร

📌 ระหว่างเปิดรับสมัคร

1. ดูที่ Tab "รายชื่อผู้สมัคร" — เห็นใครสมัครมาบ้าง
2. กด "ตรวจสอบสลิป" — อนุมัติสลิปที่อัปโหลดมา
3. เพิ่มทีมที่แจ้งทางอื่น (LINE/โทร) ด้วยปุ่ม "เพิ่มทีละคน"

📌 ก่อนวันแข่ง

1. เปลี่ยนสถานะเป็น ปิดรับสมัคร
2. ไปที่ Tab "รอบแบ่งกลุ่ม" + "รอบน็อกเอาต์" → ตั้ง bracket
3. ไปที่ Tab "ตารางแข่งขัน" → กด "วางตารางแข่ง"
4. พิมพ์ scoresheet + ตารางคิว

📌 วันแข่ง

1. เปลี่ยนสถานะเป็น กำลังแข่งขัน
2. กดปุ่ม "ระบบบันทึกคะแนน" → เปิดหน้าป้อนคะแนนสด
3. ป้อนคะแนนแต่ละแมตช์ — ระบบ auto-advance ผู้ชนะ
4. ถ้ามีการเปลี่ยนสนาม/เวลา → ระบบส่ง LINE แจ้งผู้เล่นอัตโนมัติ

📌 หลังจบรายการ

1. เปลี่ยนสถานะเป็น แข่งขันเสร็จสิ้น
2. อัปโหลดรูปการแข่งที่ Tab "รูปภาพ"
3. ตรวจสอบจำนวนลูกที่ใช้ใน Tab "ลูกแบด"

4C.1 Contributor คือใคร?

Contributor = "ผู้ช่วยจัดการรายการ" ที่เจ้าของรายการมอบสิทธิ์ให้ — เน้นช่วย ป้อนคะแนน + ดูข้อมูลผู้สมัคร ในรายการนั้น โดยไม่ได้สิทธิ์เรื่องเงินและสถานะรายการ

ตัวอย่างผู้ใช้ Contributor

• 👨‍⚖️ กรรมการประจำสนามที่ช่วยป้อนคะแนนสด
• 📝 อาสาสมัครที่ช่วยจดทีมที่มาแจ้งหน้างาน
• 📷 ช่างภาพที่ช่วยอัปโหลดรูปการแข่ง

วิธีรู้ว่าคุณเป็น Contributor

เปิดหน้ารายการ — ถ้าเห็น แท็กสีม่วง:

4C.2 เมื่อเปิด "หน้ารายละเอียดรายการ" จะเห็นอะไร?

ส่วนที่เห็นเพิ่มจาก user ทั่วไป

⚠️ ส่วนที่ Contributor "ไม่เห็น" (ที่ Client Owner เห็น)

• ❌ ปุ่ม "แก้ไขข้อมูล" ที่มุมขวาบน (Contributor แก้ข้อมูลรายการไม่ได้)
• ❌ ปุ่ม "ตรวจสอบสลิปการชำระเงิน" (ไม่มีสิทธิ์อนุมัติสลิป)
• ❌ Dropdown เปลี่ยนสถานะการชำระเงิน ในตารางผู้สมัคร (เห็นเป็นข้อความเฉย ๆ)
• ❌ ปุ่ม Import / Export CSV

4C.3 Tab "รายชื่อผู้สมัคร" — มุมมอง Contributor

✅ Contributor เห็นและทำได้

❌ Contributor ทำไม่ได้

• ❌ เปลี่ยนสถานะการชำระเงิน (เห็นเป็นข้อความล้วน ไม่ใช่ dropdown)
• ❌ อนุมัติ/ปฏิเสธสลิป
• ❌ Import CSV จำนวนมาก
• ❌ Export ผู้สมัครเป็น CSV

4C.4 Tab "ตารางแข่งขัน" + "รอบแบ่งกลุ่ม" + "น็อกเอาต์"

Tab "ตารางแข่งขัน"

Tab "รอบแบ่งกลุ่ม"

Tab "รอบน็อกเอาต์"

Contributor เห็น bracket tree เต็มและสามารถ ป้อนคะแนนแต่ละแมตช์ได้ — แต่ "ตั้งค่าสายแข่ง" (Bracket Config) เป็นปุ่มของ Client Owner เท่านั้น

4C.5 Tab อื่น ๆ — มุมมอง Contributor

Tab "กติกา"

Tab "รูปภาพ"

Tab "จำนวนลูกแบด"

Tab "ผลการแข่งขัน"

Contributor ไม่ มีปุ่มแก้ผลย้อนหลัง (เป็นของ full admin เท่านั้น) — เห็นผลแบบ read-only หลังจบรายการ

4C.6 ตารางสรุป — Contributor ทำอะไรได้ ทำไม่ได้

✅ Contributor ทำได้

❌ Contributor ทำไม่ได้

4C.7 วงจรการทำงานของ Contributor ในวันแข่ง

Contributor มักทำงานช่วงวันแข่งเป็นหลัก — flow ทั่วไป:

📌 ก่อนวันแข่ง (1-2 วัน)

1. เข้าหน้ารายการที่ได้รับมอบหมาย → ตรวจ tab "ตารางแข่งขัน"
2. พิมพ์ scoresheet จากปุ่ม "พิมพ์ใบลงคะแนน" — แจกกรรมการแต่ละสนาม
3. ดู tab "รายชื่อผู้สมัคร" — ทำความคุ้นเคยกับชื่อทีม

📌 วันแข่ง — งานหน้างาน

1. มีทีมมาแจ้งสมัครหน้างาน → ใช้ปุ่ม "เพิ่มทีละคน" ใน tab "รายชื่อผู้สมัคร"
   • (แจ้งเจ้าของรายการให้ตั้งสถานะการชำระเงินให้ — Contributor ทำเองไม่ได้)
2. ระหว่างแข่ง — เปิด "ระบบบันทึกคะแนน":
   • เลือกคู่ที่กำลังแข่ง
   • กรอกคะแนน (รับได้ทั้ง "21 15 21 10" หรือ "21-15 21-10")
   • กดบันทึก → ระบบคำนวณตารางคะแนน + advance ผู้ชนะอัตโนมัติ
3. ถ้าต้องสลับคิวกระทันหัน → ใช้ "จัดการคิว" ใน tab ตารางแข่ง
4. ถ่ายรูปการแข่ง → อัปโหลดผ่าน tab "รูปภาพ"
5. นับลูกที่ใช้ → บันทึกใน tab "จำนวนลูกแบด"

📌 หลังจบรายการ

Contributor ไม่ต้องทำอะไรเพิ่ม — Client Owner / Staff Admin จะเป็นคนเปลี่ยนสถานะรายการเป็น แข่งขันเสร็จสิ้น

4C.8 ตารางเปรียบเทียบ 3 บทบาทในหน้ารายการ

5.1 ภาพรวม LINE Bot

Bot LINE Official Account ทำงานควบคู่กับเว็บ สื่อสารกับผู้เล่นผ่าน LINE ทุกขั้นตอน

ฟีเจอร์หลัก

เพิ่มเพื่อน

สแกน QR code ในหน้า profile.php หรือเสิร์ช @thaibadtournaments ใน LINE

5.2 คำสั่งทั้งหมด

การ Match แบบ Fuzzy

Bot รองรับการพิมพ์ที่ไม่เป๊ะ:

• แมตของฉัน = แมทของฉัน = my matches
• แมตที่เท่าไร = คิว = queue

5.3 Flow ผูกบัญชี (Account Linking)

User                Web                 LINE Bot           DB
 │                   │                     │                │
 │── เข้า profile ──>│                     │                │
 │                   │── สร้าง PIN ────────────────────────>│
 │                   │<── PIN "123456" ──────────────────── │
 │<── PIN + QR ──────│                     │                │
 │                                         │                │
 │── สแกน QR + Add Friend ────────────────>│                │
 │                                         │── ลงทะเบียน ───>│ (check PIN)
 │                                         │<── valid ──────│
 │<── "ผูกบัญชีสำเร็จ!" ─────────────────── │── update user ─>│
                                                            (line_uid)

ข้อกำหนด

• PIN อายุ 15 นาทีหลังสร้าง
• PIN ใช้ครั้งเดียว — ใช้แล้วจะ invalidate
• 1 LINE UID = ผูกได้ 1 user account เท่านั้น
• เปลี่ยน LINE: ต้อง unlink ก่อน → สร้าง PIN ใหม่ → ผูก LINE ใหม่

5.4 Reminder อัตโนมัติ

ระบบ cron_notify_matches.php รันทุก 2-5 นาที

Logic

1. หา tournaments ที่อยู่สถานะ กำลังแข่งขัน วันนี้
2. คำนวณ current_leading match_no + จำนวนสนาม N
3. ส่ง reminder 1 ชม.: match_no ใน range [current_leading, current_leading + 2N]
4. ส่ง reminder 30 นาที: match_no ใน range [current_leading, current_leading + N]
5. Mark flag notify_1h_sent, notify_30m_sent เพื่อไม่ส่งซ้ำ

ตัวอย่างข้อความ

🏸 แจ้งเตือนการแข่ง
รายการ: VENSON Kamphaengphet 2026
🎾 ทีม: สมชาย / สมศักดิ์
🆚 vs: สมหญิง / สมศรี
🏟 สนาม: 2
⏰ เวลา: 14:30 (อีก 30 นาที)
📍 คิวที่: 18

กรุณามาที่สนามก่อนเวลา 15 นาที

5.5 Morning Broadcast (สรุปวันแข่ง)

ส่งสรุปตารางของผู้เล่นแต่ละคนตอน 06:00 ของวันแข่ง — 1 ข้อความ/คน

ตัวอย่างข้อความ

🌅 สวัสดียามเช้า สมชาย!
วันนี้คุณมีแข่ง 3 แมตช์

📍 รายการ: VENSON Kamphaengphet 2026
1️⃣ 09:00 ⚡ สนาม 2 ⚡ คิว 5
   ชายคู่ U35 — vs สมหมาย/สมศักดิ์

2️⃣ 11:30 ⚡ สนาม 1 ⚡ คิว 12
   คู่ผสม — vs ทีมเหลือง

3️⃣ 14:00 ⚡ สนาม 3 ⚡ คิว 18
   ชายเดี่ยว — vs ทีมแดง

ขอให้โชคดี! 🍀

ส่งผ่าน Flex Message ของ LINE — UI สวยงาม คลิกแต่ละ match เพื่อเข้าหน้า match_detail ได้

6.1 ภาพรวมหน้าที่ของ System Owner

• 🔧 ตั้งค่าระบบ — SMTP, LINE, SlipOK, Gemini TTS, Google OAuth
• ⏰ ตั้ง Cron jobs — reminder, morning broadcast, cleanup
• 🗄️ จัดการ Migrations — เพิ่ม column, ตาราง, indexes
• 👀 Monitor — error log, visitor analytics, server health
• 🔐 Security — rotate secrets, manage 2FA enforcement

ไฟล์สำคัญที่ควรรู้

6.2 ตั้งค่า SMTP (Email)

ระบบใช้ PHPMailer ส่ง email สำหรับ: OTP, reset password, error alerts, broadcast

ตั้งค่าใน smtp_config.php

<?php
return [
  'host' => 'smtp.gmail.com',
  'port' => 587,
  'username' => '[email protected]',
  'password' => 'xxxx xxxx xxxx xxxx', // App password
  'encryption' => 'tls',
  'from_email' => '[email protected]',
  'from_name' => 'ThaibadTournaments',
];

ทดสอบ

เปิด test_error_monitor.php → จะส่ง test email ไป admin email

6.3 ตั้งค่า LINE Bot

อ่านเอกสาร: Line_Admin_Setup.md, Line_Noti.md, Line_User_Guide.md

ขั้นตอน

1. สร้าง LINE Official Account ที่ developers.line.biz
2. เปิด Messaging API
3. คัดลอก: Channel Access Token + Channel Secret
4. กรอกใน line_config.php:

   return [
     'channel_access_token' => 'xxxxx...',
     'channel_secret' => 'xxxxx...',
     'liff_id' => 'xxxxx-xxxxx',
   ];

5. ตั้ง Webhook URL: https://thaibadtournaments.com/badminton/line_webhook.php
6. เปิด "Use webhook" + ปิด "Auto-reply messages"
7. เพิ่มเพื่อนเอง → ทดสอบ "สถานะ"

LIFF (LINE Front-end Framework)

สำหรับ login ผ่าน LINE ในเว็บ — สร้าง LIFF app type=Full → URL ชี้ไปที่ auth_line.php

6.4 ตั้ง Cron Jobs

ระบบมี 2 cron jobs หลักที่ต้องตั้งใน server

1. Match Reminder (ทุก 2-5 นาที)

*/3 * * * * curl -s -H "X-Cron-Secret: YOUR_SECRET" \
  https://thaibadtournaments.com/badminton/cron_notify_matches.php \
  >> /var/log/thaibad_cron.log 2>&1

2. Morning Broadcast (06:00 ทุกวัน)

0 6 * * * curl -s -H "X-Cron-Secret: YOUR_SECRET" \
  "https://thaibadtournaments.com/badminton/admin_morning_broadcast.php?auto=1&date=TODAY"

3. Cleanup เก่า (รายสัปดาห์)

0 3 * * 0 php /path/to/cleanup_old_logs.php

6.5 ตั้งค่า SlipOK API

สำหรับการตรวจสลิปอัตโนมัติ

ขั้นตอน

1. สมัครที่ slipok.com → เลือกแพ็กเกจ
2. เพิ่มสาขา (Branch) → ได้ branch_id
3. สร้าง api_key
4. ตั้งบัญชีรับโอนของแต่ละ tournament ใน edit_match.php → ฟิลด์:
   • slipok_branch_id
   • slipok_api_key
   • payment_account_name — ต้องตรงกับใน SlipOK

API Call

lib/slipok.php ส่ง POST ไปยัง https://api.slipok.com/api/line/apikey/{branch_id} พร้อมรูปสลิป

Response Codes

• 1000 = ตรวจผ่าน
• 1002 = ยอดไม่ตรง
• 1003 = สลิปซ้ำ (duplicate)
• 1010 = ชื่อผู้รับไม่ตรง

6.6 ตั้งค่า Gemini TTS API

ขั้นตอน

1. ไปที่ ai.google.dev → สร้าง API Key
2. เก็บใน app_secret.php:

   'GEMINI_API_KEY' => 'AIzaSy...',

3. Default model: gemini-2.5-flash-preview-tts + voice Kore (Thai)

Quota

• Tier 1 (Free): 100 requests/day
• Tier 2 (Paid): 1000 requests/day

การจัดการ Cache

ระบบเก็บไฟล์เสียงใน /uploads/tts_cache/SHA256(text+voice).wav

• เสียงซ้ำ → ใช้ cache (ไม่เสีย quota)
• Cleanup เก่า — ตั้ง cron ลบไฟล์ที่ไม่ได้ใช้ใน 30 วัน
• Pre-cache ก่อนวันแข่ง: ใช้ admin_tts_cache.php → batch generate

6.7 Database Migrations

เมื่ออัปเดตระบบ — รัน migration scripts ใน root ของ project

17 Migration Scripts

6.8 ระบบ Real-time Co-work

อ่านเอกสาร Real_time_Co_work.md

Editing Presence

ตาราง editing_presence:

• เก็บ: user_id, tournament_id, field_name, started_at
• TTL: 5 วินาที (refresh เมื่อยังอยู่)
• ใช้ใน live scoring + admin_manage_order

API ที่เกี่ยวข้อง

• match_order_api.php — GET ดู order + presence, POST update + lock
• schedule_api.php — build_pairings, auto_schedule, save_schedule

Polling Strategy

Frontend poll ทุก 2 วินาที — ไม่ใช้ WebSocket (เพื่อง่ายในการ host บน shared hosting)

7.1 ภาพรวมและสถานะ

เป้าหมาย

ผู้เล่นต้องการดูรูปของตัวเองในรายการแข่ง — แทนที่จะต้อง scroll หารูปทั้งหมด ระบบจะให้ อัปโหลด selfie 1 รูป → AI หารูปที่มีใบหน้าใกล้เคียงให้ทั้งหมด

เทคโนโลยีที่จะใช้

7.2 UI Design (เลียนแบบจากโค้ดจริง)

หน้าจอที่ออกแบบไว้ตาม photo_search.php:

รูปที่ 7.2 — UI ปัจจุบัน (Backend ปิด) สร้างจากการอ่านโค้ด photo_search.php

7.3 Flow ที่วางไว้

ฝั่ง User

1. เข้าหน้า match_detail.php?id=N → tab "รูปภาพ"
2. กดปุ่ม "🔍 ค้นหารูปของฉัน" → ไป photo_search.php
3. กดกล่อง "อัปโหลดเซลฟี่"
4. เลือก/ถ่ายรูป selfie (camera permission)
5. กด "ค้นหา" → loading 3-10 วินาที
6. แสดงผลลัพธ์:
   • 🎯 รูปที่มีใบหน้าตรง (similarity > 0.65) — top match
   • 📷 รูปอื่นที่คล้าย (0.50 - 0.65)
   • ปุ่ม "ดาวน์โหลดทั้งหมด" (ZIP)

ฝั่ง Server

Browser              VM1 (PHP)              VM2 (Face API)         GPU
  │                     │                         │                  │
  ├── POST selfie ─────>│                         │                  │
  │                     ├── proxy w/ tournament ─>│                  │
  │                     │                         ├── detect face ──>│
  │                     │                         │<── embedding ────│ RTX 3060
  │                     │                         │   (512-d vector) │
  │                     │                         │                  │
  │                     │                         ├── compare with ─>│
  │                     │                         │   all photo emb. │
  │                     │                         │<── ranked list ──│
  │                     │<── JSON results ────────│                  │
  │<── HTML render ─────│                         │                  │

API Spec ที่วางไว้

POST http://192.168.1.102:5000/api/face/search
Content-Type: multipart/form-data

selfie: <file>
tournament_id: 3
threshold: 0.5

Response:
{
  "status": "ok",
  "matches": [
    {"photo_id": 142, "filename": "img001.jpg", "similarity": 0.87},
    {"photo_id": 156, "filename": "img089.jpg", "similarity": 0.74},
    ...
  ],
  "processing_time_ms": 2340
}

7.4 Setup ของ Proxmox (ที่กำลังจัดทำ)

อ่านเอกสารเต็มที่ Proxmox_Setup.md

Hardware

VM Layout

Setup สรุป VM2

1. ติดตั้ง Ubuntu 22.04 LTS
2. ติดตั้ง NVIDIA driver + CUDA 12
3. ติดตั้ง Python 3.10 + virtualenv
4. pip install insightface flask onnxruntime-gpu opencv-python
5. เขียน Flask API endpoint /api/face/search
6. เปิด firewall port 5000 (เฉพาะ LAN)
7. ทดสอบเรียกจาก VM1 → match กับรูปทดสอบ

7.5 ข้อพิจารณา Privacy + Performance

🔒 Privacy

• Selfie ถูกใช้แค่ทำ embedding — ไม่ถูกเก็บถาวร
• Embedding 512-dim vector ถูกเก็บใน DB ของ VM2 ต่อ photo (ไม่ใช่ต่อ user)
• ผลการ search ไม่ถูก log (ยกเว้น count สำหรับ rate-limit)
• ผู้เล่นต้องเซ็น Privacy consent ก่อนใช้ฟีเจอร์นี้ (อ้างอิง privacy_photo.php)

⚡ Performance Target

• Index photos ของ tournament ที่มี 500 รูป → ~30 วินาที (ทำครั้งเดียวตอน upload เสร็จ)
• Face search: 1 selfie vs 500 embeddings → <3 วินาที
• Throughput: 20+ requests/วินาที บน RTX 3060

🚦 Rate Limiting

• 20 searches/ชั่วโมง/user (ป้องกัน abuse)
• ป้องกัน "spider" ใช้ระบบสำหรับสแกนรูปคนอื่น

A.1 คำถามที่พบบ่อย (FAQ)

🔑 บัญชี + ลงทะเบียน

Q: ลืม username/email — ทำยังไง?
A: ติดต่อแอดมินผ่าน LINE Bot พิมพ์ "สถานะ" — ระบบจะตอบ UID และอีเมลที่ผูกไว้

Q: ผูก LINE ไม่ได้ — PIN expire — ทำใหม่ยังไง?
A: เข้าหน้าโปรไฟล์ → กด "สร้าง PIN ใหม่" → PIN ใหม่อายุ 15 นาที

Q: เปลี่ยนชื่อในระบบได้ไหม?
A: ได้ แต่ต้องผ่าน OTP email และต้องตรงกับบัตรประชาชน (ถ้า verified แล้ว)

🏆 การสมัครแข่ง

Q: สมัครแล้วยกเลิกได้ไหม?
A: ยกเลิกได้ตราบเท่าที่รายการยังเป็น เปิดรับสมัคร หากชำระเงินแล้ว — แอดมินจะคืนตามนโยบายแต่ละรายการ

Q: คู่ที่ชวนปฏิเสธ — ใบสมัครยังอยู่ไหม?
A: ใบสมัครจะเข้าสถานะ "รอคู่" — คุณเปลี่ยนคู่ได้ภายในเวลาที่กำหนด

Q: สมัครชื่อ guest (ไม่มีบัญชี) ได้ไหม?
A: ได้ — แต่ guest จะไม่ได้รับ LINE reminder อัตโนมัติ ต้องดูตารางในเว็บเอง

💰 ชำระเงิน

Q: SlipOK ตรวจสลิปไม่ผ่าน เพราะอะไร?
A: เหตุผลที่พบบ่อย: (1) ชื่อผู้รับโอนไม่ตรง (2) ยอดไม่ตรง (3) สลิปซ้ำ (4) สลิปอ่านไม่ออก (เบลอ/มืด)

Q: โอนเงินแล้วลืมอัปโหลดสลิป?
A: กลับเข้าหน้ารายการ → tab "รายชื่อผู้สมัคร" → หาแถวของคุณ → "อัปโหลดสลิป" — ยังทำได้จนกว่ารายการจะ ปิดรับสมัคร

A.1 FAQ (ต่อ)

📱 LINE Bot

Q: Bot ไม่ตอบกลับ — เพราะอะไร?
A: เช็ค 4 จุด: (1) เพิ่ม Bot เป็นเพื่อนแล้วยัง (2) ผูกบัญชีหรือยัง (3) คำสั่งถูกต้องไหม (4) Webhook ของระบบทำงานปกติไหม (System Owner ตรวจที่ admin_errors.php)

Q: ทำไมไม่ได้รับ reminder?
A: ตรวจ 3 อย่าง: (1) ผูก LINE แล้ว (2) เปิด notify_match_reminder ในตั้งค่า (3) ตอนแข่งรายการอยู่สถานะ กำลังแข่งขัน

🏟 วันแข่ง

Q: หาคิวตัวเองไม่เจอ — ทำยังไง?
A: 3 ทาง: (1) พิมพ์ "แมตที่เท่าไร" ใน LINE Bot (2) ดูที่ tab "ตารางแข่งขัน" ในหน้ารายการ (3) ฟัง TTS Court Call

Q: คะแนนผิด/ผลแข่งผิด — แก้ยังไง?
A: แจ้งแอดมิน — แอดมินมีสิทธิ์แก้คะแนนได้ตลอดเวลา (รวมถึงหลังจบรายการ)

📸 รูปภาพ

Q: Face Search ใช้ได้เมื่อไร?
A: รออัปเดต — กำลัง setup Proxmox VM2 + RTX 3060 ดู ส่วนที่ 7

Q: ลบรูปของฉันออกได้ไหม?
A: ติดต่อแอดมินของรายการ — มีสิทธิ์ลบเฉพาะคนนั้น

A.2 ตารางอ้างอิง 4 สถานะรายการแข่ง

✅ = ทำได้   ❌ = ทำไม่ได้   ⚠️ = ทำได้แต่มีเงื่อนไข

A.3 คีย์ลัด (Keyboard Shortcuts)

ทั่วไป

หน้าป้อนคะแนน (admin_live_match.php)

LINE Bot Commands (สรุป)

A.4 ปัญหาที่พบบ่อย + วิธีแก้

"บัญชีถูกล็อก"

ใส่ password ผิด 5 ครั้ง → ล็อก 15 นาที — รอครบเวลาแล้วลองใหม่ หรือใช้ "ลืมรหัสผ่าน" reset

"CSRF token mismatch"

session expired — refresh หน้า + login ใหม่

SlipOK "ชื่อผู้รับไม่ตรง"

ตรวจ payment_account_name ใน edit_match.php ให้ตรงกับชื่อบัญชีที่ระบุใน SlipOK dashboard

LINE Webhook ไม่ทำงาน

1. Console: developers.line.biz → ตรวจ webhook URL
2. กด "Verify" → ต้องได้ 200 OK
3. เช็ค admin_errors.php ดู error
4. เช็ค HMAC signature secret ใน line_config.php

TTS เสียงไม่ออก

1. เช็ค Gemini API quota ที่ ai.google.dev
2. ลอง fallback Google Translate TTS
3. เช็คสิทธิ์ folder /uploads/tts_cache/ ต้อง writable

Score ไม่ advance ไปรอบถัดไป

เช็ค bracket_config: ทีม seed ทุกที่ต้องมีค่า team1_cond / team2_cond ที่ map ได้ — ดูรายละเอียดใน admin_live_match_helpers.php

A.5 ติดต่อ Support

ก่อนแจ้งปัญหา กรุณาเตรียม

• 📸 Screenshot ที่เห็นปัญหา
• 🔗 URL ของหน้าที่เกิดปัญหา
• 🕐 เวลาที่เกิดเหตุ (แม่นยำ — ใช้หา log ได้)
• 📝 ขั้นตอนที่ทำก่อนเจอปัญหา
• 🌐 Browser + Device

📕 จบคู่มือ ThaibadTournaments.com v1.0
จัดทำ 15 พฤษภาคม 2569 จากการอ่านโค้ดและ Screenshot จริงทั้งระบบ