KASIR THE MALAYA - PAKET HOSTING
================================

Isi paket
  index.html   halaman kasir
  api.php      server: login dan penyimpanan data bersama
  data/        dibuat otomatis saat pertama dibuka (jangan dihapus)

Kalau sudah pernah dipasang (update)
  Unggah index.html DAN api.php yang baru, timpa yang lama. Jangan hapus folder data.
  Data lama tetap aman, rekap harian dihitung otomatis dari transaksi yang sudah ada.

Fitur baru
  - Riwayat: total tunai, QRIS, dan gabungan per hari, minggu, dan bulan.
  - Stok: tabel Nama Barang, Satuan, Stok Awal, Stok Penyesuaian, Stok Akhir.
    Ketik hasil hitungan di Stok Akhir atau pakai tombol - dan +, lalu Simpan.
  - Tombol Edit di Riwayat: ubah nama pembeli, catatan, tunai/QRIS, harga, tambah/kurangi/hapus
    barang, atau hapus transaksi. Total dan stok ikut dikoreksi otomatis.
  - Tombol "Kasir: ..." di bagian atas: pilih atau tambah nama kasir yang bertugas.
    Nama kasir tercetak di struk dan tercatat di tiap pesanan.
  - Struk dapur dibuat lebih kecil dan rapi (pita judul, kotak centang, kotak catatan).
  - Tombol "Pesanan sudah dikirim" di Belum Bayar dan Riwayat.

Cara pasang
  1. Buka File Manager cPanel (atau FTP), masuk ke public_html.
  2. Buat folder baru, misalnya "kasir".
  3. Unggah index.html dan api.php ke folder itu.
  4. Buka https://namadomain.com/kasir/ di HP atau komputer.
  5. Masuk dengan:
       Nama pengguna : malaya
       Kata sandi    : themalaya

Syarat
  - Hosting memakai PHP 7.4 atau lebih baru (hampir semua hosting sudah).
  - Alamat harus HTTPS. Cetak Bluetooth di Chrome hanya jalan di HTTPS.
  - Folder kasir harus bisa ditulis oleh PHP (izin 755), supaya folder data bisa dibuat.

Cara kerja sinkron
  - Semua HP yang masuk dengan akun malaya memakai data yang sama di server.
  - Barang baru, stok masuk, pesanan ditahan, dan pembayaran tampil di HP lain
    dalam sekitar 4 detik, tanpa muat ulang.
  - Login diingat 30 hari di tiap HP. Tombol "Keluar dari akun" ada di
    Pengaturan (ikon printer di pojok atas).
  - Salah kata sandi 6 kali berturut-turut mengunci login 15 menit.

Mengganti kata sandi
  1. Buat kode sandi baru dengan menjalankan perintah ini di komputer yang punya PHP,
     atau minta Claude membuatkan:
       php -r "echo password_hash('SANDI_BARU', PASSWORD_DEFAULT);"
  2. Buka api.php, ganti isi APP_PASS_HASH dengan kode yang dihasilkan.

Cadangan data
  Salin folder data (terutama data/store.php). Transaksi lunas yang lebih dari
  90 hari dipindah ke data/archive.php, tidak dihapus.

Keamanan folder data
  Folder data berisi file .htaccess yang menolak akses dari web, dan file data
  diawali kode "exit" sehingga tidak bisa dibaca lewat browser. Kalau hosting
  memakai Nginx (bukan Apache), minta penyedia hosting menolak akses ke /kasir/data/.
