title: “Employee Portal — Portal Karyawan” description: “Portal self-service karyawan: slip gaji, kalender absensi, pengajuan cuti, dan profil di SNISHOP ERP.”

Employee Portal — Portal Karyawan

Employee Portal adalah halaman self-service untuk karyawan. Setiap karyawan bisa melihat slip gaji, memantau kehadiran, dan mengajukan cuti secara mandiri tanpa perlu menghubungi HR.

Arsitektur

Akses Halaman

URL: /employee-portal

Access Policy

Portal menggunakan resolveUniqueActiveMembership dari companyAccessPolicy untuk menentukan akses:

Kondisi	Tindakan
User memiliki membership aktif	Tampilkan data berdasarkan `company_id`
User adalah owner tapi bukan member	Buat mock member data sebagai fallback
User tidak memiliki akses	Redirect atau tampilkan pesan error

Tiga Tab Utama

Tab	Label	Fungsi
`payslips`	Slip Gaji	Lihat dan export slip gaji
`attendance`	Kehadiran	Kalender absensi mini
`leaves`	Cuti	Ajukan dan pantau cuti

Tab Slip Gaji

Daftar Slip Gaji

Menampilkan seluruh record CompanyPayroll milik karyawan:

Info per Slip	Detail
Periode	Bulan/tahun gaji
Gaji Pokok	`basic_salary`
Tunjangan	`allowances` (array)
Potongan	`deductions` (array)
Gaji Bersih	`net_salary`
Status	draft / approved / paid
Tanggal Bayar	`payment_date`

Detail Slip Gaji

Dialog detail menampilkan breakdown lengkap:

SLIP GAJI — Januari 2026
═══════════════════════════════
PENDAPATAN
  Gaji Pokok          Rp 5.000.000
  Lembur (12 jam)     Rp   375.000
  Bonus KPI           Rp   500.000
  ──────────────────────────────
  Gaji Kotor          Rp 5.875.000

  Tunjangan:
    Transport         Rp   300.000
    Makan             Rp   450.000

POTONGAN
  BPJS Kesehatan      Rp    50.000
  BPJS TK             Rp   100.000
  PPh 21              Rp   287.500
  ──────────────────────────────
  GAJI BERSIH         Rp 6.187.500

Tanggal Bayar: 28 Januari 2026
Status: PAID

Export CSV

Slip gaji bisa diexport ke CSV dengan BOM (Byte Order Mark) untuk kompatibilitas Excel:

// UTF-8 BOM + CSV content
const BOM = '\uFEFF';
const csvContent = BOM + csvData;

Kolom CSV	Field
Periode	`period`
Gaji Pokok	`basic_salary`
Lembur	`overtime_pay`
Bonus KPI	`kpi_bonus`
Gaji Kotor	`gross_salary`
Potongan	`deductions`
Gaji Bersih	`net_salary`
Tanggal Bayar	`payment_date`
Status	`status`

Tab Kehadiran: Kalender Mini

Kalender bulanan mini menampilkan status absensi dengan dot indicator:

Warna Dot	Status	Arti
Hijau	Present	Hadir
Kuning	Late	Terlambat
Merah	Absent	Tidak hadir
Biru	Leave	Cuti

Tab Cuti: Pengajuan Cuti

Form Pengajuan

Dialog form untuk mengajukan cuti baru:

Field	Tipe	Deskripsi
`leave_type`	select	Jenis cuti (6 tipe)
`start_date`	date	Tanggal mulai
`end_date`	date	Tanggal selesai
`reason`	text	Alasan singkat
`description`	textarea	Deskripsi detail

Auto-Calculate Total Hari

Sistem menghitung otomatis total_days dari selisih end_date - start_date menggunakan differenceInDays.

Jenis Cuti

Tipe	Label	Keterangan
`annual`	Cuti Tahunan	Cuti tahunan reguler
`sick`	Cuti Sakit	Dengan surat dokter
`unpaid`	Tanpa Bayaran	Di luar tanggungan
`maternity`	Melahirkan	Cuti melahirkan
`paternity`	Ayah	Cuti kelahiran
`emergency`	Darurat	Keadaan darurat

Status Pengajuan

Status	Warna	Keterangan
`pending`	Kuning	Menunggu persetujuan
`approved`	Hijau	Disetujui
`rejected`	Merah	Ditolak
`cancelled`	Abu-abu	Dibatalkan oleh karyawan

Informasi Profil

Field	Sumber
Avatar	`avatar_url`
Nama	`user_name`
Posisi	`position`
Departemen	`department`
Role	`role`
Email	`user_email`
Tanggal Bergabung	`joined_date`
Jam Kerja	`working_hours`
Permissions	`permissions` (badge list)

Statistik Karyawan

Metrik	Perhitungan
Present Days	COUNT attendance `status = 'present'`
Late Days	COUNT attendance `status = 'late'`
Absent Days	Hari kerja tanpa record absensi
Total Hours	SUM `total_hours`
Total Leaves	COUNT CompanyLeave
Pending Leaves	COUNT status `pending`
Approved Leaves	COUNT status `approved`
Total Days Used	SUM `total_days` cuti approved
YTD Income	SUM `net_salary` tahun berjalan
Latest Pay	`net_salary` dari periode terakhir

Entitas: CompanyPayroll (Detail)

