Skip to content

README.md

Latest commit

 

History

History
76 lines (56 loc) · 2.69 KB

README.md

File metadata and controls

76 lines (56 loc) · 2.69 KB
Raw

Sistem Kos & Kontrakan 🏠

Platform manajemen penyewaan properti (Kos/Kontrakan) yang dibangun menggunakan Laravel. Aplikasi ini dirancang untuk mempermudah Pemilik (Owner) dalam mengelola unit dan pembayaran, serta mempermudah Penyewa (Tenant) dalam melakukan pelaporan maintenance dan konfirmasi pembayaran.

🚀 Fitur Utama

  • Multi-Role Authentication: Mendukung 3 level pengguna (Admin, Owner, Tenant) menggunakan Spatie Laravel Permission.
  • Dashboard Terpisah: Tampilan dashboard yang dipersonalisasi sesuai dengan role masing-masing.
  • Manajemen Pembayaran: Tenant dapat mengunggah bukti pembayaran, dan Owner dapat memverifikasi secara real-time.
  • Layanan Maintenance: Tenant dapat mengajukan permintaan perbaikan unit melalui sistem.
  • Manajemen Pengguna: Admin memiliki kendali penuh untuk mengelola akun pengguna di dalam sistem.

🛠️ Tech Stack

  • Framework: Laravel 12
  • Database: MySQL / SQLite
  • Role Management: Spatie Laravel Permission
  • Frontend: Blade Templating, Tailwind CSS, Alpine.js (Laravel Breeze)
  • Auth: Laravel Breeze (Session Based)

📋 Persyaratan Sistem

  • PHP >= 8.2
  • Composer
  • Node.js & NPM

⚙️ Instalasi

  1. Clone Repository

    git clone https://github.com/username/sistem-kos-kontrakan.git
cd sistem-kos-kontrakan

  2. Instal Dependensi

    composer install
npm install && npm run build

  3. Konfigurasi Environment Salin file .env.example menjadi .env dan sesuaikan pengaturan database Anda.

    cp .env.example .env
php artisan key:generate

  4. Migrasi Database & Seeding Jalankan migrasi untuk membuat tabel dan seeder untuk membuat Role serta akun Admin default.

    php artisan migrate --seed

🔐 Konfigurasi Role (Spatie)

Aplikasi ini menggunakan sistem Role-Based Access Control (RBAC). Daftar Role yang tersedia:

  • admin: Manajemen penuh sistem dan pengguna.
  • owner: Mengelola unit kos, memverifikasi pembayaran, dan mengelola maintenance.
  • tenant: Melakukan pembayaran dan mengajukan maintenance.

Untuk memberikan role secara manual via Tinker:

$user = User::find(1);
$user->assignRole('admin');

📁 Struktur Folder Penting

  • app/Http/Controllers/Auth: Logika registrasi dan login (dengan assign role otomatis).
  • database/seeders/RolesSeed.php: Konfigurasi awal Role dan akun Admin.
  • resources/views/layouts/navigation.blade.php: Navigasi dinamis berbasis role.

📄 Lisensi

Proyek ini dikembangkan untuk tujuan pembelajaran dan manajemen internal. Silakan hubungi pengembang untuk informasi lebih lanjut.