เจ้าของรายการ / Staff Admin

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 — เพิ่ม/แก้ไขจังหวัดให้ตัวกรอง