My App

Buku Terbit (Admin)

Panduan untuk admin dalam memantau data buku terbit, mengimpor laporan penjualan dari berbagai platform, mengelola klaim ISBN, dan memetakan penulis untuk kebutuhan royalti.

Buku Terbit (Admin)

Modul Buku Terbit di panel admin digunakan untuk memantau semua buku yang sudah terbit dan memiliki data penjualan. Di sini admin bisa:

  • Melihat daftar buku terbit beserta platform penjualannya (Shopee, Tokopedia, Google Play Books, dsb.).
  • Melihat ringkasan jumlah terjual dan total penjualan per buku.
  • Mengimpor laporan penjualan dari marketplace / platform digital.
  • Mengelola klaim ISBN dari penulis (agar data buku terhubung ke akun penulis yang benar).
  • Memetakan penulis (assign author) untuk setiap ISBN agar royalti bisa dihitung dengan tepat.
  • Melihat dan mengelola klaim yang statusnya pending.

Modul ini menjadi jembatan antara data penjualan buku dan modul royalti & klaim.

1. Tampilan Utama Buku Terbit

Menu Buku Terbit di sidebar admin mengarah ke halaman /dashboard/publishedbook.

Di bagian atas biasanya terdapat:

  • Judul halaman dan deskripsi singkat.
  • Tombol-tombol aksi terkait impor data dan log impor.
  • Ringkasan status impor (misalnya error/partial success terbaru).

Halaman ini menggunakan tab untuk memisahkan beberapa tampilan data:

  • Tab Semua – menampilkan semua data buku terbit.
  • Tab Klaim Pending – fokus ke buku-buku yang sedang dalam proses klaim/menunggu keputusan admin.

1.1. Tabel Buku Terbit (Tab "Semua")

Di tab utama (biasanya bernama Semua), admin akan melihat tabel dengan kolom-kolom seperti:

  • Judul Buku
    Judul buku yang sudah terbit. Jika data belum lengkap, bisa muncul peringatan "Judul tidak tersedia".

  • ISBN
    Nomor ISBN buku. Jika tidak ada, akan ditandai sebagai "ISBN: Tidak tersedia".

  • Email Penulis / Status Mapping
    Menampilkan email penulis jika buku sudah terhubung dengan akun penulis. Jika belum:

    • Akan muncul teks "Belum ada penulis".
    • Ditambah badge "Perlu Mapping" sebagai penanda bahwa buku ini perlu dihubungkan ke penulis (supaya royalti bisa dihitung).

  • Platform
    Menunjukkan dari platform mana penjualan berasal, misalnya:

    • Shopee
    • Tokopedia
    • Google Play Books
    • WooCommerce
    • Lainnya

    Setiap platform biasanya diberi badge dengan warna berbeda agar mudah dibedakan.

  • Harga Buku
    Harga satuan buku di platform tersebut (ditampilkan dengan format mata uang).

  • Qty Terjual
    Jumlah eksemplar yang terjual. Ditampilkan dengan format angka lokal.

  • Total Penjualan
    Total omzet penjualan untuk baris tersebut (harga buku × jumlah terjual).

  • Tanggal Penjualan
    Tanggal transaksi penjualan (jika tersedia).

  • Last Update
    Informasi kapan data baris tersebut terakhir diperbarui (tanggal dan jam).

  • Status Klaim (opsional)
    Jika opsi tampilan status klaim diaktifkan, akan muncul kolom yang menunjukkan apakah ISBN/buku tersebut:

    • Belum diklaim (unclaimed).
    • Sedang diajukan klaim.
    • Sudah diklaim dan disetujui.

  • Aksi Assign Author (opsional)
    Jika tombol ini muncul, admin bisa:

    • Menekan "Assign Author" jika buku belum punya penulis.
    • Menekan "Ubah Author" jika ingin mengubah mapping penulis untuk buku tersebut.

Bagian bawah tabel biasanya menampilkan ringkasan seperti:

"Menampilkan X dari Y buku"

1.2. Filter & Pencarian di Tabel Buku Terbit

Di atas tabel terdapat area filter dasar:

  • Pencarian
    Input teks untuk mencari berdasarkan:

    • Judul buku.
    • Email penulis.
    • ISBN.

  • Filter Platform
    Dropdown untuk memilih:

    • Semua platform.
    • Hanya Shopee.
    • Hanya Tokopedia.
    • Hanya Google Play Books.
    • Hanya WooCommerce.
    • Lainnya.

  • Tombol Refresh
    Untuk memuat ulang data dari server dengan filter yang sedang aktif.

