🤖 RoboLogic Academy

RoboLogic Academy adalah platform edukasi interaktif berbasis web "Coding for Fun" yang dirancang khusus untuk anak-anak (SD/SMP) dan pemula.

Misi kami adalah menjembatani celah antara logika bermain game dengan logika pemrograman profesional. Aplikasi ini mengajarkan fondasi Computer Science dan Robotika dasar melalui simulasi robot penjelajah Mars ("Rover") yang menyenangkan.

---

📸 Galeri & Fitur Utama

Aplikasi ini menggunakan pendekatan bertahap: Mainkan, Pahami, Kreasikan.

1. Belajar Logika dengan Blok Visual

Untuk pemula absolut, anak-anak dapat menyusun logika menggunakan sistem Drag-and-Drop. Tidak perlu takut salah ketik (Syntax Error), fokus sepenuhnya pada alur logika algoritma.

2. Transisi ke Python (Mode Ketik)

Siap untuk tantangan lebih? Mode ini memperkenalkan sintaks Python secara real-time. Apa yang disusun di blok visual bisa dilihat kode aslinya, atau anak bisa mengetik langsung perintah seperti rover.move(3). Ini adalah pengenalan "Python for Fun" yang sempurna.

3. Kuis Interaktif & Wawasan

Setiap kali naik level atau menjumpai konsep baru (seperti Loop atau Function), sesi tanya jawab (Quiz Session) akan muncul. Ini memastikan anak tidak hanya menghafal pola, tapi benar-benar memahami konsep "Mengapa" di baliknya.

4. Level Builder (Sandbox)

Biarkan kreativitas anak berkembang! Di mode ini, mereka bisa merancang rintangan dan misi sendiri, lalu menantang teman atau diri sendiri untuk menyelesaikannya.

---

🗺️ Kurikulum & AI Generator

RoboLogic Academy menggabungkan kurikulum terstruktur dengan kecerdasan buatan:

1. 30 Level Fondasi (Handcrafted)

   • Level 1-30 didesain secara manual oleh instruktur untuk mengajarkan konsep secara bertahap.
   • Mulai dari gerakan dasar, belokan, pola berulang (Loop), hingga logika bersarang (Nested Loop) dan optimasi algoritma.
   • Tingkat kesulitan naik secara perlahan agar anak tidak merasa frustrasi.

2. Infinite Levels (Powered by Gemini AI)

   • Setelah lulus Level 30 ("Wisuda Akademi"), tantangan tidak berakhir!
   • Google Gemini AI akan men-generate level baru secara otomatis tanpa batas.
   • AI menyesuaikan tingkat kesulitan berdasarkan performa anak di level sebelumnya.

---

🛠️ Teknologi yang Digunakan

• Frontend: React 18, TypeScript, Vite
• Styling: Tailwind CSS
• AI Engine: Google Gemini API (@google/genai)
• Infrastructure: Docker & Nginx

---

🚀 Cara Instalasi (Menggunakan Docker)

Cara termudah untuk menjalankan aplikasi ini di komputer lokal adalah menggunakan Docker.

Prasyarat

• Install Docker Desktop.

Langkah Instalasi

1. Clone Repository

   git clone https://github.com/username-anda/robologic-academy.git
   cd robologic-academy

2. Setup API Key (Penting untuk Level 30+) Aplikasi ini membutuhkan API Key Google Gemini untuk fitur generate level setelah level 30.

   • Dapatkan key gratis di Google AI Studio.
   • Copy file contoh environment:

     cp .env.example .env

   • Masukkan key ke dalam file .env:

     GEMINI_API_KEY=masukkan_api_key_anda_disini

3. Jalankan Aplikasi

   docker-compose up -d --build

4. Mulai Bermain Buka browser dan akses: 👉 http://localhost:8080

---

📚 Panduan Bermain

1. Analisa Misi: Lihat posisi Robot (🤖), Target (🏁), dan Energi (⚡).
2. Rancang Algoritma: Pikirkan langkah apa yang paling efisien. Apakah ada pola yang berulang? Gunakan Loop.
3. Coding: Gunakan Blok atau ketik kode Python.
4. Debug: Jika robot menabrak, baca pesan error, perbaiki kodenya, dan coba lagi.
5. Menang: Ambil semua energi dan berhenti tepat di target.

---

🤝 Kontribusi

Proyek ini bersifat Open Source. Kami sangat menghargai kontribusi berupa perbaikan bug, ide level baru, atau materi edukasi tambahan.

License: MIT