Binar Academy Bootcamp - FSW - Chapter 8 - Challenge

Ini adalah repository RESTful API yang menjadi basis untuk teman-teman berkreasi di challenge chapter 8. Ikuti petunjuk di bawah dengan seksama untuk memastikan teman-teman dapat menjalankan RESTful API.

Prasyarat

Sebelum memulai menyentuh repository, pastikan komputer teman-teman memenuhi prasyarat berikut:

• sudah install Node.js & NPM
• sudah install PostgreSQL
• sudah install git

Project setup

1. Fork repository ini. Ada tombol 'fork' di kanan atas atau klik https://github.com/berbinarbinar/c8-challenge. Nanti akan muncul repository yang sama persis di akun teman-teman.
2. Clone repository teman-teman yang sudah di fork

$ git clone https://gitlab.com/[username_kalian]/binar-challenge-chapter-8.git

atau

$ git clone git@gitlab.com:username_kalian/binar-challenge-chapter-8.git

3. Pindah ke folder repository

$ cd binar-challenge-chapter-8

3. Install dependencies

$ npm install

Run

Untuk menjalankan aplikasi RESTful API, cukup jalankan perintah berikut

$ node app.js

Tasks

Jika teman-teman sudah berhasil menjalankan aplikasi RESTful API dari repository ini, teman-teman perlu melakukan dua hal:

1. Membuat dokumentasi API dengan Swagger
   • Baca code repository RESTful API ini baik-baik
   • Buat dokumentasi untuk semua endpoint yang terdaftar di router
   • Dokumentasi melingkupi :
     • HTTP method
     • URL
     • URL parameter (jika ada)
     • Query parameter (jika ada)
     • Request body (jika ada)
     • format response
   • Pasang dokumentasi Swagger dalam satu routing
2. Membuat client-side application dengan React.js
   • Buat folder baru, misalkan /client, kemudian buat project baru dalam folder tersebut dengan $ npm init -y atau $ create-react-app challenge-8
   • Buat tampilan/UI untuk fitur berikut :
     • Form untuk membuat player baru, dengan tombol Submit
     • Form untuk mengedit player, dengan tombol Submit
     • Form untuk pencarian player berdasarkan 4 kriteria pencarian : username, email, experience, dan lvl. jangan lupa juga tombol submit.
   • Kita belum belajar mengintegrasikan back-end dan front-end. Jadi untuk challenge ini, ketika di klik tombol submit tampilkan semua input sebagai satu elemen HTML baru
     • Untuk form membuat atau edit player, tampilkan info username, email, dll setelah di klik submit.
     • Untuk form mencari player, tampilkan ulang input kriteria username, email, experience, dan lvl.
   • Jalankan sebagai aplikasi client-side

Caveats / Batasan

• Tugas nomor 1 dan 2 dibuat dalam repository yang sama dengan repository RESTful API. Dengan kata lain, teman-teman bertugas mengembangkan repository RESTful API ini menjadi repository full-stack (RESTful API + client-side + documentation)
• Code existing yang ada dalam folder /app tidak boleh diubah/dihapus, kecuali bagian config db. Yang diperbolehkan hanya penambahan line untuk memenuhi challenge.
• Jika teman-teman menemukan error/bug dalam code, silakan buat issue di repository ini atau sampaikan ke tim Binar Academy
• Pastikan folder node_modules masuk dalam .gitignore, baik untuk RESTful API maupun client-side.
• Nantinya, aplikasi RESTful API dan client-side akan berjalan sebagai 2 aplikasi berbeda. Pastikan keduanya bisa berjalan berbarengan tanpa ada issue.

Petunjuk Submission

• Challenge di submit paling lambat hari Senin di minggu ketiga chapter 8, pukul 23:59 WIB.
• metode submission: kirim email ke mentor dan bagian akademik Binar, berisi link repository teman-teman (yang di fork) di Gitlab.