Download Sistem Reservasi Kost Berbasis Laravel Full Source Code

Mengelola kost dengan buku catatan dan grup WhatsApp biasanya berjalan lancar sampai jumlah kamar melewati belasan. Setelah itu mulai muncul masalah: satu kamar dijanjikan ke dua calon penghuni, Anda lupa siapa yang belum bayar bulan ini, dan setiap kali ada yang bertanya "masih ada kamar kosong?" Anda harus mengecek satu per satu.

Sistem reservasi kost berbasis web menjawab masalah itu dengan menyatukan data kamar, penghuni, booking, dan pembayaran di satu tempat. Artikel ini membahas cara kerja sistem semacam itu, desain database yang masuk akal, langkah menjalankan source code Laravel di komputer sendiri, cara mengubahnya dengan aman, serta hal yang perlu Anda periksa sebelum membeli source code apa pun.

Masalah yang Sebenarnya Diselesaikan

Pengelolaan kost terdiri dari empat proses yang saling bergantung: pencatatan data penghuni, manajemen kamar, booking atau reservasi, dan pembayaran sewa. Masalah muncul ketika keempatnya dicatat di tempat berbeda. Status kamar di buku tidak diperbarui setelah penghuni keluar, pembayaran tercatat di mutasi bank tapi tidak dicocokkan ke nama penghuni, dan booking via chat tidak pernah masuk catatan resmi.

Sistem yang baik tidak sekadar memindahkan catatan ke layar. Nilainya ada pada aturan yang dipaksakan sistem: kamar berstatus terisi tidak bisa dibooking lagi, setiap pembayaran terikat ke penghuni dan periode tertentu, dan laporan dihitung dari data yang sama.

Modul Inti dan Alur Datanya

Sistem reservasi kost umumnya terdiri dari modul berikut:

• Manajemen data kamar: nomor kamar, tipe, harga, fasilitas.
• Status kamar: tersedia atau terisi, idealnya dihitung dari data booking aktif.
• Booking atau reservasi: permintaan sewa dengan tanggal mulai dan durasi.
• Data penghuni: identitas, kontak, dan kontak darurat.
• Pencatatan pembayaran: sewa per periode beserta statusnya.
• Laporan dan dashboard monitoring: okupansi, pemasukan, dan tunggakan.

Alurnya kira-kira begini:

1. Calon penghuni memilih kamar yang berstatus tersedia.
2. Admin atau sistem membuat booking dengan status menunggu.
3. Setelah uang muka atau sewa pertama diterima, booking dikonfirmasi dan kamar berubah menjadi terisi.
4. Setiap periode, sistem mencatat tagihan dan pembayaran penghuni.
5. Saat penghuni keluar, booking ditutup dan kamar kembali tersedia.
6. Dashboard merangkum semuanya tanpa input ulang.

Desain Tabel yang Disarankan

Jika Anda menilai source code yang sudah ada atau membangun sendiri, struktur berikut adalah patokan yang sehat. Kunci utamanya: status kamar sebaiknya tidak hanya bergantung pada satu kolom yang di-update manual, dan pembayaran selalu menunjuk ke booking, bukan langsung ke kamar.

CREATE TABLE rooms (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    code VARCHAR(20) NOT NULL UNIQUE,      -- misal A-01
    type VARCHAR(50) NOT NULL,
    monthly_price BIGINT UNSIGNED NOT NULL,
    facilities TEXT NULL,
    is_active TINYINT(1) NOT NULL DEFAULT 1
);

CREATE TABLE tenants (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100) NOT NULL,
    phone VARCHAR(20) NOT NULL,
    emergency_contact VARCHAR(100) NULL
);

CREATE TABLE bookings (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    room_id BIGINT UNSIGNED NOT NULL,
    tenant_id BIGINT UNSIGNED NOT NULL,
    start_date DATE NOT NULL,
    end_date DATE NULL,                    -- NULL = masih menghuni
    status ENUM('pending','active','finished','cancelled') NOT NULL,
    INDEX (room_id, status)
);

CREATE TABLE payments (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    booking_id BIGINT UNSIGNED NOT NULL,
    period CHAR(7) NOT NULL,               -- format 2026-10
    amount BIGINT UNSIGNED NOT NULL,
    paid_at DATE NULL,
    UNIQUE (booking_id, period)
);

Constraint UNIQUE (booking_id, period) mencegah pembayaran tercatat dua kali untuk bulan yang sama, kesalahan yang sangat umum di pencatatan manual.

Mencegah double booking

Dua admin yang mengonfirmasi kamar yang sama pada detik yang hampir bersamaan adalah skenario nyata. Di Laravel, bungkus pengecekan dan penyimpanan dalam transaksi dengan penguncian baris:

