🔌 Billec (Bills of Electricity)

Sistem Manajemen Tagihan Listrik Pascabayar

Billec adalah aplikasi berbasis web untuk mengelola tagihan listrik pascabayar, memudahkan pelanggan dalam melihat tagihan, mengunggah bukti pembayaran, dan melacak riwayat pembayaran. Sementara itu, admin dapat mengelola pelanggan, tarif listrik, serta memvalidasi pembayaran.

---

🚀 Fitur Utama

🔹 Untuk Pelanggan

• 📑 Lihat Tagihan: Cek daftar tagihan berdasarkan bulan & tahun.
• 📤 Unggah Bukti Pembayaran: Upload bukti pembayaran untuk divalidasi admin.
• 💳 Riwayat Pembayaran: Lihat daftar pembayaran yang sudah dilakukan.
• 📊 Dashboard Statistik: Total tagihan, tagihan lunas, belum bayar, dan total pembayaran.

🔹 Untuk Admin

• 👥 Kelola Pelanggan: Tambah, edit, dan hapus pelanggan.
• ⚡ Atur Tarif Listrik: Tambah dan ubah tarif listrik berdasarkan daya (VA).
• 📊 Pantau Tagihan: Lihat semua tagihan pelanggan dengan statusnya.
• ✅ Validasi Pembayaran: Cek & validasi bukti pembayaran pelanggan.
• 📊 Dashboard Statistik: Total pelanggan, total tagihan, tagihan belum bayar, tagihan lunas, total pembayaran.

---

🛠 Teknologi yang Digunakan

• Backend: PHP (Native) + MySQL
• Frontend: HTML, CSS, JavaScript
• Database: MySQL dengan VIEW, INDEX, TRIGGER, STORE PROCEDURE, EVENT SCHEDULER untuk optimasi
• Autentikasi: Session-based authentication
• API: RESTful API berbasis PHP

---

🏗 Struktur Proyek

billec/
├── api/               # Endpoint API (tagihan, pelanggan, pembayaran, dashboard)
├── config/            # Konfigurasi database
├── controllers/       # Controller (MVC Pattern)
├── public/            # Halaman utama aplikasi
│   ├── admin/         # Panel admin
│   ├── pelanggan/     # Panel pelanggan
|   ├── styles.css     # Styling utama
|   ├── scripts.js     # JavaScript utama
├── uploads/           # Direktori bukti pembayaran
├── README.md          # Dokumentasi proyek
└── .gitignore         # Mengabaikan file yang tidak diperlukan

Client -> Web App -> API -> Backend Controller -> Database

Cara Instalasi & Menjalankan Aplikasi

1. Clone Repository

git clone https://github.com/arifanchan/billec.git
cd billec

2. Konfigurasi Database

1. Buat database di MySQL (misalnya billec).
2. Import file SQL dari database/billec.sql.
3. Konfigurasi koneksi database di config/database.php:

define('DB_HOST', 'localhost');
define('DB_NAME', 'billec');
define('DB_USER', 'root');  // Sesuaikan username database
define('DB_PASS', '');      // Sesuaikan password database

3. Jalankan di Localhost

Gunakan server XAMPP / MAMP / Laragon untuk menjalankan Apache & MySQL. Buka browser dan akses:

http://localhost/billec/public/

🔑 Akun Default

Role

• Admin username: admin password: admin
• Pelanggan username: arifachan password: 123

🏆 Fitur Tambahan yang Akan Datang

• 🔗 Integrasi Payment Gateway untuk pembayaran langsung.
• 📩 Notifikasi Email/SMS untuk tagihan dan konfirmasi pembayaran.
• ✨ Desain UI responsif yang lebih modern.
• 📱 Mobile App

🎯 Kontribusi & Lisensi

• Kontribusi dipersilakan! Buka Pull Request atau buat Issue di GitHub.
• Lisensi: Open-source (MIT License). Bebas digunakan & dikembangkan lebih lanjut. 🔌 Dibuat dengan ❤️ oleh Arifanchan & Kontributor Open Source. 📌 GitHub: https://github.com/arifanchan/billec