# ⚡ Admin Document Management - Quick Start Guide

## 🚀 Akses Menu

### From Admin Dashboard:
1. Login sebagai admin
2. Sidebar left → **Dokumen Upload** atau **Bukti Transfer**

### Direct URL:
```
Dokumen Upload: /admin/documents
Bukti Transfer: /admin/documents/proofs/list
Statistik: /admin/documents/stats
```

---

## 📋 Manajemen Dokumen (KTP, SIM, etc)

### Langkah Verifikasi Dokumen:

**1. Buka Daftar Dokumen**
- Menu: **Dokumen Upload**
- Filter berdasarkan tipe, status, atau user
- Klik **Filter** untuk apply

**2. Pilih Dokumen**
- Lihat tabel dokumen
- Klik tombol **Lihat** pada dokumen yang perlu diverifikasi

**3. Review Dokumen**
- Lihat preview gambar dokumen
- Klik **Download File** jika ingin lihat detail lebih besar
- Periksa informasi pengguna di sebelah kanan

**4. Verifikasi/Tolak**
- ✅ Klik **Terima & Verifikasi** untuk approve
- ❌ Klik **Tolak Dokumen** untuk reject
- Tambahkan catatan/alasan (optional/required)
- Klik konfirmasi

### Filter Dokumen:

| Filter | Options |
|--------|---------|
| **Tipe Dokumen** | Semua, KTP, SIM, Paspor, Lainnya |
| **Status** | Pending, Terverifikasi, Ditolak |
| **Cari User** | Nama, Email, Telepon |

### Status Badge:
- 🟢 **Terverifikasi** - Dokumen sudah diverifikasi
- 🟡 **Pending** - Menunggu verifikasi admin
- 🔴 **Ditolak** - Dokumen ditolak, user perlu re-upload

---

## 💳 Manajemen Bukti Transfer

### Langkah Verifikasi Pembayaran Transfer:

**1. Buka Daftar Bukti Transfer**
- Menu: **Bukti Transfer**
- Filter berdasarkan status atau cari order ID/user/mobil
- Klik **Filter** untuk apply

**2. Pilih Bukti Pembayaran**
- Lihat tabel pembayaran transfer
- Klik tombol **Lihat** pada pembayaran yang perlu diverifikasi

**3. Review Bukti Pembayaran**
- Lihat preview image bukti transfer
- Lihat detail pembayaran:
  - Order ID
  - Pengguna
  - Mobil & Rental
  - Jumlah pembayaran
  - Status

**4. Verifikasi/Tolak Pembayaran**
- ✅ Klik **Terima Pembayaran** untuk approve
  - Sistem otomatis update status menjadi "Paid"
  - Rental status berubah menjadi "Confirmed"
- ❌ Klik **Tolak Pembayaran** untuk reject
  - Tambahkan alasan penolakan
  - User akan lihat bukti ditolak di aplikasi

### Filter Bukti Transfer:

| Filter | Options |
|--------|---------|
| **Status** | Pending, Terverifikasi, Ditolak |
| **Cari** | Order ID, User, Mobil |

---

## 📊 Dashboard Statistik

### Akses:
- **Menu:** Dokumen Upload → Tombol **Statistik**
- **URL:** `/admin/documents/stats`

### Informasi yang Ditampilkan:

**Dokumen:**
- Total dokumen upload
- Menunggu verifikasi
- Terverifikasi
- Ditolak
- Distribusi by tipe

**Bukti Transfer:**
- Total bukti transfer
- Menunggu verifikasi
- Terverifikasi

### Quick Actions (dari Dashboard):
- 🔵 **Verifikasi Dokumen** - Ke daftar pending dokumen
- 🔵 **Verifikasi Bukti Transfer** - Ke daftar pending transfer
- 🔵 **Semua Dokumen** - Ke daftar lengkap
- 🔵 **Semua Bukti Transfer** - Ke daftar lengkap

---

## ⚙️ Key Actions

### Download Dokumen
```
1. Buka detail dokumen/bukti
2. Klik tombol "Download File"
3. File akan di-download ke komputer
```

### Search User
```
1. Klik kolom "Cari User"
2. Ketik nama, email, atau telepon
3. Klik "Filter"
```

### Filter by Status
```
1. Pilih status dari dropdown
2. Klik "Filter"
3. Hanya item dengan status tersebut yang ditampilkan
```

