Skip to content

Repository files navigation

🚿 SiCuci

Kasir Digital Cuci Motor & Mobil

Aplikasi antrian, kasir, dan pencatatan keuangan untuk bisnis cuci motor dan mobil

Android Kotlin Jetpack Compose Room DB License


✨ Fitur Utama

Fitur Deskripsi
πŸ“‹ Manajemen Antrian Tambah antrian cuci motor & mobil, status: Menunggu β†’ Dicuci β†’ Selesai β†’ Bayar, nomor antrian otomatis, filter & cari berdasarkan plat nomor
πŸ’° Kasir Digital Pembayaran QRIS & Tunai, perhitungan kembalian otomatis, QR Code QRIS real-time, cetak struk digital
πŸ“Š Laporan Keuangan Dashboard harian & keseluruhan, grafik pendapatan 7 hari, filter: Hari Ini / Minggu / Bulan / Pilih Bulan, export ke CSV
πŸ‘€ Riwayat Pelanggan Cari riwayat berdasarkan plat nomor, total kunjungan & total belanja, history lengkap setiap pelanggan
βš™οΈ Pengaturan Atur harga layanan, konfigurasi QRIS, backup & restore database
πŸ“± Multi Platform Support cuci motor & mobil (Sedan, SUV, MPV, dll)

πŸ› οΈ Tech Stack

Komponen Teknologi
Language Kotlin
UI Framework Jetpack Compose
Architecture MVVM
Database Room (SQLite)
Async Kotlin Coroutines + Flow
QR Code ZXing
DI Manual (ViewModelProvider)

πŸ“¦ Instalasi

Prasyarat

  • Android Studio Hedgehog (2023.1.1) atau lebih baru
  • JDK 17
  • Device/Emulator dengan Android 8.0 (API 26) atau lebih baru

Cara Install

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

# 2. Buka project di Android Studio
# File β†’ Open β†’ pilih folder sicuci

# 3. Tunggu Gradle sync selesai

# 4. Run app
# Klik tombol Run ▢️ atau Shift+F10

Build APK

# Debug APK
./gradlew assembleDebug

# Release APK
./gradlew assembleRelease

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

πŸ“ Struktur Project

sicuci/
β”œβ”€β”€ app/
β”‚   β”œβ”€β”€ src/main/
β”‚   β”‚   β”œβ”€β”€ java/com/stiman/dee/bukukas/
β”‚   β”‚   β”‚   β”œβ”€β”€ ui/                    # Compose UI
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ DashboardScreen.kt
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ QueueScreen.kt
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ ReportScreen.kt
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ SettingsScreen.kt
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ CustomerHistoryScreen.kt
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ PaymentDialog.kt
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ AddOrderDialog.kt
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ IncomeDialog.kt
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ ExpenseDialog.kt
β”‚   β”‚   β”‚   β”‚   β”œβ”€β”€ Theme.kt
β”‚   β”‚   β”‚   β”‚   └── Color.kt
β”‚   β”‚   β”‚   β”œβ”€β”€ TransactionViewModel.kt  # ViewModel
β”‚   β”‚   β”‚   β”œβ”€β”€ TransactionDao.kt        # Database DAO
β”‚   β”‚   β”‚   β”œβ”€β”€ CustomerOrderDao.kt
β”‚   β”‚   β”‚   β”œβ”€β”€ AppDatabase.kt           # Room Database
β”‚   β”‚   β”‚   β”œβ”€β”€ Transaction.kt           # Entity
β”‚   β”‚   β”‚   β”œβ”€β”€ CustomerOrder.kt
β”‚   β”‚   β”‚   β”œβ”€β”€ PriceManager.kt          # SharedPreferences
β”‚   β”‚   β”‚   β”œβ”€β”€ CsvExporter.kt           # Export CSV
β”‚   β”‚   β”‚   β”œβ”€β”€ DatabaseBackup.kt        # Backup/Restore
β”‚   β”‚   β”‚   β”œβ”€β”€ QrCodeGenerator.kt       # QR Code
β”‚   β”‚   β”‚   β”œβ”€β”€ ServiceOptions.kt
β”‚   β”‚   β”‚   β”œβ”€β”€ SplashActivity.kt
β”‚   β”‚   β”‚   └── MainActivity.kt
β”‚   β”‚   β”œβ”€β”€ res/
β”‚   β”‚   └── AndroidManifest.xml
β”‚   └── build.gradle.kts
β”œβ”€β”€ gradle/
β”œβ”€β”€ build.gradle.kts
└── settings.gradle.kts

🎨 Screenshots App

Feature Description
🏠 Splash Screen Logo animasi SiCuci
πŸ“‹ Antrian Kelola antrian cuci motor
πŸ’³ Pembayaran Bayar QRIS atau Tunai
πŸ“Š Dashboard Ringkasan keuangan harian
πŸ“ˆ Grafik Chart pendapatan 7 hari
πŸ“‘ Laporan Filter periode & export CSV
βš™οΈ Pengaturan Atur harga & QRIS
πŸ’Ύ Backup Backup & restore database
πŸ‘€ Pelanggan Riwayat berdasarkan plat

πŸ”§ Konfigurasi

Mengatur Harga Layanan

  1. Buka menu Harga (Settings)
  2. Edit harga setiap layanan
  3. Tap Simpan Semua

Mengatur QRIS

  1. Buka menu Harga (Settings)
  2. Masukkan kode/link QRIS
  3. Tap Simpan Semua

Backup Data

  1. Buka menu Harga (Settings)
  2. Scroll ke bawah β†’ Backup & Restore
  3. Tap Backup β†’ Pilih tempat simpan

πŸ“ Changelog

v1.0.0 (2026-07-14)

  • βœ… Initial release
  • βœ… Queue management (Motor & Mobil)
  • βœ… Transaction tracking
  • βœ… Dashboard & Reports
  • βœ… QRIS & Cash payment
  • βœ… CSV export
  • βœ… Backup/Restore
  • βœ… Customer history
  • βœ… Support cuci mobil (Sedan, SUV, MPV, dll)
  • βœ… Fully customizable services (tambah/edit/hapus layanan sendiri)

πŸ“₯ Download

Cara 1: Build dari Source

git clone https://github.com/Chukie99/sicuci.git
cd sicuci
./gradlew assembleDebug

APK akan ada di: app/build/outputs/apk/debug/app-debug.apk

Cara 2: Download APK

πŸ‘‰ Download APK di GitHub Releases

⚠️ Aktifkan "Install from Unknown Sources" di pengaturan Android kamu

β˜• Dukung Developer

Kalau app ini berguna untuk bisnismu, traktir kopi ya! β˜•

Ko-fi

Atau klik link langsung: ko-fi.com/chuckie999

Dukungan kamu sangat berarti untuk pengembangan app ini! πŸ™

🀝 Contributing

Kontribusi sangat welcome!

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

πŸ“„ License

Project ini menggunakan license MIT License.

πŸ‘¨β€πŸ’» Author

Chukie99


Made with ❀️ for Indonesian Motor Wash Businesses

About

🚿 SiCuci - Kasir Digital Cuci Motor & Mobil | Aplikasi antrian, kasir QRIS/Tunai, pencatatan keuangan, dan manajemen pelanggan untuk bisnis cuci motor dan mobil Indonesia

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages