# KCK HRIS --- Bento UI Design Specification

## 1. Design Direction

**Style:** Modern Enterprise Bento UI\
**Brand:** Kharisma Cahaya Krisnawan (KCK)\
**Goal:** Profesional, modern, clean, nyaman dilihat dalam penggunaan
HRIS sehari-hari.

### Design Principles

- Gunakan layout **Bento Grid** untuk dashboard dan halaman overview.
- Dominasi warna netral/off-white agar tidak melelahkan mata.
- Warna logo KCK digunakan sebagai **accent**, bukan memenuhi seluruh
  interface.
- Card menggunakan border tipis, radius medium, dan shadow yang sangat
  lembut.
- Halaman data-heavy seperti Employee, Payroll, Attendance, dan Leave
  tetap mengutamakan tabel/form yang clean.
- Gunakan whitespace yang cukup dan hierarchy typography yang jelas.

---

## 2. Color Palette

---

Token Color Hex Usage

---

Primary KCK Green `#078557` Active menu,
primary button,
highlight

Primary Dark Deep Green `#066044` Hover / pressed

Primary Soft Soft Mint `#E8F5EF` Active menu
background, badge

Accent Blue Corporate Blue `#1687B8` Information,
chart, secondary
accent

Warning Amber `#F5A623` Leave, pending,
warning

Danger Red `#E53935` Absent, rejected,
destructive
action

Background Cool Off White `#F6F8F7` Main application
background

Surface White `#FFFFFF` Card / table /
modal

Text Primary Charcoal `#292929` Heading and
primary text

Text Secondary Slate Gray `#667085` Supporting text

Border Soft Gray `#E5E9E7` Card and input
borders
-----------------------------------------------------------------------

### Color Usage

Gunakan komposisi kurang lebih:

- **80--90%** neutral / white / gray
- **10--20%** brand dan semantic colors

Hijau KCK menjadi warna utama. Biru, kuning, dan merah dari identitas
logo digunakan sebagai warna pendukung berdasarkan konteks.

---

## 3. Application Layout

```text
┌───────────────┬───────────────────────────────────────────────────┐
│               │ Search                         Notification User │
│     KCK       ├───────────────────────────────────────────────────┤
│               │                                                   │
│ Dashboard     │ Good morning, Admin 👋                            │
│ Employee      │ Here's what's happening with your team today.     │
│ Organization  │                                                   │
│ Attendance    │ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐     │
│ Leave         │ │Employee│ │Attend. │ │ Leave  │ │ Absent │     │
│ Payroll       │ └────────┘ └────────┘ └────────┘ └────────┘     │
│ Performance   │                                                   │
│ Recruitment   │ ┌─────────────────────┐ ┌──────────┐ ┌────────┐ │
│ Training      │ │ Attendance Overview │ │Department│ │ Events │ │
│ Document      │ └─────────────────────┘ └──────────┘ └────────┘ │
│ Report        │                                                   │
│ Settings      │ ┌────────────────────────────┐ ┌────────────────┐│
│               │ │ Recent Attendance          │ │ Birthdays      ││
│ Admin KCK     │ └────────────────────────────┘ ├────────────────┤│
│ Super Admin   │                                │ Announcements  ││
└───────────────┴────────────────────────────────┴────────────────┘
```

---

## 4. Sidebar

Sidebar menggunakan background putih agar logo KCK tetap menjadi focal
point.

### Menu

- Dashboard
- Employee
- Organization
- Attendance
- Leave
- Payroll
- Performance
- Recruitment
- Training
- Document
- Report
- Settings

### Active State

```css
.sidebar-item.active {
    background: #e8f5ef;
    color: #078557;
    border-radius: 10px;
}
```

Hindari sidebar hijau penuh karena akan membuat keseluruhan dashboard
terasa berat.

---

## 5. Header

Header berisi:

- Hamburger / sidebar toggle
- Global search
- Notification
- Messages
- Calendar
- User profile
- Role user

Contoh:

```text
☰   🔍 Search anything...                 🔔  💬  📅   👤 Admin KCK
                                                       Super Admin
```

Gunakan border bawah yang sangat tipis atau biarkan menyatu dengan
background.

---

## 6. Dashboard Header

