Buku Masjid

Buku Masjid adalah sistem pengelolaan keuangan 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 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.

Sponsor

Kami ingin berterima kasih kepada sponsor yang mendukung development Buku Masjid.

Jika anda tertarik untuk menjadi sponsor, silakan hubungi Whatsapp Tim Buku Masjid pada halaman ini: 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:
```
email: admin@example.net
password: password
```

Langkah Install dengan Docker

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

Atau Anda dapat mengotomatiskan proses ini menggunakan perintah ini.

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:
```
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

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):

$ 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.

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.

imanifaiz/buku-masjid