APLIKASI MANAJEMEN KOST v1.3.1
==============================

YANG BARU DI v1.3.1 (keamanan lisensi)
- Kode lisensi DEMO lama yang ikut tersebar di data contoh tidak berlaku lagi. Data contoh kini tanpa
  lisensi dan berjalan dalam masa coba. Pelanggan yang sudah membeli tidak terpengaruh.
Data disimpan di komputer ini saja (folder "data"), tidak dikirim ke internet
(kecuali bila modul Cadangan Google Drive diaktifkan: cadangan dikirim ke Google Drive milik Anda sendiri).

CARA MEMASANG (sekali saja, di komputer pengelola yang jadi pusat)
1. Salin folder "AplikasiKost" ini ke komputer, misalnya ke D:\AplikasiKost.
2. Klik dua kali AplikasiKost.exe.
   - Jika Windows menampilkan "Windows protected your PC", klik "More info" lalu "Run anyway".
   - Jika Windows Firewall bertanya, centang "Private networks" lalu klik "Allow access".
     Tanpa ini, HP penjaga kost tidak bisa membuka aplikasinya.
3. Browser terbuka otomatis. Isi nama kost dan buat akun admin.
4. Buka menu Pengaturan: isi profil kost, tipe kamar + tarif + deposit, biaya tambahan
   (WiFi, parkir, laundry), aturan denda, tata tertib, lalu tambah akun petugas/penjaga.
5. Buka menu Kamar: "Tambah banyak kamar" (misalnya A1 sampai A10 sekaligus).
6. Masukkan penghuni lewat "Check-in penghuni baru" atau "Impor dari Excel".
   Untuk penghuni lama, isi "Mulai ditagih dari" supaya bulan-bulan yang sudah lunas tidak jadi tunggakan.

CARA KERJA TAGIHAN
- Tagihan sewa terbit OTOMATIS sesuai tanggal masuk penghuni (bisa bulanan, 3, 6, atau 12 bulan).
  Jatuh tempo = tanggal masuk setiap periode (bayar di muka). Default terbit 5 hari sebelumnya.
- Biaya bulanan (WiFi, parkir) ikut otomatis di tagihan sewa bagi penghuni yang memilih.
- Denda telat (opsional): sekali bayar atau per hari, dengan masa tenggang.
- Terima Pembayaran: pilih penghuni, centang tagihan, simpan, kuitansi bisa dicetak / dikirim via WA.
- Menu Tagihan & Tunggakan: tombol "Tagih WA" membuat pesan pengingat siap kirim.
- PENGINGAT SEBELUM JATUH TEMPO: menu "Pengingat Jatuh Tempo".
  Atur filter: "Jatuh tempo tepat" atau "Jatuh tempo dalam" + jumlah hari bebas (0 = hari ini), atau tombol cepat
  Hari ini / Besok / H-3 / H-7. Muncul juga sewa periode berikutnya yang tagihannya belum terbit.
  Tekan "Kirim pengingat berurutan": WhatsApp terbuka satu penghuni per layar dengan pesan siap kirim, tekan kirim,
  kembali ke aplikasi, penghuni berikutnya sudah siap. Yang sudah dikirimi ditandai "diingatkan <tanggal>",
  jadi dengan filter "Belum diingatkan" tidak ada yang terkirim dua kali.
  Kebiasaan yang disarankan: tiap pagi buka menu ini, pilih H-3, kirim berurutan. Bawaan H-3 bisa diubah di Pengaturan.
- Check-out: deposit bisa dipotong untuk tunggakan dan kerusakan, sisanya dicetak sebagai bukti pengembalian.

