# KCK HRIS --- Mobile Dashboard UI/UX Specification

## 1. Tujuan

Dashboard mobile KCK HRIS dirancang agar terlihat **modern, clean,
kreatif, dan mudah dipahami**, dengan **Attendance sebagai fitur
utama**.

Prinsip utama:

-   Attendance selalu mendapat prioritas visual.
-   Informasi penting harus dapat dipahami dalam sekali lihat.
-   Hindari elemen dekoratif yang tidak memberikan informasi.
-   Gunakan whitespace yang cukup agar UI tidak terasa padat.
-   Pertahankan identitas warna hijau KCK secara konsisten.
-   Empty state harus menjelaskan kondisi, bukan hanya menampilkan area
    kosong.

------------------------------------------------------------------------

## 2. Struktur Dashboard

Urutan halaman:

1.  Header / Brand
2.  Employee Greeting
3.  Attendance Summary
4.  Overview
5.  Leave Balance
6.  Latest Payslips
7.  Bottom Navigation

------------------------------------------------------------------------

## 3. Header

Header berisi:

-   Logo KCK di sebelah kiri.
-   Avatar/profile user di sebelah kanan.

Contoh:

``` text
┌─────────────────────────────────┐
│ KCK                         AS  │
└─────────────────────────────────┘
```

Gunakan background putih dan hindari elemen tambahan yang tidak
diperlukan.

------------------------------------------------------------------------

## 4. Employee Greeting

Gunakan area hijau sebagai identitas utama dashboard.

Informasi:

-   Greeting berdasarkan waktu.
-   Nama employee.
-   Posisi/lokasi kerja.
-   Tanggal.
-   Initial/avatar employee.

Contoh:

``` text
Good morning,                 📅 Wed, 02 Sep 2026

Agus 👋                              AS

Employee · Head Office
```

### Catatan

Label `MY WORKSPACE` tidak wajib digunakan karena informasi tersebut
tidak terlalu penting bagi employee.

Tanggal dapat menggunakan format pendek:

``` text
Wed, 02 Sep 2026
```

agar lebih nyaman pada layar mobile.

------------------------------------------------------------------------

## 5. Attendance Summary

Attendance merupakan informasi paling penting setelah greeting.

### Kondisi Workday Completed

``` text
✓ WORKDAY COMPLETED                         Done

See you tomorrow
Your attendance has been finalized.

────────────────────────────────────────────

Shift        Clock in       Clock out       Total time
Shift 1      11:12          11:20           00:08
```

### Informasi utama

Attendance card harus menampilkan:

-   Status attendance.
-   Shift.
-   Clock in.
-   Clock out.
-   Total working time.

### Total Working Time

Total working time lebih informatif dibanding indikator persentase.

Contoh:

``` text
Clock in     Clock out     Total time
11:12        11:20         00:08
```

### Hapus indikator `100%`

Indikator seperti:

``` text
100%
TODAY
```

tidak digunakan karena maknanya tidak cukup jelas.

User dapat salah menginterpretasikan angka tersebut sebagai:

-   Persentase jam kerja.
-   Persentase kehadiran.
-   Progress shift.
-   Attendance score.

Informasi konkret seperti `Total time` lebih mudah dipahami.

------------------------------------------------------------------------

## 6. Overview

Hindari penggunaan dua heading untuk section yang sama seperti:

``` text
AT A GLANCE
Your overview
```

Gunakan satu heading:

``` text
OVERVIEW
```

### Leave Balance Card

``` text
┌─────────────────────┐
│ 📅                  │
│ 0.0                 │
│ Leave days left     │
│                     │
│ View balance      → │
└─────────────────────┘
```

### Pending Requests Card

``` text
┌─────────────────────┐
│ ⇄                   │
│ 0                   │
│ Pending requests    │
│                     │
│ Review requests   → │
└─────────────────────┘
```

Kedua card menggunakan ukuran, spacing, radius, dan hierarchy yang
konsisten.

------------------------------------------------------------------------

## 7. Leave Balance

Header:

``` text
LEAVE BALANCE                         View all
```

Jika belum ada data, gunakan informative empty state:

``` text
┌──────────────────────────────────────┐
│ 📁  No leave balance data            │
│     Your leave balance will          │
│     appear here.                     │
└──────────────────────────────────────┘
```

Hindari hanya menampilkan:

``` text
No balance data available.
```

Tujuannya agar user mengetahui bahwa area tersebut memang belum memiliki
data dan bukan mengalami error.

------------------------------------------------------------------------

## 8. Latest Payslips

Header:

``` text
LATEST PAYSLIPS                         See all
```

Empty state:

``` text
┌──────────────────────────────────────┐
│ 📄  No payslips yet                  │
│     Your published payslips will     │
│     appear here.                     │
└──────────────────────────────────────┘
```

------------------------------------------------------------------------

## 9. Bottom Navigation

Menu:

``` text
Home
Requests
Attendance
Payslip
Profile
```

Attendance merupakan **primary navigation/action** sehingga selalu
mendapat prioritas visual, mirip konsep tombol utama pada aplikasi
MyTelkomsel.

------------------------------------------------------------------------

## 10. Attendance --- Tidak Aktif

Walaupun user sedang berada di halaman lain, tombol Attendance **tetap
hijau**.

Contoh saat Home aktif:

``` text
 Home       Requests        ●        Payslip       Profile
  ⌂            ▤            ◷           ▭             ♙
 ACTIVE                   Attendance
```

### Style

Attendance button:

