Skip to content

Good-Father/CourtIQ

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CourtIQ — Self-Rating Tenis NTRP

Cek IQ Lapanganmu dalam 10 menit. 50 pertanyaan jujur untuk mengukur level NTRP-mu, dilengkapi Reality Check berdasarkan margin kemenangan dan bukti sejarah kompetisi.

CourtIQ adalah website static (HTML/CSS/JS murni — tanpa backend) yang dapat di-host gratis di GitHub Pages. Cocok untuk pemain tenis rekreasi, klub, akademi, dan pelatih yang ingin mengevaluasi level pemain secara terstruktur.


✨ Fitur

  • 📋 50 pertanyaan terstruktur dalam 6 bagian (Kompetisi, Mental, Taktik, Groundstroke, Servis, Net & Voli)
  • Reality Check otomatis — rating teknik Anda akan dipotong jika kontradiksi dengan hasil pertandingan riil (Aturan 0.5 Poin & Bukti Sejarah)
  • 📊 Radar chart breakdown per bagian — lihat di mana kekuatan & kelemahan Anda
  • 📄 Export hasil ke PDF — 1 klik, langsung simpan
  • 💾 Auto-save ke browser — progress tersimpan di localStorage, bebas tutup-buka tab
  • 🇮🇩 Bahasa Indonesia penuh dengan glosarium istilah tenis
  • 📱 Responsive — jalan mulus di HP, tablet, desktop
  • 🌐 Tanpa server — privacy 100% (data tidak dikirim ke mana pun)

📂 Struktur Folder

courtiq/
├── index.html       # Halaman utama (single-page app dengan 4 layar)
├── style.css        # Styling modern sporty (hijau lapangan + kuning bola)
├── script.js        # Logika kuesioner + Reality Check + chart + PDF
├── README.md        # File ini
└── LICENSE          # MIT License

🚀 Cara Cepat: Jalankan di Komputer (Tanpa GitHub)

  1. Download semua file di folder courtiq/
  2. Klik 2x file index.html — akan terbuka di browser
  3. Selesai! Aplikasi langsung jalan tanpa perlu install apa pun

🌐 Cara Upload ke GitHub Pages (Untuk User Baru)

Ini adalah panduan step-by-step lengkap bagi Anda yang belum pernah pakai GitHub. Hasil akhirnya: website CourtIQ Anda akan online dengan URL https://username-anda.github.io/courtiq/ — gratis, selamanya.

Langkah 1 — Buat Akun GitHub

  1. Buka https://github.com
  2. Klik tombol Sign up (kanan atas)
  3. Daftar pakai email — pilih username yang mudah diingat (akan jadi bagian URL website Anda)
  4. Verifikasi email

Langkah 2 — Buat Repository Baru

  1. Setelah login, klik tombol + di pojok kanan atas → New repository
  2. Isi form:
    • Repository name: courtiq (huruf kecil semua)
    • Description: Self-rating tenis NTRP dengan Reality Check (opsional)
    • Pilih Public ✅ (wajib agar GitHub Pages gratis)
    • Centang "Add a README file" (boleh kosongkan, akan kita timpa)
  3. Klik Create repository

Langkah 3 — Upload File via Web (Paling Mudah)

  1. Di halaman repository yang baru dibuat, klik tombol Add fileUpload files
  2. Drag & drop keempat file ini dari komputer Anda:
    • index.html
    • style.css
    • script.js
    • README.md
  3. Scroll ke bawah, di bagian Commit changes:
    • Commit message: Initial upload CourtIQ
  4. Klik Commit changes

Langkah 4 — Aktifkan GitHub Pages

  1. Di halaman repository Anda, klik tab Settings (paling kanan, ikon roda gigi)
  2. Di sidebar kiri, scroll ke bawah, klik Pages
  3. Di bagian Build and deploymentSource, pilih: Deploy from a branch
  4. Di Branch, pilih: main dan folder / (root)
  5. Klik Save

Langkah 5 — Tunggu 1–2 Menit, Lalu Buka URL

  1. Refresh halaman Settings → Pages
  2. Akan muncul box hijau: Your site is live at https://username-anda.github.io/courtiq/
  3. Klik link itu — selamat, website CourtIQ Anda sudah online!

Catatan: Pertama kali deploy bisa butuh 1–5 menit. Jika belum keluar, refresh halaman setelah beberapa menit.