use Illuminate\Support\Facades\DB;

DB::transaction(function () use ($roomId, $tenantId, $start) {
    $room = Room::whereKey($roomId)->lockForUpdate()->firstOrFail();

    $terisi = Booking::where('room_id', $room->id)
        ->whereIn('status', ['pending', 'active'])
        ->exists();

    abort_if($terisi, 422, 'Kamar sudah dibooking.');

    Booking::create([
        'room_id'    => $room->id,
        'tenant_id'  => $tenantId,
        'start_date' => $start,
        'status'     => 'pending',
    ]);
});

lockForUpdate() membuat permintaan kedua menunggu sampai transaksi pertama selesai, sehingga pengecekan exists() selalu membaca data terbaru.

Laporan yang Sebaiknya Tersedia

Dashboard monitoring baru berguna jika menjawab pertanyaan harian pemilik kost. Minimal ada tiga angka: tingkat okupansi (kamar terisi dibagi kamar aktif), pemasukan bulan berjalan, dan daftar penghuni yang belum membayar periode ini. Daftar tunggakan bisa diambil dengan query sederhana:

$periode = now()->format('Y-m');

$tunggakan = Booking::with('tenant', 'room')
    ->where('status', 'active')
    ->whereDoesntHave('payments', fn ($q) => $q->where('period', $periode))
    ->get();

Query ini hanya bekerja jika pembayaran dicatat per periode seperti desain tabel di atas. Inilah alasan struktur data lebih penting daripada tampilan saat Anda menilai sebuah source code.

Menjalankan Source Code Laravel di Komputer Lokal

Langkah umumnya sama untuk hampir semua proyek Laravel. Pastikan PHP, Composer, dan MySQL sudah terpasang; detailnya ada di panduan menjalankan source code Laravel.

composer install
cp .env.example .env
php artisan key:generate
# atur DB_DATABASE, DB_USERNAME, DB_PASSWORD di .env
php artisan migrate --seed
php artisan storage:link
php artisan serve

Jika paket menyertakan file SQL alih-alih migration, impor file tersebut ke database kosong lalu lewati migrate. Selalu baca README bawaan karena urutannya bisa berbeda.

Error yang sering muncul

• "No application encryption key has been specified": jalankan php artisan key:generate.
• "SQLSTATE[HY000] [1045] Access denied": kredensial database di .env salah atau user belum punya hak akses.
• Gambar tidak tampil: storage:link belum dijalankan.
• "Class not found" setelah menambah file: jalankan composer dump-autoload.

Kustomisasi yang Aman

Hampir semua pemilik kost ingin menyesuaikan sesuatu: menambah denda keterlambatan, tarif harian, atau kolom KTP. Beberapa prinsip agar perubahan tidak merusak:

1. Simpan source code asli di Git sebelum mengubah apa pun.
2. Tambahkan kolom baru lewat migration baru, jangan mengedit migration lama.
3. Letakkan logika baru di service class atau model, bukan menumpuk di view.
4. Uji alur booking dari awal sampai akhir setelah setiap perubahan.

Pembahasan lengkapnya ada di artikel cara kustomisasi source code tanpa merusak.

Source Code, Bikin Sendiri, atau Aplikasi Langganan?

Untuk pertimbangan lebih detail, baca beli atau bikin sendiri.

Checklist Sebelum Membeli Source Code Apa Pun

• Ada demo yang bisa dicoba, bukan hanya screenshot.
• Versi Laravel dan PHP disebutkan jelas dan masih didukung.
• Struktur database bisa dilihat atau dijelaskan.
• Tersedia dokumentasi instalasi.
• Lisensi jelas: boleh dipakai untuk berapa usaha atau domain.
• Tidak ada kode terenkripsi yang mencegah Anda mengubahnya.
• Validasi input dan proteksi CSRF bawaan Laravel tidak dimatikan.
• Jelas siapa yang bisa dihubungi jika instalasi gagal.

Keterbatasan yang Perlu Disadari

Source code siap pakai bukan produk jadi seperti aplikasi langganan. Anda perlu hosting, perlu orang yang bisa menjalankan update keamanan, dan perlu backup rutin. Fitur seperti pembayaran online otomatis, notifikasi WhatsApp, atau aplikasi mobile untuk penghuni biasanya tidak tersedia bawaan dan harus dikembangkan sendiri. Jika tidak ada yang bisa memegang sisi teknis, aplikasi langganan mungkin lebih realistis.

Bagi yang ingin melihat contoh implementasinya, detail sistem reservasi kost Laravel di GudangCode bisa dilihat di halaman aplikasinya.