# 📊 KPI (Key Performance Indicator) Management

Modul ini digunakan untuk **mengelola KPI karyawan** sebagai bagian dari penilaian performa secara sistematis. Terdapat beberapa submenu penting dalam modul ini:

- [KPI](/kpi)
- [KPI Kategori](/kpicategory)
- [KPI Indikator](/kpiindicator)
- [KPI Potensi](/kpipotency)

---

## 📌 Akses Role & Hak Pengguna

| Submenu        | Akses                            |
|----------------|----------------------------------|
| KPI            | Semua karyawan                   |
| KPI Kategori   | Hanya user dengan role akses **view all KPI Category** |
| KPI Indikator  | Hanya user dengan role akses **view all KPI Category** |
| KPI Potensi    | Hanya user dengan role akses **view all KPI Category** |

---

## 🧩 KPI Kategori

### Deskripsi
Mengelola **kategori KPI** dan **persentase bobotnya** untuk setiap jabatan (Job Position). Total bobot kategori seharusnya jumlah bobot dari semua **KPI Indikator** yang mengacu pada kategori tersebut.

### 📄 List Data
- Diakses dari menu: `Kontrak / KPI Category`
- Hanya user dengan akses penuh ke KPI kategori.

### ➕ Tambah KPI Kategori
Form input:
- Job Position
- Nama Kategori
- Persentase Bobot (%)

### ✏️ Edit & 🗑️ Delete
- Perubahan akan memengaruhi **KPI Indikator** yang terkait.
- **Tidak mengubah** KPI yang sudah **di-approve** atau sudah dihasilkan file PDF.

---

## 🧮 KPI Indikator

### Deskripsi
Mengelola indikator penilaian untuk setiap kategori KPI dan job position.

### 📄 List Data
- Diakses dari menu: `Kontrak / KPI Indikator`
- Dibatasi oleh hak akses kategori KPI

### ➕ Tambah KPI Indikator
Form input:
- Kategori (Jabatan - Kategori)
- Nama Indikator
- Persentase Bobot (%)
- Persentase Target (%)

### ✏️ Edit & 🗑️ Delete
- Perubahan akan memengaruhi data detail KPI yang terkait
- Tidak memengaruhi KPI yang sudah **di-approve**

---

## 💡 KPI Potensi

### Deskripsi
Mengelola **potensi** (soft skill/potensi individu) sebagai bagian dari penilaian karyawan.

### 📄 List Data
- Diakses dari menu: `Kontrak / KPI Potensi`
- Dibatasi oleh hak akses kategori KPI

### ➕ Tambah KPI Potensi
Form input:
- Jabatan (Job Position)
- Nama Potensi
- Persentase Bobot (%)
- Persentase Target (%)

### ✏️ Edit & 🗑️ Delete
- Sama seperti indikator, hanya memengaruhi data KPI yang belum di-approve.

---

## 📈 KPI

### Deskripsi
Mengelola KPI setiap karyawan. Semua karyawan dapat mengakses KPI miliknya. Hanya user dengan hak **akses semua data KPI** yang dapat melihat seluruh data KPI karyawan.

---

### 📄 List Data KPI

Menu: `Kontrak / KPI`

Data yang ditampilkan:
- Code
- Nama Karyawan
- Persentase Nilai Akhir
- File PDF (ikon file)
- Aksi: Edit & Delete

⚠️ Akses data tergantung role & permission masing-masing user.

---

### ➕ Tambah KPI

Form input:
- Pilih Karyawan
- Input nilai capaian per indikator & potensi (muncul otomatis sesuai jabatan karyawan)

🔐 Hanya user dengan akses `create KPI` yang dapat menggunakan fitur ini.

---

### ✏️ Edit & 🗑️ Delete KPI

- **Hanya dapat dilakukan jika status KPI = "Pending"**

---

### 🔍 Detail KPI

Klik kode KPI untuk melihat detail:
- Daftar indikator & potensi
- Nilai capaian, bobot, target
- Perhitungan:

```

Nilai Tertimbang = (Nilai Capaian \* Bobot) / 100

Sub Total Bobot (%) = Total semua bobot
Sub Total Nilai Tertimbang (%) = Total semua nilai tertimbang

Performance (80%) = Total Nilai Tertimbang Indikator \* 0.8
Potensi (20%)     = Total Nilai Tertimbang Potensi   \* 0.2

Nilai Akhir = (Performance + Potensi) / 5

```

---

### 📄 File KPI

- Tersedia tombol/icon file PDF di tabel list KPI
- Berisi detail nilai & hasil KPI

---

## ✅ Approval KPI

- Approval dilakukan secara **berjenjang**:
  - **Step 1:** Karyawan
  - **Step 2:** Approval oleh SPV / Approval Line
  - **Step 3:** HRD Approval 

  Setelah User Approve, akan menghasilkan file berisi ttd user tersebut

### 📄 List Approval KPI

- Menu: `My Approvals / KPI`
- User yang menjadi approver dapat melihat pengajuan KPI karyawan dalam satuannya.

---


📝 *Dokumentasi ini disusun untuk mempermudah penggunaan & pemahaman modul KPI. Harap pastikan role & permission Anda sesuai untuk mengakses fitur yang diinginkan.*

---

📝 **Terakhir diperbarui**: 19 Juni 2025
✍️ **Dokumentasi oleh**: Tim Development
