Ringkasan eksekutif
FullStackJS Express + React adalah project full-stack JavaScript untuk pemula: REST API dengan Express, Prisma, dan MySQL, serta aplikasi React (single-page) untuk registrasi, login dengan JWT, dan mengelola user lewat area admin yang terproteksi.
Repositori ini juga berisi FundamentalES6, kumpulan latihan kecil JavaScript modern yang menjadi dasar project ini.
Fitur
Registrasi & login
Daftar dengan nama, e-mail, dan password; login untuk mendapatkan JWT yang disimpan di cookie.
Route terproteksi
Halaman admin mengarahkan ke login jika tidak ada token; API menolak request tanpa token yang valid.
Kelola user (CRUD)
Lihat, tambah, ubah, dan hapus user dari area admin.
Validasi di server
express-validator mengecek field wajib, format e-mail, e-mail unik, dan panjang password.
Hash password
Password di-hash dengan bcrypt sebelum disimpan.
Demo live
Aplikasi React asli berjalan di GitHub Pages dengan backend yang disimulasikan di browser.
Arsitektur
| Lapisan | Teknologi | Folder |
|---|---|---|
| Frontend | React 18, Vite 5, react-router-dom 6, axios, js-cookie, Bootstrap 5 | frontend-react/ |
| Backend | Express 4, express-validator, bcryptjs, jsonwebtoken, cors, body-parser | backend-express/ |
| Database | MySQL + Prisma ORM | backend-express/prisma/ |
| Latihan | JavaScript ES6+ (Node.js) | FundamentalES6/ |
Referensi API
Base URL http://localhost:3000. Endpoint terproteksi membutuhkan JWT di header Authorization (token langsung, tanpa “Bearer”).
| Method | Endpoint | Auth | Body | Sukses |
|---|---|---|---|---|
| POST | /api/register | — | name, email, password | 201 Register successfully |
| POST | /api/login | — | email, password | 200 { user, token } |
| GET | /api/admin/users | JWT | — | 200 daftar user (terbaru dulu) |
| POST | /api/admin/users | JWT | name, email, password | 201 User created successfully |
| GET | /api/admin/users/:id | JWT | — | 200 { id, name, email } |
| PUT | /api/admin/users/:id | JWT | name, email, password | 200 User updated successfully |
| DELETE | /api/admin/users/:id | JWT | — | 200 User deleted successfully |
Respons error
| HTTP | Kapan | Body |
|---|---|---|
| 422 | Validasi gagal | { success: false, message: "Validation error", errors: [{ path, msg, ... }] } |
| 401 | Tanpa token / token tidak valid atau kedaluwarsa / password salah | Unauthenticated. · Invalid token · Invalid password |
| 404 | Login dengan e-mail yang tidak terdaftar | User not found |
| 500 | Error database (mis. mengubah atau menghapus id yang tidak ada) | Internal server error |
Contoh
curl -X POST http://localhost:3000/api/login \
-H "Content-Type: application/json" \
-d '{"email": "admin@demo.com", "password": "password"}'
# use the token from the response
curl http://localhost:3000/api/admin/users -H "Authorization: <token>"Model data & validasi
| Field | Tipe | Aturan |
|---|---|---|
id | Int, auto increment | Primary key |
name | VarChar(255) | Wajib |
email | VarChar(255), unique | Wajib, format valid, belum dipakai user lain |
password | VarChar(255) | Minimal 6 karakter, disimpan sebagai hash bcrypt |
createdAt · updatedAt | DateTime | Diisi otomatis |
Halaman frontend
| Route | Halaman | Akses |
|---|---|---|
/ | Home | Publik |
/register | Register | Tamu (yang sudah login diarahkan ke dashboard) |
/login | Login | Tamu |
/admin/dashboard | Dashboard | Sudah login |
/admin/users | Daftar user | Sudah login |
/admin/users/create | Tambah user | Sudah login |
/admin/users/edit/:id | Ubah user | Sudah login |
AuthContext menyelaraskan isAuthenticated dengan cookie token; tombol Logout di sidebar menghapus cookie dan kembali ke halaman login.
Demo live
GitHub Pages hanya bisa menyajikan file statis, sehingga server Express dan MySQL tidak bisa berjalan di sana. Karena itu build demo mengganti adapter jaringan axios dengan services/mockApi.js.
- Kode React sama dengan saat pengembangan lokal — hanya jalur pengirimannya yang berubah.
- mockApi.js meniru setiap controller dan validator: route, status code, pesan, dan format error express-validator yang sama.
- Data disimpan di browser pengunjung (localStorage). Reset data di banner demo mengembalikan user contoh.
- Login demo:
admin@demo.com/password. - Di-build dan di-deploy otomatis oleh GitHub Actions (
.github/workflows/pages.yml) denganVITE_DEMO=true. Build biasa tidak berisi kode demo.
Menjalankan di lokal
- Buat database MySQL bernama
db_express. - Salin
backend-express/.env.examplemenjadi.envlalu isiDATABASE_URLdanJWT_SECRET. - Jalankan API (port 3000):
cd backend-express npm install npx prisma migrate dev node index.js
- Jalankan aplikasi React (Vite dev server):
cd frontend-react npm install npm run dev
Untuk mencoba mode demo di lokal: VITE_DEMO=true npm run dev.
FundamentalES6
Script Node.js singkat untuk berlatih fitur JavaScript yang dipakai di seluruh project:
let · const · var
variable, variable2, variable3
Arrow function
ArrowFunction1 – 5
Template literal
TemplateStringLiteral
Destructuring
Destructuring, Destructuring2, Restructuring
Spread · Rest
SpreadOperator 1–2, RestParameter 1–2
Parameter default
DefaultParam, DefaultParam2
Array.map
ArrayMap
Promise · async/await
Promise, Promise2, AsyncAwait
Hello World
HelloWorld
Keterbatasan & perbaikan
Sudah diperbaiki
- Halaman tambah dan ubah membaca token saat request dikirim (sebelumnya dibaca sekali saat file dimuat, sehingga request tepat setelah login tidak membawa token).
- Halaman ubah mengirim token saat memuat data user, sehingga tetap berfungsi saat dibuka langsung atau di-refresh.
backend-express/.envtidak lagi disimpan di repo; gunakan.env.example.
Ide langkah berikutnya
Sembunyikan hash password
Register, create, dan update mengembalikan user lengkap termasuk hash password — pilih hanya id, nama, dan e-mail.
Penyimpanan token lebih aman
Gunakan cookie HttpOnly yang di-set server dan skema standar Bearer.
Tangani token kedaluwarsa
Logout otomatis saat API menjawab 401.
Password opsional saat ubah
Izinkan mengubah nama atau e-mail tanpa mengisi ulang password.
404 untuk id yang tidak ada
Kembalikan 404, bukan 500, saat id user tidak ada.
Deploy backend
Host API dan database MySQL terkelola agar demo bisa memakai backend sungguhan.