Field	Tipe	Deskripsi
`company_id`	string	ID perusahaan
`employee_id`	string	ID karyawan
`employee_name`	string	Nama karyawan
`period`	string	Periode gaji (YYYY-MM)
`basic_salary`	number	Gaji pokok
`attendance_days`	number	Hari hadir
`working_days`	number	Hari kerja dalam periode
`late_count`	number	Jumlah terlambat
`overtime_hours`	number	Jam lembur
`overtime_pay`	number	Upah lembur
`kpi_bonus`	number	Bonus KPI
`kpi_score`	number	Skor KPI
`gross_salary`	number	Gaji kotor
`allowances`	array	Daftar tunjangan `[{name, amount}]`
`deductions`	array	Daftar potongan `[{name, amount}]`
`net_salary`	number	Gaji bersih
`tax_amount`	number	PPh 21
`bpjs_kesehatan_employee`	number	BPJS Kesehatan karyawan
`bpjs_kesehatan_company`	number	BPJS Kesehatan perusahaan
`bpjs_tk_employee`	number	BPJS TK karyawan
`bpjs_tk_company`	number	BPJS TK perusahaan
`payment_date`	date	Tanggal pembayaran
`notes`	string	Catatan
`status`	enum	`draft`, `approved`, `paid`

Diagram Relasi Entitas Employee Portal (ER Diagram)

Diagram berikut menunjukkan relasi antar-entitas yang diakses melalui Employee Portal. Karyawan berinteraksi dengan CompanyMember (profil), CompanyPayroll (slip gaji), CompanyAttendance (absensi), CompanyLeave (cuti), dan CompanyLoan (kasbon) — semuanya terfilter berdasarkan employee_id milik user yang login.

Penjelasan Relasi Utama

Relasi	Kardinalitas	Keterangan
`User → CompanyMember`	1:1	Setiap user memiliki satu membership aktif di satu perusahaan (via `resolveUniqueActiveMembership`).
`CompanyMember → Employee`	1:1	`CompanyMember` menyimpan akses sistem; `Employee` menyimpan data personalia lengkap (rekening bank, kontak darurat).
`CompanyMember → CompanyPayroll`	1:N	Satu karyawan memiliki satu slip gaji per periode (YYYY-MM). Karyawan hanya bisa membaca slip gaji miliknya.
`CompanyMember → CompanyAttendance`	1:N	Satu karyawan memiliki banyak record absensi. Karyawan bisa membaca dan membuat (clock-in/out) absensi sendiri.
`CompanyMember → CompanyLeave`	1:N	Satu karyawan bisa mengajukan banyak cuti. Karyawan bisa membuat pengajuan baru dan membaca status pengajuan sendiri.
`CompanyMember → CompanyLoan`	1:N	Satu karyawan bisa mengajukan kasbon. Karyawan bisa membuat pengajuan dan membaca status sendiri.

Entity Schema Tables — Detail Lengkap per Entitas

Schema: Employee (Data Personalia)

Entitas Employee menyimpan data personalia lengkap karyawan. Di Employee Portal, data ini ditampilkan di sidebar profil dan digunakan untuk verifikasi informasi pribadi.

Field	Tipe	Required	Deskripsi
`company_id`	string	Ya	ID perusahaan pemilik data karyawan
`employee_id`	string	Ya	ID unik karyawan (NIP/NIK internal)
`user_id`	string	Tidak	Link ke entitas User untuk autentikasi
`full_name`	string	Ya	Nama lengkap karyawan sesuai KTP
`email`	string	Ya	Email aktif karyawan
`phone`	string	Tidak	Nomor telepon/WhatsApp
`department`	enum	Ya	Departemen: `Management`, `Sales`, `Marketing`, `Operations`, `Finance`, `IT`, `HR`, `Customer Service`
`position`	string	Ya	Jabatan/posisi karyawan
`employment_type`	enum	Tidak	Tipe pekerjaan: `full_time` (default), `part_time`, `contract`, `intern`
`hire_date`	date	Ya	Tanggal mulai bekerja
`salary`	number	Tidak	Gaji bulanan pokok (Rupiah)
`bank_account`	object	Tidak	Data rekening bank untuk transfer gaji
`bank_account.bank_name`	string	—	Nama bank (BCA, Mandiri, BNI, dll)
`bank_account.account_number`	string	—	Nomor rekening
`bank_account.account_name`	string	—	Nama pemilik rekening
`emergency_contact`	object	Tidak	Kontak darurat karyawan
`emergency_contact.name`	string	—	Nama kontak darurat
`emergency_contact.relationship`	string	—	Hubungan (suami/istri/orang tua/dll)
`emergency_contact.phone`	string	—	Nomor telepon kontak darurat
`address`	string	Tidak	Alamat tempat tinggal
`date_of_birth`	date	Tidak	Tanggal lahir
`status`	enum	Tidak	Status: `active`, `on_leave`, `terminated` (default: `active`)
`avatar_url`	string	Tidak	URL foto profil karyawan
`description`	string	Tidak	Catatan tambahan (max 1000 karakter)

Schema: CompanyMember (Akses & Profil Sistem)

Entitas CompanyMember adalah representasi karyawan dalam sistem. Di Employee Portal, entitas ini menjadi sumber data utama untuk sidebar profil, permission, dan statistik.

