# Manual Peminjaman Kendaraan (Vehicle Loan Requests)

## Login

1. Buka browser (Chrome/Edge/Firefox) dan akses URL aplikasi (contoh: `https://spatie.mersifarma.com`)
2. Halaman login akan tampil dengan logo **PT Mersifarma TM**
3. Masukkan **Email or Username** (email atau username akun Anda)
4. Masukkan **Password**
5. Centang **Remember me** agar tidak perlu login ulang (opsional)
6. Klik tombol **Sign In**
7. Jika lupa password, klik **Forgot password?** untuk reset

<!-- SCREENSHOT: Halaman login (logo, form email/password, tombol Sign In) -->

Setelah login berhasil, Anda akan masuk ke halaman utama (dashboard).

<!-- SCREENSHOT: Dashboard setelah login -->

---

## Alur Kerja (Workflow)

```
Pemohon → Manager (Approver 1) → GA (Approver 2) → Realisasi (Driver) → Feedback → Selesai
```

| Step | Peran | Aksi | Status |
|------|-------|------|--------|
| 1 | Pemohon | Buat request | **Initiated** |
| 2 | Manager (Dept Head) | Approve / Reject | **In Process** / Rejected |
| 3 | GA (Syachrezy - 953) | Assign kendaraan + driver, Approve / Reject | **Approved** / Rejected |
| 4 | Driver | Isi realisasi pemakaian (via link publik) | (tetap Approved) |
| 5 | Pemohon | Beri rating & feedback | **Complete** |

---

## 1. Akses Menu

Navigasi sidebar di sebelah kiri:

1. Cari menu **General** (kelompok menu kelima dari atas, ikon `fa-layer-group`)
2. Klik **General** untuk membuka submenu
3. Pilih **Peminjaman Kendaraan** (ikon `fa-truck`)
4. Halaman daftar peminjaman akan terbuka

<!-- SCREENSHOT: Sidebar menu — General > Peminjaman Kendaraan -->

**Alternatif cepat:** Jika ada notifikasi di **Approval Inbox** (ikon lonceng pojok kanan atas), klik item **Peminjaman Kendaraan** untuk langsung menuju halaman detail.

<!-- SCREENSHOT: Approval Inbox dropdown (lonceng pojok kanan atas) -->

---

## 2. Membuat Request Baru (Sebagai Pemohon)

1. Dari halaman daftar **Peminjaman Kendaraan**, klik tombol **Create Request**
2. Isi form:

### Personal Information
| Field | Keterangan |
|-------|-----------|
| Name | Nama pemohon (default: nama user login) |
| Department | Departemen pemohon (dropdown, default: dept user login) |

<!-- SCREENSHOT: Form create — Personal Information -->

### Perjalanan
| Field | Keterangan |
|-------|-----------|
| Departure Date | Tanggal & jam keberangkatan (min: hari ini, default jam 08:00) |
| Return Date | Tanggal & jam kepulangan (min: tanggal keberangkatan, default jam 18:00) |
| Where to go / Purpose | Tujuan / keperluan perjalanan |
| Who will join | Daftar peserta (ketik manual, pilih dari autocomplete user) — opsional |
| Additional Info | Catatan tambahan — opsional |

<!-- SCREENSHOT: Form create — bagian Perjalanan + Who will join -->

### Images
- Upload gambar pendukung (opsional)
- Format: jpg, jpeg, png, gif, webp — maks 2 MB per file
- Bisa drag & drop atau klik untuk memilih file

<!-- SCREENSHOT: Form create — bagian Images (drag & drop) -->

3. Klik **Submit Request**
4. Request masuk ke antrian approval manager (department head)

---

## 3. Approval Manager (Approver 1 — Department Head)

Manager mendapat notifikasi di **Approval Inbox**.

<!-- SCREENSHOT: Halaman detail request dari sisi Manager — bagian Actions -->

### Cara Approve/Reject:
1. Buka halaman detail request
2. Scroll ke bagian **Actions**
3. Isi **Comment** (wajib)
4. Klik:
   - **Approve** — request lanjut ke GA, status → **In Process**
   - **Reject** — request dikembalikan ke pemohon, status → **Rejected**

