Skip to content

Latest commit

 

History

History
89 lines (73 loc) · 4.06 KB

README.md

File metadata and controls

89 lines (73 loc) · 4.06 KB

Aplikasi Sistem Parkir UPNVJ (ParkingSystem)

Aplikasi Android ini dirancang untuk memanajemen dan memonitoring sistem parkir di lingkungan UPN "Veteran" Jakarta (UPNVJ). Aplikasi ini dilengkapi dengan fitur pemindaian QR Code dan manajemen data secara lokal menggunakan Room Database.

Fitur Utama

  • Pemindaian QR Code: Memudahkan proses check-in dan check-out kendaraan secara cepat menggunakan library ZXing.
  • Pencatatan Data Kendaraan: Mengelola riwayat parkir dan detail kendaraan yang keluar masuk.
  • Penyimpanan Data Lokal (Offline Support): Menggunakan Room Database untuk menyimpan data transaksi secara lokal sehingga aplikasi dapat berjalan lancar tanpa bergantung pada koneksi internet.
  • Antarmuka Pengguna Modern: Dibangun menggunakan Material Design, RecyclerView, dan CardView untuk tampilan yang responsif dan rapi.

Tech Stack

  • Bahasa Pemrograman: Java
  • Android SDK: Minimum SDK 26, Target SDK 34
  • Database: Room Database (SQLite wrapper)
  • QR Code Scanner: zxing-android-embedded
  • UI Components: Material Design, ConstraintLayout, RecyclerView, CardView

Cara Menjalankan Project di Lokal

Jika kamu ingin menjalankan aplikasi ini di komputer lokalmu, ikuti langkah-langkah berikut:

1. Kloning Repositori

Buka terminal/command prompt dan jalankan perintah berikut:

git clone https://github.com/ZerithX/ParkingSystem.git
cd ParkingSystem

2. Buka di Android Studio

  • Buka Android Studio.
  • Pilih "Open" dan arahkan ke folder proyek hasil kloning (ParkingSystem atau ParkingUPNVJUpdated).
  • Tunggu proses sinkronisasi (Gradle Sync) selesai sepenuhnya.

3. Jalankan Aplikasi

  • Hubungkan perangkat Android fisik Anda menggunakan kabel USB (pastikan USB Debugging aktif), atau jalankan Emulator (AVD) di Android Studio.
  • Klik tombol Run (ikon segitiga hijau) di toolbar atas Android Studio, atau gunakan shortcut Shift + F10.
  • Aplikasi akan di-build dan langsung terbuka di perangkat/emulator Anda.

Alur Kontribusi (Git Workflow)

Bagi anggota tim yang ingin menambahkan fitur, memperbarui tampilan antarmuka, atau memperbaiki bug pada aplikasi ini, gunakan panduan git berikut untuk berkolaborasi dengan aman:

1. Ambil Perubahan Terbaru (Pull)

Sebelum Anda mulai menulis kode baru, selalu ambil pembaruan terbaru dari GitHub agar tidak terjadi konflik kode (conflict code):

git pull origin main

2. Lakukan Perubahan Kode

Silakan edit atau tambahkan file baru di dalam direktori app/src/main/java/ (untuk logika Java) atau app/src/main/res/ (untuk antarmuka XML).

3. Periksa Status File yang Diubah

Lihat daftar file apa saja yang telah Anda ubah atau tambahkan dengan perintah:

git status

4. Simpan Perubahan (Add & Commit)

Tambahkan file yang diubah ke area staging, lalu buat pesan commit yang deskriptif:

# Untuk menambahkan semua file baru/berubah
git add .

# Atau jika hanya ingin menambahkan file spesifik
git add app/src/main/java/...

# Buat commit dengan pesan yang jelas
git commit -m "Menambahkan [Nama Fitur/Perubahan] ke sistem parkir"

5. Kirim Perubahan ke GitHub (Push)

Kirimkan commit lokal Anda ke repositori utama di GitHub:

git push origin main

Struktur Direktori Proyek

ParkingSystem/
│
├── app/
│   ├── src/main/java/com/example/parkingupnvj/ # Kode sumber logika aplikasi (Java)
│   ├── src/main/res/                           # Resource UI (layout XML, drawable, dll)
│   ├── src/main/AndroidManifest.xml            # Konfigurasi perizinan dan komponen Android
│   └── build.gradle                            # Konfigurasi dependencies (Room, ZXing, dll)
│
├── build.gradle                                # Konfigurasi Gradle level proyek utama
├── gradle.properties                           # Properti environment Gradle
├── settings.gradle                             # Pengaturan modul proyek
└── README.md                                   # Dokumentasi proyek (file ini)