-   Background hijau.
-   Icon putih.
-   Bentuk lingkaran.
-   Posisi sedikit naik dari navigation bar.
-   Ukuran tetap prominent.
-   Tidak memiliki outer ring.
-   Label menggunakan warna muted/abu-abu.

Contoh:

``` css
.attendance-button {
    width: 58px;
    height: 58px;
    border-radius: 50%;
    background: #07965f;
    color: #ffffff;

    display: flex;
    align-items: center;
    justify-content: center;

    transform: translateY(-14px);
}
```

------------------------------------------------------------------------

## 11. Attendance --- Aktif

Saat user berada pada halaman Attendance, tombol tetap menggunakan
ukuran yang sama.

Tambahkan **outer ring** untuk memberikan active state.

``` css
.attendance-item.active .attendance-button {
    box-shadow:
        0 0 0 5px #ffffff,
        0 0 0 10px #d9f1e7;
}

.attendance-item.active .attendance-label {
    color: #087a50;
    font-weight: 700;
}
```

Visual:

``` text
 Home       Requests       ◎●◎       Payslip       Profile
  ⌂            ▤            ◷           ▭             ♙
                         Attendance
                           ACTIVE
```

------------------------------------------------------------------------

## 12. Mengapa Ukuran Attendance Tidak Berubah?

Ukuran Attendance harus tetap sama antara kondisi aktif dan tidak aktif.

Jangan:

``` text
Inactive → icon kecil
Active   → icon besar
```

Gunakan:

``` text
Inactive → tombol hijau besar
Active   → tombol hijau besar + outer ring
```

Keuntungan:

-   Navigation tidak terasa berubah/loncat.
-   Attendance selalu mudah ditemukan.
-   Memperkuat Attendance sebagai fitur utama.
-   Active state tetap dapat dikenali dengan jelas.

------------------------------------------------------------------------

## 13. Active State Menu Lain

Menu biasa seperti Home menggunakan soft background ketika aktif.

Contoh:

``` css
.nav-item.active {
    background: #e8f6f0;
    color: #087a50;
    border-radius: 16px;
}
```

Inactive:

``` css
.nav-item {
    color: #94a39d;
}
```

Attendance tidak mengikuti background rectangle tersebut karena memiliki
treatment khusus sebagai primary action.

------------------------------------------------------------------------

## 14. Visual Hierarchy

Urutan perhatian user:

``` text
1. Attendance status
2. Clock in / Clock out / Total time
3. Overview
4. Leave balance
5. Payslip
6. Navigation
```

User harus dapat membuka dashboard dan langsung memahami:

> Apakah saya sudah attendance hari ini?

kemudian:

> Jam berapa saya masuk, keluar, dan berapa lama saya bekerja?

------------------------------------------------------------------------

## 15. Design System

### Primary Green

``` css
--primary: #07965f;
--primary-dark: #087a50;
--primary-soft: #e8f6f0;
--primary-ring: #d9f1e7;
```

### Text

``` css
--text-primary: #183d32;
--text-secondary: #71877f;
--text-muted: #94a39d;
```

### Background

``` css
--background: #f4f8f6;
--surface: #ffffff;
```

### Border

``` css
--border: #dfe9e4;
```

------------------------------------------------------------------------

## 16. Border Radius

Gunakan radius besar tetapi konsisten:

``` css
--radius-small: 12px;
--radius-medium: 18px;
--radius-large: 28px;
```

Rekomendasi:

-   Small icon container: `12px`
-   Overview card: `18px`
-   Empty state card: `18px`
-   Attendance card: `28px`
-   Bottom navigation: `28px`

------------------------------------------------------------------------

## 17. Spacing

Gunakan sistem spacing konsisten:

``` css
--space-xs: 4px;
--space-sm: 8px;
--space-md: 16px;
--space-lg: 24px;
--space-xl: 32px;
```

Hindari spacing random seperti:

``` text
13px
19px
27px
```

kecuali memang diperlukan.

------------------------------------------------------------------------

## 18. Iconography

Gunakan satu icon library secara konsisten.

Contoh:

-   Home → House
-   Requests → FileText
-   Attendance → Clock
-   Payslip → CreditCard / WalletCards
-   Profile → User
-   Leave → CalendarDays
-   Pending request → ArrowRightLeft

Jangan mencampur beberapa style icon seperti filled, outline, dan
duotone tanpa aturan yang jelas.

------------------------------------------------------------------------

## 19. Final Navigation Behaviour

### Home aktif

``` text
[ HOME ]    Requests       ●       Payslip     Profile
                           ◷
                       Attendance
```

Attendance tetap hijau tetapi tanpa outer ring.

### Attendance aktif

``` text
 Home       Requests      ◎●◎      Payslip     Profile
                           ◷
                       Attendance
```

Attendance mendapatkan outer ring dan label hijau bold.

### Requests aktif

``` text
 Home      [ REQUESTS ]     ●       Payslip     Profile
                           ◷
                       Attendance
```

Konsep yang sama berlaku untuk Payslip dan Profile.

------------------------------------------------------------------------

## 20. Final UX Direction

Dashboard KCK HRIS menggunakan konsep:

**Modern HR Workspace + Attendance First**

Karakter visual:

-   Clean.
-   Soft.
-   Professional.
-   Friendly.
-   Mobile-first.
-   Informasi mudah dipindai.
-   Attendance selalu mudah dijangkau.
-   Tidak menggunakan visual yang tidak memiliki arti jelas.
-   Empty state tetap memberikan konteks kepada user.

Tujuan akhirnya bukan sekadar membuat dashboard terlihat bagus, tetapi
membuat employee dapat memahami status kerja hariannya dalam beberapa
detik.
