# ✅ RINGKASAN IMPLEMENTASI SISTEM APPROVAL PEMINJAMAN BUKU

## 📌 Overview

Sistem approval peminjaman buku yang lengkap memungkinkan murid/guru mengajukan permintaan peminjaman, dan admin menerima atau menolak permintaan dengan validasi stok real-time.

---

## 🎯 Fitur yang Sudah Diimplementasikan

### **✅ Fitur Murid/Guru**

| Fitur | Lokasi | Status | Keterangan |
|-------|--------|--------|-----------|
| **Mengajukan Peminjaman** | `/anggota/profil`, `/guru/profil` | ✅ Aktif | Form dengan dropdown buku & qty |
| **Lihat Status Pengajuan** | Tabel Riwayat Peminjaman | ✅ Aktif | Badge dengan 5 status berbeda |
| **Lihat Statistik** | Dashboard Profil | ✅ Aktif | Total, Sedang Dipinjam, Selesai |
| **Mengembalikan Buku** | Tombol "Kembalikan" | ✅ Aktif | Submit pengembalian ke admin |
| **Validasi Input** | Client-side & Server-side | ✅ Aktif | Cek duplikat, stok, limit |

### **✅ Fitur Admin**

| Fitur | Lokasi | Status | Keterangan |
|-------|--------|--------|-----------|
| **Lihat Daftar Peminjaman** | `/admin/peminjaman` | ✅ Aktif | Tabel lengkap dengan pagination |
| **Filter Status** | Dropdown Filter | ✅ Baru | Menunggu ACC, Dipinjam, dll |
| **Search Real-time** | Input Search | ✅ Aktif | Cari nama, buku, status |
| **Approve Peminjaman** | Modal "Setujui" | ✅ Aktif | Tentukan durasi, hitung tanggal |
| **Reject Peminjaman** | Tombol "Tolak" | ✅ Aktif | Confirm & ubah status |
| **Terima Pengembalian** | "Terima Pengembalian" | ✅ Aktif | Cek kondisi, hitung denda |
| **Edit Peminjaman** | Tombol "Edit" | ✅ Aktif | Ubah data, durasi, status |
| **Dashboard Statistics** | Card Statistics | ✅ Aktif | 4 metrik utama |

---

## 🔧 Komponen Teknis

### **A. Database**

#### **Tabel: bookrent**
```sql
- id (primary key)
- user_id (foreign key → user)
- borrow_date (date)
- return_date (date nullable)
- status (enum: 'menunggu_acc','dipinjam','ditolak','proses_kembali','kembali')
- denda (integer, default 0)
- created_at (timestamp)
- updated_at (timestamp)
```

#### **Tabel: detail_bookrent**
```sql
- id (primary key)
- bookrent_id (foreign key → bookrent)
- book_id (foreign key → books)
- qty (integer)
- condition (enum: 'baik','rusak','hilang', default 'baik')
```

**Status Enum Values:**
- `menunggu_acc` - Menunggu persetujuan admin
- `dipinjam` - Sudah disetujui, buku sedang dipinjam
- `ditolak` - Permintaan ditolak
- `proses_kembali` - Proses pengembalian
- `kembali` - Peminjaman selesai

---

### **B. Models**

#### **Model: Bookrent** (`app/Models/Bookrent.php`)
```php
- user() → belongsTo(User)
- details() → hasMany(DetailBookrent)
- getDueAtAttribute() → Carbon
```

#### **Model: DetailBookrent** (`app/Models/DetailBookrent.php`)
```php
- bookrent() → belongsTo(Bookrent)
- book() → belongsTo(Book)
```

#### **Model: User** (`app/Models/User.php`)
```php
- ROLE_ANGGOTA = 0
- ROLE_ADMIN = 1
- ROLE_GURU = 2
```

---

### **C. Controllers**

#### **1. PeminjamanController** (`app/Http/Controllers/Admin/PeminjamanController.php`)

