Dokumentasi Aplikasi Koperasi

📖 Pengantar

Aplikasi ini adalah software manajemen koperasi modern dengan dukungan dual-mode (Konvensional & Syariah) dalam satu platform. Cocok untuk:

• Koperasi Simpan Pinjam (KSP) — fokus simpanan & pinjaman
• Koperasi Serba Usaha (KSU) — multi unit (SP + Toko + Jasa)
• Koperasi Syariah (KSPPS) — 9 akad syariah lengkap
• Koperasi Pegawai (KPRI) — auto-debit gaji integrasi payroll
• Koperasi Karyawan (Kopkar) — internal perusahaan
• Koperasi Pondok Pesantren (Kopontren) — multi unit syariah

Aplikasi menjual source code — Anda dapat repository lengkap, deploy di server sendiri, dan modifikasi sesuka hati. Tidak ada SaaS subscription. Untuk pembelian: hubungi WhatsApp 0812-9605-2010.

🔑 Kredensial Default

Setelah php artisan migrate --seed dijalankan, berikut akun default untuk login pertama:

Role yang tersedia (Spatie Permission)

Role di-seed otomatis via RoleSeeder.php. Untuk assign role ke user lewat Filament: menu Users → Edit User → tab Roles.

⚙️ Instalasi

Prasyarat

• PHP 8.3 atau lebih baru (cek: php --version)
• Composer 2.7+ (composer --version)
• Node.js 18+ dan npm (untuk asset compilation)
• MySQL 8 / MariaDB 10.5+ atau PostgreSQL 14+
• Web server: Apache, Nginx, atau Laragon (Windows)

Langkah Instalasi

1. Extract source code ke folder web (mis. htdocs/koperasi atau /var/www/koperasi).
2. Buka terminal di folder tersebut, jalankan:

# 1. Install PHP dependencies
composer install --no-dev --optimize-autoloader

# 2. Install Node dependencies dan build asset
npm install
npm run build

# 3. Salin file environment
cp .env.example .env

# 4. Generate application key
php artisan key:generate

# 5. Edit .env — isi konfigurasi database
# DB_CONNECTION=mysql
# DB_HOST=127.0.0.1
# DB_DATABASE=koperasi
# DB_USERNAME=root
# DB_PASSWORD=

# 6. Buat database (lewat phpMyAdmin atau CLI)
mysql -u root -e "CREATE DATABASE koperasi CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

# 7. Run migration + seeder default
php artisan migrate --seed

# 8. Symlink storage (untuk upload file)
php artisan storage:link

# 9. Set permission folder storage & cache (Linux)
chmod -R 775 storage bootstrap/cache

# 10. Jalankan dev server
php artisan serve

Aplikasi sekarang accessible di http://localhost:8000. Login admin dengan kredensial di atas.

Deploy ke Production (Nginx)

server {
    listen 80;
    server_name koperasi.example.com;
    root /var/www/koperasi/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

Setelah deploy, jalankan optimasi:

php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan event:cache

🔓 Aktivasi License

Aplikasi menggunakan domain-locked license. Tanpa aktivasi, semua route (selain /__pair) akan di-redirect ke wizard aktivasi. Khusus localhost dan domain *.test, license check di-bypass otomatis (dev mode).

1. Setelah pembelian via WhatsApp 0812-9605-2010, Anda akan mendapat License Key dan Activation Code.
2. Buka https://yourdomain.com/__pair di browser.
3. Masukkan License Key dan Activation Code → klik Aktifkan.
4. Sistem akan validate ke server marketplace (whitelabel.co.id) dan generate storage/app/.license.lock.
5. Anda di-redirect ke /admin setelah aktivasi sukses.

Bypass Sementara untuk Development

Set di .env:

LICENSE_DEV_BYPASS=true
APP_ENV=local

Bypass hanya aktif untuk host localhost, 127.0.0.1, *.test, *.localhost. Banner peringatan akan muncul di setiap halaman.

Konfigurasi Heartbeat

Aplikasi melakukan heartbeat ke marketplace setiap 24 jam untuk verifikasi license aktif:

# config/license.php
'heartbeat_interval' => 86400,   // 24 jam
'heartbeat_grace'    => 604800,  // grace 7 hari saat marketplace unreachable

🎲 Seed Demo Data 100.000 Records

Untuk demo dan stress-testing, tersedia command artisan yang generate ~100.000 record dummy realistic dalam beberapa menit:

# Generate 100.000 records (default)
php artisan koperasi:seed-demo

# Custom size
php artisan koperasi:seed-demo --members=10000 --tx-per-member=15

# Reset semua data demo
php artisan koperasi:seed-demo --fresh

Distribusi Default

Perkiraan Waktu Eksekusi

• Local development (Laragon, MySQL): 3–5 menit
• VPS 1 vCPU 2GB RAM: 5–8 menit
• VPS 4 vCPU 8GB RAM: 1–2 menit

Seeder pakai batch insert (chunk 1000 records) supaya memori-efisien. Bisa di-interrupt kapan saja dengan Ctrl+C tanpa korup data.

Login Anggota Demo

Setelah seeder selesai, semua anggota demo punya password seragam anggota123. Login portal di /portal/login:

Email: anggota1@demo.local      → anggota#1
Email: anggota2@demo.local      → anggota#2
...
Email: anggota5000@demo.local   → anggota#5000

Password (semua): anggota123

🎓 Tutorial Pemakaian (10 Langkah)

Workflow lengkap dari pertama login sampai operasional harian. Ikuti urutan ini saat pertama setup.

⚡ Daftar Fitur Confirmed di Source Code

Daftar di bawah ini semuanya sudah dibangun di repository — diverify dengan grep manual ke file resource/model/controller:

Filament Resources (19 modul)

Custom Pages (2)

• LaporanKeuangan — Neraca, Laba-Rugi, Arus Kas dalam 1 page tab
• Pengaturan — Settings global koperasi

Dashboard Widgets (6)

• HeroBanner — Banner welcome dashboard
• StatsKoperasi — KPI cards (total anggota, simpanan, pinjaman aktif, kas)
• KolektabilitasChart — Chart kualitas pinjaman (Lancar/DPK/Macet)
• TrenSimpananChart — Tren simpanan 12 bulan
• AktivitasTerbaru — Feed transaksi real-time
• TopAnggotaTable — Top peminjam / penabung

Routes Public (luar Filament)

• GET / — Landing page (LandingController)
• GET /portal/login — Portal Anggota login
• GET /portal — Portal dashboard anggota
• GET /__pair — License activation wizard
• GET /sitemap.xml — Auto-generated sitemap (75+ URL)
• GET /robots.txt — Robots
• 7 pSEO routes — kota, jenis, akad, panduan, kalkulator, alternatif, compare

Models (32)

Anggota, AhliWaris, AnggotaStatusLog, Asset, Cabang, Coa, Jurnal, JurnalDetail, Karyawan, Kas, KasTransaksi, Pinjaman, PinjamanApproval, PinjamanJadwal, PinjamanJaminan, PinjamanPembayaran, ProdukPinjaman, ProdukSimpanan, Rat, Setting, ShuDistribusi, ShuPerhitungan, Simpanan, SimpananTransaksi, Tagihan, TagihanMaster, Tenant, TokoBarang, TokoPenjualan, TokoPenjualanDetail, UnitJasaOrder, UnitProdusenSetoran, User.

⚠️ Belum Termasuk (Tersedia sebagai Add-on)

Konfirmasi via WhatsApp untuk biaya custom add-on: 0812-9605-2010.

🛠️ Admin Panel

Filament Panel di /admin dengan navigation groups:

• Dashboard — 6 widgets KPI & analytics
• Anggota — Anggota, Ahli Waris
• Master Data — Tenant, Cabang, Produk Simpanan, Produk Pinjaman
• Transaksi — Simpanan (set, set, tarik), Pinjaman (ajukan, approval, cair, cicil)
• Akuntansi — COA, Jurnal, Kas, Laporan Keuangan (Page)
• Toko / Unit Usaha — Toko Barang, Penjualan, Unit Jasa, Unit Produsen
• Karyawan & Aset — Karyawan, Asset
• Akhir Tahun — RAT, SHU Perhitungan
• Sistem — User, Tagihan, Pengaturan

Navigation groups bisa di-customize lewat tiap Resource ($navigationGroup, $navigationSort).

📱 Portal Anggota

Antarmuka khusus untuk anggota koperasi (di luar admin Filament). Tidak butuh role admin — semua anggota auto-bisa login dengan akun yang dibuat saat registrasi.

URL Portal

• /portal/login — Login form
• /portal — Dashboard anggota (saldo simpanan, riwayat pinjaman)
• /laporan/neraca, /laporan/laba-rugi, /laporan/arus-kas — Laporan keuangan koperasi (auth required)

Yang Anggota Bisa Lakukan

• Lihat saldo Simpanan Pokok / Wajib / Sukarela / Berjangka
• Lihat riwayat transaksi setoran/penarikan
• Lihat pinjaman aktif: sisa pokok, sisa cicilan, tanggal jatuh tempo
• Download bukti setoran (PDF)
• Update profil (alamat, no HP, password)

🌐 pSEO Built-in (70+ Halaman SEO)

Aplikasi sudah include sistem Programmatic SEO yang otomatis generate halaman public untuk traffic dari Google. Data master ada di config/pseo.php:

Setiap halaman: JSON-LD schema, meta tags lengkap, 300+ kata konten unik, internal linking. Auto-registered di /sitemap.xml. Submit ke Google Search Console untuk indexing.

🚑 Troubleshooting

"Routes tidak ditemukan / 404 setelah deploy"

Clear semua cache route lalu rebuild:

php artisan optimize:clear
php artisan route:cache
php artisan config:cache

"Internal Server Error setelah composer install"

• Pastikan storage/ dan bootstrap/cache/ writable: chmod -R 775
• Pastikan APP_KEY ter-generate: php artisan key:generate
• Pastikan .env ada dan database connection benar
• Cek log: tail -f storage/logs/laravel.log

"Filament page blank putih"

• Run: php artisan filament:cache-components
• Run: php artisan icons:cache
• Compile asset: npm run build

"License pairing gagal — server unreachable"

• Pastikan server bisa akses https://whitelabel.co.id (firewall, DNS)
• Cek SSL cert: curl -I https://whitelabel.co.id
• Untuk dev: set LICENSE_DEV_BYPASS=true di .env

"Seeder demo OOM (out of memory)"

Naikkan PHP memory limit:

php -d memory_limit=512M artisan koperasi:seed-demo

Atau pakai --chunk=500 untuk mengurangi batch size.

❓ FAQ

💬 Kontak Pembelian & Support

Untuk pembelian source code, hubungi via WhatsApp di nomor di atas. Tim sales akan kirim:

• Penawaran resmi (PDF) dengan detail spesifikasi
• Demo akses (admin panel + portal anggota)
• Invoice pembayaran (transfer bank atau e-wallet)
• License Key + Activation Code (setelah pembayaran)
• Link download source code (ZIP / Git repository)