Koperasi Sedia — Sistem Core Banking & Akuntansi Koperasi Simpan Pinjam Terpadu

Koperasi Sedia adalah platform perbankan dan manajemen keuangan terpadu (Core Banking System) berbasis web yang dirancang khusus untuk memodernisasi tata kelola Koperasi Simpan Pinjam (KSP) di Indonesia. Sistem ini menghubungkan tiga pihak utama koperasi—yaitu Pengurus / Komite Kredit (Super Admin), Petugas Kasir (Teller), dan Anggota Koperasi (Nasabah)—ke dalam satu ekosistem digital yang transparan, akuntabel, dan amanah.

Sistem ini bekerja layaknya sistem perbankan mini yang lengkap: anggota dapat memantau saldo 3 jenis rekening tabungan (Pokok, Wajib, Sukarela) secara real-time, mengajukan pinjaman dengan simulasi bunga yang transparan, serta mengunduh rekening koran resmi. Di sisi lain, petugas kasir dibekali terminal kasir cepat untuk melayani setoran tunai, penarikan, dan pembayaran cicilan dengan bukti kwitansi cetak otomatis. Sementara itu, jajaran pengurus memiliki kendali penuh atas neraca kas harian, alur persetujuan kredit (underwriting), laporan laba rugi berjalan (PHU), penagihan simpanan wajib massal, hingga pembagian Sisa Hasil Usaha (SHU) tahunan yang dihitung otomatis berdasarkan kontribusi riil masing-masing anggota.

Proyek ini berfokus pada keandalan logika matematika finansial perbankan (bunga flat dan anuitas menurun), integritas pembukuan kas (dual-control cash register), penerbitan otomatis dokumen legal resmi bersertifikat (Surat Perjanjian Kredit A4 2 halaman bermaterai dan berstempel dinas, Kwitansi Kasir A5, dan Rekening Koran), serta pengalaman pengguna yang elegan dengan identitas visual institusi keuangan terpercaya.

---

Ringkasan Proyek

