Buku Masjid
Buku Masjid adalah sistem pengelolaan finansial dan jadwal pengajian masjid berbasis web yang dibuat dengan framework Laravel.
Tujuan
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.
Manfaat
Meningkatkan kepercayaan jamaah/masyarakat terhadap pengelolaan dana infak masjid/mushalla.
Memudahkan masyarakat dalam memutuskan untuk berinfak ke masjid tertentu.
Mengurangi beban tugas bendahara dalam pembuatan laporan kas masjid/mushalla.
Memungkinkan masyarakat/jamaah untuk memantau jadwal pengajian secara online.
Sponsor / Mitra
Kami ingin berterima kasih kepada sponsor yang mendukung development Buku Masjid.
Pondok Teknologi
Pondok IT
Mushaira
LKSA Al Ma'un Center
STIMI Banjarmasin
Jetorbit
Jika anda tertarik untuk menjadi sponsor/mitra, silakan hubungi Whatsapp Tim Buku Masjid pada halaman Kontak Buku Masjid .
Fitur
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.
Cara Install
Aplikasi ini dapat diinstal pada server lokal maupun online dengan spesifikasi berikut:
Kebutuhan Server
PHP 8.1 (dan sesuai dengan persyaratan server Laravel 10.x ).
Database MySQL atau MariaDB.
SQLite (digunakan untuk pengujian otomatis).
Langkah Instalasi
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:
Langkah Install dengan Docker
Untuk menggunakan docker silahkan jalankan perintah ini di terminal:
Buat file .envbash 复制
$ cp .env.example .env
Update untuk mengubah env DB_HOST: Atau Anda dapat mengotomatiskan proses ini menggunakan perintah ini.bash 复制
COPY .env.example .env.tmp
sed 's/DB_HOST=127.0.0.1/DB_HOST=mysql_host/' .env.tmp > .env && rm .env.tmp
Build docker images dan jalankan container:bash 复制
docker-compose build
docker-compose up -d
Jalankan database migration:bash 复制
docker-compose exec server php artisan migrate --seed
Buka web browser dengan alamat web: http://localhost:8000 , kemudian login dengan default user:
Untuk masuk ke docker container shell:bash 复制
docker-compose exec server sh
docker-compose exec mysql bash
Data Demo
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):
bash 复制
$ php artisan buku-masjid:generate-demo-dataHapus semua demo data (yang created_at nya NULL)
bash 复制
$ php artisan buku-masjid:remove-demo-dataLengkapnya dapat dilihat pada: Dokumentasi buku-masjid/demo-data .
Screenshot
Laporan Bulanan
Laporan Per Kategori
Laporan Per Pekan
Jadwal Pengajian
Kontribusi
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.
Kontak
Untuk Diskusi:
Untuk pengumuman dan update:
Lisensi
Proyek Buku Masjid merupakan perangkat lunak open-source yang dilisensikan di bawah Lisensi MIT .
Credits
Proyek ini menggunakan bunyi bip dari Pixabay oleh transcendedlifting (Pixabay License)