Panduan Admin Kantong Nona

1. Login Admin

1. Buka halaman http://localhost:3000/backend/login (atau domain toko Anda + /backend/login).
2. Masukkan username dan password akun admin.
3. Klik Masuk. Anda akan diarahkan ke panel admin (/backend/dashboard).

2. Dashboard

Setelah login, Anda melihat Ringkasan Sistem: total produk, banner, dan booster pack yang tersimpan.

Menu di sisi kiri panel:

Untuk keluar, klik Keluar di pojok kanan atas panel.

3. Manajemen Produk

Tambah / Edit produk

1. Buka menu Produk → klik + Tambah Produk (atau klik Edit pada produk yang ada).
2. Isi form:
   • Nama Produk — wajib.
   • Deskripsi — penjelasan produk.
   • Harga dan Stok — angka.
   • Berat (gram) — dipakai menghitung ongkir. Contoh: 1.000 = 1 kg.
   • Gambar Utama (URL) — URL gambar atau klik Pilih dari Galeri.
   • Foto Tambahan — lebih dari 1 foto: klik + Pilih dari Galeri atau + Tambah URL. Foto muncul sebagai strip thumbnail di detail produk publik.
   • Kategori — mis. "Sealed Box", "Aksesoris", "Sleeve".
3. Klik Simpan. Produk langsung tampil di beranda & halaman /produk.

Menghapus produk

Klik Hapus pada baris produk. Produk yang dihapus tidak bisa dikembalikan (tidak ada trash untuk produk).

4. Banner

Banner tampil sebagai carousel di bagian atas beranda. Mendukung gambar dan video.

Tambah / edit banner

1. Buka menu Banners → + Tambah Banner.
2. Isi:
   • Judul & Deskripsi — opsional. Jika media terisi, judul & deskripsi tidak ditampilkan (hanya media yang tampil).
   • Media Type — Image atau Video.
   • Urutan — nomor urut tampil.
   • Media URL — URL gambar/video, atau Pilih dari Galeri.
   • Media URL Mobile (Opsional) — versi khusus tampilan HP. Disarankan rasio 16:9 (mis. 1080×608) agar tidak terpotong. Jika dikosongkan, versi desktop dipakai sebagai cadangan.
   • Banner Aktif — centang untuk menampilkan.
3. Klik Simpan.

5. Galeri Media & Trash (28 Hari)

Galeri media adalah penyimpanan gambar & video untuk banner, logo, favicon, dan foto produk.

Upload media

1. Buka Galeri Media (menu di sidebar, di bawah menu utama).
2. Pilih file dari komputer → isi Nama media (opsional) → klik Upload.
3. Gambar otomatis dikompresi ke WebP 75%. Video diunggah tanpa kompresi.

Menghapus media (trash)

• Klik Hapus pada media → media dipindah ke Trash, disimpan 28 hari. File tidak hilang, sehingga gambar yang sedang dipakai produk/banner tetap tampil.
• Buka tab Trash (28 hari): setiap item menampilkan "Sisa X hari, lalu hapus permanen".
• Di trash Anda bisa Restore (kembalikan) atau Hapus Permanen (file & data dihapus, tidak bisa dibatalkan).

6. Booster Pack (Gacha)

Booster pack adalah paket gacha Pokémon. Pembeli membuka pack menggunakan poin mereka.

Tambah / edit pack

1. Buka menu Booster Packs → + Tambah Pack.
2. Isi:
   • Nama Pack — mis. "Sword & Shield Booster".
   • Icon — emoji untuk tampilan pack.
   • Harga (String) — harga dalam poin untuk membuka pack (mis. "500").
   • Bahasa — EN / JA / ID (bahasa kartu dari tcgdex).
   • Kategori & Tipe — mis. "pokemon", "booster".
   • Pokemon IDs — daftar ID kartu (dari tcgdex.dev), dipisah koma. Contoh: 1, 4, 7, 25. Saat gacha, sistem memilih acak dari daftar ini.
3. Klik Simpan.

7. Manajemen Pesanan

Daftar pesanan menampilkan kolom ringkas: ID, Tanggal, User, Status, Resi (Kurir), dan Aksi. Klik baris mana pun untuk melihat detail lengkap (nama lengkap, alamat, metode pembayaran, nomor invoice, item, total).

Mencari pesanan

• Gunakan kotak pencarian di atas tabel: cari berdasarkan ID, nomor invoice, username, nama, no. HP, kota, alamat, atau nomor resi.
• Tekan Enter atau klik Cari. Pagination otomatis mengikuti hasil pencarian (5 pesanan per halaman).