```text
Good morning, Admin 👋
Here's what's happening with your team today.

                                      📅 29 May 2025, Thursday
```

Heading harus menjadi focal point pertama setelah user masuk dashboard.

---

## 6A. Master Data Table & Compact Form

Halaman master data dan pengaturan, seperti Company, Branch, Department,
Division, Position, dan Job Level, menggunakan tabel standar dengan form
popup/modal untuk data yang memiliki sedikit field.

```text
Breadcrumb                                            Back to dashboard

General
Companies
Deskripsi singkat halaman.

                         [ + Add data ]

┌──────────────────────────────────────────────────────────────┐
│ Name             Code       Status       Actions             │
│ Company name     KCK-HQ     ACTIVE       Edit   Delete       │
└──────────────────────────────────────────────────────────────┘

                  ┌─────────────────────────┐
                  │ Add / edit data       ×  │
                  │ field + * wajib         │
                  │ [Cancel] [Save]          │
                  └─────────────────────────┘
```

- Gunakan padding halaman `20–22px` pada desktop dan `16px` pada mobile, dengan
  breadcrumb dan tautan kembali dalam satu baris.
- Gunakan satu card tabel dengan border dan shadow yang sama seperti Profile.
  Kolom minimal mencakup identitas utama, code bila ada, status, dan actions.
- Tabel data harus menyediakan search, pilihan jumlah baris per halaman (10,
  25, 50, 100), informasi rentang seperti `Showing 1 to 25 of 120 entries`,
  serta pagination Previous, nomor halaman, dan Next.
- Kolom `Actions` secara default rata kanan pada shared `DataTable`; gunakan
  alignment eksplisit hanya jika kebutuhan module memang berbeda.
- Search, `per_page`, dan nomor halaman harus tersinkron dengan query string dan
  diproses server-side agar tetap benar saat data bertambah besar.
- Gunakan shared component `DataTable` untuk struktur tabel, toolbar, info,
  pagination, dan empty state. Gunakan shared `Button` untuk tombol primary,
  secondary, dan destructive agar spacing, focus state, serta disabled state
  konsisten antar-modul.
- Setiap module wajib memiliki page entry sendiri di
  `resources/js/features/<module>/pages`. Page menjadi pemilik konfigurasi,
  label, relasi, dan aturan khusus module. Shared hanya boleh menampung
  primitive UI seperti table, button, toast, dan confirmation; jangan membuat
  satu page domain generik sebagai pusat seluruh module.
- Gunakan shared `Toast` untuk notifikasi berhasil atau gagal setelah aksi,
  dengan auto-dismiss dan tombol close. Gunakan shared `ConfirmDialog` untuk
  konfirmasi aksi destruktif; jangan gunakan `alert()` atau native
  `window.confirm()` pada modul.
- Sediakan tombol aksi utama `Add data` di dekat heading. Untuk form dengan
  sedikit field, buka form dalam modal; jangan mengambil ruang permanen dari
  tabel.
- Modal menggunakan lebar maksimal sekitar `520px`, padding `20px` desktop dan
  `16px` mobile, heading berborder bawah tipis, serta tombol `Cancel` dan
  `Save` yang jelas.
- Setiap input wajib memiliki placeholder yang membantu, schema validasi form
  frontend berbasis Zod, dan tanda bintang `*` pada label. Jangan bergantung
  pada atribut HTML `required`; field opsional tidak diberi tanda bintang dan
  harus menyebutkan sifat opsionalnya melalui placeholder atau helper text.
- Backend tetap menjadi sumber kebenaran untuk validasi keamanan, aturan bisnis,
  unique constraint, dan integritas data. Error backend harus dipetakan kembali
  ke field yang sesuai di form.
- Field dokumen menggunakan input upload, bukan input teks untuk path file.
  Backend wajib memvalidasi tipe dan ukuran file, menyimpannya pada disk public
  di folder module terkait dengan nama `jenis-dokumen-document-number.ext`,
  menyimpan relative path tersebut ke database, dan mengembalikan URL file yang
  dapat digunakan oleh client. Pada tabel, file path harus ditampilkan sebagai
  link yang membuka file pada tab baru. Label link menggunakan gabungan jenis
  dan nomor dokumen, sedangkan path asli cukup tersedia melalui tooltip. Saat
  edit tanpa file baru, file sebelumnya tetap dipertahankan.
