CORE KOPERASI DIGITAL • PLUG & PLAY • WHITE-LABEL

Koperasi Modern dalam
Satu App & Satu Core

Simpan pinjam, transfer antar anggota, pulsa & semua pembayaran tagihan, SHU otomatis, laporan keuangan — app Android untuk anggota, web untuk pengurus, self-host di server koperasi sendiri.

📱 Unduh APK Anggota 🖥️ Coba Demo Admin 📘 Manual Book

Untuk Anggota 🤝

Satu aplikasi untuk semua urusan keuangan di koperasi — tanpa antre ke kantor.

💰

Dompet Simpanan Sukarela

Saldo dompet selalu di depan, bisa disembunyikan. Setor/tarik cukup ajukan lewat app.

🔁

Transfer Antar Anggota

Cari no. anggota, nama terverifikasi, konfirmasi PIN, uang pindah seketika.

📶

Pulsa & Paket Data

Operator terdeteksi otomatis dari nomor HP. Nominal tinggal pilih.

⚡

Token PLN & Tagihan

Token listrik, BPJS, PDAM, IndiHome, telepon, gas, cicilan — SN tersimpan di riwayat.

🏦

Pinjaman Online

Simulasi angsuran, ajukan dari app, pantau status sampai cair & lunas.

🏆

SHU Saya

Sisa Hasil Usaha tahunan masuk otomatis ke simpanan — transparan di app.

🪪

Kartu Anggota QR

Tunjukkan QR ke teller — tanpa perlu bawa kartu fisik.

👉

Login Sidik Jari

Buka cepat dengan biometrik + PIN transaksi terpisah untuk keamanan dana.

🤲

Zakat, Donasi & Qurban

Zakat/infaq, donasi santri, tabungan qurban — khas koperasi santri.

📢

Pengumuman Koperasi

Info RAT, promo, jadwal layanan — langsung muncul di Beranda.

Untuk Pengurus 🖥️

Web admin lengkap untuk operasional koperasi harian — dari kasir sampai laporan RAT.

📊

Dashboard

KPI simpanan, pinjaman berjalan, tunggakan, transaksi PPOB & margin.

👥

Manajemen Anggota

Daftar anggota, register, atur/reset PIN, status keanggotaan.

🧾

Antrean Setor/Tarik

Anggota ajukan via app → pengurus setujui → jurnal & saldo otomatis.

📑

Approval Pinjaman

Pengajuan dari app masuk antrean: review → approve → cairkan → angsuran.

📡

PPOB & Supplier

Katalog produk, mapping supplier multi-provider, harga auto-sync, monitor transaksi + SN + recheck.

📚

Laporan Keuangan

Neraca & laba rugi real-time dari ledger double-entry — bukan spreadsheet.

🏆

SHU Otomatis

Tutup buku tahunan → bagi hasil proporsional sesuai simpanan anggota.

📢

Pengumuman

Terbitkan banner ke app seluruh anggota sekali klik.

Teknologi di Baliknya 🛡️

Dibangun dengan standar core banking — bukan aplikasi kasir biasa.

⚖️

Ledger Double-Entry

Setiap rupiah lewat jurnal. Tidak ada ubah saldo langsung. Audit-ready.

🔁

Idempotent by Design

Transaksi aman dari retry/double-send — standar sistem pembayaran.

🏠

Self-Host

Satu docker compose up di server/VPS koperasi. Data milik koperasi.

🌐

Tanpa IP Publik

Terhubung via Cloudflare Tunnel (outbound-only) — aman di belakang NAT.

🏢

Multi-Koperasi

Satu instalasi bisa melayani banyak koperasi — siap white-label.

🧩

Adapter Terbuka

Supplier PPOB, payment gateway, notifikasi — semua lewat interface.

DOWNLOAD

📱 APK App Anggota — Android

Link berikut selalu menunjuk rilis terbaru. Versi sekarang: v0.5.0 (Bayar Tokopedia-style, transfer, pinjaman online, sidik jari).
Instal: unduh → buka file → izinkan "instal dari sumber tidak dikenal" → selesai.

⬇️ Unduh APK (Terbaru)
Lihat semua versi →

Link sementara menuju GitHub Releases — akan dipindah ke domain sendiri setelah koperasi mulai beroperasi.

Coba Demo 🧪

Server demo aktif. URL bersifat sementara (quick tunnel) — bisa berubah sewaktu-waktu.

🖥️ Web Admin (Pengurus)

