Pengaturan Admin

Halaman Pengaturan Admin digunakan untuk mengelola pengaturan global yang memengaruhi beberapa modul lain, terutama:

• Integrasi WhatsApp untuk komunikasi terkait naskah dengan penulis.
• Pengaturan Royalti default untuk buku fisik dan digital.

Menu ini bisa diakses dari sidebar admin melalui Pengaturan Admin, dan mengarah ke halaman /dashboard/admin-settings.

---

1. Integrasi WhatsApp

Bagian pertama halaman berjudul Integrasi WhatsApp. Di sini admin mengatur nomor WhatsApp utama dan template pesan standar yang digunakan ketika sistem membuat tautan WhatsApp otomatis.

1.1. Nomor WhatsApp

• Field Nomor WhatsApp menerima input nomor dengan format internasional.
• Di UI, field ini ditampilkan sebagai input teks dengan font monospaced, contoh placeholder: +6281234567890.
• Saat admin mengetik nomor:
  • Sistem akan membersihkan karakter selain angka dan tanda +.
  • Jika nomor diawali 62 tanpa +, sistem otomatis menambah + di depan (contoh: 62812... menjadi +62812...).

Gunanya:

• Nomor ini dipakai sebagai tujuan utama ketika sistem membuat link WhatsApp untuk komunikasi terkait naskah.

1.2. Template Pesan WhatsApp

• Field Template Pesan adalah textarea berisi teks pesan default yang akan dikirim ke penulis.
• Di atas textarea ada tombol Salin untuk menyalin isi template ke clipboard.
• Template mendukung placeholder berikut:
  • {author_name} – akan diganti dengan nama penulis.
  • {manuscript_title} – akan diganti dengan judul naskah.

Contoh sederhana template default:

"Halo {author_name}, terkait naskah "{manuscript_title}" Anda, silakan hubungi kami untuk informasi lebih lanjut."

Admin dapat menyesuaikan kalimat sesuai gaya komunikasi internal, selama tetap menyertakan placeholder yang dibutuhkan.

1.3. Pratinjau URL WhatsApp

Jika Nomor WhatsApp terisi, di bawah form akan muncul area Pratinjau:

• Menampilkan contoh URL WhatsApp yang akan dihasilkan untuk kombinasi judul naskah dan nama penulis contoh (misalnya "Sample Manuscript Title" dan "John Doe").
• Menyediakan tombol "Uji Coba" yang akan membuka tab baru ke WhatsApp menggunakan URL tersebut, sehingga admin bisa memastikan:
  • Format nomor sudah benar.
  • Template pesan terisi dengan benar.

1.4. Tombol Simpan & Atur Ulang (WhatsApp)

Di bagian bawah kartu Integrasi WhatsApp ada dua tombol utama:

• Atur Ulang

  • Mengembalikan form ke nilai terakhir yang tersimpan di server.
  • Hanya aktif jika ada perubahan yang belum disimpan.

• Simpan Perubahan

  • Mengirim perubahan ke backend (/admin/settings).
  • Jika validasi berhasil dan penyimpanan sukses:
    • Muncul notifikasi bahwa pengaturan berhasil diperbarui.
    • Indikator "Perubahan Belum Disimpan" akan hilang.
  • Jika gagal, muncul notifikasi error yang menyarankan admin untuk mencoba lagi.

Saat ada perubahan yang belum disimpan, di header halaman akan muncul badge kecil bertuliskan misalnya "Perubahan Belum Disimpan" sebagai pengingat.

---

2. Pengaturan Royalti

Bagian kedua berjudul Pengaturan Royalti. Di sini admin mengatur persentase royalti default untuk dua jenis buku:

• Buku Fisik.
• Buku Digital.

Pengaturan ini dipakai sebagai referensi oleh modul royalti ketika menghitung hak penulis berdasarkan jenis penjualan (fisik vs digital).

2.1. Royalti Buku Fisik (%)

• Field Royalti Buku Fisik (%) menerima angka dari 0 sampai 100, dengan langkah desimal kecil (misalnya 0.1).
• Contohnya, admin bisa mengisi 60 untuk menyatakan bahwa penulis menerima 60% dari pendapatan bersih penjualan buku fisik.
• Deskripsi di bawah field menjelaskan bahwa pengaturan ini berlaku untuk platform fisik seperti Shopee, Tokopedia, dan sejenisnya.