Alur status

1. Klik baris pesanan → modal Detail Pesanan terbuka.
2. Pilih status baru di dropdown (opsional) dan isi Nomor Resi + Kurir bila mengirim.
3. Klik Simpan. Pembeli mendapat notifikasi otomatis.

8. Ongkir

Sistem ongkir memakai 3 zona. Tarif bisa diubah kapan saja; perubahan langsung berlaku di checkout.

Mengubah tarif

1. Buka menu Ongkir.
2. Ubah Nama Zona, Tarif Dasar, dan Tarif per Kg.
3. Klik Simpan Tarif.

9. Pembayaran Midtrans

Konfigurasi

1. Buka menu Pembayaran.
2. Daftar/login di dashboard.sandbox.midtrans.com (mode percobaan/sandbox).
3. Buka Settings → Access Keys, salin Server Key & Client Key.
4. Tempel ke form, centang Production hanya jika memakai akun asli.
5. Klik Simpan Konfigurasi. Kunci tersimpan aman (Server Key tidak pernah ditampilkan ulang).
6. Klik Uji Koneksi untuk memastikan kunci valid.

Cara pembeli membayar

Di checkout, setelah pesanan dibuat, popup Midtrans Snap terbuka otomatis menampilkan pilihan metode (Kartu Kredit, QRIS, VA, e-Wallet, Alfamart/Indomaret, dll). Pembeli memilih & menyelesaikan pembayaran. Untuk uji coba sandbox, gunakan kartu uji 4811 1111 1111 1114 (expired bulan depan, CVV apa saja).

• Lunas → status pesanan otomatis menjadi Diproses.
• Menutup popup → pesanan dibatalkan & item kembali ke keranjang pembeli (stok dilepas).
• Kedaluwarsa (24 jam) → pesanan dibatalkan otomatis, stok kembali.

10. Manajemen Pengguna

Menu Pengguna untuk menambah anggota tim atau akun admin lain.

Tambah user / moderator / admin

1. Buka menu Pengguna → + Tambah User.
2. Isi Username (min. 3 karakter, unik) dan Password (min. 8 karakter).
3. Pilih Role:
   • User — pembeli biasa.
   • Moderator — role menengah (saat ini tanpa akses panel admin).
   • Admin — akses penuh ke panel ini.
4. Lengkapi Nama Lengkap, No. HP, Alamat (opsional) → Simpan.

Edit / hapus

• Edit — ubah role, nama, no. HP, alamat, atau ganti password (kosongkan password untuk mempertahankan yang lama). Username tidak bisa diubah.
• Hapus — hapus akun. Anda tidak bisa menghapus akun sendiri atau menurunkan role akun sendiri.
• Gunakan pencarian untuk mencari user berdasarkan username, nama, no. HP, atau role.

11. Poin Gacha

Pembeli mendapat poin dari setiap pembelian yang sudah lunas. Poin dipakai untuk membuka booster pack.

Aturan yang bisa diatur

1. Buka menu Poin Gacha.
2. Ubah nilai → klik Simpan Aturan Poin.

12. Pengaturan Web

Menu Pengaturan Web mengontrol tampilan identitas toko di seluruh halaman:

13. Backup & Restore

Menu Backup melindungi seluruh data toko: database (produk, pesanan, user, poin, dll.) dan file media (gambar/video) dalam satu file ZIP.

Membuat backup

1. Buka menu Backup.
2. Klik Buat Backup Sekarang. File ZIP dibuat di server dengan nama berisi tanggal & jam (mis. backup-2026-08-14_092603.zip).
3. File muncul di tabel Riwayat Backup dengan ukuran & tanggal.

Mengunduh backup

Klik Unduh pada baris backup untuk menyimpan salinannya ke komputer. Disarankan mengunduh secara rutin dan menyimpannya di tempat aman (mis. Google Drive / flashdisk).

Restore

1. Klik Restore pada backup yang diinginkan.
2. Konfirmasi, lalu ketik RESTORE (huruf besar) untuk memastikan Anda sadar bahwa seluruh data saat ini akan ditimpa.
3. Sebelum menimpa, sistem otomatis membuat backup keselamatan (berawalan pre-restore-) — jadi Anda bisa kembali ke kondisi sebelumnya bila perlu.

Menghapus backup

Klik tombol sampah pada baris backup untuk menghapus file backup dari server.

14. Alur Lengkap dari Toko

Urutan kegiatan yang umum dilakukan admin dan pembeli:

15. FAQ & Troubleshooting