🔄 Cara Update Website Anda Nanti

Kalau mau ubah isi (misal ganti warna atau tambah pertanyaan):

  1. Edit file di komputer Anda
  2. Buka halaman repository GitHub Anda
  3. Klik file yang mau di-update → tombol pensil ✏️ (edit) atau Add file → Upload files
  4. Commit perubahan
  5. Tunggu 1–2 menit — website auto-update

🧮 Cara Kerja Algoritma Rating

CourtIQ menggunakan algoritma 3 langkah:

Langkah 1 — Rata-rata Teknik

Technical Average = (Total nilai Q6 sampai Q50) ÷ 45

Hanya menghitung 45 pertanyaan teknis & mental (Bagian 2–6). Bagian 1 (kompetisi) tidak dihitung di sini — perannya untuk Reality Check.

Langkah 2 — Reality Check (4 Aturan)

Aturan Kondisi Hasil
A — Cap karena kalah telak Q2 ≤ 2.0 (kalah telak vs 3.5) AND Avg ≥ 3.5 Rating final maksimum 3.0
B — Konfirmasi sejarah Q1 ≥ 4.0 (varsity/universitas/pro) AND Avg ≥ 3.5 Rating valid apa adanya
C — Cap tanpa sejarah Q1 ≤ 2.0 (tanpa kompetisi formal) AND Avg > 4.5 Rating final maksimum 4.5
D — Cap karena hancur vs 4.0 Q3 ≤ 1.5 AND Avg ≥ 4.0 Rating final maksimum 3.5

Langkah 3 — Pembulatan & Klasifikasi

Hasil dibulatkan ke kelipatan 0.5 terdekat, lalu dikonversi ke tier:

  • 1.5 – 2.5 → Pemula – Menengah Bawah
  • 3.0 – 3.5 → Menengah USTA Rata-rata
  • 4.0 – 4.5 → Mahir / Varsity / Top Klub
  • 5.0 – 7.0 → Eks-Atlet / Elit Nasional

🎨 Customisasi

Mau ganti warna, judul, atau pertanyaan? Mudah:

Mau ubah... Edit file... Cari...
Warna utama style.css --green-700, --yellow di bagian :root
Nama aplikasi index.html "CourtIQ"
Pertanyaan script.js Array SECTIONS di atas file
Tier label script.js Array TIERS
Aturan Reality Check script.js Function calculateRating()
Rekomendasi script.js Object recMap di renderRecommendations

🛠 Stack Teknologi

  • HTML5 semantic + meta tags responsive
  • CSS3 dengan custom properties (variables) untuk theming
  • Vanilla JavaScript (ES6+) — tidak ada framework
  • Chart.js 4.4 (via CDN) untuk radar chart
  • html2pdf.js 0.10 (via CDN) untuk export PDF
  • Inter font (Google Fonts)

Semua dependency di-load dari CDN — tidak ada npm install yang perlu dijalankan.


❓ FAQ

Q: Apakah hasil bersifat resmi USTA? A: Tidak. CourtIQ adalah alat self-assessment edukatif. Untuk rating resmi, ikut liga USTA atau dirate oleh verifier resmi.

Q: Apakah data saya dikirim ke server? A: Tidak. Semua disimpan di browser Anda (localStorage). Tidak ada server.

Q: Bisa pakai di HP? A: Bisa. Sudah responsive dan tested di iOS Safari + Android Chrome.

Q: Bagaimana kalau saya lupa jawab pertanyaan? A: Sistem akan beri default 4.0 untuk pertanyaan kosong, tapi disarankan isi semua untuk hasil akurat.

Q: Bisakah saya pakai untuk klub/akademi tenis saya? A: Bisa, gratis. Lisensi MIT — boleh dipakai komersial, asal kredit tetap dipertahankan.


📝 Lisensi

MIT License — bebas dipakai, dimodifikasi, dan didistribusikan, asal kredit asli dipertahankan.


🙏 Kredit & Disclaimer

  • Kuesioner & metodologi terinspirasi dari NTRP guideline USTA dan sistem UTR.
  • CourtIQ bukan afiliasi resmi USTA atau UTR.
  • Dibuat dengan ☕ dan 🎾 — semoga bermanfaat untuk komunitas tenis Indonesia.

Selamat bermain dan semoga rating Anda terus naik! 🎾

About

Web

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors