# Kalkulator Cashback SERUBI — Bank Papua

Simulasi Tabungan/Giro + cashback SERUBI dibandingkan deposito, dengan halaman admin untuk mengubah parameter. PHP native + MySQL.

- Kalkulator: `http://localhost/calcserubi/`
- Admin: `http://localhost/calcserubi/admin/` (saat pertama dibuka, Anda diminta membuat akun admin)

## Instalasi

1. Atur koneksi di `config.php` (default `127.0.0.1:3309`, user `root`, database `calcserubi`). Di server, nilai ini bisa diganti lewat environment variable `SERUBI_DB_HOST/PORT/NAME/USER/PASS`.
2. Buka aplikasinya. Database, tabel, dan parameter awal dari file Excel dibuat otomatis. Bisa juga lewat CLI: `php database/migrate.php`.
3. Buka `/admin/` dan buat akun admin pertama.

Perintah lain:

- `php database/migrate.php --reseed` mengembalikan semua parameter ke nilai Excel.
- `php database/migrate.php --dump-params` menampilkan parameter aktif dalam format JSON.

## Versi JS/CSS (update langsung terlihat di klien)

Semua file JS/CSS dimuat dengan `?v=<versi>-<waktu ubah file>` (lihat `asset()` di `includes/helpers.php`):

- Setiap file yang diunggah ulang ke server otomatis mendapat URL baru, sehingga browser langsung memuat versi terbaru.
- Halaman PHP dikirim dengan `Cache-Control: no-cache`, jadi selalu merujuk versi asset terbaru.
- Asset boleh di-cache lama (`.htaccess`) karena URL-nya selalu berubah saat ada update.
- Untuk menandai rilis, naikkan `'version'` di `config.php`. Versi juga tampil di `<meta name="app-version">`.

## Struktur

| Path | Isi |
|---|---|
| `assets/js/engine.js` | Rumus perhitungan (port dari sheet COB), dipakai kalkulator, preview admin, dan test |
| `index.php`, `assets/js/app.js` | Halaman kalkulator |
| `admin/` | Login, parameter bank, rate produk, rate deposito, porsi cashback, pengguna, riwayat |
| `includes/` | Koneksi DB, pemuatan parameter, auth, aksi admin |
| `database/` | `schema.sql`, `defaults.php` (nilai Excel), `migrate.php` |
| `tests/` | Validasi terhadap Excel, lihat `docs/VALIDASI.md` |

## Validasi

`node tests/validate.js` membandingkan engine (dengan parameter dari MySQL) terhadap 155 skenario yang dihitung oleh Excel. Hasil saat ini: 4.805/4.805 cocok. Detail ada di [docs/VALIDASI.md](docs/VALIDASI.md).

## Keamanan

Detail lengkap dan checklist server ada di [docs/SECURITY.md](docs/SECURITY.md). Wajib dikerjakan setelah deploy: HTTPS + `SERUBI_FORCE_HTTPS=1`, `ServerTokens Prod` dan `TraceEnable Off` di httpd.conf, user MySQL khusus (`php database/migrate.php --create-db-user`), dan PHP yang masih didukung.

Membuat admin pertama di server baru: `php database/migrate.php --create-admin`.