Penulis (Admin)

Halaman Penulis di panel admin digunakan untuk mengelola akun penulis yang terdaftar di sistem Nasmedia. Dari sini admin bisa:

• Melihat daftar semua penulis yang memiliki akun.
• Mengecek kontak penulis (email, nomor WhatsApp).
• Melihat jumlah naskah dan total royalti yang pernah dihitung untuk masing-masing penulis.
• Menyaring penulis berdasarkan pencarian dan status kepemilikan naskah.
• Menambahkan penulis baru secara manual.

Halaman ini berhubungan erat dengan modul:

• Naskah & Draft – untuk melihat naskah milik penulis tersebut.
• Royalti Admin – untuk melihat bagaimana total royalti per penulis dihitung dari data penjualan.

---

1. Tampilan Utama Manajemen Penulis

Menu Penulis di sidebar admin mengarah ke halaman /dashboard/authors.

Di bagian atas halaman terdapat header dengan:

• Judul halaman: Manajemen Penulis.
• Deskripsi singkat: menjelaskan bahwa halaman ini untuk mengelola dan memantau semua penulis yang terdaftar.
• Tombol "Tambah Penulis Baru" di sisi kanan.

---

2. Filter & Pencarian Penulis

Di bawah header terdapat kartu "Filter & Pencarian" yang berisi beberapa kontrol untuk menyaring data penulis:

2.1. Pencarian Nama / Email

• Input teks dengan ikon kaca pembesar.
• Admin bisa mengetik nama penulis atau email.
• Sistem akan melakukan pencarian dengan jeda singkat (debounce), sehingga tidak setiap ketikan langsung memicu permintaan baru.

2.2. Filter "Punya Naskah"

Dropdown dengan pilihan:

• Semua – tampilkan semua penulis.
• Punya Naskah – fokus ke penulis yang sudah memiliki setidaknya satu naskah di sistem.
• Belum Punya Naskah – penulis yang sudah punya akun tetapi belum punya naskah di modul Naskah.

Filter ini membantu admin memprioritaskan penulis yang sudah aktif menulis atau yang baru mendaftar.

2.3. Tombol Reset & Tambah Penulis

Di sisi kanan baris filter terdapat:

• Tombol "Tambah Penulis" (di dalam modal) – membuka dialog untuk mengisi data penulis baru.
• Tombol Reset (ikon panah melingkar) – mengembalikan filter ke kondisi awal:
  • Pencarian kosong.
  • Filter "Punya Naskah" kembali ke default.

---

3. Tabel Daftar Penulis

Bagian utama halaman menampilkan tabel "Daftar Penulis".

3.1. Kolom-kolom Utama

Setiap baris mewakili satu penulis. Kolom yang ditampilkan antara lain:

• Nama Penulis
  Nama lengkap penulis sesuai profil akun.

• Email
  Alamat email yang digunakan penulis untuk login dan komunikasi.

• Nomor WhatsApp
  Nomor WhatsApp penulis (ditampilkan dengan font mono agar mudah dibaca dan disalin).

• Jumlah Naskah
  Berapa banyak naskah yang terdaftar atas nama penulis ini. Angka ini diambil dari modul Naskah dan menggambarkan seberapa aktif penulis tersebut.

• Total Royalti
  Total nominal royalti yang pernah dihitung sistem untuk penulis ini (akumulasi dari semua buku yang sudah terbit dan ikut perhitungan royalti). Angka ditampilkan dalam format Rupiah.

3.2. Status Loading dan Data Kosong

• Saat data sedang dimuat, tabel akan menampilkan beberapa baris skeleton abu-abu sebagai penanda loading.
• Jika setelah filter/pencarian tidak ada penulis yang cocok:
  • Tabel menampilkan pesan "Tidak ada penulis yang ditemukan".
  • Disertai saran untuk mengubah filter pencarian.

3.3. Navigasi Halaman (Pagination)

Jika jumlah penulis cukup banyak, di bawah tabel akan muncul kontrol pagination:

• Teks ringkasan:
  Menampilkan X - Y dari Z penulis.
• Tombol Sebelumnya dan Berikutnya, dengan otomatis non-aktif jika sudah di halaman pertama/terakhir.
• Nomor halaman yang bisa diklik untuk berpindah ke halaman tertentu.

Semua ini terhubung ke backend, sehingga perpindahan halaman tetap efisien dan tidak membebani browser.

---

4. Menambahkan Penulis Baru

Admin bisa menambahkan penulis baru dengan dua cara yang terlihat di UI:

• Tombol besar "Tambah Penulis Baru" di header halaman.
• Tombol "Tambah Penulis" di dalam dialog/modal (komponen CreateAuthorModal).

Keduanya akan membuka dialog form yang berisi:

• Nama Lengkap
  Wajib diisi, dengan panjang minimal dan maksimal tertentu.

• Email
  Wajib diisi dengan format email yang valid.

• Nomor WhatsApp
  Wajib diisi dengan panjang minimal dan maksimal tertentu, hanya boleh berisi angka, spasi, +, dan -.
  Disarankan menggunakan format internasional (misalnya 62812XXXXXXX).

Setelah admin menekan "Simpan":

1. Sistem akan mengirim data ke API admin user dengan informasi:
   • nama_lengkap
   • email
   • nomor_whatsapp
   • role = author (supaya akun ini dikenali sebagai penulis).
2. Jika berhasil:
   • Muncul notifikasi sukses bahwa penulis baru berhasil ditambahkan.
   • Form di-reset dan dialog ditutup.
   • Daftar penulis otomatis diperbarui (penulis baru muncul di tabel).
3. Jika gagal (misalnya email sudah terpakai atau ada error lain):
   • Muncul notifikasi error dengan pesan dari backend.