Field	Tipe	Required	Deskripsi
`company_id`	string	Ya	ID perusahaan
`user_id`	string	Tidak	Link ke entitas User
`user_email`	string	Ya	Email akun pengguna
`user_name`	string	Tidak	Nama lengkap pengguna
`role`	enum	Tidak	Role dalam perusahaan: `owner`, `admin`, `supervisor`, `store_admin`, `stock_admin`, `finance_admin`, `hr_admin`, `transaction_admin`, `employee` (default), `production_operator`, `qc_inspector`, `sales_marketing`, `partner_distributor`
`employee_id`	string	Tidak	Link ke entitas Employee
`department`	string	Tidak	Departemen penempatan
`position`	string	Tidak	Jabatan/posisi
`status`	enum	Tidak	Status membership: `active`, `inactive`, `pending` (default: `active`)
`joined_date`	date	Tidak	Tanggal bergabung di perusahaan
`invited_by`	string	Tidak	Email yang mengundang
`permissions`	object	Tidak	Hak akses detail per modul (30+ permission flags)
`permissions.can_view_dashboard`	boolean	—	Akses dashboard (default: true)
`permissions.can_view_tasks`	boolean	—	Lihat task (default: true)
`permissions.can_create_tasks`	boolean	—	Buat task (default: true)
`permissions.can_edit_tasks`	boolean	—	Edit task (default: true)
`permissions.can_delete_tasks`	boolean	—	Hapus task (default: false)
`permissions.can_view_notes`	boolean	—	Lihat catatan (default: true)
`permissions.can_create_notes`	boolean	—	Buat catatan (default: true)
`permissions.can_edit_notes`	boolean	—	Edit catatan (default: true)
`permissions.can_delete_notes`	boolean	—	Hapus catatan (default: false)
`permissions.can_view_hr`	boolean	—	Lihat data HR (default: false)
`permissions.can_edit_hr`	boolean	—	Edit data HR (default: false)
`permissions.can_view_finance`	boolean	—	Lihat data keuangan (default: false)
`permissions.can_edit_finance`	boolean	—	Edit data keuangan (default: false)
`permissions.can_view_inventory`	boolean	—	Lihat inventori (default: false)
`permissions.can_edit_inventory`	boolean	—	Edit inventori (default: false)
`permissions.can_view_projects`	boolean	—	Lihat proyek (default: false)
`permissions.can_edit_projects`	boolean	—	Edit proyek (default: false)
`permissions.can_view_pos`	boolean	—	Lihat modul POS (default: false)
`permissions.can_use_pos`	boolean	—	Gunakan POS kasir (default: false)
`permissions.can_view_reports`	boolean	—	Lihat laporan (default: false)
`permissions.can_manage_members`	boolean	—	Kelola anggota (default: false)
`permissions.can_manage_roles`	boolean	—	Kelola role (default: false)
`permissions.can_view_settings`	boolean	—	Lihat pengaturan (default: false)
`permissions.can_edit_settings`	boolean	—	Edit pengaturan (default: false)
`permissions.can_manage_cashier_shift`	boolean	—	Kelola shift kasir (default: false)
`permissions.can_approve_stock_opname`	boolean	—	Approve stock opname (default: false)
`permissions.can_count_stock_opname`	boolean	—	Hitung stock opname (default: false)
`permissions.can_transfer_inventory`	boolean	—	Transfer inventori (default: false)
`permissions.can_create_production_batch`	boolean	—	Buat batch produksi (default: false)
`permissions.can_release_production_qc`	boolean	—	Rilis QC produksi (default: false)
`permissions.can_view_hpp`	boolean	—	Lihat HPP (default: false)
`permissions.can_manage_channel_pricing`	boolean	—	Kelola harga channel (default: false)
`permissions.can_view_distribution`	boolean	—	Lihat distribusi (default: false)
`permissions.can_create_distribution_shipment`	boolean	—	Buat pengiriman distribusi (default: false)
`permissions.can_confirm_distribution_shipment`	boolean	—	Konfirmasi pengiriman (default: false)
`permissions.can_view_b2b_invoices`	boolean	—	Lihat invoice B2B (default: false)
`permissions.can_create_b2b_invoice`	boolean	—	Buat invoice B2B (default: false)
`permissions.can_verify_b2b_payment`	boolean	—	Verifikasi pembayaran B2B (default: false)
`assigned_locations`	array	Tidak	Daftar ID lokasi gudang/outlet yang diizinkan (RBAC-01)
`working_hours`	object	Tidak	Jam kerja karyawan
`working_hours.start`	string	—	Jam mulai (default: 09:00)
`working_hours.end`	string	—	Jam selesai (default: 17:00)
`salary`	number	Tidak	Gaji karyawan (opsional)
`notes`	string	Tidak	Catatan tambahan

Schema: CompanyPayroll (Ringkasan Slip Gaji)

Entitas CompanyPayroll menyimpan slip gaji bulanan. Di Employee Portal, karyawan hanya bisa membaca slip gaji milik sendiri.

Field	Tipe	Required	Deskripsi
`company_id`	string	Ya	ID perusahaan
`employee_id`	string	Ya	ID karyawan
`employee_name`	string	Tidak	Nama karyawan (denormalisasi)
`period`	string	Ya	Periode gaji format YYYY-MM
`basic_salary`	number	Ya	Gaji pokok
`attendance_days`	number	Tidak	Jumlah hari hadir
`working_days`	number	Tidak	Total hari kerja di periode
`late_count`	number	Tidak	Jumlah hari terlambat (default: 0)
`absent_count`	number	Tidak	Jumlah hari absen (default: 0)
`overtime_hours`	number	Tidak	Total jam lembur (default: 0)
`kpi_score`	number	Tidak	Skor KPI periode ini
`allowances`	array	Tidak	Daftar tunjangan `[{name, amount}]`
`deductions`	array	Tidak	Daftar potongan `[{name, amount}]`
`overtime_pay`	number	Tidak	Upah lembur (default: 0)
`kpi_bonus`	number	Tidak	Bonus berdasarkan KPI (default: 0)
`gross_salary`	number	Ya	Gaji kotor = basic + allowances + overtime + kpi_bonus
`net_salary`	number	Ya	Gaji bersih = gross - deductions
`status`	enum	Tidak	`draft`, `approved`, `paid` (default: `draft`)
`payment_date`	date	Tidak	Tanggal pembayaran
`payment_method`	enum	Tidak	`bank_transfer`, `cash`, `check`
`notes`	string	Tidak	Catatan tambahan

Schema: CompanyAttendance (Record Absensi)

Entitas CompanyAttendance menyimpan record absensi harian karyawan. Di Employee Portal, karyawan bisa membaca absensi sendiri dan membuat record clock-in/clock-out.