- Tampilkan error validasi dekat field terkait, pertahankan focus state dan
  keyboard-accessible close/cancel action.
- Tabel harus memiliki horizontal overflow pada mobile, row ringkas, empty
  state, loading/error state, dan action yang tetap mudah digunakan.
- Menu `Users & Access` menggunakan dua tab terpisah: `Users` untuk CRUD akun
  dan assignment role, serta `Roles & Permissions` untuk CRUD role dan
  assignment permission action. Form keduanya menggunakan modal dan aksi
  delete menggunakan confirmation modal.
- Permission setiap menu menggunakan action standar `read`, `create`, `update`,
  `delete`, dan `others`. Seeder wajib idempotent dan hanya membuat permission
  granular tanpa alias legacy yang redundan.
- Popup permission menyediakan checkbox `Select all modules`, checkbox select
  all pada setiap module, dan checkbox action individual.
- Tabel role tidak menampilkan seluruh permission secara inline; gunakan tombol
  `View permissions` untuk membuka detail permission dalam modal per module.
- Authorization route menggunakan permission granular: request `GET` membaca
  `module.read`, `POST` membaca `module.create`, `PUT/PATCH` membaca
  `module.update`, dan `DELETE` membaca `module.delete`.
- Tombol aksi pada frontend wajib mengikuti permission yang sama; tombol create,
  edit, dan delete tidak ditampilkan jika action permission terkait tidak dimiliki.
- Role scope wajib ditegakkan backend: `GLOBAL` tanpa batas tenant, `COMPANY`
  sesuai `role_user.company_id`, dan `BRANCH` sesuai `role_user.branch_id` serta
  branch target request.
- Implementasi scope menggunakan `App\\Support\\AccessScope` terpusat pada seluruh
  repository master Phase 0/1. Semua query Company, Branch, Division,
  Department, Position, Job Level, Employee, Employee Document, dan Users wajib
  menerapkan scope sebelum pagination atau response. Assignment role `COMPANY`
  menyimpan `company_id`, sedangkan assignment `BRANCH` menyimpan
  `company_id` dan `branch_id` pada pivot `role_user`.
- Empty state menggunakan pola `module-empty`: ikon ringan, heading informatif,
  deskripsi singkat, dan CTA untuk menambahkan data pertama. Jangan tampilkan
  pesan kosong sebagai teks polos yang menempel pada garis tabel.
- Master Division menggunakan selector Company wajib serta Branch opsional.
  Department menggunakan selector Company dan Division wajib serta Branch
  opsional. Position menggunakan selector Company dan Department wajib serta
  Branch opsional. Selector hanya boleh menampilkan opsi dalam company yang
  dipilih dan server wajib memvalidasi ulang scope tersebut.

Pola ini adalah standar untuk halaman master data selanjutnya kecuali sebuah
modul membutuhkan tabel analitis atau dashboard yang lebih padat informasi.

---

## 6B. Module Page Consistency

Semua halaman baru wajib mengikuti pola visual halaman **Branches** sebagai referensi utama. Hindari layout custom jika pola module standar sudah sesuai.

```text
Module layout
├── Sidebar dengan active state dan mobile toggle
├── Header global
└── Module content
    ├── Breadcrumb + Back to dashboard
    ├── Module heading: eyebrow, title, description, primary action
    └── Profile card: heading, DataTable/content, empty state
```

Aturan wajib:

