📖 Panduan Pengelola Turnamen (Promotor, Panitia, & Operator)

Panduan ini disusun untuk memberikan petunjuk langkah-demi-langkah bagi promotor turnamen, panitia pelaksana lokal, dan operator skor lapangan dalam membeli lisensi turnamen, mengonfigurasi kategori kompetisi, hingga mengoperasikan papan skor digital secara profesional.


💼 Langkah 1: Pendaftaran Layanan SaaS & Pembayaran Lisensi

Untuk membuat turnamen berlisensi baru di platform turnamen.info, Anda wajib mengisi permohonan SaaS.

  1. Mengakses Form Pendaftaran:
    • Login ke dashboard admin turnamen.info.
    • Klik menu Buat Turnamen / Pengajuan SaaS pada sidebar kiri.
  2. Mengisi Formulir Pengajuan:
    • Nama Rencana Turnamen: Masukkan nama event resmi Anda (contoh: Bupati Cup Futsal Sulsel 2026).
    • Perkiraan Jumlah Tim: Input perkiraan jumlah tim tanding yang akan berpartisipasi (default: 16).
      • Ketentuan Tim Kustom (>64): Jika Anda menginput nilai di atas 64 tim (misal: 108 tim), sistem secara otomatis menonaktifkan Paket 16 dan Paket 32 Tim di bagian bawah, serta mengubah Paket 64 Tim menjadi Paket Kustom. Harga dasar akan otomatis dihitung secara proporsional berdasarkan tarif rata-rata per tim dari paket 64 tim ($Harga = \text{Perkiraan Tim} \times (\text{Harga Paket 64 Tim} / 64)$).
    • Lokasi Wilayah: Pilih dropdown Provinsi dan Kabupaten/Kota.
      • Kerjasama Wilayah (MoU): Jika Kabupaten/Kota terpilih memiliki MoU aktif, akan muncul notifikasi sukses "Kerjasama Wilayah Aktif!".
      • Surat Rekomendasi: Wajib klik Browse dan unggah Surat Rekomendasi/Permohonan dari DISPORA/KONI daerah setempat (berkas PDF/JPG/PNG) untuk klaim potongan harga regional.
    • Pilih Paket Cabor: Klik tombol Pilih Paket (tombol biru) pada card olahraga yang sesuai di bagian bawah.
  3. Checkout & Aktivasi:
    • Klik tombol Lanjutkan Pembayaran (tombol biru besar di bagian bawah).
    • Anda akan diarahkan ke halaman Invoice Checkout.
    • Input Voucher: Jika memiliki kupon promosi, ketikkan kode voucher pada kolom Kode Voucher dan klik tombol Terapkan (potongan harga terhitung secara AJAX).
    • Metode Pembayaran: Klik tombol Bayar Sekarang untuk simulasi/integrasi payment gateway, atau klik tautan Hubungi Asistensi untuk melakukan aktivasi manual via transfer bank ke Admin.
    • Setelah berstatus lunas (Paid), turnamen Anda akan otomatis dibuat di menu Manajemen Turnamen dengan status awal DRAFT.

⚙️ Langkah 2: Konfigurasi Turnamen & Aturan Kompetisi

Buka menu Manajemen Turnamen pada dashboard admin dan klik tombol Kelola di samping turnamen Anda.

  1. Pengaturan Skala & Keabsahan (Tab Pengaturan):
    • Level Turnamen: Pilih skala kompetisi (Kabupaten, Provinsi, Nasional, atau Internasional) untuk membatasi wilayah asal tim pendaftar.
    • Tie-Break System: Pilih preferensi penentuan peringkat klasemen grup jika ada poin sama (opsi: Selisih Gol atau Head-to-Head).
  2. Konfigurasi Kategori & Cabang Olahraga:
    • Klik menu Kategori Turnamen > Edit Kategori (contoh: Kategori Putra U-19).
    • Jika cabang olahraga berbasis set (Voli, Bulu Tangkis, Tenis Meja), sistem secara otomatis mendeteksi kolom tipe_skor cabor dan menyajikan konfigurasi set dinamis:
      • Max Set: Tentukan sistem Best of 3 atau Best of 5.
      • Poin Reguler: Poin kemenangan per set (misal: 25 poin untuk voli, 21 poin badminton).
      • Deciding Point: Batas poin pada set penentu (misal: 15 poin untuk voli set 3/5).
      • Status Deuce: Aktifkan/nonaktifkan sistem deuce beserta skor maksimal deuce (misal deuce sampai batas 30 poin).
  3. Kalender Turnamen Wilayah:
    • Buat jadwal pertandingan pada menu Jadwal Pertandingan > Tambah Jadwal.
    • Jadwal Anda otomatis disinkronkan ke Regional Sport Calendar wilayah untuk mencegah tumpang tindih jadwal antar turnamen lokal.

