Project Definition

[reacto11mecha]

Tujuan

Project ini adalah software yang dibuat untuk memenuhi kebutuhan ujian secara digital berbasis web dan aplikasi mobile.

Nama

鉛筆 | えんぴつ | enpitsu

enpitsu memiliki arti pensil, mengapa? Karena pensil adalah ATK yang digunakan untuk mengisi LJK (Lembar Jawaban Komputer) ketika ulangan tulis.

Keseluruhan Komponen

• Database: PostgreSQL
• Web untuk Admin dan Ulangan: Next.js
• Aplikasi Mobile (saat ini untuk android terlebih dahulu): Expo
• Caching: Redis

Breakdown

Web (bagian admin)

• Login menggunakan OAuth Google
• Dapat memiliki banyak admin (yaitu guru atau tim IT) dan mengelolanya #2
• Pengguna harus menunggu approval dari admin yang sudah ada untuk mendapatkan akses masuk #26
• Admin bisa mengelola keseluruhan soal, sedangkan guru hanya mengakses soal yang ia buat #27
• Admin dapat mengatur sudah bisa login ke aplikasi atau aksesnya ditutup #28
• Melakukan RBAC di tingkat trpc endpoint #30
• Dapat mengelola murid-murid yang menjadi peserta ujian #3
• Dapat mendownload data excel spesifik angkatan #33
• Web otomatis membuat token login #4
• Membuat soal dan tampilannya mirip gform #6
• Dapat membuat soal pilihan ganda dan esai #5
• Dapat menambahkan pertanyaan berbentuk audio #46
• Dapat ditetapkan waktu mulai dan selesai ujian #7
• Jawaban benar pilihan ganda langsung terkoreksi #8
• Jawaban esai yang berupa jawaban singkat yang langsung terkoreksi #9
• Jawaban esai yang berupa jawaban panjang bisa dikoreksi manual #10
• Support mengoreksi jawaban tanpa soal esai #36
• Dapat mengunduh hasil nilai secara agregat maupun spesifik mata pelajaran #21
• Dapat melakukan rekalkulasi ulang semua jawaban esai hanya pada spesifik soal #22
• Dapat mengubah status esai apakah wajib persis sama atau kesalahan dapat bersifat di toleransi #24
• Setiap soal dapat dibuat slug berdasarkan judul soal (bisa diubah) #11
• Dapat membuat QR Code tiap mata pelajaran #12
• Support input gambar dan notasi matematika juga konsistensi bahasa arab dan jepang (Implementasi react-quill) #13
• Menambahkan halaman untuk melihat data kecurangan per soal dari peserta #17
• Dapat export data semua kecurangan dalam bentuk excel (baik keseluruhan maupun spesifik soal) #64
• Menambahkan halaman untuk melihat data jawaban per soal dari peserta #18
• Dapat select banyak peserta jika admin ingin menghapus banyak jawaban peserta #63
• Automasi deploy web admin menggunakan docker #25
• Menambahkan provider chibisafe untuk file upload #48
• Dapat menambahkan peserta spesifik supaya tidak bisa mengerjakan soal apapun secara sementara #55
• Dapat mengatur cors origin dari environment variable #57
• Membuat halaman pengaturan khusus mngatur regex token peserta dan spesifikasi panjang token #100
• Mewajibkan penggunaan aplikasi mobile untuk pengerjaan soal #109

Web Ulangan

• Login dengan token #14
• Bisa scan barcode atau memasukkan kode soal secara manual #15
• Pekerjaan yang sudah ada akan disimpan secara lokal #16
• Bisa menyalakan koneksi internet dengan aman apabila internet tiba-tiba terputus #23
• Implementasi wake lock #32
• Mematikan fungsi copy paste #34

Mobile apps

• Implementasi hal yang sama seperti pada web ujian #19
• Menambahkan fitur input npsn untuk menentukan server #72
• Mencegah floating apps dan split screen #20

Alur Penggunaan

1. Admin login terlebih dahulu, jika belum ada admin yang ada di database maka admin yang login pertama kali otomatis menjadi admin yang bisa approve admin lain
2. Kemudian admin menambahkan data kelas (X, XI, XII) dan sub kelas (1, 2, ..., BAHASA) kemudian di ikuti dengan nama peserta setiap kelasnya. Di poin ini token akan dibuat secara otomatis.
3. Selanjutnya admin membuat soal pg dan/atau esai. Kode soal akan dibuat otomatis berdasarkan judul soal maupun bisa diganti secara manual.
4. Dari jauh hari, sekolah harus menghimbau murid-murid untuk menguji koneksi dan gladi bersih penggunaan aplikasi mobile. Di aplikasi mobile wajib memasukan token dan alamat server.
5. Pada hari ujian, murid bisa scan qr atau memasukkan kode soal yang tertera
6. Peserta bisa mengerjakan ujian dengan tenang, khidmat, dan jujur

Perbaikan

• (admin) Perbaiki fitur realtime input soal seperti google form supaya support optimistic update dan memindahkan query get ke masing-masing soal #35
• (admin) Perbaiki halaman koreksi soal yang error ketika terdapat soal yang tidak memiliki esai #37
• (web ulangan) menurunkan versi target output dari vite supaya bisa di buka di chrome versi yang lebih lama juga mematikan fitur translasi #39
• (admin) Memperbaiki paste supaya tidak memiliki format (memperbaiki support untuk dark mode dan bug) #40
• (admin) Membawa kembali fitur tempel gform yang otomatis menggunakan kolom yang tersedia #41
• (web ulangan) Paksa pengguna android harus menggunakan chrome dan harus versi terbaru #59
• (admin) Memperbaiki format excel yang hanya mengeluarkan data mentahan saja #68
• (admin) Memperbaiki performa dump reporting data nilai #70
• Upgrade keseluruhan dependency (react jangan ke v19 dulu) #82

Enhancement

• Menambahkan status kelayakan pengerjaan soal #83
• Upload excel untuk spesifik angkatan yang nama sheetnya memiliki korelasi dengan nama masing-masing kelas #79
• Menambahkan email auto approve untuk mendapatkan role otomatis sebagai administrator #80
• Fitur hapus seluruh data kecurangan peserta ujian yang tercatat pada sistem #84
• Memindahkan zod validator ke sub package khusus agar skema terpusat #101
• Upload satu file CSV untuk mengisi semua data angkatan #105
• Fitur duplikasi soal untuk memudahkan pemisahan peserta yang susulan #85

Temporary Fix (Update yang perlu di revert)

• Mengubah sistem input token jadi nomor peserta.... #73
• Revert input nomor peserta jadi token kembali #75