SinauGaes 🚀📚✨

Platform latihan soal gratis, dibuat 100% menggunakan GitHub Copilot AI 🤖!

SinauGaes adalah platform latihan soal gratis berbasis Laravel, Livewire, dan Flux UI. Pengguna dapat menjelajah soal yang sudah tersedia, membuat soal baru dengan AI melalui OpenRouter, mengerjakan soal satu per satu, lalu melihat hasil dan pembahasan secara langsung tanpa login.

---

✨ Fitur Utama

✅ Jelajah soal Matematika, Bahasa Indonesia, dan Bahasa Inggris 🤖 Pembuatan soal dengan AI dalam Bahasa Indonesia 🔀 Soal dan opsi jawaban diacak setiap kali sesi pengerjaan dimulai ⏱️ Durasi pengerjaan ramah pelajar: 30 menit, 60 menit, dan 90 menit 📊 Halaman hasil dengan pembahasan lengkap, tombol bagikan, dan form umpan balik 🌗 Dark mode dan light mode 🛡️ Validasi AI terstruktur dengan format JSON yang ketat 🚫 Proteksi spam: - Maksimal 3 pembuatan soal per IP per hari - Maksimal 1 feedback per hasil pengerjaan per IP

🛠️ Teknologi

• PHP 8.4
• Laravel 13
• Livewire 4
• Flux UI 2
• Tailwind CSS 4
• Vite 7
• MySQL
• OpenRouter API
• Pest 4

🖥️ Persiapan Server

Pastikan server produksi atau lokal memiliki:

• PHP 8.4+
• Composer 2+
• Node.js 20+
• npm 10+
• MySQL 8+
• Ekstensi PHP yang dibutuhkan Laravel: BCMath, Ctype, cURL, DOM, Fileinfo, JSON, Mbstring, OpenSSL, PDO, PDO MySQL, Tokenizer, XML

⚡ Instalasi

1. Clone repository.

git clone https://github.com/ariefng/sinaugaes.git
cd sinaugaes

2. Install dependency backend dan frontend.

composer install
npm install

3. Salin file environment.

copy .env.example .env

Jika memakai PowerShell bisa juga:

Copy-Item .env.example .env

4. Atur konfigurasi di file .env.

Karena aplikasi ini menggunakan OpenRouter sebagai driver AI, tambahkan konfigurasi berikut di .env:

OPENROUTER_API_KEY=your-openrouter-api-key
OPENROUTER_MODEL1="stepfun/step-3.5-flash:free"
OPENROUTER_MODEL2="openrouter/hunter-alpha"
OPENROUTER_MODEL3="nvidia/nemotron-3-nano-30b-a3b:free"
OPENROUTER_BASE_URL=https://openrouter.ai/api/v1
OPENROUTER_REFERER=your-website-url
OPENROUTER_TITLE=your-application-name

5. Generate application key.

php artisan key:generate

6. Jalankan migration.

php artisan migrate

7. Build asset frontend.

npm run build

🏠 Menjalankan di Lokal

Backend dan frontend bisa dijalankan dengan salah satu cara berikut.

Opsi Laravel Herd:

• Akses aplikasi melalui domain Herd yang aktif, misalnya https://sinaugaes.test.

Opsi development manual:

php artisan serve
npm run dev

🧪 Menjalankan Test

php artisan test --compact

🚀 Checklist Produksi

Sebelum deploy ke produksi, pastikan:

• APP_DEBUG=false
• APP_ENV=production
• APP_KEY sudah terisi
• Database MySQL tersedia dan migrasi sudah dijalankan
• OPENROUTER_API_KEY valid
• OPENROUTER_REFERER dan OPENROUTER_TITLE sesuai domain produksi
• Cache konfigurasi dan route sudah dibangun
• Asset frontend sudah dibuild

Command yang direkomendasikan:

php artisan config:cache
php artisan route:cache
php artisan view:cache
npm run build

🧭 Struktur Alur Pengguna

1. Pengguna membuka halaman daftar soal.
2. Pengguna bisa memilih soal yang sudah ada atau membuat soal baru dengan AI.
3. Saat mulai mengerjakan, urutan soal dan opsi jawaban akan diacak.
4. Setelah selesai, pengguna melihat skor, pembahasan, lalu dapat mengirim feedback.
5. Feedback dibatasi satu kali per hasil pengerjaan dari IP yang sama.

🔒 Catatan Keamanan dan Stabilitas

• Pembuatan soal dibatasi 3 kali per hari per IP.
• Feedback dibatasi 1 kali per hasil pengerjaan per IP.
• Payload AI divalidasi secara ketat sebelum disimpan.
• Share link tidak memerlukan data pribadi pengguna.
• Tidak ada autentikasi atau pembayaran di aplikasi ini.

⚡ Deploy Singkat

Urutan minimum deploy:

composer install --no-dev --optimize-autoloader
php artisan migrate --force
php artisan config:cache
php artisan route:cache
php artisan view:cache
npm install
npm run build

📄 Lisensi

Proyek ini mengikuti lisensi MIT sesuai basis Laravel yang digunakan.

---

_{SinauGaes dibuat 100% menggunakan GitHub Copilot AI 🤖.
Terima kasih Copilot!}