Field	Tipe	Required	Deskripsi
`company_id`	string	Ya	ID perusahaan
`employee_id`	string	Ya	ID karyawan
`employee_name`	string	Tidak	Nama karyawan (denormalisasi)
`employee_email`	string	Tidak	Email karyawan (untuk RLS self-access)
`date`	date	Ya	Tanggal absensi
`shift_id`	string	Tidak	ID shift yang dipilih karyawan
`shift_name`	string	Tidak	Nama shift (Pagi/Siang/Malam)
`clock_in_time`	datetime	Ya	Waktu clock-in
`clock_out_time`	datetime	Tidak	Waktu clock-out
`clock_in_photo_url`	string	Tidak	URL foto selfie saat clock-in
`clock_out_photo_url`	string	Tidak	URL foto selfie saat clock-out
`clock_in_location`	object	Tidak	Koordinat GPS saat clock-in
`clock_in_location.latitude`	number	—	Garis lintang lokasi clock-in
`clock_in_location.longitude`	number	—	Garis bujur lokasi clock-in
`clock_in_location.accuracy`	number	—	Akurasi GPS dalam meter
`clock_out_location`	object	Tidak	Koordinat GPS saat clock-out
`clock_out_location.latitude`	number	—	Garis lintang lokasi clock-out
`clock_out_location.longitude`	number	—	Garis bujur lokasi clock-out
`clock_out_location.accuracy`	number	—	Akurasi GPS dalam meter
`status`	enum	Tidak	Status absensi: `present` (default), `late`, `absent`, `sick`, `leave`, `wfh`
`notes`	string	Tidak	Catatan absensi
`total_hours`	number	Tidak	Total jam kerja hari ini
`overtime_hours`	number	Tidak	Total jam lembur (default: 0)
`distance_from_office`	number	Tidak	Jarak dari kantor/geofence pusat dalam meter
`location_id`	string	Tidak	ID lokasi geofence absensi terpilih
`location_name`	string	Tidak	Nama lokasi geofence terpilih (misal: Head Office, Outlet 2)
`clock_in_accuracy`	number	Tidak	Akurasi GPS saat clock in dalam meter
`clock_out_accuracy`	number	Tidak	Akurasi GPS saat clock out dalam meter
`is_manual_override`	boolean	Tidak	Flag apakah absensi ini disetujui via koreksi manual berizin (default: false)
`override_reason`	string	Tidak	Alasan pengajuan koreksi manual absensi
`override_approved_by`	string	Tidak	ID user/manager yang menyetujui koreksi manual
`override_approved_at`	datetime	Tidak	Waktu persetujuan koreksi manual

Schema: CompanyLeave (Pengajuan Cuti)

Entitas CompanyLeave menyimpan pengajuan cuti karyawan. Di Employee Portal, karyawan bisa membuat pengajuan cuti baru dan membaca status pengajuan sendiri.

Field	Tipe	Required	Deskripsi
`company_id`	string	Ya	ID perusahaan
`employee_id`	string	Ya	ID karyawan
`employee_name`	string	Tidak	Nama karyawan (denormalisasi)
`employee_email`	string	Tidak	Email karyawan (untuk RLS self-access)
`leave_type`	enum	Ya	Jenis cuti: `annual` (default), `sick`, `unpaid`, `maternity`, `paternity`, `emergency`
`start_date`	date	Ya	Tanggal mulai cuti
`end_date`	date	Ya	Tanggal selesai cuti
`total_days`	number	Tidak	Jumlah hari cuti (dihitung otomatis dari `end_date - start_date`)
`reason`	string	Ya	Alasan singkat pengajuan cuti
`description`	string	Tidak	Keterangan tambahan atau dokumen pendukung (max 1000 karakter)
`attachment_url`	string	Tidak	URL file pendukung (surat dokter, dll)
`status`	enum	Tidak	Status pengajuan: `pending` (default), `approved`, `rejected`, `cancelled`
`approver_id`	string	Tidak	ID user yang menyetujui/menolak
`approver_notes`	string	Tidak	Catatan dari approver (alasan reject, dll)
`approved_at`	datetime	Tidak	Waktu persetujuan/penolakan

Schema: CompanyLoan (Pengajuan Kasbon)

Entitas CompanyLoan menyimpan pengajuan kasbon/pinjaman karyawan. Di Employee Portal, karyawan bisa membuat pengajuan kasbon dan membaca status serta sisa pinjaman sendiri.

Field	Tipe	Required	Deskripsi
`company_id`	string	Ya	ID perusahaan
`employee_id`	string	Ya	ID karyawan
`employee_name`	string	Tidak	Nama karyawan (denormalisasi)
`employee_email`	string	Tidak	Email karyawan (untuk RLS self-access)
`amount`	number	Ya	Jumlah kasbon yang diajukan (Rupiah)
`reason`	string	Ya	Alasan pengajuan kasbon
`description`	string	Tidak	Detail tambahan mengenai keperluan kasbon dan rencana pelunasan (max 1000 karakter)
`attachment_url`	string	Tidak	URL bukti pendukung
`installment_months`	number	Tidak	Jumlah cicilan dalam bulan (default: 1)
`monthly_deduction`	number	Tidak	Potongan gaji per bulan untuk cicilan
`remaining_amount`	number	Tidak	Sisa pinjaman yang harus dibayar
`status`	enum	Tidak	Status pengajuan: `pending` (default), `approved`, `rejected`, `paid_off`
`approver_id`	string	Tidak	ID user yang menyetujui/menolak
`approver_notes`	string	Tidak	Catatan dari approver
`approved_at`	datetime	Tidak	Waktu persetujuan/penolakan
`disbursed_at`	datetime	Tidak	Waktu pencairan dana

Schema: CompanyAttendanceSettings (Pengaturan Absensi)

Entitas CompanyAttendanceSettings menyimpan konfigurasi kebijakan absensi perusahaan. Di Employee Portal, pengaturan ini digunakan untuk validasi clock-in/clock-out (geofence, jam kerja, shift).

