muhfaris/perpustakaan

Tentang Perpustakaan Sederhana

Sistem Informasi Manajemen Perpustakaan Sederhana ini adalah -seperti namanya- sebuah sistem sederhana untuk mengelola perpustakaan dari manajemen pustakawan, anggota, buku, hingga peminjaman buku yang dibuat dengan sesederhana mungkin agar mudah digunakan.

Sebetulnya dulu sudah pernah ada aplikasinya, tetapi source codenya tidak ada lagi. Adapun videonya bisa dilihat di YouTube.

Fitur Perpustakaan Sederhana

Status	Role	Modul	Keterangan
✅	Semua	Login	👍
❌	Semua	Login dengan Gmail	✨
✅	Administrator	Manajemen Pustakawan	👍📬
✅	Pustakawan	Manajemen Anggota	👍📬
✅	Pustakawan	Manajemen Buku	👍
❌	Pustakawan	Manajemen Kategori Buku	👍
✅	Pustakawan	Manajemen Peminjaman Buku	👍║▌💰📬
❌	Pustakawan	Cetak Kartu Angota	✨💰📬
❌	Anggota	Histori Peminjaman Buku	👍
✅	Semua	Ubah Profil	👍
✅	Semua	Ubah Password	👍

Keterangan: Sint ea quam exercit ✅ = Sudah ada dan mungkin butuh modifikasi lebih baik
🔧 = Sudah ada dan butuh perbaikan segera ❌ = Belum ada
⏲️ = Dalam pengerjaan
📬 = Butuh SMTP
║▌ = Butuh barcode scanner (atau logikanya)
💰 = Butuh perhitungan uang
👍 = Wajib ada
✨ = Nice to have

Administrator juga dapat akses terhadap seluruh aksi yang dapat dilakukan oleh Pustakawan.

Kebutuhan Sistem

PHP 8.1+
Composer

Proses Instalasi

Fork repositori ini terlebih dahulu. Lebih senang lagi kalau klik tanda Star juga.
Kemudian clone ke dalam komputer Anda. git clone url-repositori
Masuk ke dalam folder projek. cd perpustakaan
Install dependencies. composer install
Salin file env. cp .env.example .env
Sesuaikan nilai pada env, misalnya kredensial database
Masukkan data. php artisan migrate --seed
Jalankan projek. php artisan serve
Buka di browser http://localhost:8000

Alur Bisnis

Login

Seluruh user bisa login setelah melakukan verifikasi email.

Manajemen Pustakawan

Admin menambahkan user pustakawan dari panel (minimal nama dan email).
Pustakawan menerima email verifikasi berisi link untuk set password.
Pustakawan belum bisa login sebelum melakukan verifikasi di atas.
Pustakawan belum bisa melakukan transaksi peminjaman buku sebelum melengkapi seluruh data diri.

Manajemen Anggota

Pustakawan menambahkan user anggota dari panel (minimal nama dan email).
Anggota menerima email verifikasi berisi link untuk set password.
Anggota belum bisa login sebelum melakukan verifikasi di atas.
Anggota belum bisa meminjam buku sebelum melengkapi seluruh data diri.

Peminjaman Buku

Pustakawan scan kartu anggota atau input nomor anggota dahulu.
Selanjutnya tinggal scan barcode ISBN pada buku.
Secara default, batas waktu peminjaman adalah tiga (3) hari. Lebih dari itu akan dikenakan biaya Rp 500.
Nominal denda diatur di file .env dengan key DENDA_RUPIAH.

Cara menjalankan aplikasi

Install Composer secara global (tanpa docker)
Install Docker
Install make, biasanya sudah terpasang secara default oleh OS yang dipakai. Tetapi untuk Windows, bisa menggunakan Chocolatey

Salin repositori dan masuk ke repositori yang telah disalin

git clone https://github.com/nurfachmi/perpustakaan.git
cd perpustakaan

Salin file .env.example dan beri nama .env
```
cp .env.example .env
```
Jalankan command make untuk install dependencies, dan migrasi db dengan dummy data
```
make
```
Setelah berhasil, aplikasi sudah bisa diakses pada http://localhost. Dan bisa masuk dengan email admin@nurfachmi.com dan password password

Selain itu, terdapat beberapa make command yang tersedia

make install Untuk menginstall dependencies yang dibutuhkan menjalankan Laravel sail
make run Untuk menjalankan aplikasi
make migrate Mempersiapkan database dan table untuk menjalankan aplikasi (hanya perlu sekali run atau ketika ada perubahan dimodel)
make seed Mengisi database dengan dummy data untuk keperluan testing (hanya perlu sekali run atau ketika ada perubahan dimodel dan seeder)
make restart Menjalankan ulang aplikasi
make stop Menghentikan aplikasi
make rebuild Jika ingin merebuild image docker (Bisa digunakan ketika ada perubahan yang tidak langsung terlihat)

Kontribusi

Terima kasih atas niatan kontribusinya kepada Sistem Informasi Manajemen Perpustakaan Sedehana ini.

Silahkan ajukan Pull Request jika ada penambahan, pengurangan, atau perbaikan fitur serta ajukan Issue jika menemukan kekeliruan dalam sistem yang ada, khususnya dari demo yang disediakan.

License

Sistem Informasi Manajemen Pepustakaan Sederhana dibuat dengan MIT license.

muhfaris / perpustakaan