- Gunakan `module-layout`, `module-page`, `module-content`, dan `profile-content` sebagai shell.
- Sidebar menerima `activeMenu`, `open`, dan `onClose`; header memakai `onMenuOpen`.
- Breadcrumb dan `Back to dashboard` berada dalam satu `profile-navigation` row.
- Heading menggunakan `module-heading`, `eyebrow`, `h1`, description, dan shared `Button`.
- Data-heavy page menggunakan `profile-card`, `profile-card-heading`, dan shared `DataTable`.
- Form dengan field terbatas dibuka dalam modal popup menggunakan `company-modal`, maksimal sekitar 520px, dengan footer `Cancel` dan `Save/Submit`.
- Input menggunakan `profile-field`, label jelas, placeholder membantu, dan grid dua kolom hanya untuk field yang berhubungan.
- Aksi destruktif atau approval memakai shared `ConfirmDialog`; hasil aksi memakai shared `Toast`.
- Empty state menggunakan `module-empty` dengan ikon, heading, description, dan primary action bila relevan.
- Setiap halaman wajib memiliki loading, error, empty, disabled, keyboard-accessible, dan responsive mobile state.
- Gunakan bahasa Inggris yang konsisten untuk label, action, helper text, empty state, toast, dan validation message.
- Gunakan green hanya untuk primary/active state; background halaman dan card tetap neutral/off-white.

## 6C. Workflow and Approval Pages

Halaman workflow seperti Attendance Correction dan Approvals mengikuti pola module yang sama:

- Form request selalu berupa modal dengan tombol `Add ...` di dekat heading.
- Daftar request menampilkan identitas, ringkasan alasan, status badge, dan waktu pengajuan.
- Approval menampilkan perubahan `Before` dan `After` dalam dua panel yang mudah dibandingkan.
- Tombol `Approve` dan `Reject` berada di kanan bawah card dan memerlukan konfirmasi.
- Pending menggunakan amber, approved menggunakan green, dan rejected menggunakan red.

## 7. KPI Bento Cards

### Total Employees

```text
┌──────────────────────────┐
│ 👥  Total Employees      │
│                          │
│ 1,248               ╱╱╱ │
│ ↑ 2.4% vs last month     │
└──────────────────────────┘
```

Accent: Green.

### Attendance Rate

```text
┌──────────────────────────┐
│ 🕐  Attendance Rate      │
│                          │
│ 94.8%               ╱╱╱ │
│ ↑ 1.8% vs last month     │
└──────────────────────────┘
```

Accent: Blue.

### On Leave Today

Accent: Amber.

### Absent Today

Accent: Red.

Setiap KPI card dapat memiliki **mini sparkline** untuk memberikan
informasi tren tanpa membuat dashboard terlalu padat.

---

## 8. Attendance Overview

Gunakan Bento card berukuran besar.

```text
Attendance Overview                         This Month

● Present     ● Absent

1000 ┤                                  ╭──
 750 ┤        ╭────╮          ╭────────╯
 500 ┤──╮╭────╯    ╰──────────╯
 250 ┤
   0 ┼────────────────────────────────────
     1 May      7 May      14 May     28 May
```

- Present: KCK Green
- Absent: Red
- Chart background tetap putih.
- Grid line dibuat sangat subtle.

---

## 9. Employee by Department

Gunakan donut chart.

Kategori contoh:

Department Employees

---

Production 520
Marketing 210
HR & GA 180
Finance 160
Other 178

Total:

**1,248 Employees**

Warna chart boleh mengambil warna identitas KCK, tetapi gunakan
saturation yang terkontrol.

---

## 10. Upcoming Events

Gunakan stacked mini Bento cards.

```text
┌──────────────────────────────┐
│ 🎂 3 Birthdays              ›│
│    In next 7 days            │
├──────────────────────────────┤
│ 🌴 12 Leave Requests        ›│
│    Pending approval          │
├──────────────────────────────┤
│ 📅 2 Company Events         ›│
│    In this month             │
└──────────────────────────────┘
```

---

## 11. Recent Attendance

Gunakan table yang clean, bukan memaksakan Bento pada setiap data.

Employee Department Check In Check Out Status Location

---

Ahmad Wijaya Production 08:01 17:04 On Time Head Office
Siti Aisyah Marketing 08:15 17:18 On Time Head Office
Budi Santoso Production 08:45 17:30 On Time Plant 1
Dewi Lestari HR & GA 09:05 \- Late Head Office
Rudi Hermawan Finance \- \- Absent \-

### Status Badge

```text
On Time  → Soft Green
Late     → Soft Amber
Absent   → Soft Red
```

Badge tidak menggunakan warna solid yang terlalu kuat.

---

## 12. Birthdays This Week

Gunakan card horizontal dengan avatar employee.