Catatan: Pembuatan penulis baru akan membuat user dengan role author di backend. Penulis ini nantinya bisa:

• Mengirim draft/naskah dari sisi portal penulis.
• Mengklaim buku dan melihat royalti jika sudah ada data penjualan.

---

5. Hubungan Dengan Modul Lain

Modul Penulis (Admin) tidak berdiri sendiri. Data yang ditampilkan di sini diambil dan dipakai ulang oleh modul lain:

• Naskah & Draft

  • Jumlah naskah per penulis (Jumlah Naskah) terhubung ke modul Draft/Naskah.
  • Dari sisi teknis, sistem menghitung berapa banyak naskah yang dimiliki setiap penulis.

• Royalti Admin

  • Kolom Total Royalti diambil dari perhitungan royalti yang dikerjakan modul Royalti Admin.
  • Admin bisa menggunakan angka ini untuk melihat kontribusi finansial masing-masing penulis.

• Klaim Royalti & Buku Terbit

  • Saat penulis mengklaim buku dan royalti dari sisi portal penulis, hasil akhirnya akan tercermin di Total Royalti di modul ini.

Dengan memahami halaman Penulis (Admin), tim admin bisa:

• Memantau daftar penulis yang aktif maupun belum aktif.
• Melihat dengan cepat siapa saja penulis dengan banyak naskah atau royalti tinggi.
• Menambahkan penulis baru saat diperlukan (misalnya ketika penulis belum mendaftar sendiri, tetapi sudah ada kerja sama).

---

6. Halaman Detail Penulis

Selain daftar penulis, admin juga bisa membuka halaman detail penulis dengan mengklik salah satu penulis di daftar. Halaman ini biasanya berada di URL seperti /dashboard/authors/{id} dan menampilkan informasi lengkap per penulis.

Secara garis besar, halaman detail ini dibagi menjadi beberapa bagian:

6.1. Header & Navigasi Kembali

Di bagian paling atas terdapat:

• Tombol Kembali untuk kembali ke halaman daftar penulis.
• Judul yang menunjukkan bahwa ini adalah halaman detail penulis.
• Tombol Edit Penulis untuk mengubah data dasar penulis.

6.2. Ringkasan Profil Penulis

Bagian pertama biasanya berupa kartu Profil Penulis yang menampilkan:

• Nama lengkap penulis.
• Email.
• Nomor WhatsApp.
• Status akun (Aktif / Tidak Aktif), biasanya ditandai dengan badge/label.
• Tanggal bergabung – diambil dari tanggal akun penulis dibuat.

Admin bisa menekan tombol Edit untuk memperbarui data ini. Di dalam dialog Edit, admin dapat:

• Mengubah nama lengkap.
• Mengubah email.
• Mengubah nomor WhatsApp.
• Mengubah status akun (misalnya menonaktifkan penulis yang sudah tidak aktif).

Perubahan akan disimpan ke backend dan langsung tercermin di halaman ini.

6.3. Ringkasan Aktivitas & Naskah Penulis

Di bagian berikutnya terdapat kartu ringkasan yang menampilkan:

• Total Naskah milik penulis ini.
• Total Royalti yang pernah dihitung untuk penulis ini.

Melalui angka ringkasan ini, admin bisa dengan cepat melihat seberapa aktif penulis tersebut (dari sisi jumlah naskah) dan seberapa besar kontribusi finansialnya (dari sisi total royalti) tanpa harus membuka modul lain terlebih dahulu.

6.4. Paket Layanan yang Dimiliki Penulis

Jika sistem menggunakan paket layanan penerbitan, di halaman ini juga ditampilkan daftar paket layanan yang pernah atau sedang dimiliki penulis tersebut.

Untuk setiap paket biasanya ditampilkan:

• Nama paket layanan (misalnya paket terbit tertentu).
• Deskripsi singkat paket.
• Tanggal paket ditambahkan ke penulis.
• Status paket (misalnya: aktif/digunakan atau belum digunakan).
• Jika paket sudah dikaitkan dengan naskah tertentu, akan ditampilkan judul naskah tersebut.

Admin dapat:

• Menambahkan paket layanan baru ke penulis melalui dialog khusus (memilih salah satu paket yang tersedia).
• Menghapus paket layanan tertentu jika sudah tidak relevan (misalnya paket belum digunakan dan perlu dibatalkan).

Setiap perubahan paket akan disimpan ke backend dan daftar akan diperbarui.

6.5. Riwayat Royalti Penulis

Di bagian bawah terdapat kartu Riwayat Royalti khusus untuk penulis tersebut. Di sini admin bisa melihat daftar periode royalti yang pernah dihasilkan penulis ini, misalnya per bulan atau per periode lain.

Setiap item riwayat biasanya berisi:

• Judul buku terbit yang menjadi sumber royalti.
• Periode royalti (tanggal awal–akhir perhitungan).
• Jumlah royalti untuk periode tersebut (dalam Rupiah).
• Jumlah penjualan (jumlah eksemplar terjual) yang menjadi dasar perhitungan.

Jika belum ada data royalti untuk penulis ini, bagian ini akan menampilkan pesan bahwa belum ada riwayat royalti.

---

Dengan menggabungkan daftar penulis dan detail penulis dalam satu pemahaman, admin mendapatkan pandangan menyeluruh:

• Dari daftar: siapa saja penulis yang aktif dan bagaimana gambaran besarnya.
• Dari detail: riwayat lengkap aktivitas, paket layanan, dan royalti untuk masing-masing penulis.

Ini memudahkan tim internal untuk mengambil keputusan, melakukan follow up, dan menjaga hubungan yang baik dengan para penulis.