• Kategori: Fintech, Core Banking Systems, Cooperative & Microfinance Management
• Peran: Full-Stack Web & Financial Systems Engineer (Solo Developer)
• Fokus Utama: Multi-role portal koperasi, otomasi perhitungan bunga pinjaman (Flat & Anuitas), alur persetujuan kredit bertingkat, rekonsiliasi kas register harian, penerbitan dokumen hukum otomatis (SPK, Kwitansi, Rekening Koran), ekspor Excel universal, dan distribusi SHU proporsional.
• Backend & Arsitektur: Next.js 16 (App Router, Server Actions murni), Clean Architecture (Domain, Application, Infrastructure, Presentation), Keamanan Session JWT dengan Proteksi Cookie HTTP-Only, Kontrol Akses Berbasis Peran (RBAC).
• Database & Integritas Finansial: PostgreSQL 16 (Docker Container), Prisma ORM, Skema Relasional Multi-Entitas ACID Compliant (Buku Kas, Rekening Simpanan, Jadwal Amortisasi Pinjaman, Audit Trail).
• Antarmuka Web (Frontend): React 19, Tailwind CSS, Phosphor Icons, Desain Bertema Lembaga Keuangan Modern (Palet Obsidian Charcoal #0A0A0A, Warm Gold, dan Lambang Resmi Melingkar Official Seal Crest).
• Engine Dokumen Legal & Ekspor: jsPDF Vektor Beresolusi Tinggi (Generasi Dokumen Resmi A4 & A5 dengan Logo Resmi Tersemat), Universal Spreadsheet Engine (CSV dengan UTF-8 BOM untuk Microsoft Excel & Google Sheets).

---

Latar Belakang & Motivasi

Koperasi Simpan Pinjam merupakan pilar penting dalam perputaran ekonomi masyarakat dan UMKM di Indonesia. Namun, sebagian besar koperasi skala menengah ke bawah masih dikelola menggunakan cara-cara lama yang manual, rawan manipulasi, dan lambat.

Sebelumnya, operasional koperasi tradisional sering menghadapi kendala berat di lapangan:

1. Pencatatan Buku Kas Manual Rawan Selisih & Manipulasi: Transaksi kasir masih sering dicatat di buku tulis fisik atau spreadsheet terpisah. Akibatnya, saat penutupan kas di sore hari sering ditemukan selisih uang tunai yang sulit dilacak siapa yang bertanggung jawab.
2. Ketiadaan Surat Perjanjian Kredit (SPK) yang Sah dan Lengkap: Sering kali pinjaman dicairkan hanya bermodalkan nota kwitansi sederhana tanpa akad perjanjian hukum tertulis. Jika terjadi kredit macet atau sengketa, koperasi tidak memiliki dasar hukum yang kuat untuk menagih.
3. Ketidakterbukaan Perhitungan Bunga & Denda: Anggota sering kali tidak memahami secara pasti bagaimana cicilan mereka dihitung, berapa porsi pokok vs bunga, dan berapa potongan yang seharusnya mereka dapatkan jika ingin melunasi pinjaman lebih awal (early payoff).
4. Proses Penagihan Simpanan Wajib yang Lambat & Melelahkan: Setiap awal bulan, pengurus harus merekap dan menagih simpanan wajib ratusan anggota satu per satu secara manual, yang memakan waktu berhari-hari.
5. Perdebatan Pembagian SHU pada Rapat Anggota Tahunan (RAT): Pembagian keuntungan koperasi (SHU) sering menimbulkan kecurigaan antar-anggota karena rumus pembagian tidak transparan dan penghitungannya rumit jika dilakukan secara manual.

Saya merancang dan membangun platform Koperasi Sedia untuk menyelesaikan seluruh permasalahan tersebut secara menyeluruh:

1. Digitalisasi Transaksi Kas Kasir Sekaligus Rekonsiliasi Harian: Setiap rupiah kas masuk dan keluar wajib melalui pencatatan sistem dengan verifikasi status buka/tutup kasir (Cash Register).
2. Otomasi Akad Pinjaman Resmi (SPK Legal): Setiap pinjaman yang disetujui otomatis menghasilkan dokumen hukum 2 halaman A4 berstandar perbankan, lengkap dengan pasal perjanjian, jadwal angsuran, kolom materai Rp 10.000, dan cap stempel dinas koperasi.
3. Transparansi Penuh untuk Anggota: Anggota dapat mengakses rekening koran kapan saja dari ponsel mereka, melihat rincian cicilan dengan metode bunga flat maupun anuitas, dan mengetahui simulasi pelunasan dipercepat secara adil.
4. Penagihan Massal Cepat (Mass Billing Payroll): Pengurus dapat mendebet atau menagihkan simpanan wajib seluruh anggota aktif hanya dengan satu kali klik secara aman.
5. Distribusi SHU Otomatis & Adil Sesuai Regulasi: Sistem menghitung pembagian keuntungan secara proporsional sesuai UU Perkoperasian No. 25/1992, membagi hak anggota secara presisi berdasarkan saldo tabungan dan keaktifan angsuran mereka.

---

Kontribusi Utama Saya

Arsitektur Multi-Peran dengan Pengamanan Akses Ketat (RBAC)

• Merancang alur pemisahan peran yang tegas antara Super Admin (Pengurus), Admin Teller (Kasir), dan Anggota. Setiap peran memiliki akses data dan antarmuka khusus yang terlindungi di level otentikasi server, mencegah kebocoran data antar-nasabah.
• Menerapkan sesi terenkripsi menggunakan HTTP-Only cookie, memastikan kredensial pengguna tidak dapat disusupi melalui celah skrip sisi peramban (XSS/CSRF).

Mesin Perhitungan Finansial Presisi (Flat & Anuitas Menurun)

• Membangun modul kalkulasi matematika keuangan murni yang independen untuk menghitung jadwal angsuran kredit secara akurat hingga nominal rupiah terkecil.
• Mengimplementasikan dua metode bunga standar perbankan:
  • Metode Bunga Flat: Beban bunga merata sepanjang tenor, sangat cocok untuk pembiayaan mikro dan barang konsumtif.
  • Metode Bunga Menurun / Anuitas: Beban bunga dihitung dari sisa pokok berjalan, menghasilkan cicilan bulanan yang adil bagi pembiayaan modal usaha.
• Mengembangkan fitur Pelunasan Dipercepat (Early Payoff) yang secara otomatis menghapus kewajiban bunga masa depan, memberikan insentif penghematan biaya bagi anggota yang melunasi pinjaman lebih awal.

Sistem Kas Register Harian & Mekanisme Pembatalan Transaksi Berjenjang (Dual-Control Void)

• Membangun alur operasional kasir terminal (Teller Cash Register) di mana kasir wajib membuka kas dengan mencatat saldo awal fisik di pagi hari dan melakukan rekonsiliasi fisik vs sistem di sore hari sebelum kas ditutup.
• Mencegah kecurangan atau manipulasi transaksi melalui sistem Dual-Control: jika teller melakukan kesalahan input nominal uang, transaksi tidak bisa langsung dihapus sembarangan, melainkan masuk ke status PENDING_VOID dan memerlukan persetujuan otorisasi resmi dari Super Admin untuk membatalkan mutasi kas.

Penerbitan Otomatis Dokumen Hukum Berstandar Resmi (PDF Vektor)

• Mengintegrasikan mesin pembuat dokumen PDF vektor murni beresolusi tajam tanpa penurunan kualitas grafis saat dicetak:
  • Surat Perjanjian Kredit (SPK / Akad Pinjaman 2 Halaman A4): Memuat kop surat resmi berlogo, identitas para pihak, klausul hak & kewajiban hukum, tabel jadwal angsuran, kotak materai resmi, serta stempel dinas KSP Sedia.
  • Slip Kwitansi Kasir A5 Landscape: Bukti transaksi penyetoran dan penarikan kasir lengkap dengan stempel digital hijau "TERVALIDASI SISTEM", kode unik otorisasi kasir, dan tanda tangan petugas.
  • Rekening Koran Anggota A4 Portrait: Salinan mutasi historis rekening simpanan anggota yang siap dicetak sebagai lampiran administrasi formal.

Penagihan Simpanan Wajib Massal (Mass Billing Payroll Deduction)

• Membangun modul pemotongan simpanan wajib kolektif yang mengeksekusi pendebetan dana seluruh anggota aktif sekaligus secara atomik menggunakan transaksi database ACID (prisma.$transaction). Jika terjadi satu kegagalan jaringan di tengah jalan, seluruh data otomatis di-rollback sehingga tidak ada saldo anggota yang terpotong ganda.

Mesin Distribusi SHU Komprehensif Sesuai Anggaran Dasar Koperasi

• Membangun algoritma pembagian laba bersih koperasi (Sisa Hasil Usaha) tahunan yang mengalokasikan persentase dana cadangan, dana pengurus, dana pendidikan, dan dana sosial.
• Menghitung pembagian SHU bagian anggota secara objektif melalui kombinasi proporsional:
  • Jasa Modal: Berdasarkan rata-rata simpanan anggota terhadap total modal koperasi.
  • Jasa Usaha / Anggota: Berdasarkan akumulasi kontribusi bunga angsuran yang telah dibayarkan anggota kepada koperasi.

Optimalisasi Kueri Paralel Berkecepatan Tinggi

• Mengoptimalkan waktu respons aplikasi dari yang sebelumnya lambat akibat kueri database berurutan menjadi sangat cepat menggunakan eksekusi paralel Promise.all. Data kas harian, transaksi, dan saldo kini termuat seketika dalam waktu di bawah 300 milidetik.

---

Fitur Produk Inti

1. Portal Keanggotaan Mandiri (Self-Service Member Portal)

• Dashboard pribadi anggota untuk memantau saldo 3 jenis simpanan (Pokok, Wajib, Sukarela) secara terpisah.
• Riwayat mutasi setor dan tarik dana transparan yang diperbarui secara langsung.
• Akses cepat untuk mengunduh dan mencetak Rekening Koran resmi kapan saja.

2. Fasilitas Pinjaman & Simulasi Angsuran Transparan

• Kalkulator pinjaman interaktif di halaman depan yang dapat dicoba siapa saja untuk menghitung simulasi cicilan bulanan.
• Formulir pengajuan pinjaman online mandiri oleh anggota dengan pilihan metode bunga (Flat atau Anuitas) dan tenor pinjaman.
• Kartu pemantauan pinjaman aktif dengan indikator progres pembayaran, sisa pokok hutang, tanggal jatuh tempo, dan tombol cetak SPK akad pinjaman.

3. Terminal Kasir Operasional (Teller Front-Office POS)

• Layanan cepat setoran tunai, penarikan simpanan, dan pembayaran cicilan angsuran dengan validasi nomor rekening instan.
• Otomasi deteksi keterlambatan jatuh tempo dan perhitungan denda harian secara presisi.
• Penerbitan bukti kwitansi transaksi instan dalam dua pilihan format: Kwitansi Resmi A5 (untuk arsip nasabah) atau Struk Termal Kasir 58/80mm (untuk mesin cetak struk mini).

4. Panel Pengurus & Buku Kas Keuangan (Super Admin Back-Office)

• Ringkasan Neraca Keuangan koperasi secara real-time: Total Kas Tunai, Total Simpanan Terhimpun, Total Pinjaman Beredar di Anggota, dan Laba Berjalan.
• Laporan Laba Rugi Komprehensif (PHU Statement): Menyajikan rincian pendapatan operasional (bunga pinjaman, denda, administrasi), beban operasional kasir, serta rasio efisiensi BOPO.
• Rekonsiliasi harian kas fisik kasir vs catatan sistem dengan peringatan otomatis jika terjadi selisih uang tunai.
• Alur Underwriting Pinjaman: komite dapat meninjau, menyetujui dengan penyesuaian plafon, atau menolak pengajuan kredit baru.

5. Alat Ekspor Finansial Universal (Excel / CSV)

• Fitur ekspor satu klik untuk Buku Kas Harian, Rekapitulasi Daftar Anggota, dan Portofolio Pinjaman ke dalam file spreadsheet yang kompatibel 100% dengan Microsoft Excel dan Google Sheets tanpa masalah karakter berantakan (UTF-8 BOM Protection).

---

Teknologi & Arsitektur Sistem (Tech Stack)

Koperasi Sedia dibangun menggunakan tumpukan teknologi modern dengan prinsip keamanan data tinggi, stabilitas perbankan, dan skalabilitas jangka panjang:

• Framework Web & API: Next.js 16 (React 19, Server Actions, App Router Architecture)
• Bahasa Pemrograman: TypeScript (Keamanan tipe data 100% dari database hingga tampilan)
• Database & Data Relasional: PostgreSQL 16 (Containerized via Docker Compose), Prisma ORM
• Keamanan & Otorisasi: JWT Session dengan HttpOnly Secure Cookies, Bcrypt Password Hashing, Role-Based Route Guards
• Desain & Antarmuka: Tailwind CSS, Phosphor Icons, Font Playfair Display & Inter
• Pembuatan Dokumen Legal: jsPDF (Penyusunan tata letak dokumen vektor murni A4 & A5)
• Ekspor Dokumen: Custom CSV Engine dengan proteksi Byte Order Mark (\uFEFF)
• Pengujian & Kualitas: Node.js Test Runner Terintegrasi (Unit Testing Rumus Bunga, Denda, dan SHU)

---

Tantangan Nyata & Solusi yang Diterapkan

1. Menghindari Selisih Pembulatan Rupiah pada Angsuran Bunga Anuitas

• Tantangan: Rumus matematika anuitas perbankan menggunakan eksponensial yang menghasilkan angka desimal pecahan. Jika dibulatkan sembarangan di tiap bulan, akumulasi total pembayaran cicilan di akhir tenor bisa berselisih beberapa rupiah dari total kewajiban pinjaman yang disepakati.
• Solusi: Saya merancang modul perhitungan dengan mekanisme penyesuaian otomatis di angsuran bulan terakhir (final schedule rounding adjustment). Sistem memastikan bahwa penjumlahan seluruh baris angsuran pokok persis sama dengan plafon yang dicairkan hingga angka satu rupiah terakhir.

2. Mencegah Kecurangan Kasir Melalui Pembatalan Transaksi Sembarangan

• Tantangan: Di dunia kasir fisik, teller terkadang salah mengetik nominal setoran. Namun, jika kasir diberi wewenang menghapus atau mengedit transaksi secara bebas, celah ini dapat disalahgunakan untuk penggelapan uang kas.
• Solusi: Saya menerapkan pola tata kelola Dual-Control. Petugas kasir hanya memiliki hak mengajukan permohonan pembatalan (Request Void) disertai alasan tertulis. Transaksi kemudian dibekukan berstatus PENDING_VOID. Uang kas baru disesuaikan setelah Super Admin memeriksa fisik bukti setor dan memberikan persetujuan resmi. Seluruh jejak audit terekam permanen di tabel audit log.

3. Kompatibilitas Format Dokumen Ekspor di Microsoft Excel

• Tantangan: Sering kali file CSV yang diekspor dari aplikasi web memunculkan karakter tanda tanya yang aneh di Microsoft Excel Windows, dan nomor NIK atau nomor rekening yang diawali angka nol (0) otomatis terpotong atau berubah menjadi notasi ilmiah (misal: 3.27E+15).
• Solusi: Saya menyematkan karakter Byte Order Mark UTF-8 (\uFEFF) di awal aliran data file dan menambahkan pembungkus tanda kutip teks khusus pada kolom identitas penting. Hasilnya, file ekspor langsung terbuka rapi di Excel versi apa pun tanpa perlu pengaturan impor manual.

---

Nilai Bisnis & Pembelajaran Kunci

• Penerapan Standar Tata Kelola Lembaga Keuangan Riil: Memperdalam pemahaman tentang bagaimana sistem perbankan mikro dan koperasi simpan pinjam beroperasi di dunia nyata, mulai dari manajemen likuiditas kas, pengawasan risiko kredit macet, hingga akuntabilitas hukum dokumen akad.
• Kekuatan Dokumen Legal Digital: Menyadari bahwa aplikasi finansial yang bernilai tinggi bukan hanya menampilkan angka di layar kaca, melainkan mampu memproduksi dokumen hukum fisik yang sah dan diakui secara legal di mata hukum perkoperasian.
• Pentingnya Keamanan Berlapis (Defensive Programming): Mengasah keahlian membangun sistem finansial yang defensif—memastikan setiap mutasi kas memiliki pencatatan ganda (double-entry bookkeeping audit), eksekusi atomik database, serta kontrol otorisasi yang ketat.