```text
Birthdays This Week

👩 Dewi Lestari    👨 Faisal Rahman    👩 Maya Sari    👨 Rizky Pratama
   29 May             30 May              31 May          02 Jun
```

---

## 13. Company Announcements

Contoh:

```text
📢 Update Kebijakan WFH

Mulai 1 Juni 2025, kebijakan Work From Home
berlaku 2 hari dalam seminggu.

2 hours ago
```

Gunakan background `#E8F5EF` untuk announcement penting tanpa membuatnya
terlalu mencolok.

---

## 14. Bento Card Style

```css
.bento-card {
    background: #ffffff;
    border: 1px solid #e5e9e7;
    border-radius: 16px;
    box-shadow:
        0 1px 2px rgba(16, 24, 40, 0.02),
        0 4px 12px rgba(16, 24, 40, 0.04);
}
```

### Hover

```css
.bento-card:hover {
    border-color: #d7ded9;
    box-shadow:
        0 2px 4px rgba(16, 24, 40, 0.03),
        0 8px 20px rgba(16, 24, 40, 0.06);
}
```

Shadow harus subtle agar tampilan tetap terasa enterprise.

---

## 15. Border Radius

Gunakan radius secara konsisten:

```text
Button          8–10px
Input           8–10px
Small Card      12px
Bento Card      16px
Modal           16px
Badge           6–8px
Avatar          50%
```

Hindari penggunaan radius `24–32px` secara berlebihan karena dapat
membuat HRIS terasa terlalu playful.

---

## 16. Typography

Rekomendasi font:

**Inter**

Fallback:

```css
font-family:
    Inter,
    ui-sans-serif,
    system-ui,
    -apple-system,
    BlinkMacSystemFont,
    'Segoe UI',
    sans-serif;
```

Typography hierarchy:

```text
Page Title       24–28px / 600
Section Title    16–18px / 600
Card Label       13–14px / 500
KPI Number       30–36px / 600
Body             14px / 400
Small / Caption  12px / 400
```

---

## 17. Spacing

Gunakan basis **8px spacing system**:

```text
4px
8px
12px
16px
24px
32px
40px
48px
```

Rekomendasi:

```text
Dashboard padding    24–32px
Card padding         20–24px
Card gap             16px
Section gap          24px
Table row height     52–56px
```

---

## 18. CSS Variables

```css
:root {
    --primary: #078557;
    --primary-dark: #066044;
    --primary-soft: #e8f5ef;

    --accent-blue: #1687b8;

    --background: #f6f8f7;
    --surface: #ffffff;

    --text-primary: #292929;
    --text-secondary: #667085;

    --border: #e5e9e7;

    --success: #078557;
    --warning: #f5a623;
    --danger: #e53935;

    --radius-sm: 8px;
    --radius-md: 12px;
    --radius-lg: 16px;

    --shadow-card:
        0 1px 2px rgba(16, 24, 40, 0.02), 0 4px 12px rgba(16, 24, 40, 0.04);
}
```

---

## 19. Responsive Bento Grid

Desktop:

```css
.dashboard-grid {
    display: grid;
    grid-template-columns: repeat(12, minmax(0, 1fr));
    gap: 16px;
}

.kpi-card {
    grid-column: span 3;
}

.attendance-chart {
    grid-column: span 6;
}

.department-chart {
    grid-column: span 3;
}

.upcoming-events {
    grid-column: span 3;
}
```

Tablet:

```css
@media (max-width: 1024px) {
    .kpi-card {
        grid-column: span 6;
    }

    .attendance-chart,
    .department-chart,
    .upcoming-events {
        grid-column: span 6;
    }
}
```

Mobile:

```css
@media (max-width: 640px) {
    .dashboard-grid > * {
        grid-column: 1 / -1;
    }
}
```

---

## 20. Final Visual Direction

KCK HRIS sebaiknya terasa seperti:

> **Modern SaaS + Enterprise HR System + Bento Dashboard**

Bukan seperti admin template konvensional yang penuh warna.

Gunakan logo KCK sebagai identitas utama, lalu ambil **green sebagai
primary**, sementara **blue, amber, dan red** digunakan secara
kontekstual. Background, card, table, dan form tetap didominasi neutral
color sehingga interface terasa profesional dan nyaman digunakan dalam
waktu lama.