DIPAKAI BEBERAPA ORANG (pemilik + penjaga kost)
- Komputer pusat harus menyala dan jendela hitam aplikasi JANGAN ditutup.
- Penjaga membuka alamat yang tertulis di jendela hitam / menu Pengaturan
  (contoh: http://192.168.1.10:8080) dari browser di HP atau komputer masing-masing.
- Semua perangkat harus terhubung ke Wi-Fi yang sama.
- Alamat bisa berubah jika komputer pusat di-restart. Minta teknisi mengatur "IP statis" agar tetap.
- Petugas bisa check-in, terima pembayaran, dan mencatat. Pembatalan kuitansi/tagihan,
  pengaturan, dan hapus data hanya admin.

BACKUP (PENTING)
- Aplikasi membuat salinan otomatis di folder data\backups.
- Tetap unduh backup dari menu Pengaturan minimal seminggu sekali dan simpan di flashdisk / Google Drive,
  atau pakai modul Cadangan Google Drive (lihat di bawah) supaya cadangan terkirim otomatis.
- Jika komputer rusak dan tidak ada backup di tempat lain, data hilang.

MENCOBA DENGAN DATA CONTOH
- Klik dua kali Jalankan-DEMO.bat, lalu buka http://localhost:8090
- Akun demo admin  : admin / rahasia1
- Akun demo petugas: budi  / petugas1
- Data contoh terpisah dari data asli. Jangan pakai akun demo untuk data sungguhan.

LISENSI
- Tanpa kode lisensi, aplikasi hanya bisa dipakai 7 hari (masa pemasangan, dihitung per komputer; menghapus folder
  data tidak mengulangnya, dan memundurkan jam komputer tidak memperpanjangnya). Masukkan kode setelah pembayaran.
- Versi yang diunduh sendiri dari halaman web (ada file coba-gratis.txt di samping program) dan versi HP Android:
  masa coba gratis 14 hari. Setelah habis, data tetap aman dan bisa dilihat; masukkan kode lisensi untuk lanjut.
- Kode lisensi dari penjual dimasukkan di menu Pengaturan > Lisensi.
- Kode lisensi terikat nama kost, dan bisa diikat ke komputer/HP tertentu. Ada lisensi tahunan dan lisensi selamanya.
- Kode komputer/HP terlihat di Pengaturan > Lisensi (contoh: K7M2-9QX4). Tekan "Salin data untuk penjual" lalu kirim
  lewat WhatsApp saat memesan atau memperpanjang, supaya nama kost tidak salah ketik. Pindah ke komputer/HP baru:
  minta kode pengganti ke penjual, GRATIS.
- Kalau tanggal komputer pernah salah (mis. baterai jam lemah atau salah ketik tahun), aplikasi memberi tahu di layar.
  Betulkan tanggal Windows/HP. Bila lisensi masih berlaku, tekan "Perbaiki tanggal aplikasi" di Pengaturan > Lisensi
  (bisa sekali untuk setiap kode lisensi).
- Setelah lisensi tahunan habis ada masa tenggang 14 hari, lalu input baru terkunci. Data tetap aman dan bisa dilihat.

LUPA KATA SANDI ADMIN
- Admin lain bisa menggantinya di menu Pengaturan. Jika hanya ada satu admin, hubungi penjual.

MODUL DASAR (selalu ada)
- Dashboard, Kamar (peta kamar), Penghuni (check-in, pindah kamar, check-out + deposit, surat perjanjian),
  Tagihan otomatis & denda, Terima Pembayaran + kuitansi, Tunggakan + pengingat WA,
  Riwayat Kuitansi, Laporan (pendapatan, rekap sewa per penghuni, okupansi), Pengaturan, Backup.

MODUL TAMBAHAN (LIMA MODUL)
Semua modul terbuka selama masa pemasangan / masa coba gratis. Setelah itu hanya modul yang tercantum di kode lisensi yang terbuka.
Modul yang tidak dibeli tetap terlihat di menu dengan tanda gembok.

1. Kas & Pengeluaran
   - Mencatat pengeluaran operasional (PLN, PDAM, WiFi, gaji penjaga, kebersihan, perbaikan) dan pemasukan lain.
   - Pembayaran penghuni, deposit, dan uang booking masuk buku kas otomatis.
   - Laporan laba bersih per bulan. Deposit dihitung titipan, bukan pendapatan.
2. Meteran Listrik & Air
   - Catat angka meteran tiap kamar sebulan sekali; biaya dihitung dan tagihan dibuat otomatis.
   - Tandai kamar bermeteran di menu Kamar (centang "punya meteran"). Tarif diisi admin.
3. Booking & Calon Penghuni
   - Catat calon penghuni yang survei, terima uang booking/DP, kamar ditandai "dipesan".
   - "Jadikan penghuni" tanpa ketik ulang; uang booking otomatis dipotongkan ke deposit / sewa pertama.
   - Booking batal: isi jumlah yang dikembalikan, sisanya dihitung pendapatan (hangus).
4. Keluhan & Perbaikan
   - Catat kerusakan per kamar dengan prioritas, pantau status sampai selesai.
   - Biaya perbaikan masuk buku kas (bila modul Kas aktif) atau bisa ditagihkan ke penghuni.
   - Kamar bisa ditutup sementara selama perbaikan.
5. Cadangan Google Drive
   - Cadangan data dikirim OTOMATIS ke Google Drive sesuai pilihan "Jeda cadangan otomatis" di Pengaturan:
     Cepat (sekitar 20 detik setelah ada perubahan, bawaan), Normal (2-3 menit), Hemat kuota (tiap 30 menit),
     Sekali sehari, atau Manual (hanya saat tombol "Cadangkan sekarang" ditekan, cocok bila jarang ada internet).
     Bila internet putus, dicoba ulang sendiri. Satu file per hari, 30 hari terakhir disimpan.
   - Tidak perlu memasang aplikasi Google Drive. Cara mengaktifkan (sekali saja, di KOMPUTER PUSAT,
     buka lewat http://localhost:8080): Pengaturan > Cadangan Google Drive > "Hubungkan Google Drive",
     pilih akun Google, CENTANG kotak izin Google Drive, lalu klik Lanjutkan.
   - Status cadangan tampil di menu samping (bawah). Tombol "Cadangkan sekarang" untuk mengirim saat itu juga.
   - Aplikasi hanya bisa melihat file cadangan buatannya sendiri di folder "Cadangan Aplikasi Manajemen Kost",
     bukan file lain di Drive Anda.
   - Komputer rusak / ganti komputer: pasang aplikasi di komputer baru, buat akun admin sementara,
     hubungkan Google Drive dengan akun yang sama, lalu pilih "Pulihkan dari Google Drive".
     Semua data, akun, dan logo kembali seperti cadangan terakhir.
   - Pengaman: bila di Drive ada cadangan yang lebih baru (misalnya aplikasi juga dipakai di komputer lain
     dengan akun Google yang sama), cadangan otomatis DITAHAN dan admin diminta memilih
     "Pulihkan dari Google Drive" atau "Lanjutkan cadangan komputer ini". Tidak ada data yang tertimpa diam-diam.

Data demo sudah berisi contoh untuk modul 1-4.