Field	Tipe	Required	Deskripsi
`company_id`	string	Ya	ID perusahaan
`description`	string	Tidak	Penjelasan mengenai kebijakan absensi dan pengaturan jam kerja (max 1000 karakter)
`office_location`	object	Tidak	Lokasi kantor utama
`office_location.latitude`	number	—	Garis lintang kantor
`office_location.longitude`	number	—	Garis bujur kantor
`office_location.address`	string	—	Alamat fisik kantor
`office_radius_meters`	number	Tidak	Radius dari kantor dalam meter untuk validasi absensi (default: 100)
`require_office_location`	boolean	Tidak	Wajib absen dari lokasi kantor (default: false)
`default_accuracy_tolerance_meters`	number	Tidak	Batas toleransi akurasi GPS dalam meter (default: 150)
`locations`	array	Tidak	Daftar multi-lokasi geofence absensi (default: [])
`locations[].location_id`	string	Ya	ID unik area/lokasi absensi
`locations[].name`	string	Ya	Nama lokasi absensi (misal: Head Office, Outlet 2)
`locations[].address`	string	Tidak	Alamat fisik lokasi
`locations[].latitude`	number	Ya	Garis lintang lokasi pusat geofence
`locations[].longitude`	number	Ya	Garis bujur lokasi pusat geofence
`locations[].radius_meters`	number	Tidak	Radius lingkaran geofence dalam meter (default: 100)
`locations[].accuracy_tolerance_meters`	number	Tidak	Toleransi akurasi GPS maksimum (default: 150)
`locations[].assigned_employee_ids`	array	Tidak	Daftar ID karyawan yang ditugaskan ke lokasi ini (default: [])
`locations[].is_active`	boolean	Tidak	Status aktif lokasi geofence (default: true)
`working_hours`	object	Tidak	Jam kerja default
`working_hours.start_time`	string	—	Jam mulai kerja (HH:MM, default: 09:00)
`working_hours.end_time`	string	—	Jam selesai kerja (HH:MM, default: 17:00)
`working_hours.break_duration_minutes`	number	—	Durasi istirahat dalam menit (default: 60)
`shifts`	array	Tidak	Daftar shift kerja yang tersedia (default: [])
`shifts[].shift_id`	string	Ya	ID unik shift
`shifts[].shift_name`	string	Ya	Nama shift (misal: Shift Pagi)
`shifts[].start_time`	string	Ya	Jam mulai shift (HH:MM)
`shifts[].end_time`	string	Ya	Jam selesai shift (HH:MM)
`shifts[].break_duration_minutes`	number	Tidak	Durasi istirahat shift dalam menit (default: 60)
`overtime_settings`	object	Tidak	Pengaturan lembur
`overtime_settings.enabled`	boolean	—	Fitur lembur diaktifkan (default: true)
`overtime_settings.start_after_hours`	number	—	Lembur dimulai setelah X jam kerja (default: 8)
`overtime_settings.max_overtime_hours_per_day`	number	—	Maksimal jam lembur per hari (default: 4)
`late_tolerance_minutes`	number	Tidak	Toleransi terlambat dalam menit (default: 15)
`working_days`	array	Tidak	Hari kerja: 1=Senin, 7=Minggu (default: [1,2,3,4,5])
`auto_clock_out_enabled`	boolean	Tidak	Otomatis clock out jika karyawan lupa (default: false)
`auto_clock_out_time`	string	Tidak	Jam auto clock out (default: 18:00)
`require_photo`	boolean	Tidak	Wajib foto selfie saat absen (default: true)
`require_notes`	boolean	Tidak	Wajib catatan saat absen (default: false)

Schema: PayslipTemplate (Template Slip Gaji)

Entitas PayslipTemplate menyimpan template tampilan slip gaji yang bisa dikustomisasi per perusahaan. Template ini mengatur komponen apa saja yang ditampilkan saat slip gaji diexport atau dicetak.

Field	Tipe	Required	Deskripsi
`company_id`	string	Ya	ID perusahaan pemilik template
`template_name`	string	Ya	Nama template slip gaji
`description`	string	Tidak	Penjelasan mengenai tampilan dan komponen yang dicetak (max 1000 karakter)
`logo_url`	string	Tidak	URL logo perusahaan untuk header slip
`header_html`	string	Tidak	Custom HTML header untuk slip gaji
`footer_html`	string	Tidak	Custom HTML footer untuk slip gaji
`show_company_info`	boolean	Tidak	Tampilkan informasi perusahaan di slip (default: true)
`show_breakdown`	boolean	Tidak	Tampilkan rincian komponen gaji (default: true)
`show_attendance_summary`	boolean	Tidak	Tampilkan ringkasan absensi (default: true)
`show_kpi_score`	boolean	Tidak	Tampilkan skor KPI (default: true)
`is_default`	boolean	Tidak	Apakah ini template default perusahaan (default: false)

Schema: User (Akun Pengguna)

Entitas User menyimpan akun autentikasi global. Di Employee Portal, entitas User digunakan untuk autentikasi dan menentukan active_company_id yang sedang diakses.