🔑 Langkah 3: Penugasan Operator Pertandingan (QR Code)

Panitia dapat menunjuk operator lapangan untuk mengisi skor pertandingan tanpa perlu memberikan password akun admin utama.

  1. Mendapatkan PIN & QR Code:
    • Masuk ke dashboard admin di menu Pertandingan > Jadwal Pertandingan.
    • Pada kolom aksi pertandingan yang ingin dioperasikan, klik tombol Aksi > Kelola Operator / Generate QR Code.
    • Halaman akan menampilkan kode PIN 6-digit dan sebuah QR Code dinamis yang memuat konfigurasi server dan otorisasi akses operator.
  2. Auto-Login Operator Lapangan:
    • Operator di lapangan membuka aplikasi mobile (tablet/smartphone Capacitor) atau mengakses halaman web login operator.
    • Klik tombol Scan QR Code / Masuk Cepat.
    • Arahkan kamera smartphone ke QR Code yang disediakan admin. Perangkat operator secara otomatis masuk ke halaman Live Console tanpa perlu mengetik PIN/URL server secara manual.

🎮 Langkah 4: Mengoperasikan Live Console Pertandingan

Live Console adalah pusat kendali operator skor pertandingan di lapangan (dapat diakses di rute /operator/live/[id_pertandingan]).

  1. Mengatur Lineup Pemain:
    • Sebelum pertandingan dimulai, klik tab Susunan Pemain / Lineup.
    • Tentukan pemain utama (Starter). Klik tombol STARTER ALL (tombol hijau) untuk memindahkan seluruh daftar cadangan menjadi pemain utama dalam satu klik (khusus cabor beregu).
    • Persistent Lineup: Susunan pemain aman dan tersimpan di database meskipun halaman browser tidak sengaja ter-refresh oleh operator.
  2. Mengoperasikan Waktu & Kejadian Babak:
    • Live Timer: Klik tombol Start untuk memulai jalannya babak, Pause untuk menjeda waktu timeout/cedera, dan tombol penyesuaian menit (Adjust Timer Up/Down) jika diperlukan.
      • Catatan: Untuk cabor set (Voli/Badminton), kontrol timer dan durasi otomatis disembunyikan oleh sistem.
    • Input Event Gol/Point: Klik tombol Input Skor / Gol (ikon bola) di samping nama tim, pilih pemain yang mencetak gol, menit kejadian, dan pilih tipe gol (Normal, Penalti, Bunuh Diri). Klik Simpan.
    • Input Pelanggaran (Foul): Klik tombol Tambah Foul (+Foul) pada sisi tim yang melanggar.
      • Reset Foul: Jika babak/periode pertandingan berganti, klik tombol Sapu Foul / Reset Foul (ikon sapu merah) untuk mengembalikan akumulasi foul tim menjadi nol.
    • Substitusi & Kartu: Klik tombol Substitusi Pemain atau Kartu (Kuning/Merah) di kolom pemain yang bersangkutan untuk mencatat kartu kuning/merah.
    • Sync Skor: Jika skor utama di bagian atas tidak cocok dengan jumlah entri log gol di timeline bawah, klik tombol Sync Skor (tombol kuning) untuk sinkronisasi otomatis.

📺 Langkah 5: Layar Display Videotron & Output Media

  1. Mengaktifkan Layar Videotron:
    • Masuk ke menu Pertandingan > Layar Display / Videotron.
    • Klik tombol Buka Display Videotron (atau gunakan monitor eksternal pada aplikasi desktop Electron).
    • Layar videotron akan menampilkan visual papan skor raksasa yang tersinkronisasi secara real-time via BroadcastChannel dengan Live Console operator.
    • Papan skor videotron dilengkapi kelas dinamis has-foul untuk mendeteksi status akumulasi foul. Jika foul aktif, ukuran font skor utama dan nama tim otomatis mengecil secara proporsional agar tidak menabrak batas bawah layar (section bottom).
  2. Mengunduh Match Card Medsos (Media Branding):
    • Masuk ke beranda Match Center publik, pilih pertandingan Anda pada tab Jadwal/Hasil.
    • Klik tombol Unduh Match Card (ikon download).
    • Pilih salah satu dari 3 template yang tersedia: Modern Square, Versus Battle, atau Minimalist.
    • Pilih warna teks (Light jika gambar latar belakang gelap, atau Dark jika gambar terang) untuk memastikan kontras yang baik.
    • Klik tombol Unduh JPG HD untuk menyimpan gambar 1080x1080 ber-watermark siap sebar.
  3. Mencetak Laporan PDF:
    • Masuk ke menu Laporan > Cetak Laporan Turnamen.
    • Pilih format laporan birokrasi, isi data kop surat resmi Dispora/KONI, dan klik tombol Cetak PDF (ikon printer). Laporan resmi siap diserahkan kepada pimpinan daerah.