URL: https://quit-aspect-realistic-fork.trycloudflare.com

EMAILadmin@bus.local
PASSWORDbus-admin-123

📱 App Anggota (APK di atas)

NO. ANGGOTABUS-0001
PIN123456
⚠️ Server demo = data contoh. Jangan masukkan data asli. Untuk instalasi koperasi sendiri, lihat Manual Book bagian C.

📘 Manual Book

Panduan lengkap: app anggota, admin web, dan pemasangan koperasi.

A. Manual App Anggotainstall, login, semua menu B. Manual Web Adminoperasional koperasi harian C. Manual Pemasangandeploy koperasi sendiri D. FAQ & Troubleshootingmasalah umum & solusi

A. Manual App Anggota (Android)

A1. Instalasi

  1. Unduh APK dari tombol Unduh APK di atas (butuh internet).
  2. Buka file APK → bila muncul "diblokir", pilih Pengaturan → Izinkan dari sumber ini.
  3. Tap Instal → buka app BUS Anggota.
  4. Persyaratan: Android 6.0+ (minSdk 23), koneksi internet.

A2. Login Pertama

  1. Masukkan No. Anggota (contoh: BUS-0001) dan PIN dari pengurus.
  2. Belum punya PIN? Minta pengurus mengaturnya lewat web admin (Bagian B2).
  3. Setelah login sukses, muncul tawaran Buka Cepat dengan Sidik Jari — aktifkan agar berikutnya tak perlu ketik PIN.
  4. Sesi berlaku 24 jam; setelah itu login ulang.

A3. Beranda

  • Kartu dompet: saldo Simpanan Sukarela. Ikon mata 👁 untuk sembunyikan saldo.
  • Grid aksi cepat: Transfer, Pulsa, Paket Data, Token PLN, E-Wallet, BPJS, Pinjaman, Lainnya.
  • Koperasi: ringkasan total simpanan & pinjaman aktif.
  • Transaksi terakhir + banner pengumuman koperasi.
  • Tarik ke bawah untuk refresh.

A4. Transfer Antar Anggota

  1. Beranda → Transfer.
  2. Ketik no. anggota tujuan → Cari → pastikan nama penerima muncul (jangan kirim bila nama tidak sesuai).
  3. Isi nominal & catatan → ketik PIN (PIN transaksi bila sudah diatur) → Kirim.
  4. Layar sukses muncul = dana sudah masuk ke simpanan penerima, cek di Riwayat.
Transfer hanya antar sesama anggota koperasi, dipotong dari saldo Simpanan Sukarela.

A5. Bayar — Top Up (Pulsa, Data, Token PLN, E-Money, Game)

  1. Tab Bayar → seksi TOP UP → pilih produk.
  2. Ketik nomor HP (pulsa/data: logo operator muncul otomatis) atau no. meter/ID.
  3. Pilih nominal dari grid harga → Lanjutkan.
  4. Cek rincian (produk, tujuan, harga) → ketik PIN → Bayar Sekarang.
  5. Untuk Token PLN: SN 20 digit muncul di layar hasil & tersimpan di Riwayat — salin ke meter listrik.

A6. Bayar — Tagihan (PLN Pascabayar, BPJS, PDAM, dll)

  1. Tab Bayar → seksi TAGIHAN → pilih jenis tagihan.
  2. Masukkan ID pelanggan sesuai tagihan → pilih biaya layanan → PIN → bayar.
  3. Nilai tagihan akhir dikonfirmasi pengurus saat diproses (butuh supplier pascabayar aktif).

A7. Zakat, Infaq & Donasi

Tab Bayar → TAGIHAN → Zakat & Infaq / Donasi → pilih paket → isi no. HP (untuk bukti) → PIN → kirim. Bukti masuk di Riwayat.

A8. Riwayat

  • Semua transaksi gabungan: simpanan, transfer, PPOB, SHU — urut terbaru.
  • Filter chip: Semua / Transfer / Simpanan / PPOB.
  • Tap transaksi → detail + SN/token (bisa dicopy).

A9. Koperasi — Simpanan

  • Saldo per produk: Pokok, Wajib, Sukarela (dompet), Qurban, dll.
  • Ajukan Setor/Tarik: pilih jenis (setor/tarik), produk, nominal → kirim → menunggu persetujuan pengurus → status berubah (disetujui = saldo berubah).
  • SHU Saya: total Sisa Hasil Usaha yang pernah diterima.
  • Mutasi terakhir: 10 transaksi simpanan terbaru.