Selain itu, beberapa kolom di header tabel bisa diklik untuk sortir, misalnya:

  • Sortir berdasarkan judul.
  • Sortir berdasarkan total penjualan.
  • Sortir berdasarkan tanggal penjualan.
  • Sortir berdasarkan last update.

2. Tab Klaim Pending

Selain tab utama, ada tab khusus (misalnya bernama Klaim Pending atau sejenis) yang menampilkan buku-buku yang terkait dengan klaim penulis dan statusnya belum tuntas.

Di tab ini biasanya ditampilkan:

  • Daftar buku yang sedang dalam proses klaim ISBN atau klaim penjualan.
  • Status klaim (misalnya menunggu persetujuan admin).
  • Tombol untuk melihat detail klaim, menyetujui, menolak, atau menghapus klaim.

Ada juga tabel khusus Pending Claims (komponen seperti PendingClaimsTable dan ClaimReviewModal) yang memudahkan admin:

  • Melihat ringkasan klaim per buku.
  • Membuka modal review klaim, lengkap dengan detail yang diajukan penulis.
  • Mengambil keputusan: setujui, tolak, atau hapus klaim.

Keputusan admin di sini akan memengaruhi:

  • Status klaim di sisi penulis.
  • Data yang nantinya dipakai di modul royalti.

3. Impor Data Penjualan Buku

Salah satu fungsi utama modul Buku Terbit adalah mengimpor data penjualan dari marketplace atau platform digital. Di bagian atas halaman biasanya ada tombol-tombol untuk:

  • Impor Data
    Membuka dialog Import untuk mengunggah file penjualan.

  • Lihat Riwayat Import
    Membuka dialog Import Logs yang berisi daftar aktivitas import sebelumnya, termasuk status sukses/gagal/partial.

3.1. Jenis Import yang Didukung

Dari sisi admin, beberapa jenis import yang didukung antara lain:

  • Generic Import
    Import file CSV/Excel standar (menggunakan format yang sudah disepakati internal) melalui endpoint /admin/published-books/import.

  • Import Google Play Transaction Report
    Mengimpor laporan transaksi Google Play Books (berbasis transaksi). Sistem akan:

    • Membaca file CSV/TSV.
    • Mengelompokkan data per judul/ISBN.
    • Menghitung jumlah eksemplar terjual dan total pendapatan.

  • Import Google Play Books (Legacy)
    Format lama yang berbasis ringkasan, masih didukung untuk kompatibilitas, tapi secara konsep direkomendasikan memakai format Transaction Report.

  • Import Shopee
    Mengimpor laporan penjualan dari Shopee. Sistem menangani:

    • Deteksi kesalahan format.
    • Ukuran file terlalu besar.
    • Timeout koneksi.

Setiap jenis import akan mengubah atau menambah data di tabel Buku Terbit sesuai cara kerjanya (ada yang additive, ada yang aggregate). Detail teknis di-backend sudah di-handle; dari sisi admin cukup memilih jenis import yang sesuai dan mengunggah file yang benar.

3.2. Dialog Import & Hasil Import

Saat admin membuka dialog import:

  1. Pilih jenis import (generic / Google Play Transaction / Google Play / Shopee).
  2. Pilih file yang sesuai (biasanya CSV/TSV/Excel).
  3. Tekan tombol Import.

Setelah proses selesai, sistem akan menampilkan ringkasan hasil import, seperti:

  • Berapa baris yang berhasil diimport.
  • Berapa baris yang error.
  • Pesan kesalahan (jika ada) untuk membantu memperbaiki file.

Setelah import berhasil, data di tabel Buku Terbit akan diperbarui.

3.3. Undo Import Terakhir

Modul ini juga menyediakan fitur Undo Import Terakhir yang terhubung dengan riwayat import di backend:

  • Admin bisa membuka dialog Undo Import.
  • Sistem menjelaskan bahwa tindakan ini akan:
    • Mengurangi kembali qty terjual dan total penjualan yang sebelumnya ditambahkan oleh import terakhir.
    • Menghapus record buku yang hanya dibuat oleh import terakhir (record yang tidak ada sebelum import itu).
  • Setelah admin mengkonfirmasi, sistem akan menjalankan rollback berdasarkan log import terbaru, bukan semua import yang pernah dilakukan.

Fitur ini sangat berguna jika ada file salah yang terlanjur diimpor dan perlu dibatalkan efeknya.

4. Mapping Penulis & Klaim ISBN

Agar modul royalti bisa berjalan dengan benar, setiap baris buku terbit harus terhubung ke penulis yang tepat. Untuk itu, modul Buku Terbit menyediakan beberapa mekanisme:

