💰 Qanaah - Aplikasi Budgeting & Refleksi Keuangan

Aplikasi open source untuk mencatat, memantau, dan mengelola keuangan keluarga dengan sentuhan nilai-nilai Islami.

---

✨ Fitur Utama

📊 Manajemen Keuangan

• Pencatatan Pemasukan & Pengeluaran: Catat transaksi harian dengan mudah dan cepat.
• Kategori Pengeluaran: Kelompokkan pengeluaran berdasarkan kategori untuk analisis yang lebih baik.
• Pengeluaran Berulang (Recurring Expenses): Fitur otomatis untuk menyalin pengeluaran rutin ke bulan berikutnya.
• Dashboard Interaktif: Grafik tren bulanan dan breakdown pengeluaran per kategori.
• Filter Periode: Lihat riwayat keuangan berdasarkan bulan dan tahun.

🕌 Fitur Islami & Refleksi

• Daily Finance Wisdom: Tampilkan kutipan ayat Al-Qur'an, Hadis, atau kata mutiara tentang muamalah dan keuangan setiap hari.
• Tadabbur & Catatan: Fitur untuk mencatat refleksi keuangan harian atau catatan penting lainnya.
• Notifikasi Harian: Pengingat harian untuk melihat wisdom keuangan terbaru.

🚀 Fitur Teknis & Lainnya

• PWA Support: Aplikasi dapat diinstal di perangkat mobile layaknya aplikasi native.
• Tracking Statistik Aplikasi: Melacak jumlah download/install aplikasi.
• Mode Tamu & User: Halaman publik untuk melihat fitur aplikasi.
• Dukungan Docker: Siap dideploy dengan mudah menggunakan Docker (support Easypanel).
• Database Ringan: Menggunakan SQLite secara default, mudah dikonfigurasi.

---

📸 Tampilan Aplikasi

🏠 Dashboard Utama

📊 Statistik Pengeluaran

📝 Pencatatan Transaksi

---

⚙️ Teknologi yang Digunakan

• Laravel 11
• PHP 8.2+
• SQLite Database
• Tailwind CSS / Bootstrap 5
• Docker & Docker Compose
• Blade Template Engine

---

🚀 Instalasi

Opsi 1: Instalasi Manual

1. Clone Repository

   git clone https://github.com/luqni/budget-app.git
   cd budget-app

2. Install Dependencies

   composer install
   npm install && npm run build

3. Konfigurasi Environment

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

   Atur koneksi database di .env (default SQLite):

   DB_CONNECTION=sqlite

   Buat file database jika belum ada:

   touch database/database.sqlite

4. Jalankan Migrasi

   php artisan migrate

5. Jalankan Aplikasi

   php artisan serve

Opsi 2: Menggunakan Docker

1. Build & Run Container

   docker-compose up -d --build

2. Setup Awal (Jalankan sekali saja)

   docker-compose exec app php artisan key:generate
   docker-compose exec app php artisan migrate

---

🔒 Lisensi

Proyek ini menggunakan lisensi MIT License.

💬 Dukungan

Jika kamu menyukai proyek ini, bantu dengan ⭐️ memberi star di GitHub. Atau jika ingin berdiskusi, buka Issues untuk memberikan ide atau melaporkan bug.

Dibuat dengan ❤️ oleh Muhammad Luqni Baehaqi