Field	Tipe	Required	Deskripsi
`email`	string	Ya	Email akun pengguna
`full_name`	string	Ya	Nama lengkap pengguna
`role`	enum	Tidak	Role global: `admin`, `user`
`active_company_id`	string	Tidak	ID perusahaan yang sedang aktif diakses
`subscription_plan`	enum	Tidak	Plan langganan: `free` (default), `pro`, `business`, `advanced`, `enterprise`
`subscription_start`	datetime	Tidak	Tanggal mulai langganan
`subscription_end`	datetime	Tidak	Tanggal berakhir langganan
`membership_duration_type`	enum	Tidak	Tipe durasi membership: `monthly`, `yearly`, `custom`, `lifetime`
`membership_start_date`	date	Tidak	Tanggal mulai membership
`membership_end_date`	date	Tidak	Tanggal berakhir membership
`is_readonly_mode`	boolean	Tidak	Mode read-only ketika expired dalam grace period 3 hari (default: false)
`trial_end`	datetime	Tidak	Tanggal berakhir masa percobaan
`company_slots_purchased`	number	Tidak	Slot perusahaan tambahan yang dibeli (default: 0)
`admin_type`	enum	Tidak	Tipe admin APLIKASI: `owner` (full access) atau `basic` (hanya transaksi digital)
`admin_tier`	enum	Tidak	Tier admin untuk company management: `none` (default), `business`, `advanced`, `enterprise`
`balance`	number	Tidak	Saldo deposit untuk membeli membership/addon (default: 0)
`commission_balance`	number	Tidak	Saldo komisi dari referral yang dapat ditarik (default: 0)
`admin_commission_balance`	number	Tidak	Saldo komisi admin basic dari proses transaksi (default: 0)
`total_earnings`	number	Tidak	Total komisi yang pernah diterima (default: 0)
`productivity_score`	number	Tidak	Skor produktivitas pengguna (default: 0)
`current_streak`	number	Tidak	Streak hari berturut-turut menyelesaikan tugas (default: 0)
`longest_streak`	number	Tidak	Streak terpanjang (default: 0)
`last_active_date`	date	Tidak	Tanggal terakhir aktif
`total_tasks_completed`	number	Tidak	Total tugas yang diselesaikan (default: 0)
`total_notes_created`	number	Tidak	Total catatan yang dibuat (default: 0)
`achievement_points`	number	Tidak	Poin pencapaian (default: 0)
`user_level`	number	Tidak	Level pengguna berdasarkan achievement points (default: 1)
`preferences`	object	Tidak	Preferensi pengguna
`preferences.theme`	string	—	Tema tampilan
`preferences.primary_color`	string	—	Warna utama UI
`preferences.wallpaper_url`	string	—	URL wallpaper background
`preferences.referral_modal_dismissed`	boolean	—	Modal referral sudah ditutup (default: false)

Schema: Company (Data Perusahaan)

Entitas Company menyimpan data perusahaan tempat karyawan bekerja. Di Employee Portal, entitas ini menjadi konteks utama filtering data melalui company_id.

Field	Tipe	Required	Deskripsi
`name`	string	Ya	Nama perusahaan
`owner_id`	string	Ya	ID user pemilik perusahaan
`owner_email`	string	Ya	Email pemilik perusahaan
`owner_subscription_plan`	enum	Tidak	Plan membership owner: `free`, `pro`, `business`, `advanced`, `enterprise`
`description`	string	Tidak	Deskripsi perusahaan
`industry`	enum	Tidak	Industri: `retail`, `manufacturing`, `services`, `technology`, `food_beverage`, `healthcare`, `education`, `other`
`address`	string	Tidak	Alamat perusahaan
`phone`	string	Tidak	Nomor telepon perusahaan
`email`	string	Tidak	Email perusahaan
`website`	string	Tidak	Website perusahaan
`logo_url`	string	Tidak	URL logo perusahaan
`tax_id`	string	Tidak	NPWP perusahaan
`employee_count`	number	Tidak	Jumlah karyawan (default: 0)
`metadata`	object	Tidak	Data tambahan / legacy
`business_type`	string	Tidak	Kategori bisnis yang dipilih saat onboarding
`active_modules`	string	Tidak	JSON string berisi array ID modul aktif
`settings`	object	Tidak	Pengaturan perusahaan
`settings.working_hours_start`	string	—	Jam mulai kerja (default: 09:00)
`settings.working_hours_end`	string	—	Jam selesai kerja (default: 17:00)
`settings.working_days`	array	—	Hari kerja: 1=Senin, 7=Minggu (default: [1,2,3,4,5])
`settings.leave_policy`	object	—	Kebijakan cuti perusahaan
`settings.tax`	object	—	Konfigurasi pajak (enabled, rate, mode, rounding)
`settings.batch_allocation_strategy`	enum	—	Strategi alokasi batch: `fifo` (default), `fefo`

State Diagram — Siklus Hidup Pengajuan Self-Service

Diagram berikut menunjukkan siklus hidup pengajuan yang bisa dilakukan karyawan melalui Employee Portal: pengajuan cuti dan pengajuan kasbon.

Status Pengajuan Cuti (CompanyLeave)

Status Pengajuan Kasbon (CompanyLoan)

Status Payroll (CompanyPayroll)

Status Absensi (CompanyAttendance)

Sequence Diagrams — Alur Interaksi Employee Portal

Alur Melihat Slip Gaji (Payslip View)

Karyawan membuka tab “Slip Gaji” untuk melihat dan mengexport slip gaji bulanan.

Alur Mengajukan Cuti (Leave Request)

Karyawan mengajukan cuti baru melalui tab “Leaves” di Employee Portal.

Alur Update Profil (Profile Update)

Karyawan memperbarui informasi profil pribadi melalui sidebar di Employee Portal.

Alur Clock-in/Clock-out (Attendance)

Karyawan melakukan absensi masuk dan keluar melalui Employee Portal dengan validasi geofence dan GPS.

Enum Tables

Enum: `leave_type` (Jenis Cuti)

Nilai	Label	Keterangan
`annual`	Cuti Tahunan	Cuti tahunan reguler, mengurangi jatah cuti
`sick`	Cuti Sakit	Cuti karena sakit, memerlukan surat dokter
`unpaid`	Tanpa Bayaran	Cuti di luar tanggungan, menjadi deduction di payroll
`maternity`	Melahirkan	Cuti melahirkan
`paternity`	Ayah	Cuti kelahiran untuk ayah
`emergency`	Darurat	Cuti keadaan darurat

Enum: `approval_status` (Status Pengajuan Self-Service)

Nilai	Deskripsi	Warna UI	Entitas
`pending`	Menunggu persetujuan HR/Finance	Kuning	CompanyLeave, CompanyLoan
`approved`	Disetujui oleh approver	Hijau	CompanyLeave, CompanyLoan
`rejected`	Ditolak oleh approver	Merah	CompanyLeave, CompanyLoan
`cancelled`	Dibatalkan oleh karyawan	Abu-abu	CompanyLeave
`paid_off`	Cicilan pinjaman sudah lunas	Hijau	CompanyLoan