A10. Koperasi — Pinjaman

  1. Tab Koperasi → sub-tab Pinjaman → Ajukan Pinjaman Baru.
  2. Pilih produk pinjaman → isi nominal → lihat simulasi angsuran/bulan otomatis.
  3. Kirim → status Menunggu Review → pengurus memproses (approve → cair).
  4. Setelah cair: jadwal angsuran muncul; bayar per angsuran dari saldo Sukarela.
Tips: ajukan setor ke dompet dulu supaya saldo cukup untuk angsuran. Dengan autodebet aktif, angsuran jatuh tempo terbayar otomatis dari dompet.

A11. Akun

  • Kartu anggota QR: tunjukkan ke teller.
  • Ganti PIN: PIN lama → PIN baru (4–12 digit).
  • Atur PIN Transaksi: PIN khusus transfer/pembayaran, terpisah dari PIN login.
  • Ajak Teman: kode referral = no. anggotamu, sebutkan saat mendaftar.
  • Keluar: hapus sesi di perangkat ini.

A12. Lupa PIN / Ganti HP

Hubungi pengurus untuk reset PIN (Bagian B2). Sidik jari otomatis nonaktif setelah reset — login dengan PIN baru, aktifkan ulang bila perlu.

B. Manual Web Admin (Pengurus)

B1. Login

Buka URL admin koperasi (contoh demo di atas) → login dengan email & password admin (bawaan pemasangan: admin@bus.local / bus-admin-123 — segera ganti di produksi via env SEED_ADMIN_PASSWORD).

B2. Anggota

  1. Daftar anggota: cari, lihat detail (simpanan, pinjaman, transaksi).
  2. Register anggota baru: isi data → sistem membuat no. anggota (BUS-0002, dst.).
  3. Atur PIN: dari detail anggota → set PIN awal / reset PIN untuk anggota lupa.

B3. Pinjaman

  1. Antrean: pengajuan dari app berstatus draft (Menunggu Review).
  2. Review simulasi → Approve (pinjaman disetujui) atau Tolak.
  3. Cairkan (disburse) → status aktif, jadwal angsuran terbentuk.
  4. Pembayaran angsuran masuk dari app (potong dompet) atau dicatat manual.
  5. Laporan tunggakan/arrears untuk follow-up.

B4. Simpanan — Antrean Tiket Setor/Tarik

  1. Menu Simpanan → tab Tiket Setor/Tarik.
  2. Pengajuan dari app muncul di daftar (badge jumlah menunggu).
  3. Setujui = setor/tarik dieksekusi: uang fisik diurus di kas, jurnal & saldo otomatis. Tolak = pengajuan ditutup.
Pastikan uang fisik sudah diterima/diserahkan SEBELUM menekan Setujui.

B5. Simpanan — Pengumuman

Tab Pengumuman → tulis judul & isi → Terbitkan → muncul di Beranda seluruh anggota. Nonaktifkan untuk menyembunyikan.

B6. PPOB / Pulsa

  • Produk: katalog internal — tambah/edit produk (SKU, kategori, harga jual). Kategori: pulsa, data, pln, emoney, game, bpjs, pdam, zakat, donasi, dll.
  • Supplier: daftarkan supplier (Digiflazz dll) + API key → aktifkan.
  • Mapping: hubungkan produk internal ↔ kode produk supplier + harga beli → routing otomatis (termurah/prioritas/round-robin + fallback).
  • Sync harga: tarik daftar harga terbaru dari supplier (juga otomatis tiap interval job).
  • Transaksi: monitor semua transaksi — status, SN/ref, error, dan tombol Recheck untuk transaksi pending/gagal.
Produk tampil di app meski supplier belum terpasang, namun pembelian baru SUKSES setelah supplier aktif. Ini urutan: daftar produk → pasang supplier → mapping → test beli kecil.

B7. Laporan

  • Neraca: posisi keuangan (aset = kewajiban + ekuitas) per tanggal.
  • Laba Rugi: pendapatan bunga, margin PPOB, beban — per periode.
  • Angka real-time dari ledger; siap untuk RAT dan pemeriksaan.

B8. SHU (Tutup Buku Tahunan)

  1. Buat periode tahun (mis. 2026) → atur alokasi (mis. 60% anggota).
  2. Approve periode → Distribute → SHU dibagi proporsional simpanan anggota → masuk simpanan tiap anggota → muncul di "SHU Saya" app.