2.2. Royalti Buku Digital (%)

• Field Royalti Buku Digital (%) juga menerima angka 0–100.
• Misalnya diisi 70 untuk menyatakan bahwa penulis menerima 70% dari pendapatan bersih penjualan buku digital.
• Deskripsi menjelaskan bahwa pengaturan ini efektif untuk platform digital seperti Google Play Books, Apple Books, dan platform e-book lainnya.

2.3. Pratinjau Pengaturan Royalti

Jika data royalti sudah dimuat dari server, di bawah kedua field akan muncul blok Pratinjau Pengaturan Saat Ini:

• Menampilkan dua kartu ringkasan:
  • Buku Fisik – persentase royalti saat ini + catatan platform contoh (Shopee, Tokopedia, dll.).
  • Buku Digital – persentase royalti saat ini + catatan platform contoh (Google Play Books, Apple Books, dll.).

Hal ini membantu admin memverifikasi angka sebelum menyimpan perubahan.

2.4. Tombol Simpan & Reset (Royalti)

Di bagian bawah kartu Pengaturan Royalti terdapat tiga tombol utama:

• Kembalikan ke Default

  • Mengembalikan pengaturan royalti ke nilai default yang ditentukan oleh sistem (misalnya standar awal Nasmedia).
  • Cocok digunakan jika angka sudah terlalu banyak diutak-atik dan ingin kembali ke baseline.

• Atur Ulang

  • Mengembalikan nilai di formulir ke angka terakhir yang tersimpan di server (tanpa memanggil default global).
  • Hanya aktif jika ada perubahan yang belum disimpan.

• Simpan Perubahan

  • Mengirim nilai baru ke backend melalui hook useRoyaltySettings.
  • Jika proses simpan sedang berjalan, teks tombol akan berubah menjadi "Menyimpan..." dengan indikator loading.
  • Setelah berhasil:
    • Perubahan dianggap tersimpan.
    • Indikator "Perubahan Belum Disimpan" untuk bagian royalti akan hilang.

Seperti bagian WhatsApp, ada juga indikator kecil yang menyatakan bahwa pengaturan royalti saat ini sudah tersimpan ketika tidak ada perubahan lokal.

---

3. Error & Loading State

Ketika halaman pertama kali dibuka:

• Jika data pengaturan masih diambil dari server, akan muncul tampilan skeleton loading sederhana dengan placeholder untuk judul dan field.
• Jika terjadi kesalahan saat mengambil pengaturan (baik WhatsApp maupun royalti), akan muncul Alert merah di bagian atas halaman dengan pesan seperti:
  • "Gagal memuat pengaturan WhatsApp".
  • "Gagal memuat pengaturan royalti".

Pesan error tidak menggunakan istilah teknis, hanya menjelaskan bahwa sedang ada kendala dan admin dapat mencoba lagi nanti.

---

4. Dampak ke Modul Lain

Pengaturan di halaman Pengaturan Admin ini digunakan oleh modul-modul lain sebagai berikut:

• Nomor & Template WhatsApp

  • Dipakai untuk membentuk tautan WhatsApp otomatis ketika admin ingin menghubungi penulis terkait naskah.
  • Nomor publik juga bisa digunakan di halaman lain (misalnya halaman harga/paket) sebagai tombol kontak cepat.

• Persentase Royalti Buku Fisik & Digital

  • Menjadi referensi untuk modul Royalti Admin dalam menghitung berapa persen pendapatan bersih yang menjadi hak penulis.
  • Dengan memisahkan pengaturan buku fisik dan digital, admin bisa menyesuaikan skema royalti sesuai karakteristik masing-masing kanal penjualan.

Dengan memahami dan mengelola Pengaturan Admin ini, tim admin dapat memastikan:

• Komunikasi WhatsApp dengan penulis konsisten dan profesional.
• Perhitungan royalti berjalan di atas nilai persentase yang sesuai kebijakan terbaru perusahaan.