Gajayana Kost

1/4/2026

Gajayana Kost

Tentang Proyek

Gajayana Kost adalah aplikasi mobile untuk platform booking kos (boarding house) yang menghubungkan pemilik kos (Owner) dengan penyewa (Society). Aplikasi ini memungkinkan Owner untuk mengelola kos mereka dan Society untuk mencari dan memesan kos dengan mudah.

Pengembang:

• Cipto Yafig Adiwongso

Deskripsi Aplikasi

Gajayana Kost adalah platform berbasis mobile yang memudahkan proses pencarian dan pemesanan kos. Aplikasi ini memiliki dua peran utama: Owner (Pemilik Kos) dan Society (Penyewa). Owner dapat mengelola kos mereka, melihat statistik, mengelola booking, dan merespon review. Society dapat menjelajahi berbagai kos, melakukan booking, melihat detail booking, dan memberikan review.

Unduh Aplikasi

Anda dapat mengunduh dan mencoba aplikasi MediList melalui link berikut:
Unduh Gajayana-Kost.apk

Struktur Proyek

mobile/
├── lib/
│   ├── main.dart
│   ├── config.dart
│   ├── core/
│   │   └── app_theme.dart
│   ├── models/
│   │   ├── booking.dart
│   │   ├── kos.dart
│   │   └── user.dart
│   ├── pages/
│   │   ├── auth/
│   │   │   ├── login_page.dart
│   │   │   ├── register_page.dart
│   │   │   ├── forgot_password_page.dart
│   │   │   └── change_password_page.dart
│   │   ├── owner/
│   │   │   ├── add_kos_page.dart
│   │   │   ├── edit_kos_page.dart
│   │   │   ├── manage_kos_page.dart
│   │   │   ├── reviews_page.dart
│   │   │   ├── facility_management_page.dart
│   │   │   ├── analytics_page.dart
│   │   │   └── transaction_history_page.dart
│   │   ├── society/
│   │   │   ├── bookings_page.dart
│   │   │   ├── booking_detail_page.dart
│   │   │   └── booking_success_page.dart
│   │   └── shared/
│   │       ├── splash_page.dart
│   │       ├── home_page.dart
│   │       ├── dashboard_page.dart
│   │       └── profile_page.dart
│   ├── services/
│   │   └── api_service.dart
│   └── widgets/
│       ├── common/
│       ├── kos/
│       └── owner/
└── assets/
    └── image_documentation/

Fitur Aplikasi

Fitur Umum (Shared)

• Autentikasi: Login dan registrasi dengan validasi
• Home Page: Menjelajahi daftar kos dengan filter dan pencarian
• Dashboard: Navigasi utama dengan role-based menu
• Profile: Mengelola profil pengguna dan melihat statistik

Fitur Owner

• Kelola Kos: Menambah, mengedit, dan menghapus kos
• Kelola Kamar: Menambahkan dan mengelola kamar untuk setiap kos
• Kelola Fasilitas: Menambahkan dan mengelola fasilitas kos
• Manajemen Booking: Menerima, menolak, dan melihat detail booking
• Review Management: Melihat dan membalas review dari penyewa
• Analytics: Melihat statistik kos, booking, dan revenue
• Transaction History: Riwayat transaksi booking

Fitur Society (Penyewa)

• Pencarian Kos: Mencari kos berdasarkan filter (harga, lokasi, gender)
• Detail Kos: Melihat detail lengkap kos termasuk kamar, fasilitas, dan review
• Booking: Membuat booking dengan memilih tanggal sewa
• Manajemen Booking: Melihat status booking dan detail booking
• Review: Memberikan review dan rating untuk kos
• Cetak Bukti Booking: Mencetak dan membagikan bukti booking

Dokumentasi Aplikasi

Cara Menjalankan Proyek

Prasyarat

• Flutter SDK (versi terbaru)
• Dart SDK
• Android Studio / VS Code dengan Flutter extension
• Backend Laravel yang sudah berjalan (lihat dokumentasi backend)

1. Clone Repository

git clone <repository-url>
cd gajayana-kost/mobile

2. Install Dependencies

flutter pub get

3. Konfigurasi

Pastikan file lib/config.dart sudah dikonfigurasi dengan benar:

• apiHostBase: URL backend API
• Pastikan backend sudah berjalan dan dapat diakses

4. Menjalankan di Mode Debug

flutter run

5. Build Aplikasi Release

# Android APK
flutter build apk --release

# Android App Bundle
flutter build appbundle --release

# iOS (hanya di macOS)
flutter build ios --release

Teknologi yang Digunakan

• Frontend:
  • Flutter
  • Dart
  • Provider (State Management)
• Backend:
  • Laravel (PHP)
  • MySQL Database
  • Laravel Sanctum (Authentication)
• Libraries:
  • Dio (HTTP Client)
  • SharedPreferences (Local Storage)
  • Image Picker (Image Selection)
  • Printing & PDF (Bukti Booking)

API Endpoints

Aplikasi ini menggunakan RESTful API yang dihosting di backend Laravel. Dokumentasi lengkap API dapat dilihat di API_DOCUMENTATION.md di root project.

Endpoint Utama:

• /api/auth/login - Login pengguna
• /api/auth/register - Registrasi pengguna
• /api/kos - Daftar kos (Society)
• /api/owner/kos - Kelola kos (Owner)
• /api/bookings - Manajemen booking
• /api/owner/bookings - Manajemen booking (Owner)
• /api/reviews - Review dan rating

Struktur Backend

Backend menggunakan Laravel dengan struktur:

• API routes terpisah untuk Owner dan Society
• Middleware untuk authentication dan authorization
• Model relationships untuk data kos, booking, dan review
• File upload untuk gambar kos

© 2025 Cipto Yafig Adiwongso