Enum: `payroll_status` (Status Slip Gaji)

Nilai	Deskripsi	Bisa Di-edit
`draft`	Slip gaji belum diapprove, masih bisa direvisi	Ya
`approved`	Slip gaji sudah disetujui Finance/HR	Ya (bisa dikembalikan)
`paid`	Gaji sudah ditransfer ke karyawan	Tidak (status final)

Enum: `attendance_status` (Status Absensi)

Nilai	Deskripsi	Warna Dot
`present`	Hadir tepat waktu	Hijau
`late`	Hadir terlambat	Kuning
`absent`	Tidak hadir tanpa keterangan	Merah
`sick`	Sakit (dengan surat dokter)	Biru
`leave`	Cuti (approved)	Biru
`wfh`	Work from home	Abu-abu

Enum: `employment_type` (Tipe Pekerjaan)

Nilai	Deskripsi
`full_time`	Karyawan tetap penuh waktu (default)
`part_time`	Karyawan paruh waktu
`contract`	Karyawan kontrak (PKWT)
`intern`	Magang

Enum: `employee_status` (Status Karyawan)

Nilai	Deskripsi
`active`	Karyawan aktif bekerja (default)
`on_leave`	Karyawan sedang cuti panjang
`terminated`	Karyawan sudah tidak bekerja (PHK/resign)

Enum: `department` (Departemen)

Nilai	Deskripsi
`Management`	Manajemen perusahaan
`Sales`	Penjualan
`Marketing`	Pemasaran
`Operations`	Operasional
`Finance`	Keuangan
`IT`	Teknologi Informasi
`HR`	Sumber Daya Manusia
`Customer Service`	Layanan Pelanggan

Enum: `payment_method` (Metode Pembayaran Gaji)

Nilai	Deskripsi
`bank_transfer`	Transfer bank (BCA, Mandiri, BNI, dll)
`cash`	Tunai
`check`	Cek/giro

Enum: `member_role` (Role dalam Perusahaan)

Nilai	Deskripsi	Scope Akses
`owner`	Pemilik perusahaan	Full access semua modul dan data
`admin`	Administrator global	Full access semua modul (non-owner)
`supervisor`	Supervisor tim	Akses tim yang dipimpin
`store_admin`	Admin toko/outlet	Akses modul POS dan inventori toko
`stock_admin`	Admin gudang	Akses modul inventori dan stock opname
`finance_admin`	Admin keuangan	Akses modul keuangan, payroll, kasbon
`hr_admin`	Admin HR	Akses modul HR, absensi, cuti, karyawan
`transaction_admin`	Admin transaksi	Akses modul transaksi penjualan
`employee`	Karyawan biasa	Self-service: profil, slip gaji, absensi, cuti
`production_operator`	Operator produksi	Akses modul produksi
`qc_inspector`	Inspector QC	Akses modul quality control
`sales_marketing`	Sales & Marketing	Akses modul sales dan marketing
`partner_distributor`	Partner/Distributor	Akses modul distribusi

Enum: `user_role` (Role Global User)

Nilai	Deskripsi
`admin`	Administrator aplikasi (akses penuh ke semua fitur)
`user`	Pengguna biasa (akses fitur standar)

Enum: `subscription_plan` (Plan Langganan)

Nilai	Deskripsi
`free`	Plan gratis dengan fitur terbatas (default)
`pro`	Plan profesional dengan fitur tambahan
`business`	Plan bisnis untuk perusahaan menengah
`advanced`	Plan advanced dengan fitur lanjutan
`enterprise`	Plan enterprise dengan fitur lengkap

Enum: `industry` (Industri Perusahaan)

Nilai	Deskripsi
`retail`	Ritel dan perdagangan
`manufacturing`	Manufaktur dan pabrik
`services`	Jasa dan layanan
`technology`	Teknologi dan perangkat lunak
`food_beverage`	Makanan dan minuman (F&B)
`healthcare`	Kesehatan dan farmasi
`education`	Pendidikan
`other`	Industri lainnya

Enum: `membership_duration_type` (Tipe Durasi Membership)

Nilai	Deskripsi
`monthly`	Langganan bulanan
`yearly`	Langganan tahunan
`custom`	Durasi kustom
`lifetime`	Akses seumur hidup

RBAC (Role-Based Access Control) — Employee Portal

Tabel berikut mendefinisikan hak akses per role terhadap fitur-fitur di Employee Portal. Permission disimpan di field CompanyMember.permissions.

Akses Fitur Employee Portal per Role

Fitur	owner	admin	hr_admin	finance_admin	supervisor	employee
Lihat profil sendiri	✅	✅	✅	✅	✅	✅
Edit profil sendiri	✅	✅	✅	✅	✅	✅ (terbatas)
Lihat slip gaji sendiri	✅	✅	✅	✅	✅	✅
Export slip gaji CSV	✅	✅	✅	✅	✅	✅
Lihat absensi sendiri	✅	✅	✅	✅	✅	✅
Clock-in / Clock-out	✅	✅	✅	✅	✅	✅
Lihat cuti sendiri	✅	✅	✅	✅	✅	✅
Ajukan cuti baru	✅	✅	✅	✅	✅	✅
Batalkan cuti pending	✅	✅	✅	✅	✅	✅
Ajukan kasbon	✅	✅	✅	✅	✅	✅
Approve cuti karyawan lain	✅	✅	✅	❌	✅ (tim)	❌
Approve kasbon karyawan lain	✅	✅	❌	✅	❌	❌
Lihat absensi tim	✅	✅	✅	❌	✅	❌
Lihat cuti tim	✅	✅	✅	❌	✅	❌

Akses per Entitas (Employee Portal Scope)

