# Manual Permintaan ATK Umum (Office Supply 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) → Selesai
```

- **Step 1**: User membuat request → status **Initiated**
- **Step 2**: Manager approve → status **In Process**
- **Step 3**: GA approve per-item → status **Approved** (siap cetak)
- Jika ditolak di step mana pun → status **Rejected** (bisa diedit)

---

## 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 **Permintaan ATK Umum** (ikon `fa-pen-to-square`)
4. Halaman daftar request akan terbuka

<!-- SCREENSHOT: Sidebar menu — General > Permintaan ATK Umum -->

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

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

---

## 2. Membuat Request Baru (Sebagai Pemohon)

1. Dari halaman daftar **Permintaan ATK Umum**, klik tombol **Create Request**
2. Isi form:

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

<!-- SCREENSHOT: Form create request — Personal Information + Items + Comment -->

### Items (daftar barang)
- Klik kolom **Item** lalu mulai ketik — akan muncul **autocomplete** dari katalog barang
- Pilih barang yang sesuai
- Isi **Qty** (jumlah), **Unit** (satuan, contoh: pcs, box, rim)
- **Comment** (opsional) — catatan untuk barang tersebut
- Klik **Add More Items** untuk menambah baris (minimal 1 item)

### Comment
- Catatan tambahan untuk keseluruhan request (opsional)

3. Klik **Submit Request**
4. Request masuk ke antrian approval manager

---

## 3. Approval Manager (Approver 1)

Manager mendapat notifikasi di **Approval Inbox** (ikon lonceng pojok kanan atas).

<!-- SCREENSHOT: Halaman detail request dari sisi Manager — bagian Actions (Approve/Reject + Comment) -->

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

### Catatan:
- Manager hanya bisa **Approve, Reject, dan Comment** — tidak bisa mengubah item
- Item hanya bisa diedit oleh GA di step selanjutnya

<!-- SCREENSHOT: Manager — item tampil read-only, hanya ada textarea Comment + tombol Approve/Reject -->

---

## 4. Approval GA (Approver 2 — Utami Mayangsari SH)

GA mendapat notifikasi setelah manager approve.

### Sebelum Approve, GA Bisa:

#### a. Cek Stok (Check Stock)
- Klik tombol **Check Stock** di atas tabel Items
- Kolom **Stock** akan muncul menampilkan stok gudang dari SnipeIT
- Berguna untuk memutuskan barang mana yang disetujui

<!-- SCREENSHOT: Tabel Items dengan kolom Stock muncul setelah Check Stock -->

#### b. Setujui Per-Item
GA bisa menyetujui atau menolak **masing-masing item** secara individual:
- Centang **Approve** pada item yang disetujui
- Kosongkan centang pada item yang tidak disetujui
- GA juga bisa mengedit nama barang, qty, unit, komentar per-item

<!-- SCREENSHOT: Tabel Items dari sisi GA — kolom Approve (checkbox), edit inline, dan status per-item -->

#### c. Approve atau Reject
- **Approve** → hanya item yang dicentang akan berstatus **Approved**
  - Jika semua item dicentang → status → **Approved** (siap cetak)
  - Jika ada item yang tidak dicentang → tetap **Approved**, tapi item tersebut tidak akan tercetak
- **Reject** → seluruh request ditolak, status → **Rejected** (wajib isi komentar)

<!-- SCREENSHOT: Bagian Actions GA — tombol Approve dan Reject -->

---

## 5. Cetak Request (Print)

Setelah status **Approved**:

1. Di halaman daftar **Permintaan ATK Umum**
2. Centang satu atau beberapa request yang sudah **Approved**
3. Klik tombol **Print Selected**
4. Dokumen PDF terbuka di tab baru, siap dicetak
5. Hanya item yang di-*approved* oleh GA yang akan muncul di cetakan
6. Serahkan print-out ke GA untuk diproses pengadaan

<!-- SCREENSHOT: Halaman daftar — centang request Approved, tombol Print Selected -->

<!-- SCREENSHOT: Hasil cetakan PDF yang menunjukkan hanya item yang di-approve -->

---

## 6. 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) -->

---

## 7. Activity Log

Di halaman detail, terdapat **Activity Log** yang mencatat:
- Siapa yang approve/reject
- Komentar dari approver
- Perubahan yang dibuat approver pada item
- Waktu kejadian

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

---

## Ringkasan Status

| Status | Arti | Bisa Dicetak? |
|--------|------|:---:|
| Initiated | Menunggu approval manager | ✗ |
| In Process | Manager sudah approve, menunggu GA | ✗ |
| Approved | GA sudah approve | ✓ |
| Rejected | Ditolak (bisa diedit) | ✗ |
| Cancelled | Dibatalkan oleh pemohon | ✗ |

---

## Tips
- **Approval Inbox** auto-refresh setiap 30 detik
- Status **Rejected** bisa diedit kapan saja oleh pemohon
- Bisa print beberapa request sekaligus dengan centang
- GA bisa mengecek stok barang sebelum approve
- Request yang sudah **Approved** tidak bisa diedit atau dihapus