**Methods:**
| Method | Route | Aksi |
|--------|-------|------|
| `index()` | GET `/admin/peminjaman` | Tampilkan daftar peminjaman |
| `create()` | GET `/admin/peminjaman/create` | Form buat peminjaman manual |
| `store()` | POST `/admin/peminjaman` | Simpan peminjaman admin |
| `edit()` | GET `/admin/peminjaman/{id}/edit` | Form edit peminjaman |
| `update()` | PUT `/admin/peminjaman/{id}` | Update peminjaman |
| `approve()` | POST `/admin/peminjaman/{id}/approve` | Approve permintaan |
| `reject()` | POST `/admin/peminjaman/{id}/reject` | Reject permintaan |
| `confirmReturn()` | PUT `/admin/peminjaman/{id}/confirm-return` | Terima pengembalian |
| `processReturn()` | GET `/admin/peminjaman/{id}/process-return` | Form pengembalian |
| `calculateFineAjax()` | POST `/admin/peminjaman/{id}/calculate-fine` | Hitung denda AJAX |
| `destroy()` | DELETE `/admin/peminjaman/{id}` | Hapus peminjaman |

**Key Logic:**
- ✅ Validasi stok sebelum approve
- ✅ Lock transaksi untuk mencegah race condition
- ✅ Auto-calculate denda based on return date & condition
- ✅ Stok management (decrement saat approve, increment saat return)

#### **2. ProfileAnggotaController** (`app/Http/Controllers/ProfileAnggotaController.php`)

**Methods:**
| Method | Route | Aksi |
|--------|-------|------|
| `profilDetail()` | GET `/anggota/profil-detail` | Tampilkan profil + form pinjam |
| `borrow()` | POST `/anggota/pinjam` | Submit permintaan peminjaman |
| `returnBook()` | POST `/anggota/pengembalian/{id}` | Submit pengembalian |

**Key Logic:**
- ✅ Validasi 3 peminjaman aktif max
- ✅ Cek duplikat peminjaman
- ✅ Cek buku sudah dipinjam (status aktif)
- ✅ Validasi stok per item
- ✅ Auto-set status 'menunggu_acc'

---

### **D. Routes**

#### **Admin Routes** (`routes/web.php`)
```php
Route::prefix('admin')->middleware(['auth', 'role:1'])->group(function () {
    // Peminjaman
    Route::resource('peminjaman', PeminjamanController::class)
        ->only(['index', 'create', 'store', 'edit', 'update', 'destroy']);
    
    Route::post('peminjaman/{peminjaman}/approve', [PeminjamanController::class, 'approve'])
        ->name('admin.peminjaman.approve');
    Route::post('peminjaman/{peminjaman}/reject', [PeminjamanController::class, 'reject'])
        ->name('admin.peminjaman.reject');
    Route::put('peminjaman/{peminjaman}/confirm-return', [PeminjamanController::class, 'confirmReturn'])
        ->name('admin.peminjaman.confirm-return');
    Route::post('peminjaman/{peminjaman}/calculate-fine', [PeminjamanController::class, 'calculateFineAjax'])
        ->name('admin.peminjaman.calculate-fine');
    Route::get('peminjaman/{peminjaman}/process-return', [PeminjamanController::class, 'processReturn'])
        ->name('admin.peminjaman.process-return');
});
```

#### **Murid/Guru Routes** (`routes/web.php`)
```php
Route::prefix('anggota')->middleware(['auth', 'role:0'])->group(function () {
    Route::post('pinjam', [ProfileAnggotaController::class, 'borrow'])
        ->name('anggota.pinjam.store');
    Route::post('pengembalian/{bookrent}', [ProfileAnggotaController::class, 'returnBook'])
        ->name('anggota.pengembalian.store');
    Route::get('profil-detail', [ProfileAnggotaController::class, 'profilDetail'])
        ->name('anggota.profil.detail');
});

Route::prefix('guru')->middleware(['auth', 'role:2'])->group(function () {
    Route::post('pinjam', [ProfileAnggotaController::class, 'borrow'])
        ->name('guru.pinjam.store');
    Route::post('pengembalian/{bookrent}', [ProfileAnggotaController::class, 'returnBook'])
        ->name('guru.pengembalian.store');
    Route::get('profil-detail', [ProfileAnggotaController::class, 'profilDetail'])
        ->name('guru.profil.detail');
});
```

---

### **E. Views**

#### **1. Admin Views**

| File | Path | Fitur |
|------|------|-------|
| **index.blade.php** | `resources/views/admin/peminjaman/` | Daftar peminjaman, filter, search, tombol action |
| **create.blade.php** | `resources/views/admin/peminjaman/` | Form buat peminjaman manual |
| **edit.blade.php** | `resources/views/admin/peminjaman/` | Form edit peminjaman |
| **return.blade.php** | `resources/views/admin/peminjaman/` | Form terima pengembalian |

