สำหรับ System Owner

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)