BAB 1Pendahuluan Administrator
1.1 Peran Administrator
Sebagai administrator aplikasi MyKop, Anda bertanggung jawab atas pengelolaan operasional aplikasi koperasi, termasuk:
- Mengelola data dan akun anggota koperasi.
- Memproses pengajuan pinjaman, kredit barang, dan penarikan simpanan sukarela.
- Mengelola konten aplikasi (promo, running text, RKAPBK).
- Mengatur parameter keuangan (suku bunga, limit, tenor).
- Menjalankan sinkronisasi data antara sistem lokal dan server cloud.
- Berkomunikasi dengan anggota melalui fitur chat.
1.2 Hak Akses dan Hierarki
Terdapat dua level akses administrasi:
| Level | Keterangan | Akses |
|---|---|---|
| Admin | Administrator biasa dengan hak akses terbatas sesuai konfigurasi Super Admin. | Hanya menu yang diizinkan oleh Super Admin. |
| Super Admin | Administrator tertinggi dengan akses penuh ke seluruh fitur, termasuk pengaturan hak akses admin lain. | Seluruh menu + Kelola Akses Admin. |
1.3 Mengakses Panel Admin
- Login ke aplikasi MyKop menggunakan akun Admin/Super Admin.
- Buka tab Profil di bottom navigation.
- Ketuk ikon âī¸ (Pengaturan).
- Ketuk menu "Panel Admin" yang muncul di halaman Pengaturan.
- Anda akan masuk ke Dashboard Admin dengan menu sesuai hak akses Anda.
BAB 2Panel Admin
2.1 Dashboard Admin
Dashboard Admin menampilkan seluruh menu administrasi dalam bentuk card menu. Setiap menu dibatasi oleh hak akses yang dikelola Super Admin. Menu yang tersedia meliputi:
2.2 Kelola Promo
Menu ini digunakan untuk mengelola banner promo yang ditampilkan di slider Dashboard anggota.
Fungsi yang tersedia:
- Tambah Promo: Upload gambar banner promo dengan judul dan deskripsi. Gambar akan ditampilkan di carousel Dashboard anggota.
- Edit Promo: Ubah judul, deskripsi, atau gambar promo yang sudah ada.
- Hapus Promo: Hapus promo yang sudah tidak berlaku.
- Atur Urutan: Ubah urutan tampilan promo di slider.
2.3 Running Text
Running text adalah teks berjalan (marquee) yang ditampilkan di bagian header Dashboard anggota. Teks ini cocok untuk pengumuman penting yang ingin segera dilihat semua anggota.
- Ketuk menu "Running Text" di Dashboard Admin.
- Masukkan teks pengumuman pada kolom yang tersedia.
- Ketuk "Simpan" untuk memperbarui.
- Untuk menonaktifkan, kosongkan teks dan simpan.
2.4 Manajemen Pengguna
Menu ini digunakan untuk mengelola seluruh akun pengguna aplikasi MyKop.
Fungsi yang tersedia:
| Fungsi | Keterangan |
|---|---|
| Lihat Daftar | Melihat semua anggota yang terdaftar, termasuk NRP, nama, dan status aktif. |
| Pencarian | Cari pengguna berdasarkan NRP atau nama. |
| Reset Password | Reset password pengguna ke PIN default. Pengguna akan diminta ganti password saat login berikutnya. |
| Ubah Hak Akses | Mengubah level akses pengguna (Anggota â Admin, atau sebaliknya). |
| Aktivasi/Nonaktifkan | Menonaktifkan akun pengguna yang sudah tidak aktif atau keluar dari keanggotaan. |
2.5 Pengaturan Aplikasi
Menu ini digunakan untuk mengatur konfigurasi umum aplikasi, seperti:
- URL Server: Alamat API server yang digunakan aplikasi.
- Versi Minimum: Versi minimum aplikasi yang harus digunakan anggota.
- Pengaturan Umum: Konfigurasi lainnya yang mempengaruhi seluruh pengguna.
BAB 3Manajemen Pengajuan
3.1 Daftar Pengajuan
Menu ini menampilkan seluruh pengajuan (pinjaman, simpanan sukarela, kredit barang) dari semua anggota.
Fungsi yang tersedia:
- Lihat Semua Pengajuan: Daftar pengajuan dari seluruh anggota. Dapat di-filter berdasarkan status (Menunggu, Diproses, Disetujui, Ditolak, Dicairkan).
- Detail Pengajuan: Lihat informasi lengkap setiap pengajuan, termasuk nama anggota, NRP, jumlah, tenor, keperluan, dan lampiran.
- Setujui Pengajuan: Menyetujui pengajuan yang memenuhi syarat.
- Tolak Pengajuan: Menolak pengajuan dengan memberikan alasan penolakan yang akan dilihat oleh anggota.
- Download Lampiran: Mengunduh file lampiran yang dikirim oleh anggota (KTP, slip gaji, QR Jamsostek, dll).
3.2 Alur Persetujuan
Berikut alur proses pengajuan dari awal hingga pencairan:
Mengajukan
Meninjau
Tolak
Terbit
di Kantor
Penjelasan setiap tahap:
3.3 QR Generator
Menu ini digunakan untuk membuat dan memantau QR Code pengajuan yang telah disetujui.
Fungsi yang tersedia:
- Generate QR Code: Membuat QR Code baru untuk pengajuan yang telah disetujui.
- Download QR Code: Mengunduh QR Code individu dalam format gambar.
- Download Semua: Mengunduh semua QR Code sekaligus dalam file ZIP.
- Pantau Status: Melihat status QR Code yang sudah di-scan atau dicairkan.
BAB 4Pengaturan Keuangan
4.1 Pengaturan Global Kredit
Menu ini digunakan untuk mengatur parameter kredit barang secara global:
| Parameter | Keterangan |
|---|---|
| Suku Bunga Default | Persentase bunga yang berlaku untuk semua kredit baru yang belum memiliki pengaturan khusus. |
| Suku Bunga Khusus | Mengatur bunga khusus untuk kategori kredit tertentu atau untuk anggota tertentu. |
| Limit Kredit | Batas maksimal total kredit barang yang dapat diajukan oleh satu anggota. |
4.2 Pengaturan Pinjaman (Rules)
Menu ini digunakan untuk mengatur aturan dan batasan pengajuan pinjaman per kategori:
| Aturan | Keterangan |
|---|---|
| Limit Pinjaman | Batas maksimal jumlah pinjaman per kategori. |
| Tenor Maksimal | Jangka waktu maksimal cicilan per kategori (dalam bulan). |
| Syarat Lampiran | Menentukan apakah lampiran (foto KTP, slip gaji, QR Jamsostek, dll) wajib atau opsional untuk setiap kategori. |
| Aturan Eligibility | Konfigurasi pengecekan kelayakan anggota sebelum dapat mengajukan pinjaman (cek pinjaman aktif, cek angsuran tertunggak, dll). |
4.3 Kategori Kredit
Menu ini digunakan untuk mengelola kategori kredit barang yang tersedia di aplikasi. Admin dapat:
- Tambah Kategori: Membuat kategori kredit baru (misal: Elektronik, Furnitur, Kendaraan).
- Edit Kategori: Mengubah nama atau deskripsi kategori.
- Hapus Kategori: Menghapus kategori yang sudah tidak digunakan.
BAB 5Konten & Dokumen
5.1 Upload RKAPBK
Menu ini digunakan untuk mengunggah dokumen Rencana Kerja dan APBK (Anggaran Pendapatan Belanja Koperasi) dalam format PDF agar dapat diakses oleh seluruh anggota.
- Ketuk menu "Upload RKAPBK" pada Dashboard Admin.
- Pilih aksi: "Upload Baru" atau "Lihat PDF" yang sudah ada.
- Untuk upload baru, pilih file PDF dari perangkat Anda.
- File yang di-upload akan menggantikan file sebelumnya.
- Seluruh anggota dapat melihat dokumen ini melalui menu RKAPBK di Dashboard.
5.2 Chat Admin
Menu Chat Admin menampilkan daftar semua thread percakapan dari anggota koperasi.
Fungsi yang tersedia:
- Lihat Daftar Chat: Menampilkan semua thread chat yang masuk, diurutkan berdasarkan pesan terbaru.
- Balas Pesan: Membalas pesan dari anggota secara langsung.
- Kirim Gambar: Mengirim gambar sebagai lampiran pesan.
- Kirim Stiker: Mengirim stiker untuk komunikasi yang lebih ekspresif.
- Badge Unread: Melihat jumlah pesan belum dibaca per anggota.
- Arsip Chat: Mengarsipkan thread chat yang sudah selesai ditangani.
BAB 6Keamanan & Akses Super Admin
6.1 Kelola Akses Admin
Menu ini digunakan untuk mengatur hak akses menu Panel Admin untuk setiap pengguna admin. Dengan fitur ini, Super Admin dapat membatasi menu apa saja yang dapat diakses oleh masing-masing admin.
Kode Menu yang Dapat Diatur:
| Kode | Menu | Keterangan |
|---|---|---|
| PROMO | Kelola Promo | Akses untuk mengelola banner promo. |
| RUNNING_TEXT | Running Text | Akses untuk mengubah running text. |
| USERS | Manajemen Pengguna | Akses untuk mengelola akun pengguna. |
| SETTINGS | Pengaturan Aplikasi | Akses untuk mengubah konfigurasi aplikasi. |
| PENGAJUAN | Daftar Pengajuan | Akses untuk menyetujui/menolak pengajuan. |
| RKAPBK | Upload RKAPBK | Akses untuk upload dokumen RKAPBK. |
| QR | QR Generator | Akses untuk generate dan pantau QR Code. |
| KREDIT | Pengaturan Kredit | Akses untuk mengatur bunga dan limit kredit. |
| RULES | Pengaturan Pinjaman | Akses untuk mengatur rules pinjaman. |
6.2 Audit Trail
Menu Audit Trail menampilkan log aktivitas seluruh admin yang menggunakan Panel Admin. Informasi yang dicatat meliputi:
- Siapa: NRP dan nama admin yang melakukan aksi.
- Kapan: Tanggal dan waktu aksi dilakukan.
- Apa: Jenis aksi yang dilakukan (setujui pengajuan, reset password, ubah pengaturan, dll).
- Detail: Rincian perubahan yang dilakukan.
BAB 7SyncApp (Sinkronisasi Data)
7.1 Tentang SyncApp
SyncApp adalah aplikasi desktop (Windows) yang berfungsi untuk melakukan sinkronisasi data antara database lokal koperasi (FoxPro/DBF) dengan server cloud. Tanpa SyncApp, data di aplikasi MyKop tidak akan ter-update.
SyncApp melakukan sinkronisasi untuk data berikut:
| Data | Keterangan |
|---|---|
| Data Anggota | Nama, NRP, status keanggotaan |
| Data Pinjaman & Angsuran | Detail pinjaman dan riwayat angsuran |
| Data Simpanan | Simpanan Pokok, Wajib, dan Sukarela |
| Data Kredit Barang | Tagihan kredit toko koperasi |
| Data SHU | Sisa Hasil Usaha per tahun |
| Data Slip Potongan | Slip potongan gaji dan BSM |
| Data Tabungan | Riwayat tabungan anggota |
| Data Belanja Toko | Transaksi belanja di toko koperasi |
7.2 Instalasi & Build
Persiapan Awal
- Copy seluruh folder SYNCAPP dari sumber ke komputer Windows yang digunakan admin koperasi.
- Download dan instal Python dari python.org.
- Saat instalasi Python, WAJIB centang opsi "Add python.exe to PATH" di halaman pertama installer.
- Klik "Install Now" dan tunggu sampai selesai.
Build Menjadi EXE
Untuk membuat file EXE agar lebih mudah dijalankan tanpa perlu Python terpasang di komputer lain:
- Buka folder app di dalam folder SYNCAPP.
- Klik ganda file build_windows.bat.
- Jendela Command Prompt akan terbuka dan mulai proses build.
- Tunggu hingga muncul pesan:
============================================
BUILD SELESAI!
Aplikasi EXE Anda berada di folder: dist\SyncApp_v2\
============================================ - Tekan Enter untuk menutup jendela.
- Aplikasi EXE tersedia di folder dist/SyncApp_v2/.
7.3 Menjalankan Sinkronisasi
- Jalankan SyncApp_v2.exe dari folder dist, atau run.bat dari folder app.
- Aplikasi akan menampilkan antarmuka sinkronisasi dengan progress bar.
- Pilih jenis data yang ingin disinkronkan, atau jalankan sinkronisasi lengkap (
--sync all). - Tunggu hingga proses selesai. Status sinkronisasi ditampilkan secara real-time.
- Setelah selesai, data di aplikasi MyKop akan ter-update.
7.4 Penjadwalan Otomatis (Task Scheduler)
Agar sinkronisasi berjalan otomatis tanpa harus menjalankan manual setiap hari, gunakan Task Scheduler Windows:
- Buka Task Scheduler di Windows (cari di Start Menu).
- Klik "Create Basic Task..." di panel kanan.
- Beri nama task, misalnya: SYNCAPP.
- Pilih trigger: "Daily" dan atur waktu eksekusi (contoh: 01:00 AM setiap hari).
- Pilih action: "Start a program".
- Browse ke lokasi file:
D:\PANCA_SYNC_APP\SyncApp_v2\SyncApp_v2.exe - Di kolom "Add arguments", isi:
--sync all - Klik Finish untuk menyimpan.
BAB 8FAQ Administrator
Q: Bagaimana cara menambah admin baru?
A: Pertama, pastikan pengguna sudah terdaftar di aplikasi. Kemudian, buka Manajemen Pengguna â cari pengguna â ubah hak akses menjadi Admin. Setelah itu, Super Admin dapat mengatur menu apa saja yang dapat diakses oleh admin baru tersebut melalui Kelola Akses Admin.
Q: Anggota tidak bisa login, apa yang harus saya lakukan?
A: Buka Manajemen Pengguna, cari anggota tersebut, lalu gunakan fungsi Reset Password. Password akan direset ke PIN default dan anggota diminta ganti password saat login berikutnya.
Q: Data di aplikasi MyKop tidak sesuai dengan data di kantor?
A: Jalankan SyncApp untuk sinkronisasi data terbaru. Jika masalah berlanjut, pastikan:
- File database FoxPro/DBF tidak sedang dibuka oleh aplikasi lain.
- Koneksi internet ke server cloud stabil.
- Konfigurasi path database di
config.jsonSyncApp sudah benar.
Q: SyncApp error saat dijalankan, bagaimana cara mengatasinya?
A: Periksa file error.log di folder app untuk melihat pesan error detail. Penyebab umum:
- File DBF terkunci: Tutup aplikasi lain yang mengakses database (misal: FoxPro, Z2Soft).
- Koneksi gagal: Periksa koneksi internet dan pastikan server cloud aktif.
- Path tidak ditemukan: Pastikan path database di
config.jsonsesuai dengan lokasi file DBF di komputer.
Q: Bagaimana cara menjalankan SyncApp di Mac?
A: SyncApp dirancang untuk Windows karena memerlukan akses ke database FoxPro/DBF yang biasanya dikelola di lingkungan Windows. Untuk menjalankan di Mac, diperlukan virtual machine (VMware/Parallels) atau remote desktop ke komputer Windows.
Q: Bagaimana jika admin lupa password Super Admin?
A: Reset Super Admin hanya dapat dilakukan melalui akses langsung ke database server. Hubungi developer/technical support untuk bantuan.
Q: Apakah pengajuan yang sudah ditolak bisa disetujui kembali?
A: Tidak. Pengajuan yang sudah ditolak tidak dapat diubah statusnya. Anggota harus membuat pengajuan baru jika ingin mengajukan kembali.