Dokumentasi Sistem Koperasi Bina Mandiri

Selamat datang di dokumentasi resmi Sistem Koperasi Bina Mandiri, solusi manajemen koperasi digital untuk Koperasi Merah Putih. Dokumen ini dirancang untuk membantu administrator dan staf koperasi dalam menginstal, mengonfigurasi, dan menggunakan aplikasi secara efektif.

Versi Terbaru: 2.5 (2025)

Dilengkapi dengan modul Akuntansi SAK EP dan Sistem Lisensi Keamanan Tinggi.

Persyaratan Server

Sebelum melakukan instalasi, pastikan server atau hosting Anda memenuhi spesifikasi berikut:

  • PHP Version: 8.1 atau 8.2 (Disarankan 8.2)
  • Database: MySQL 5.7+ atau MariaDB 10.3+
  • Web Server: Apache atau Nginx
  • PHP Extensions: BCMath, Ctype, Fileinfo, JSON, Mbstring, OpenSSL, PDO, Tokenizer, XML.
  • IonCube Loader: Wajib aktif untuk menjalankan file inti yang terenkripsi.

Panduan Instalasi

  1. Upload File

    Upload seluruh file source code ke folder public_html (untuk hosting) atau direktori root web server Anda.

  2. Buat Database

    Buat database baru di MySQL/MariaDB (misal: db_koperasi).

  3. Konfigurasi .env

    Salin file .env.example menjadi .env. Edit konfigurasi database:

    DB_DATABASE=db_koperasi
    DB_USERNAME=root
    DB_PASSWORD=password_anda
  4. Jalankan Migrasi

    Buka terminal atau SSH, lalu jalankan perintah:

    php artisan migrate --seed

    Ini akan membuat tabel-tabel database dan mengisi data awal (Admin default).

  5. Set Permissions

    Pastikan folder storage dan bootstrap/cache memiliki permission 775.

Aktivasi Lisensi

Aplikasi ini dilindungi oleh sistem lisensi berbasis domain (Site Key).

  1. Buka aplikasi di browser (misal: http://koperasi-anda.com).
  2. Anda akan diarahkan otomatis ke halaman Verifikasi Lisensi.
  3. Salin Site Key yang muncul di layar.
  4. Kirimkan Site Key tersebut ke tim support kami atau gunakan Generator Lisensi (jika Anda memiliki akses).
  5. Masukkan Purchase Code yang Anda terima ke kolom yang tersedia.
  6. Klik Activate License. Jika berhasil, Anda akan diarahkan ke Dashboard.

Panduan: Dashboard

Halaman utama memberikan ringkasan kesehatan koperasi Anda secara real-time.

  • Total Anggota: Jumlah anggota aktif.
  • Simpanan Masuk: Total dana simpanan yang dihimpun.
  • Pinjaman Cair: Total dana yang sedang dipinjamkan.
  • Grafik Bulanan: Tren pendaftaran anggota dan transaksi kas.

Panduan: Manajemen Anggota

Menu ini digunakan untuk mengelola data nasabah atau anggota koperasi.

Menambah Anggota Baru

  1. Masuk ke menu Members > Add Member.
  2. Isi data pribadi: Nama, NIK, No HP, Alamat.
  3. Upload Dokumen: Foto KTP dan KK (Wajib untuk verifikasi).
  4. Tentukan Cabang (jika koperasi memiliki banyak cabang).
  5. Klik Save. Anggota akan berstatus Pending hingga disetujui Admin.

Detail Anggota

Klik nama anggota untuk melihat profil lengkap, riwayat transaksi simpanan, dan status pinjaman aktif mereka.

Panduan: Pinjaman (Loan)

1. Membuat Produk Pinjaman

Sebelum memberikan pinjaman, Anda harus membuat produk terlebih dahulu di Loan Products.

  • Bunga Flat: Bunga tetap setiap bulan dari pokok awal.
  • Bunga Menurun: Bunga dihitung dari sisa pokok pinjaman.
  • Tenor: Tentukan jangka waktu (misal: 6, 12, 24 bulan).

2. Pengajuan Pinjaman

  1. Masuk ke menu Loans > Create Loan.
  2. Pilih Anggota dan Produk Pinjaman.
  3. Masukkan Jumlah Pinjaman (Principal).
  4. Sistem akan otomatis menghitung angsuran per bulan.
  5. Klik Submit. Status menjadi Pending Approval.

3. Persetujuan & Pencairan

Admin atau Komite Kredit harus memverifikasi pengajuan. Jika disetujui, klik Approve lalu Disburse (Cairkan). Saat dicairkan, saldo kas koperasi berkurang dan piutang bertambah.

Panduan: Simpanan (Savings)

Kelola dana simpanan anggota dengan mudah.

Jenis Simpanan

  • Simpanan Pokok: Dibayar sekali saat mendaftar.
  • Simpanan Wajib: Dibayar rutin setiap bulan.
  • Simpanan Sukarela: Bisa disetor dan ditarik kapan saja.

Transaksi Setor/Tarik

  1. Masuk ke menu Savings > Transactions.
  2. Pilih Anggota dan Jenis Simpanan.
  3. Pilih Deposit (Setor) atau Withdraw (Tarik).
  4. Masukkan nominal dan keterangan.
  5. Klik Save. Saldo anggota akan langsung terupdate.

Panduan: Akuntansi & Laporan

Sistem ini menggunakan Auto-Journaling. Setiap transaksi (Simpanan, Pinjaman, Biaya) otomatis mencatat jurnal akuntansi.

Laporan SAK EP

Akses menu Reports untuk melihat laporan standar:

  • Neraca (Balance Sheet): Posisi aset, kewajiban, dan ekuitas.
  • Laba Rugi (Profit & Loss): Pendapatan vs Beban operasional.
  • Arus Kas (Cash Flow): Pergerakan uang masuk dan keluar.
  • Buku Besar (Ledger): Detail transaksi per akun COA.

Troubleshooting

Error: "License Invalid"

Pastikan domain Anda tidak berubah. Jika Anda memindahkan aplikasi ke domain baru, Anda harus meminta reset lisensi kepada kami.

Error: "500 Internal Server Error"

Cek file storage/logs/laravel.log. Biasanya disebabkan oleh permission folder yang salah atau ekstensi PHP yang belum aktif.

Hubungi Support

Jika Anda mengalami kendala yang tidak tercantum di sini, tim teknis kami siap membantu.