Entitas	owner	admin	hr_admin	finance_admin	supervisor	employee
CompanyMember	Full	Full	Read + Edit	Read only	Read (tim)	Read (self)
Employee	Full	Full	Full	Read only	Read (tim)	Read (self)
CompanyPayroll	Full	Full	Read only	Full	Read (tim)	Read (self)
CompanyAttendance	Full	Full	Full	Read only	Read (tim)	Read + Create (self)
CompanyLeave	Full	Full	Full (approve)	Read only	Read (tim)	Read + Create (self)
CompanyLoan	Full	Full	Read + Create	Full (approve)	Read (tim)	Read + Create (self)
CompanyAttendanceSettings	Full	Full	Full	Read only	Read only	Read only
PayslipTemplate	Full	Full	Read only	Read only	❌	❌

Catatan RLS (Row-Level Security)

Semua entitas di Employee Portal dilindungi oleh Row-Level Security (RLS). Karyawan dengan role employee hanya bisa mengakses data milik sendiri melalui kondisi berikut:

Entitas	Kondisi RLS untuk Self-Access
`CompanyMember`	`data.user_id = user.id` ATAU `data.user_email = user.email`
`Employee`	`data.user_id = user.id`
`CompanyPayroll`	Hanya via `company_id` match (admin generate, employee baca)
`CompanyAttendance`	`data.employee_email = user.email`
`CompanyLeave`	`data.employee_email = user.email`
`CompanyLoan`	`data.employee_email = user.email`

Admin global (user_condition: { role: "admin" }) memiliki akses penuh ke semua data tanpa batasan RLS.

ER Diagram Lengkap — Semua Entitas Employee Portal

Diagram berikut menampilkan relasi lengkap termasuk entitas pendukung: CompanyAttendanceSettings, PayslipTemplate, dan Company dengan field detail.

Ringkasan Kardinalitas Relasi

Relasi	Kardinalitas	Keterangan
`Company → CompanyAttendanceSettings`	1:1	Setiap perusahaan memiliki satu konfigurasi absensi
`Company → PayslipTemplate`	1:N	Perusahaan bisa memiliki beberapa template slip gaji
`CompanyAttendanceSettings → CompanyAttendance`	1:N	Satu pengaturan absensi berlaku untuk banyak record absensi
`PayslipTemplate → CompanyPayroll`	1:N	Satu template bisa digunakan untuk banyak slip gaji
`User → CompanyMember`	1:1	Satu user memiliki satu membership aktif
`CompanyMember → Employee`	1:1	Satu member terhubung ke satu data personalia
`CompanyMember → CompanyPayroll`	1:N	Satu member memiliki banyak slip gaji (per periode)
`CompanyMember → CompanyAttendance`	1:N	Satu member memiliki banyak record absensi
`CompanyMember → CompanyLeave`	1:N	Satu member bisa mengajukan banyak cuti
`CompanyMember → CompanyLoan`	1:N	Satu member bisa mengajukan banyak kasbon

​title: “Employee Portal — Portal Karyawan” description: “Portal self-service karyawan: slip gaji, kalender absensi, pengajuan cuti, dan profil di SNISHOP ERP.”

​Employee Portal — Portal Karyawan

​Arsitektur

​Akses Halaman

​Access Policy

​Tiga Tab Utama

​Tab Slip Gaji

​Daftar Slip Gaji

​Detail Slip Gaji

​Export CSV

​Tab Kehadiran: Kalender Mini

​Tab Cuti: Pengajuan Cuti

​Form Pengajuan

​Auto-Calculate Total Hari

​Jenis Cuti

​Status Pengajuan

​Profile Sidebar

​Informasi Profil

​Statistik Karyawan

​Entitas: CompanyPayroll (Detail)

​Diagram Relasi Entitas Employee Portal (ER Diagram)

​Penjelasan Relasi Utama

​Entity Schema Tables — Detail Lengkap per Entitas

​Schema: Employee (Data Personalia)

​Schema: CompanyMember (Akses & Profil Sistem)

​Schema: CompanyPayroll (Ringkasan Slip Gaji)

​Schema: CompanyAttendance (Record Absensi)

​Schema: CompanyLeave (Pengajuan Cuti)

​Schema: CompanyLoan (Pengajuan Kasbon)

​Schema: CompanyAttendanceSettings (Pengaturan Absensi)

​Schema: PayslipTemplate (Template Slip Gaji)

​Schema: User (Akun Pengguna)

​Schema: Company (Data Perusahaan)

​State Diagram — Siklus Hidup Pengajuan Self-Service

​Status Pengajuan Cuti (CompanyLeave)

​Status Pengajuan Kasbon (CompanyLoan)

​Status Payroll (CompanyPayroll)

​Status Absensi (CompanyAttendance)

​Sequence Diagrams — Alur Interaksi Employee Portal

​Alur Melihat Slip Gaji (Payslip View)

​Alur Mengajukan Cuti (Leave Request)

​Alur Update Profil (Profile Update)

​Alur Clock-in/Clock-out (Attendance)

​Enum Tables

​Enum: leave_type (Jenis Cuti)

​Enum: approval_status (Status Pengajuan Self-Service)

​Enum: payroll_status (Status Slip Gaji)

​Enum: attendance_status (Status Absensi)

​Enum: employment_type (Tipe Pekerjaan)

​Enum: employee_status (Status Karyawan)

​Enum: department (Departemen)

​Enum: payment_method (Metode Pembayaran Gaji)

​Enum: member_role (Role dalam Perusahaan)

​Enum: user_role (Role Global User)

​Enum: subscription_plan (Plan Langganan)

​Enum: industry (Industri Perusahaan)

​Enum: membership_duration_type (Tipe Durasi Membership)

​RBAC (Role-Based Access Control) — Employee Portal

​Akses Fitur Employee Portal per Role

​Akses per Entitas (Employee Portal Scope)

​Catatan RLS (Row-Level Security)

​ER Diagram Lengkap — Semua Entitas Employee Portal

​Ringkasan Kardinalitas Relasi