KosKeeper

Sistem manajemen kos/homestay berbasis Android

---

Suka dengan project ini? Dukung pengembangannya!

---

Fitur Utama

Fitur	Deskripsi
Manajemen Kamar	Kelola data kamar/homestay lengkap dengan status
Sistem Booking	Buat, edit, dan lacak status booking tamu
Data Tamu	Database tamu dengan riwayat kunjungan
Kalender	Visualisasi booking dalam tampilan kalender
Pembayaran & DP	Catat pembayaran, DP, dan riwayat pembayaran per booking
Buku Kas	Kas terpadu (tunai/transfer/QRIS/lainnya) dengan riwayat transaksi
Refund & Pro-rate	Skema refund pembatalan/no-show dan perhitungan pro-rate
Kebijakan Kos	Atur tarif, DP, jam check-in/out, batas refund, dan lainnya
Laporan	Laporan bulanan dengan export ke PDF
Hari Libur	Atur hari libur untuk perhitungan tarif
Riwayat Aktivitas	Log semua aktivitas di aplikasi
Kunci Aplikasi	Proteksi aplikasi dengan PIN
Tema Warna	10 pilihan tema warna
Backup & Restore	Backup dan pulihkan database kapan saja (otomatis via WorkManager)
Notifikasi	Pengingat checkout otomatis
WA Cepat	Kirim pesan WhatsApp cepat ke tamu

Tech Stack

• Language: Kotlin
• UI: Jetpack Compose + Material Design 3
• Database: Room (SQLite)
• Architecture: MVVM
• Async: Kotlin Coroutines + Flow
• Background: WorkManager

Screenshots

Analytics	Payment	Booking

Report	Guest	Calendar

Setting	Home	Rooms

Load

Instalasi

Prerequisites

• Android Studio Hedgehog (2023.1.1) atau lebih baru
• JDK 17
• Android SDK 34

Build & Run

# Clone repository
git clone https://github.com/Chukie99/KosKeeper.git

# Buka project di Android Studio
# Tunggu sync gradle selesai
# Run pada device/emulator

Atau build via command line:

./gradlew assembleDebug

APK debug akan tersedia di app/build/outputs/apk/debug/

Struktur Project

app/src/main/java/com/koskeeper/app/
├── MainActivity.kt           # Entry point
├── SplashScreen.kt           # Splash screen
├── AppLockScreen.kt          # Kunci aplikasi (PIN)
├── PondokViewModel.kt        # ViewModel utama
├── AppDatabase.kt            # Room database
├── Format.kt                 # Helper format (rupiah, tanggal, dll)
├── NotificationHelper.kt     # Notifikasi
├── CheckoutReminderWorker.kt # Pengingat checkout otomatis
├── BackupReminderWorker.kt   # Backup otomatis
├── *.kt                      # Entity & DAO (Kamar, Booking, Tamu,
│                            #  Pembayaran, Transaksi, HariLibur,
│                            #  Kebijakan, RefundLog, AktivitasLog)
└── ui/
    ├── HomeScreen.kt         # Dashboard (saldo kas, statistik hari ini)
    ├── KamarScreen.kt        # Manajemen kamar
    ├── BookingScreen.kt      # Form booking
    ├── DaftarBookingScreen.kt# Daftar booking
    ├── BookingDetailScreen.kt# Detail booking
    ├── TamuScreen.kt         # Manajemen tamu
    ├── KalenderScreen.kt     # Tampilan kalender
    ├── KasScreen.kt          # Buku kas
    ├── PembayaranScreen.kt   # Pembayaran & DP
    ├── InvoiceScreen.kt      # Invoice
    ├── LaporanScreen.kt      # Laporan & statistik (PDF)
    ├── AnalyticsScreen.kt    # Dashboard analytics
    ├── HariLiburScreen.kt    # Pengaturan hari libur
    ├── KebijakanScreen.kt    # Pengaturan kebijakan kos
    ├── RiwayatScreen.kt      # Riwayat aktivitas
    ├── SearchScreen.kt       # Pencarian
    ├── SettingsScreen.kt     # Pengaturan (tema, ukuran teks)
    ├── BackupScreen.kt       # Backup & restore
    ├── AboutScreen.kt        # Tentang aplikasi
    ├── Theme.kt              # Tema warna (10 pilihan)
    └── WarmUI.kt             # Komponen UI bersama

Kontribusi

Kontribusi sangat diterima! Silakan buka issue atau submit pull request.

1. Fork repository
2. Buat branch baru (git checkout -b feature/fitur-baru)
3. Commit perubahan (git commit -m 'Tambah fitur baru')
4. Push ke branch (git push origin feature/fitur-baru)
5. Buka Pull Request

License

Project ini dilisensikan di bawah MIT License.

Dukungan

Project ini gratis dan open source. Jika kamu merasa terbantu, dukung pengembangannya:

Platform	Link
Ko-fi	ko-fi.com/chukie99
Buy Me A Coffee	buymeacoffee.com/chukie99
GitHub Sponsors	github.com/sponsors/Chukie99

Donasi seikhlasnya sangat membantu pengembangan fitur baru!

Kontak

Chukie99 - @Chukie99

Dibuat dengan ❤️ untuk kemudahan pengelolaan kos/homestay