C. Manual Pemasangan (Deploy Koperasi Sendiri)

C1. Kebutuhan Server

KomponenMinimum
VPS / server2 vCPU, 2 GB RAM, 20 GB disk (Ubuntu 22.04+)
SoftwareDocker + Docker Compose
JaringanAkses internet outbound (tidak perlu IP publik)
Domain (produksi)Opsional — via Cloudflare Tunnel named + domain sendiri

C2. Langkah Pemasangan

  1. Clone repo: git clone https://github.com/autokeren/bus-core.git && cd bus-core/deploy
  2. Set env wajib: JWT_SECRET (acak panjang), SEED_ADMIN_PASSWORD, SEED_ADMIN_EMAIL, SEED_ORG_NAME (nama koperasi).
  3. Opsional: AUTODEBET_ENABLED=1 (autodebet angsuran dari dompet anggota).
  4. Jalankan: docker compose up -d — sistem otomatis: migrate DB → seed akun, produk, coa → start API + admin web.
  5. Uji: curl http://localhost:8080/api/v1/health dan buka web admin.

C3. Ekspos ke Internet (Cloudflare Tunnel)

  1. Buat tunnel di Cloudflare Zero Trust → salin token.
  2. Isikan TUNNEL_TOKEN (file .env) → docker compose --profile tunnel up -d.
  3. Pointkan hostname publik → service bus:8080.
  4. Build APK dengan base URL sendiri: flutter build apk --dart-define=API_BASE_URL=https://domain-koperasi.example (atau set var APP_API_BASE_URL di repo untuk CI).
Demo saat ini memakai quick tunnel (URL acak, bisa berubah). Produksi wajib named tunnel + domain sendiri.

C4. Operasional Harian

  • Backup: docker exec deploy-db-1 pg_dump -U bus bus > backup-$(date +%F).sql — jadwalkan harian, uji restore berkala.
  • Update versi: git pull && docker compose build && docker compose up -d (migrate jalan otomatis).
  • Log: docker logs -f bus-api.
  • Job otomatis: recheck transaksi pending & sync harga supplier tiap JOB_INTERVAL (default 5m).

C5. Checklist Go-Live

  1. Ganti JWT_SECRET & password admin.
  2. Domain sendiri + tunnel named.
  3. Akun supplier PPOB (Digiflazz dkk) + deposit saldo + mapping produk.
  4. Backup otomatis terpasang & teruji.
  5. APK produksi dibangun dengan base URL domain koperasi.
  6. Training pengurus (Bagian B) & sosialisasi anggota (Bagian A).

D. FAQ & Troubleshooting

Q1. Produk pulsa muncul di app tapi pembayaran gagal/menggantung?

Belum ada supplier aktif. Daftar akun supplier (mis. Digiflazz), isi API key di menu PPOB → Supplier, mapping produk, lalu test nominal kecil. Transaksi pending akan dicek ulang otomatis oleh job.

Q2. Lupa PIN app?

Minta pengurus reset PIN lewat web admin (Anggota → detail → Atur PIN). Login ulang dengan PIN baru.

Q3. Saldo dompet berkurang tapi pembayaran belum sukses?

Dana ditahan (hold) selama transaksi pending. Bila supplier konfirmasi gagal, dana dikembalikan otomatis. Cek status di Riwayat; bila stuck > 1 jam, minta pengurus tekan Recheck di PPOB → Transaksi.

Q4. Transfer berkata "anggota tidak ditemukan"?

Pastikan no. anggota benar (format BUS-0001) dan penerima berstatus aktif. Transfer hanya antar anggota koperasi yang sama.

Q5. Setoran dari app belum masuk saldo?

Pengajuan setor/tarik harus disetujui pengurus dulu (menu Simpanan → Tiket). Status pengajuan terlihat di app.

Q6. App tidak bisa connect ("tidak bisa terhubung ke server")?

Periksa internet; bila server koperasi pindah URL, APK lama tidak akan tersambung — minta APK terbaru dari pengurus (dibangun dengan base URL baru).

Q7. Apakah bisa dipakai banyak koperasi?

Bisa. Mode multi-org tersedia di core; white-label (logo, nama, domain) per koperasi. Hubungi tim untuk setup.

Q8. Data aman?

Data 100% milik koperasi (self-host). PIN disimpan sebagai hash (tidak reversible), semua mutasi uang lewat jurnal double-entry + idempotency key. Tetap wajib: HTTPS (tunnel), backup rutin, password admin kuat.