# Panduan Pengguna Empat Role

## Tujuan

Dokumen ini menjelaskan penggunaan aplikasi oleh empat role resmi: `PEGAWAI`, `TU`, `PIMPINAN`, dan `TEKNISI`. Tidak terdapat role Admin. Setiap pengguna harus memakai akun individual dan tidak membagikan kata sandi.

## Ketentuan Umum

1. Buka URL aplikasi yang diberikan pengelola dan masuk menggunakan akun sendiri.
2. Periksa nama serta role pada topbar sebelum melakukan tindakan.
3. Notifikasi dapat dibuka melalui ikon lonceng atau menu **Notifikasi**.
4. Gunakan menu **Profil Saya** untuk memperbarui nama/unit dan mengganti kata sandi.
5. Keluar melalui tombol logout setelah selesai, terutama pada komputer bersama.
6. Pesan status harus dibaca sebagai teks; warna hanya merupakan penanda tambahan.

## Alur Utama

```text
Pegawai membuat tiket dan foto kerusakan
→ TU memeriksa
→ bila perlu, Pegawai merevisi dan mengajukan ulang
→ TU menyatakan valid dan mengajukan ke Pimpinan
→ Pimpinan menyetujui atau menolak
→ bila disetujui, TU menetapkan SLA dan menugaskan Teknisi
→ Teknisi memulai pekerjaan, mencatat progres dan hasil
→ Teknisi mengunggah foto bukti dan menutup tiket
→ seluruh role terkait menerima notifikasi dan riwayat tersimpan
```

## Pegawai

### Dashboard dan daftar tiket

- Dashboard menampilkan total tiket milik pengguna, tiket revisi, tiket dalam proses, dan tiket selesai.
- Buka **Tiket Saya** untuk mencari tiket serta memfilter status dan prioritas.
- Pegawai hanya dapat melihat tiket yang dibuat oleh akun tersebut.

### Membuat tiket

1. Pilih **Buat Tiket**.
2. Pilih aset yang rusak.
3. Isi judul, uraian kerusakan, detail lokasi, kategori kerusakan, dan prioritas.
4. Unggah minimal satu foto kerusakan berformat JPG/JPEG, PNG, atau WEBP.
5. Pastikan foto jelas dan tidak memuat informasi pribadi yang tidak diperlukan.
6. Kirim formulir dan catat nomor tiket yang diterbitkan.

### Menangani revisi

1. Buka tiket berstatus **Perlu Revisi**.
2. Baca alasan revisi dari TU.
3. Perbaiki data tiket dan tambahkan foto bila diperlukan.
4. Ajukan ulang. Foto lama tetap menjadi bagian riwayat.

### Memantau tiket

- Detail tiket menampilkan aset, status, SLA, Teknisi, hasil keputusan, hasil pekerjaan, foto bukti, dan timeline yang boleh dilihat Pegawai.
- Tiket yang ditolak atau selesai bersifat baca-saja.

## Bagian Tata Usaha (TU)

### Pemeriksaan tiket

1. Buka **Antrean TU**.
2. Cari atau filter tiket, lalu buka detail pemeriksaan.
3. Periksa identitas pelapor, aset, uraian, lokasi, prioritas, dan seluruh foto kerusakan.
4. Pilih salah satu tindakan:
   - **Minta Revisi** dan isi alasan yang spesifik; atau
   - **Nyatakan Valid** bila data lengkap.
5. Tiket valid kemudian diajukan kepada Pimpinan dengan catatan pengajuan wajib.

### Menindaklanjuti keputusan

- Tiket ditolak menjadi arsip final.
- Tiket disetujui masuk menu **Tiket Disetujui**.
- Tetapkan SLA masa depan terlebih dahulu.
- Setelah SLA tersimpan, pilih Teknisi aktif dan isi catatan penugasan bila diperlukan.

### Pemantauan dan laporan

- **Pemantauan SLA** menampilkan kondisi aman, mendekati tenggat, terlambat, dan selesai tanpa menjadikan keterlambatan sebagai status proses.
- **Laporan** menyediakan filter periode, status, aset, kategori isu, unit, Teknisi, dan kondisi SLA serta ekspor CSV.
- **Riwayat Aset** menampilkan seluruh tiket per aset.
- **Audit tiket** menampilkan pelaku, role, perubahan status, waktu, dan catatan secara baca-saja.

## Pimpinan

### Memberikan keputusan

1. Buka **Antrean Persetujuan**.
2. Periksa data Pegawai, aset, laporan kerusakan, foto, hasil verifikasi TU, catatan pengajuan, dan timeline.
3. Pilih salah satu keputusan final:
   - **Setujui Tiket**, catatan bersifat opsional; atau
   - **Tolak Tiket**, alasan wajib diisi.
4. Baca kembali dialog konfirmasi. Keputusan tidak dapat dikoreksi melalui UI biasa.

### Pemantauan

- Dashboard menampilkan antrean dan ringkasan keputusan pengguna.
- Laporan bersifat baca-saja dan dapat diekspor CSV.
- Aset pada laporan dapat dibuka untuk melihat riwayat perbaikan.
- Audit trail tiket dapat dibuka dari halaman terkait dan tidak dapat diubah.

## Teknisi

### Daftar tugas dan mulai pekerjaan

1. Buka **Tugas Saya**.
2. Pilih tugas yang ditugaskan kepada akun sendiri.
3. Periksa aset, lokasi, laporan, SLA, foto kerusakan, dan catatan TU.
4. Klik **Mulai Pekerjaan**. Status tiket berubah menjadi **Dikerjakan**.

### Progres dan hasil

- Tambahkan progres dengan memilih tahap dan mengisi catatan yang jelas.
- Buka **Catat Hasil Pekerjaan** untuk menyimpan tindakan perbaikan.
- Biaya hanya diisi bila ada dan harus berupa nilai nonnegatif; kolom ini bukan modul pembayaran atau akuntansi.

### Bukti dan penutupan

1. Unggah minimal satu foto bukti penyelesaian.
2. Pastikan tindakan perbaikan telah tercatat.
3. Periksa checklist penutupan.
4. Gunakan dialog konfirmasi **Selesaikan Tiket**.
5. Setelah selesai, tugas menjadi baca-saja dan tidak menerima progres tambahan.

## Notifikasi

- Notifikasi perubahan proses dibuat otomatis untuk penerima terkait.
- Membuka notifikasi menggunakan tombol **Baca & Buka** sekaligus menandainya dibaca.
- Pengingat SLA otomatis dapat muncul saat mendekati tenggat atau terlambat.
- Tidak ada notifikasi email, SMTP, WhatsApp, atau push browser pada implementasi saat ini.

## Penanganan Masalah Pengguna

- **Akses ditolak:** pastikan akun memiliki role yang benar dan membuka menu miliknya.
- **Sesi berakhir:** login kembali; formulir yang belum dikirim perlu diisi ulang.
- **Upload gagal:** periksa format, ukuran, jumlah foto, serta batas PHP server.
- **Tindakan tidak tersedia:** muat ulang halaman; status mungkin telah berubah pada proses lain.
- **Data tidak ditemukan:** hubungi TU/pengelola tanpa membagikan kata sandi atau file `.env`.
