ninoaddict / Tubes2_FE_Pembalap-Kapas

🐈‍⬛ Wikipedia Race 🐈‍⬛

✨ Description

WikiRace atau Wiki Game adalah permainan yang melibatkan Wikipedia, sebuah ensiklopedia daring gratis yang dikelola oleh berbagai relawan di dunia, dimana pemain mulai pada suatu artikel Wikipedia dan harus menelusuri artikel-artikel lain pada Wikipedia (dengan menekan tautan di dalam setiap artikel) untuk menuju suatu artikel lain yang telah ditentukan sebelumnya dalam waktu yang paling singkat atau klik (artikel) yang paling sedikit.

Website yang dibuat pada tugas ini bertujuan untuk memberikan jarak terpendek dari suatu artikel ke artikel lain di wikipedia. Pengguna dapat memilih untuk mendapatkan solusi tunggal atau solusi banyak, baik dengan menggunakan algoritma BFS maupun IDS.

🔍 Table of Contents

- Description
- Table of Contents
- Tech Stack
- How To Run
- Usage
- Contributors

💻 Tech Stack

• Go
• Gin
• Typescript
• Tailwind CSS
• Next.js
• Docker
• Node.js
• sweetalert2

🏃 How To Run

Projek ini terdiri atas dua repository, yaitu repository frontend dan backend. Anda dapat memilih untuk menjalankan projek ini menggunakan docker atau secara lokal (tanpa docker). Untuk memulai menjalankan program ini, clone repository backend_ dan frontend

git clone https://github.com/ninoaddict/Tubes2_FE_Pembalap-Kapas
git clone https://github.com/Farhannr28/Tubes2_BE_Pembalap-Kapas

Dengan Docker

Untuk menjalankan projek ini dengan docker, pastikan docker desktop sudah terunduh pada perangkat Anda. Jika belum, Anda dapat mengunduhnya sesuai dengan perangkat Anda pada link berikut.

• Lakukan build terhadap program frontend

cd Tubes2_FE_Pembalap-Kapas/src
docker-compose build

• Jalankan program frontend

docker-compose up

• Buka terminal baru pada root folder dan jalankan build terhadap program backend

cd Tubes2_BE_Pembalap-Kapas/src
docker-compose build

• Jalankan program backend

docker-compose up

• Jika Anda ingin menghentikan program, lakukan hal berikut, baik pada program frontend maupun backend

docker-compose down

Tanpa Docker

Untuk menjalankan projek ini tanpa docker (secara lokal), Anda harus sudah meng-install Node.js, npm (atau yarn), dan bahasa Go pada perangkat Anda.

• Lakukan install terhadap semua dependencies pada program frontend Anda

cd Tubes2_FE_Pembalap-Kapas/src
npm install

• Jalankan program frontend

npm run dev

• Buka terminal baru pada root folder dan jalankan server backend Anda

cd Tubes2_BE_Pembalap-Kapas/src
go run ./api

Agar program dapat berjalan dengan baik, pastikan bahwa frontend berjalan pada localhost:3000 dan server backend berjalan pada localhost:8080. Selain itu, Anda dapat mengetes algoritma pada program ini menggunakan API endpoints yang tersedia dengan metode POST. Endpoint untuk algoritma BFS tersedia pada localhost:8080/bfs?solution={single|multi}, sedangkan endpoint untuk algoritma IDS tersedia pada localhost:8080/ids?solution={single|multi}. Adapun JSON body untuk melakukan fetch terhadap API endpoints tersebut memiliki format sebagai berikut

{
    "origin": originUrl,
    "target": targetUrl
}

📘 Usage

1. Masukkan judul dari halaman artikel wikipedia awal dan tujuan

   

2. Pilih algoritma dan banyak solusi yang diinginkan

   

3. Klik tombol search untuk melihat hasil

   

🤵 Contributors

Nama	NIM	Email	Github
Kristo Anugrah	13522024	[e-mail]	qrst0
Farhan Nafis Rayhan	13522037	[e-mail]	Farhannr28
Adril Putra Merin	13522068	[e-mail]	ninoaddict