Project Structure

• app.py : Streamlit Dashboard Quiz Grader
• quiz-grader-R.ipynb : Notebook Quiz Grader (dokumentasi project)
• quiz_grader.py : Python Script penyimpanan function grade quiz Classroom
• credentials.json : File autentikasi Google untuk mengakses API
• token.json : File credentials yang telah diautentikasi menggunakan akun Product Team Algoritma (delete jika ingin menggunakan akun pribadi)
• requirements.txt : Library-library yang diperlukan untuk menjalankan aplikasi

How to Use: Quiz Grader

Streamlit Dashboard (sebagai Product Team Algoritma)

Preparation

Sebelum mengakses aplikasi, pastikan anda telah mempersiapkan hal-hal berikut:

• Download file CSV hasil quiz dari Algoritma Online

Grade Quiz

1. Buka link https://quiz-grader.streamlit.app/ untuk mengakses dashboard Quiz Grader
2. Pilih nama Course di Google Classroom dari quiz yang ingin dinilai
3. Pilih spesialisasi kelas, nama kelas, dan masukkan nama Sheet pada Score Academy (⚠️case-sensitive) dari quiz yang ingin dinilai
4. Upload CSV Algoritma Online yang telah didownload sebelumnya
5. Klik Grade Quiz untuk memulai proses penilaian, kemudian tunggu beberapa menit hingga proses selesai
6. Periksa Score Academy dan Google Classroom untuk memastikan penilaian sudah berhasil dilaksanakan

📝 Note :

• List Classroom yang tersedia untuk dipilih hanya kelas yang dapat diakses oleh Product Team Algoritma
• Jika ada student di Google Classroom tidak ada pada Score Academy, maka akan ditampilkan sebagai warning pada Dashboard

Run App Locally (sebagai akun Algoritma pribadi)

Sebelum mengakses aplikasi, pastikan anda telah mempersiapkan hal-hal berikut:

• Python dan Visual Studio Code

• Instalasi library yang diperlukan pada requirements.txt di virtual environment dengan menjalankan

  pip install -r requirements.txt
  

• File credentials.json tersedia pada directory untuk melakukan autentikasi akun pengguna

• Hapus file token.json sehingga anda dapat menggunakan dashboard menggunakan akun Algoritma pribadi

Grade Quiz (Streamlit Dashboard Local)

1. Buka Visual Studio Code dan pastikan virtual environment yang digunakan telah sesuai (pada bagian pojok kanan bawah)
   

2. Pilih menu Terminal di bagian kiri atas dan pilih New Terminal
   

3. Buka Dashboard Streamlit dengan menjalankan code berikut:
   

   streamlit run app.py
   

4. Pilih nama Course di Google Classroom dari quiz yang ingin dinilai

5. Pilih spesialisasi kelas, nama kelas, dan masukkan nama Sheet pada Score Academy (⚠️case-sensitive) dari quiz yang ingin dinilai

6. Upload CSV Algoritma Online yang telah didownload sebelumnya

7. Klik Grade Quiz untuk memulai proses penilaian, kemudian tunggu beberapa menit hingga proses selesai

8. Periksa Score Academy dan Google Classroom untuk memastikan penilaian sudah berhasil dilaksanakan

Grade Quiz (Jupyter Notebook)

1. Buka file quiz-grader.ipynb pada IDE anda
2. Pastikan link spreadsheet yang tersimpan pada SCORE_ACADEMY_LINK dan range sheet yang tersimpan pada GRADE_RANGE sudah sesuai
3. Lakukan Run All
4. Browser akan terbuka untuk melakukan autentikasi pada akun Google anda, gunakan email algorit.ma, dan kemudian klik Allow
5. Jika proses autentikasi berhasil, maka akan muncul "The authentication flow has completed. You may close this window.", dan silahkan kembali ke IDE
6. File token.json telah terbentuk untuk memberikan akses untuk penggunaan selanjutnya (sehingga tidak perlu melakukan autentikasi kembali)
7. Pastikan nilai yang diakses sudah tepat dengan memeriksa dataframe pada section Score Academy
8. Input nama course yang diinginkan untuk pembuatan post (case-insensitive, contoh : wizard data visualization)
9. Input code quiz yang diinginkan untuk dilakukan penilaian (case-insensitive, contoh : p4ds), berikut list code quiz yang tersedia:
   • P4DS : 1. Q: Programming for Data Science (P4DS) & Practical Statistic (PS)
   • DV : 2. Q: Data Visualization (DV)
   • IP : 3. Q: Interactive Plotting (IP)
10. Nama, nilai, dan status hasil penilaian akan ditampilkan pada dataframe di section Draft Grade. Jika e-mail/nilai student tidak ditemukan, maka akan muncul warning
11. Konfirmasi hasil grade draft yang telah dilakukan di Google Classroom, pastikan nilai-nilai sudah sesuai. Jika sudah sesuai, ketik y kemudian enter
12. Jika penilaian quiz telah berhasil, maka akan menampilkan "Quiz grades was successfully returned"
13. Quiz telah berhasil dinilai secara otomatis, silahkan periksa pada Google Classroom

Pembuatan File credentials.json

Jika file credentials.json hilang/tidak bisa digunakan untuk melakukan autentikasi, anda dapat membuat file credentials baru. Secara keseluruhan, guide pembuatan file tersebut telah disediakan oleh Google pada Classroom Quickstart. Berikut step-step yang perlu dilaksanakan:

1. Membuat Google Cloud Project dengan melakanakan step-step dari Create a Google Cloud project
2. Mengaktivasi API Google Classroom sesuai dengan guide pada section Enable the API
3. Konfigurasi OAuth consent screen sesuai dengan guide pada section Configure the OAuth consent screen
4. Berikan nama Algoritma untuk mengisi App Name OAuth consent screen
5. Melakukan pembuatan file credential sesuai dengan guide pada section Authorize credentials for a desktop application
6. Rename file credential yang telah didownload menjadi credentials.json dan letakkan pada directory notebook