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, tabungan qurban — khas koperasi santri.

📢

Pengumuman Koperasi

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

📊

Skor Kredit Anggota

Skor A-D dari perilaku menabung & angsuran → plafon pinjaman otomatis.

🗳️

RAT Voting Online

Pilih pengurus lewat app — satu anggota satu suara, hasil real-time.

🎯

Target Menabung

Set target (mis. Qurban 2jt) — progres bar otomatis dari saldo.

📄

e-Statement PDF

Rekening koran bulanan dibuat di HP — share ke WA/email sekali tap.

🛡️

Limit Harian & Lockout

Batas transaksi per hari, PIN salah 3x terkunci, PIN transaksi terpisah.

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.

💵

Teller / Kasir

Setor & tarik tunai, transfer antar anggota, rekap kas harian + tutup kas.

📚

Buku Besar

Jurnal double-entry lengkap dengan saldo per akun & cek seimbang otomatis.

🧮

Kolektibilitas OJK

Grading portofolio pinjaman K1-K5 (Lancar s.d. Macet) otomatis dari tunggakan.

🔎

Audit Trail

Semua aksi admin tercatat otomatis — siapa, apa, kapan. Transparan untuk RAT.

🧩

Master Produk

Bikin produk simpanan/pinjaman sendiri dari UI — bunga flat/anuitas/declining.

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.9.0 — Bayar Tokopedia-style, transfer antar anggota, pinjaman online, sidik jari, skor kredit, RAT voting, e-Statement PDF, limit transaksi harian.
Instal: unduh → buka file → izinkan "instal dari sumber tidak dikenal" → selesai.

⬇️ Unduh APK (Terbaru)
Lihat semua versi →

Sumber kode privat (white-label) — APK didistribusikan langsung dari situs ini.

Coba Demo 🧪

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

🖥️ Web Admin (Pengurus)

URL: https://bus.ceritasuaraibu.my.id

EMAILadmin@bus.local
PASSWORDbus-admin-123
TELLER (DEMO)teller@bus.local / teller-bus-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.
  • Target Menabung: buat target (mis. Qurban Rp2jt) → progres bar otomatis dari saldo; selesai target → tanda tercapai 🎉
  • 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. Opsional: isi no. anggota penjamin (anggota aktif) — mempercepat approval.
  4. Kirim → status Menunggu Review → pengurus memproses (approve → cair).
  5. Setelah cair: jadwal angsuran muncul; bayar per angsuran dari saldo Sukarela. Angsuran jatuh tempo terbayar otomatis dari dompet bila saldo cukup.

A13. RAT — Voting Online

  1. Tab Koperasi → sub-tab RAT.
  2. Pilih agenda aktif → tap kandidat/pilihan → suara langsung tercatat.
  3. Satu anggota satu suara; setelah voting ditutup pengurus, hasil final tampil di app.

A14. Keamanan PIN

  • PIN login 3x salah → terkunci 15 menit (proteksi otomatis).
  • PIN transaksi bisa dibuat terpisah dari PIN login (menu Akun) — dipakai untuk transfer & pembayaran.
  • Sidik jari hanya untuk buka app — transaksi uang tetap minta PIN.

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.

A11b. e-Statement PDF & Limit Harian

  • Akun → e-Statement Bulanan: pilih bulan → ringkasan masuk/keluar → Bagikan PDF (dibuat di HP, bisa dikirim ke WA/email).
  • Transaksi transfer + pembayaran digabung maksimal Rp5.000.000/hari (bisa diatur pengurus) — melindungi dana anggota bila HP hilang.

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.

B7b. Teller — Kas Harian & Tutup Kas

  1. Menu Teller / Kasir: setor/penarikan tunai langsung + transfer antar anggota.
  2. Setiap hari, panel Kas Hari Ini menampilkan rekap tunai per teller.
  3. Klik Tutup Kas di akhir hari → snapshot permanen (rekonsiliasi & audit). Bisa diulang jika ada transaksi baru.

B7c. Kolektibilitas (OJK)

Menu Pinjaman → panel Kolektibilitas Portofolio: semua pinjaman aktif dinilai otomatis K1 (Lancar) s.d. K5 (Macet) berdasarkan hari tunggakan — standar pelaporan OJK, siap untuk RAT & pengawas.

B7d. Audit Log

Menu Pengaturan → Audit Log: semua aksi mutasi admin (siapa, aksi, path, detail, waktu) tercatat otomatis oleh sistem. Filter per path (mis. /savings). Bisa di-export untuk pemeriksa.

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.

B9. User & Role (Teller/Pengurus)

  1. Menu User & Role → isi email, nama, password (min 8), pilih role → Buat User.
  2. Role: admin (semua), pengurus (approval & laporan), teller (setor/tarik harian).

B10. RAT — Voting Online

  1. Menu RAT → buat agenda (judul, deskripsi, minimal 2 kandidat/opsi) → terbit.
  2. Agenda langsung muncul di app anggota (tab Koperasi → RAT) dengan nama kandidat.
  3. Hasil real-time di admin; Tutup Voting untuk finalisasi.

B11. Collection (Tunggakan)

Menu Pinjaman → panel Tunggakan & Collection (WA): daftar pinjaman jatuh tempo + tombol Kirim WA (template pesan siap). Menu Laporan → tombol Export CSV (neraca, laba rugi, tunggakan) untuk RAT & pemeriksa.

B12. Ganti Supplier Mock → Supplier Asli (Digiflazz)

  1. Daftar akun supplier (mis. Digiflazz) → siapkan API key + deposit saldo.
  2. Menu PPOB → Supplier → tambah provider baru (protocol json, isi URL + username + API key) → aktifkan.
  3. Menu Mapping → hubungkan tiap produk internal ke kode produk supplier + harga beli.
  4. Nonaktifkan provider MOCK. Uji dengan pembelian nominal kecil.
Semua konfigurasi via admin web — tanpa ubah kode. Selama masih MOCK, semua transaksi pembayaran otomatis sukses untuk keperluan demo.

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.