### Verify dengan Catatan
```
1. Buka detail dokumen/bukti
2. Klik "Terima & Verifikasi" / "Terima Pembayaran"
3. Tambahkan catatan (opsional)
4. Klik tombol confirm
```

### Reject dengan Alasan
```
1. Buka detail dokumen/bukti
2. Klik "Tolak Dokumen" / "Tolak Pembayaran"
3. Isi alasan penolakan (wajib)
4. Klik "Konfirmasi Penolakan"
```

---

## 📱 UI Elements

### Status Colors:
| Warna | Arti | Action |
|-------|------|--------|
| 🟢 Hijau | Terverifikasi | Tidak ada (final) |
| 🟡 Kuning | Pending | Perlu verify |
| 🔴 Merah | Ditolak | Final |

### Tombol:
- 🔵 **Biru** - Info/View
- 🟢 **Hijau** - Approve/Accept
- 🔴 **Merah** - Reject/Delete
- 🔘 **Abu-abu** - Back/Cancel

---

## 🔄 Workflow Otomatis

### Saat Dokumen Diverifikasi:
```
Status: Pending → Verified
Pengguna notif: Dokumen Anda sudah terverifikasi
```

### Saat Dokumen Ditolak:
```
Status: Pending → Rejected
Alasan: Terlihat di aplikasi user
Pengguna notif: Dokumen Anda ditolak, alasan: [reason]
```

### Saat Bukti Transfer Diverifikasi:
```
Status Payment: Pending → Paid
Status Rental: Active → Confirmed
Pengguna notif: Pembayaran Anda sudah diverifikasi
Rental: Otomatis dikonfirmasi
```

### Saat Bukti Transfer Ditolak:
```
Status Payment: Pending → Failed
Alasan: Terlihat di aplikasi user
Pengguna notif: Pembayaran Anda ditolak, alasan: [reason]
Rental: Tetap active sampai pembayaran berhasil
```

---

## 🎯 Tips & Best Practices

### ✅ DO:
- ✅ Verifikasi dokumen dengan teliti
- ✅ Tambahkan catatan untuk dokumentasi
- ✅ Berikan alasan jelas saat reject
- ✅ Check timestamps untuk track timing
- ✅ Use search/filter untuk efisiensi

### ❌ DON'T:
- ❌ Jangan approve dokumen yang terlihat palsu
- ❌ Jangan reject tanpa alasan
- ❌ Jangan lupa download file untuk backup
- ❌ Jangan skip verifikasi pembayaran transfer manual

### 💡 Tips:
- Batch verifikasi dokumen saat ada banyak pending
- Download dokumen jika perlu konsultasi
- Use filters untuk fokus ke item tertentu
- Check statistik untuk monitor workload
- Sort by tanggal untuk verifikasi berdasarkan urutan

---

## 🆘 Common Issues

### Dokumen tidak terlihat?
→ Check filter status (mungkin terfilter)
→ Coba gunakan tombol "Reset"

### Image tidak load?
→ Check internet connection
→ Refresh browser (F5)
→ Check storage permissions

### Can't download file?
→ File mungkin sudah dihapus dari server
→ Check storage/app/ folder permissions

### Perubahan status tidak muncul?
→ Refresh halaman (F5)
→ Check browser cache (Ctrl+Shift+Delete)

---

## 📞 Navigation Quick Reference

```
Admin Dashboard
├── Sidebar > Dokumen Upload
│   ├── Lihat daftar dokumen
│   ├── Filter & search
│   ├── Review & verify/reject
│   └── Download file
│
├── Sidebar > Bukti Transfer
│   ├── Lihat daftar transfer
│   ├── Filter & search
│   ├── Review & verify/reject
│   └── Download bukti
│
└── Sidebar > Dokumen Upload > Statistik
    ├── Dashboard dengan stats
    └── Quick action buttons
```

---

## 🔐 Permissions

Hanya admin yang bisa:
- ✅ View dokumen users
- ✅ Verify dokumen
- ✅ Reject dokumen
- ✅ Download dokumen
- ✅ View payment proofs
- ✅ Verify/reject payments
- ✅ Access statistics

---

**Version**: 1.0
**Last Updated**: 2026-06-09
**Status**: ✅ Ready to Use