**Fitur View Index:**
- 📊 Statistics cards (4 metrik)
- 🔍 Search box
- 📋 Filter dropdown status
- 📑 Responsive table dengan pagination
- 🎨 Modal approve dengan durasi input
- 📱 Mobile-friendly design

#### **2. Murid/Guru Views**

| File | Path | Fitur |
|------|------|-------|
| **index.blade.php** | `resources/views/anggota/Profile/` | Form pinjam + tabel riwayat |

**Fitur:**
- 📝 Form pinjam dengan tambah/hapus buku
- 📊 Statistik peminjaman (3 card)
- 📜 Tabel riwayat dengan status badge
- 🔄 Tombol kembalikan untuk buku aktif

---

### **F. JavaScript & AJAX**

#### **Admin Approval Modal**
```javascript
// Show modal
function showApproveModal(peminjaman_id, student_name)

// Handle form submission
function handleApproveSubmit(e)

// Update return date preview
function updateReturnDate()

// Filter functionality
document.getElementById('statusFilter').addEventListener('change', filterRows)
```

#### **Features:**
- ✅ Modal dengan form durasi
- ✅ Real-time return date calculation
- ✅ AJAX submission tanpa reload
- ✅ Loading state di submit button
- ✅ Error handling dengan user feedback
- ✅ Auto-reload page after success

---

### **G. Validasi & Business Logic**

#### **Saat Mengajukan (borrow)**
```php
- Validate buku ada di DB
- Cek 3 peminjaman aktif max
- Cek duplikat buku dalam form
- Cek buku tidak sedang dipinjam (status aktif)
- Cek stok >= qty yang diminta
- Auto-set status = 'menunggu_acc'
- Tidak kurangi stok (pending approval)
```

#### **Saat Approve**
```php
- Validasi status = 'menunggu_acc'
- Cek stok cukup (lock for update)
- Decrement stok untuk setiap buku
- Set borrow_date = hari ini
- Set return_date = hari ini + durasi
- Set status = 'dipinjam'
- Return date preview real-time
```

#### **Saat Reject**
```php
- Validasi status = 'menunggu_acc'
- Set status = 'ditolak'
- Stok tidak berubah
```

#### **Saat Pengembalian (confirm)**
```php
- Validasi status = 'proses_kembali'
- Cek kondisi: baik/rusak/hilang
- Calculate denda:
  - Late fee: (hari - 7) × Rp 5.000
  - Damage: Rp 50.000 per buku
  - Loss: Rp 50.000 per buku
- Increment stok sesuai kondisi
- Set status = 'kembali'
- Simpan denda di DB
```

---

## 📊 Alur Data

### **Flow Approval Peminjaman**

```
MURID/GURU
   ↓
[Submit Form Pinjam]
   ↓
ProfileAnggotaController::borrow()
   ↓
[Validasi]
├─ Stok?
├─ Duplikat?
├─ Max 3 aktif?
├─ Sudah pinjam buku ini?
   ↓
[Simpan ke DB]
→ bookrent (status='menunggu_acc')
→ detail_bookrent (qty, book_id)
   ↓
ADMIN
   ↓
[Lihat daftar di /admin/peminjaman]
   ↓
[Klik Setujui]
   ↓
[Modal: Tentukan durasi]
   ↓
[Click Konfirmasi]
   ↓
PeminjamanController::approve()
   ↓
[Validasi & Lock Transaksi]
├─ Status = 'menunggu_acc'?
├─ Stok >= qty?
   ↓
[Update Data]
→ Decrement stock
→ Set borrow_date = NOW()
→ Set return_date = NOW() + duration
→ Set status = 'dipinjam'
   ↓
[Redirect + Flash Message]
   ↓
MURID/GURU
   ↓
[Lihat status berubah menjadi DIPINJAM]
   ↓
[Datang ke perpus ambil buku]
```

---

## 🔐 Keamanan

| Aspek | Implementasi |
|-------|-------------|
| **Auth** | Middleware `['auth', 'role:X']` |
| **Authorization** | Role check (Admin=1, Murid=0, Guru=2) |
| **CSRF** | Token di semua form @csrf |
| **SQL Injection** | Query Builder + Prepared Statements |
| **Mass Assignment** | $fillable di Model |
| **Race Condition** | lockForUpdate() saat approve |
| **Validation** | Server-side + Client-side |

---

## ⚙️ Konfigurasi

