# Changelog — Kasir Unta Store

Catatan riwayat versi aplikasi, supaya versi lama & baru mudah dibandingkan.

## Skema penomoran versi
Project ini sebelumnya sudah informal memakai penomoran "V..." — terlihat dari judul-judul
bagian update di `README.md` (V4, V7, V9, V10, V33 ... V46) dan nama file build/zip yang
biasa dibuat (mis. `kasir-unta-store-app-v49.zip`). Mulai dari update ini, penomoran itu
**dilanjutkan** (bukan diganti skema baru) dan **ditampilkan langsung di aplikasi** (halaman
login web admin & aplikasi kasir), bukan cuma di nama file zip atau komentar README — supaya
versi yang benar-benar berjalan di server/HP tertentu selalu bisa dicek dan dibandingkan.

Aturan sederhana: **setiap kali ada perubahan/rilis baru ke server, naikkan satu angka.**
Tidak perlu format MAJOR.MINOR.PATCH — cukup angka urut seperti yang sudah biasa dipakai.

> Catatan: beberapa versi di antara V46 (terakhir didokumentasikan di README) dan v49 (nama
> zip yang jadi acuan update ini) tidak sempat tercatat detail perubahannya di README maupun
> di sini. Mulai **v50**, setiap versi akan selalu punya catatan di file ini.

## v50 - 2026-09-13 — Versioning resmi & Detail Member
### Ditambahkan
- Nomor versi aplikasi kini ditampilkan langsung di **halaman login web admin** dan
  **halaman login aplikasi kasir (PWA)** (sumber: `APP_VERSION` di `backend/config.php` &
  `kasir-pwa/js/app.js`, keduanya harus selalu disamakan tiap update).
- Halaman **Detail Member** baru di web admin (`admin/member_detail.php`), dibuka lewat
  tombol "Detail" di halaman Member. Menampilkan:
  - Ringkasan (jumlah transaksi, total belanja, sisa poin saat ini).
  - **Riwayat belanja** lengkap milik member tersebut.
  - **Riwayat aktivitas poin** (didapat & ditukar) lengkap dengan **poin awal**, **poin
    setelah** aktivitas, dan **deskripsi/keterangan** tiap aktivitas.
- Kolom `points_before` & `points_after` di tabel `member_point_mutations`
  (`database/migration_v18.sql`) untuk mendukung riwayat poin di atas.

### Catatan
- Riwayat poin yang tercatat **sebelum** migrasi v18 dijalankan tidak memiliki data poin
  awal/setelah (tampil "0"), karena data itu memang belum pernah disimpan sebelumnya. Semua
  aktivitas poin setelah migrasi ini akan tercatat lengkap.
- Wajib jalankan `database/migration_v18.sql` di database sebelum upload kode versi ini.

---

## Cara menambah entri versi baru (mulai dari v51 dst.)
Setiap kali membuat pembaruan aplikasi untuk dirilis ke server:
1. Naikkan satu angka: update isi file `VERSION` (satu baris angka saja, mis. `51`).
2. Update `define('APP_VERSION', '...')` di `backend/config.php` (dan `example.config.php`)
   ke angka yang sama.
3. Update `const APP_VERSION = '...'` di `kasir-pwa/js/app.js` ke angka yang sama.
4. Kalau ada file di `kasir-pwa/` yang berubah, naikkan juga `CACHE_NAME` & `RUNTIME_CACHE`
   di `kasir-pwa/service-worker.js` (lihat komentar di file itu) supaya HP kasir mengambil
   ulang versi terbaru.
5. Tambahkan entri baru di bagian atas file ini (di atas entri `v50`), isi tanggal &
   ringkasan perubahan.
6. Kalau perubahannya cukup besar, boleh juga ditambahkan sebagai bagian baru
   `## VXX - ...` di `README.md`, mengikuti gaya bagian-bagian sebelumnya.