Buku Masjid adalah sistem pengelolaan keuangan dan jadwal pengajian masjid berbasis web yang dibuat dengan framework Laravel.
- Meningkatkan transparansi laporan keuangan masjid/mushalla.
- Memungkinkan akses online bagi jamaah dan masyarakat umum untuk melihat laporan kas.
- Mempermudah bendahara masjid/mushalla dalam mencatat transaksi keuangan.
- Otomatisasi pembuatan laporan kas setiap kali ada transaksi.
- Mempermudah pengurus masjid/mushalla dalam mengelola jadwal khatib dan pengajian.
- Meningkatkan kepercayaan jamaah/masyarakat terhadap pengelolaan dana infaq masjid/mushalla.
- Memudahkan masyarakat dalam memutuskan untuk berinfaq ke masjid tertentu.
- Mengurangi beban tugas bendahara dalam pembuatan laporan kas masjid/mushalla.
- Memungkinkan masyarakat/jamaah untuk memantau jadwal pengajian secara online.
- Pengelolaan buku catatan: Setiap kegiatan dapat dicatat di buku catatan kas yang terpisah.
- Pengelolaan kategori/kelompok pemasukan dan pengeluaran untuk setiap buku catatan.
- Input pemasukan dan pengeluaran.
- Laporan:
- Laporan kas Bulanan
- Laporan kas per Kategori
- Laporan kas Mingguan
- Pengelolaan jadwal khatib Jumat.
- Pengelolaan jadwal pengajian rutin.
Aplikasi ini dapat diinstal pada server lokal maupun online dengan spesifikasi berikut:
- PHP 8.1 (dan sesuai dengan persyaratan server Laravel 10.x).
- Database MySQL atau MariaDB.
- SQLite (digunakan untuk pengujian otomatis).
- Clone repositori ini dengan perintah:
git clone https://github.com/buku-masjid/buku-masjid.git
- Masuk ke direktori buku-masjid:
$ cd buku-masjid
- Instal dependensi menggunakan:
$ composer install
- Salin berkas
.env.example
ke.env
:$ cp .env.example .env
- Generate kunci aplikasi:
$ php artisan key:generate
- Buat database MySQL untuk aplikasi ini.
- Konfigurasi database dan pengaturan lainnya di berkas
.env
.APP_URL=http://localhost APP_TIMEZONE="Asia/Makassar" DB_DATABASE=homestead DB_USERNAME=homestead DB_PASSWORD=secret MASJID_NAME="Masjid Ar-Rahman" MASJID_DEFAULT_BOOK_ID=1 AUTH_DEFAULT_PASSWORD=password MONEY_CURRENCY_CODE="Rp" MONEY_PRECISION=2 MONEY_DECIMAL_SEPARATOR="," MONEY_THOUSANDS_SEPARATOR="."
- Jalankan migrasi database:
$ php artisan migrate --seed
- Buat kunci passport:
$ php artisan passport:keys
- Buat tautan penyimpanan:
$ php artisan storage:link
- Mulai server:
$ php artisan serve
- Buka web browser dengan alamat web: http://localhost:8000, kemudian masuk dengan akun bawaan:
email: admin@example.net password: password
Untuk menggunakan docker silahkan jalankan perintah ini di terminal:
- Buat file .env
$ cp .env.example .env
- Update untuk mengubah env
DB_HOST
:DB_HOST=mysql_host
- Build docker images dan jalankan container:
docker-compose build docker-compose up -d
- Jalankan database migration:
docker-compose exec server php artisan migrate --seed
- Buka web browser dengan alamat web: http://localhost:8000, kemudian login dengan default user:
email: admin@example.net password: password
- Untuk masuk ke docker container shell:
docker-compose exec server sh docker-compose exec mysql bash
Ketika sudah ter-install di localhost, kita bisa generate data dummy untuk simulasi sistem buku masjid. Datad demo dapat di-generate dengan perintah berikut:
Generate demo data (3 bulan terakhir):
$ php artisan buku-masjid:generate-demo-data
Hapus semua demo data (yang created_at
nya NULL
)
$ php artisan buku-masjid:remove-demo-data
Lengkapnya dapat dilihat pada: Dokumentasi buku-masjid/demo-data.
Jika Anda ingin berkontribusi pada proyek ini, kami sangat menghargainya. Berikut beberapa yang dapat Anda lakukan:
- Laporkan issue jika Anda menemui kesalahan atau bug.
- Sampaikan diskusi jika Anda ingin mengusulkan fitur baru atau perubahan pada fitur yang sudah ada.
- Ajukan pull request untuk perbaikan bug, penambahan fitur baru, atau perbaikan label.
Untuk Diskusi:
Untuk pengumuman dan update:
Proyek Buku Masjid merupakan perangkat lunak open-source yang dilisensikan di bawah Lisensi MIT.