### **Durasi Peminjaman**
- Min: 1 hari
- Max: 30 hari
- Default: 7 hari
- **Edit di:** `PeminjamanController::approve()` line ~330

### **Denda Perhitungan**
- Late fee: Rp 5.000/hari (setelah 7 hari)
- Damage: Rp 50.000
- Loss: Rp 50.000
- **Edit di:** `PeminjamanController::calculateFine()` atau `confirmReturn()`

### **Limit Peminjaman Aktif**
- Maksimal: 3 buku sekaligus
- **Edit di:** `ProfileAnggotaController::borrow()` line ~75

---

## 📈 Testing Checklist

### **✅ User Flow Murid**
- [ ] Bisa lihat form pinjam buku
- [ ] Bisa tambah/hapus buku
- [ ] Bisa submit pengajuan
- [ ] Status berubah ke "Menunggu ACC"
- [ ] Bisa lihat riwayat peminjaman
- [ ] Bisa melihat statistik

### **✅ Admin Flow**
- [ ] Bisa lihat daftar peminjaman
- [ ] Bisa filter status
- [ ] Bisa search nama/buku
- [ ] Bisa click tombol "Setujui"
- [ ] Modal muncul dengan form
- [ ] Return date auto-update
- [ ] Bisa submit dengan durasi
- [ ] Status berubah ke "Dipinjam"
- [ ] Stok berkurang
- [ ] Bisa click tombol "Tolak"
- [ ] Status berubah ke "Ditolak"
- [ ] Bisa terima pengembalian
- [ ] Denda terhitung
- [ ] Stok kembali

### **✅ Validasi**
- [ ] Tidak bisa pinjam > stok
- [ ] Tidak bisa pinjam buku sama 2x
- [ ] Tidak bisa pinjam > 3 aktif
- [ ] Tidak bisa approve jika stok <= 0
- [ ] Denda keterlambatan terhitung benar

---

## 📚 Dokumentasi Lengkap

| File | Tujuan |
|------|--------|
| **SISTEM_APPROVAL_PEMINJAMAN.md** | Dokumentasi teknis lengkap |
| **PANDUAN_CEPAT_ADMIN.md** | Quick start untuk admin |
| **PANDUAN_MURID_GURU.md** | Panduan lengkap untuk murid/guru |

---

## 🚀 Fitur Tambahan yang Dapat Dikembangkan

- [ ] Email notification saat approval/rejection
- [ ] SMS reminder 2 hari sebelum deadline
- [ ] Laporan peminjaman per bulan
- [ ] Export data peminjaman ke Excel
- [ ] QR code untuk tracking buku
- [ ] Mobile app untuk submit request
- [ ] Integration dengan sistem poin/reward
- [ ] Auto-fine calculation di dashboard
- [ ] Reservation buku (pre-order)
- [ ] Wishlist buku untuk murid

---

## 📞 Troubleshooting

### **Masalah: Tombol approve tidak berfungsi**
```
Solusi:
1. Refresh halaman
2. Cek browser console untuk error
3. Pastikan JavaScript enabled
4. Cek CSRF token valid
```

### **Masalah: Stok tidak berkurang**
```
Solusi:
1. Cek approval berhasil (status berubah?)
2. Refresh halaman inventory
3. Cek database langsung
4. Cek migration sudah run
```

### **Masalah: Denda tidak terhitung**
```
Solusi:
1. Cek return_date > borrow_date + 7
2. Cek kondisi buku (rusak/hilang)?
3. Manual hitung: (hari - 7) × 5000
4. Hubungi developer jika ada bug
```

---

## 📝 Catatan Penting

1. **Stok Management**
   - Stok hanya berkurang saat APPROVE
   - Tidak berkurang saat REQUEST
   - Dikembalikan saat RETURN (sesuai kondisi)

2. **Status Flow**
   ```
   menunggu_acc → (approve) → dipinjam → proses_kembali → kembali
                → (reject) → ditolak
   ```

3. **Durasi Peminjaman**
   - Default: 7 hari
   - Admin bisa tentukan durasi lain
   - Dihitung mulai dari tanggal approval

4. **Denda Perhitungan**
   - Otomatis saat konfirmasi pengembalian
   - Admin bisa override manual jika diperlukan

---

**Status:** ✅ **PRODUCTION READY**  
**Version:** 1.0  
**Last Updated:** 2024  
**Maintained By:** Admin Perpustakaan