---

## 4. Approval GA (Approver 2 — Syachrezy Kurniawan / 953)

GA mendapat notifikasi setelah manager approve.

### Tugas GA sebelum Approve:

#### a. Assign Kendaraan & Driver
- Pilih **Vehicle** dari dropdown (data kendaraan dari SnipeIT)
- Pilih **Driver** dari dropdown (anggota departemen driver)
- Data driver (no. telepon, WhatsApp) akan tampil setelah dipilih

<!-- SCREENSHOT: Form assign kendaraan & driver -->

#### b. Approve atau Reject
- Isi **Comment** (wajib)
- Klik:
  - **Approve** — status → **Approved**, link realisasi dibuat
  - **Reject** — request ditolak, status → **Rejected**

### Shareable Realization Link
Setelah approve, GA mendapat **link realisasi** unik yang bisa:
- **Copy** — disalin ke clipboard
- **Share via WhatsApp** — langsung terkirim ke nomor driver

GA bisa meng-*update* assignment (ganti kendaraan/driver) kapan saja sebelum realisasi disubmit.

<!-- SCREENSHOT: Bagian Realization Link + tombol Copy / Share WhatsApp -->

---

## 5. Realisasi (Diisi Driver — Via Link Publik)

Driver membuka link yang dibagikan GA (tidak perlu login).

Form realisasi:
| Field | Keterangan |
|-------|-----------|
| Nama Pemakai | Nama pemakai kendaraan (default: nama pemohon) |
| Jumlah Pemakai | Berapa orang yang ikut |
| Tanggal & Jam Keberangkatan | Waktu berangkat aktual |
| Tanggal & Jam Kepulangan | Waktu pulang aktual |
| KM Awal | Angka odometer awal |
| KM Akhir | Angka odometer akhir |
| Catatan / Keterangan | Opsional |

<!-- SCREENSHOT: Form realisasi (tanpa login) -->

Setelah disubmit, jarak tempuh otomatis terhitung (KM Akhir - KM Awal).

---

## 6. Feedback & Rating (Sebagai Pemohon)

Setelah perjalanan selesai dan realisasi disubmit:

1. Buka halaman detail request
2. Scroll ke bagian **Feedback**
3. Beri **Rating** (klik bintang 1-5)
4. Isi **Feedback** (opsional)
5. Klik **Submit Feedback**
6. Status → **Complete**

<!-- SCREENSHOT: Bagian Rating (bintang) + Feedback textarea -->

---

## 7. Edit Request (Jika Ditolak)

Jika request di-**Rejected**:
1. Klik tombol **Edit** di halaman detail
2. Perbaiki data yang diperlukan
3. Klik **Update Request**
4. Status kembali ke **Initiated**, menunggu approval manager lagi

<!-- SCREENSHOT: Halaman edit (form sama seperti create, terisi data sebelumnya) -->

---

## 8. Activity Log

Di halaman detail, **Activity Log** mencatat:
- Siapa yang approve/reject
- Komentar dari approver
- Data realisasi (KM, waktu, pemakai)
- Rating & feedback
- Waktu kejadian

<!-- SCREENSHOT: Activity Log di bagian bawah halaman detail -->

---

## 9. Print

Di halaman detail, klik tombol **Print** untuk mencetak detail peminjaman.

---

## Ringkasan Status

| Status | Arti |
|--------|------|
| Initiated | Menunggu approval manager |
| In Process | Manager approve, menunggu GA |
| Approved | Semua approve, menunggu realisasi |
| Complete | Feedback sudah diisi, selesai |
| Rejected | Ditolak (bisa diedit) |

---

## Tips
- **Approval Inbox** auto-refresh setiap 30 detik
- Status **Rejected** bisa diedit kapan saja oleh pemohon
- GA bisa mengubah kendaraan/driver sebelum realisasi
- Link realisasi bersifat publik — simpan link dengan aman
- Setelah **Complete**, tidak bisa diedit atau dihapus