# Q-badminton

> ระบบจัดการก๊วนแบดมินตันสำหรับเช็กอิน จัดคิว คุมคอร์ด และดูคิวสดผ่านเว็บ จัดการครบตั้งแต่เปิดรอบก๊วนจนสรุปค่าใช้จ่าย

Q-badminton ออกแบบมาเพื่อลดภาระของคนจัดก๊วน (Court Admin) และยกระดับประสบการณ์ของผู้เล่นในก๊วนแบดมินตันในประเทศไทย ใช้งานผ่านเว็บเบราว์เซอร์ได้ทันทีโดยที่ผู้เล่นไม่ต้องติดตั้งแอปพลิเคชันและไม่ต้องสมัครสมาชิก

## Core Pages
- [หน้าแรก Q-badminton](https://www.q-badminton.com/): ภาพรวมระบบ ฟีเจอร์นำเข้ารายชื่อจาก LINE จัดคิวอัตโนมัติ คุมคอร์ดสด และคำนวณเงิน
- [ค้นหาก๊วนที่กำลังเปิด](https://www.q-badminton.com/clubs): ค้นหาก๊วนแบดมินตันที่กำลังเปิดรอบก๊วนและเข้าสู่กระดานคิวสด

## Key Features
- **นำเข้ารายชื่อจาก LINE ในคลิกเดียว**: คัดลอกรายชื่อคนลงชื่อจากกลุ่ม LINE มาวาง ระบบตรวจจับและตัดข้อความส่วนเกินให้อัตโนมัติ
- **จัดคิวอัตโนมัติและจัดคิวเอง**: เกลี่ยจำนวนเกมให้ทุกคนอย่างเท่าเทียม ป้องกันการนั่งรอนาน รองรับการล็อกคู่และจัดตามระดับมือ
- **กระดานคิวสด (Live Viewer)**: ส่งลิงก์เดียวให้ผู้เล่นเปิดดูคอร์ดที่กำลังแข่งและคิวถัดไปผ่านมือถือได้แบบเรียลไทม์
- **สรุปยอดเงินและหารค่าใช้จ่าย**: คำนวณค่าคอร์ดและค่าลูกแบดตามจำนวนคนที่เช็กอินจริงอย่างแม่นยำระดับสตางค์ (ระบบไม่รับเงินแทน)
- **สถิติแต้มและ Daily Ranking**: บันทึกแต้มแข่งขันและจัดอันดับมาสคอตน่ารักประจำวันโดยไม่บังคับ

## Domain Terms
- **Club (ก๊วน)**: กลุ่มก๊วนแบดมินตันหรือผู้เช่าคอร์ดประจำ
- **Session (รอบก๊วน)**: ช่วงเวลาการเล่นในแต่ละวัน (ภาษาไทยใช้คำว่า "รอบก๊วน")
- **Court (คอร์ด)**: สนามแบดมินตันที่เปิดใช้งานในแต่ละรอบก๊วน
- **Live Viewer**: หน้าแสดงผลคิวสดสำหรับผู้เล่น (/{slug}) เป็นแบบอ่านได้อย่างเดียว (Read-only)

## Privacy & Financial Guardrails
- **ความปลอดภัยของข้อมูลผู้เล่น**: หน้ากระดานคิวสดสาธารณะไม่เปิดเผยอีเมล, UUID, บันทึกเวลาเช็กอิน, หรือหมายเหตุส่วนตัว
- **ความปลอดภัยทางการเงิน**: ระบบบันทึกเฉพาะสถานะ Paid/Unpaid ด้วยตนเองโดยแอดมิน ไม่มีการรับชำระเงินแทน ไม่มีการอัปโหลดสลิป และไม่เปิดเผยข้อมูลการเงินในหน้าสาธารณะ

## Optional
- [ข้อกำหนดการให้บริการ](https://www.q-badminton.com/terms): เงื่อนไขและข้อกำหนดในการใช้งานระบบ
- [นโยบายความเป็นส่วนตัว](https://www.q-badminton.com/privacy): ข้อมูลการคุ้มครองข้อมูลส่วนบุคคลตามมาตรฐานความปลอดภัย
- [ข้อมูลผู้ให้บริการ](https://www.q-badminton.com/legal): ข้อมูลทางกฎหมายและนิติบุคคล
- [นโยบายคุกกี้](https://www.q-badminton.com/cookies): ข้อมูลการใช้งานคุกกี้เพื่อความปลอดภัยและการทำงานของระบบ
- [เอกสาร LLM ฉบับเต็ม](https://www.q-badminton.com/llms-full.txt): รายละเอียดขั้นตอนการทำงานและคู่มือฉบับสมบูรณ์สำหรับ AI