4.1. Assign Author per Buku

Di tabel Buku Terbit, jika sebuah buku belum memiliki penulis yang terhubung, admin akan melihat:

  • Email penulis kosong atau tidak valid.
  • Badge "Perlu Mapping".
  • Tombol Assign Author.

Admin bisa:

  1. Klik Assign Author.
  2. Memilih penulis yang sesuai (berdasarkan daftar penulis di sistem).
  3. Menyimpan perubahan.

Setelah assign berhasil:

  • Email penulis akan muncul di kolom penulis.
  • Badge "Perlu Mapping" hilang.
  • Buku tersebut siap digunakan dalam perhitungan royalti.

4.2. Klaim ISBN oleh Penulis

Di sisi penulis, ada fitur klaim buku (klaim ISBN) agar penulis bisa mengklaim buku yang sudah terbit di marketplace. Klaim ini akan muncul di admin melalui modul Buku Terbit sebagai:

  • Status klaim pada baris buku.
  • Daftar klaim yang bisa dilihat di tab Klaim Pending.

Admin dapat:

  • Menyetujui Klaim – buku terhubung ke penulis yang mengklaim; ini akan memengaruhi royalti.
  • Menolak Klaim – jika klaim tidak valid (misalnya bukan buku penulis tersebut).
  • Menghapus Klaim – jika klaim perlu dibersihkan dari sistem.

Semua aksi ini menggunakan tombol seperti Approve, Reject, atau Delete di tabel klaim atau modal review klaim.

5. Hubungan dengan Modul Royalti & Klaim Royalti

Modul Buku Terbit sangat erat kaitannya dengan modul Royalti Admin dan Klaim Royalti:

  • Data yang dipakai untuk royalti

    • Jumlah terjual (qty_terjual).
    • Total penjualan (total_penjualan).
    • Platform (untuk membedakan fisik vs digital jika diperlukan).
    • ISBN dan penulis terkait.

  • Perhitungan royalti (di modul Royalti Admin) menggunakan buku-buku yang sudah:

    • Terdaftar dengan benar di Buku Terbit.
    • Memiliki mapping penulis yang valid.
    • Klaim ISBN‑nya sudah disetujui admin.

  • Klaim Royalti oleh penulis akan merujuk ke saldo yang berasal dari data Buku Terbit + perhitungan royalti.

Dengan kata lain:

Buku Terbit = sumber kebenaran untuk penjualan.
Royalti Admin = tempat menghitung hak penulis dari penjualan itu.
Klaim Royalti = tempat penulis mencairkan hak royalti mereka.

6. Tips Praktis untuk Admin di Modul Buku Terbit

  • Pastikan file import sesuai format sebelum mengunggah, terutama untuk Google Play dan Shopee, agar mengurangi error parsing.
  • Gunakan fitur Undo Import dengan hati-hati. Sebaiknya hanya digunakan segera setelah sadar ada kesalahan di import terakhir.
  • Segera mapping penulis untuk baris yang ditandai "Perlu Mapping" supaya royalti tidak tertahan.
  • Pantau tab Klaim Pending secara berkala sehingga klaim penulis tidak menggantung terlalu lama.
  • Koordinasikan modul Buku Terbit dengan Royalti & Klaim: setiap perubahan besar di Buku Terbit (import, undo, delete) bisa mempengaruhi perhitungan royalti dan saldo klaim penulis.

Dengan memahami modul Buku Terbit (Admin) ini, tim admin mendapatkan kendali penuh atas data penjualan buku dan bisa memastikan bahwa proses penghitungan royalti berjalan di atas data yang bersih dan akurat.

Klaim Royalti (Admin)

Panduan untuk admin dalam memantau, memfilter, dan memproses klaim royalti yang diajukan penulis sampai selesai dibayar.

Penulis (Admin)

Panduan untuk admin dalam mengelola data penulis, melihat ringkasan naskah dan royalti per penulis, serta menambahkan penulis baru ke sistem.

On this page

Buku Terbit (Admin)1. Tampilan Utama Buku Terbit1.1. Tabel Buku Terbit (Tab "Semua")1.2. Filter & Pencarian di Tabel Buku Terbit2. Tab Klaim Pending3. Impor Data Penjualan Buku3.1. Jenis Import yang Didukung3.2. Dialog Import & Hasil Import3.3. Undo Import Terakhir4. Mapping Penulis & Klaim ISBN4.1. Assign Author per Buku4.2. Klaim ISBN oleh Penulis5. Hubungan dengan Modul Royalti & Klaim Royalti6. Tips Praktis untuk Admin di Modul Buku Terbit