title: “Attendance — Absensi Personal” description: “Absensi personal dengan GPS+foto, kalender bulanan, dan statistik kehadiran di SNISHOP ERP.”

Attendance — Absensi Personal

Halaman Attendance memungkinkan setiap karyawan melakukan clock-in dan clock-out dengan verifikasi foto dan GPS. Sistem mencatat jam kerja, keterlambatan, dan lembur secara otomatis.

Arsitektur Absensi

Akses Halaman

URL: /attendance

Tiga Tab Utama

Tab	Label	Konten	Komponen
`checkin`	Clock In/Out	Form absensi dengan kamera dan GPS	LiveWorkTimer, Camera
`history`	Riwayat	Kalender bulanan dengan status harian	Calendar Grid
`stats`	Statistik	Ringkasan kehadiran dan jam kerja	Stats Cards

Entitas: AttendanceRecord

Field	Tipe	Wajib	Deskripsi
`employee_id`	string	Ya	ID karyawan
`employee_name`	string	Ya	Nama karyawan (denormalized)
`date`	date	Ya	Tanggal absensi
`clock_in_time`	datetime	Tidak	Waktu clock-in
`clock_out_time`	datetime	Tidak	Waktu clock-out
`clock_in_photo_url`	string	Tidak	URL foto clock-in (Cloudinary)
`clock_out_photo_url`	string	Tidak	URL foto clock-out (Cloudinary)
`clock_in_location`	object	Tidak	`{ lat, lng }` koordinat GPS clock-in
`clock_out_location`	object	Tidak	`{ lat, lng }` koordinat GPS clock-out
`status`	enum	Auto	`present` atau `late` (dihitung otomatis)
`late_minutes`	number	Auto	Menit keterlambatan (0 jika tepat waktu)
`total_hours`	number	Auto	Total jam kerja (dihitung saat clock-out)
`overtime_hours`	number	Auto	Jam lembur (total_hours - 9)
`notes`	string	Tidak	Catatan tambahan
`company_id`	string	Ya	ID perusahaan (multi-tenant)
`created_at`	datetime	Auto	Timestamp pembuatan

Clock-In: Deteksi Keterlambatan

Sistem menggunakan threshold tetap untuk menentukan status kehadiran:

Konstanta	Nilai	Fungsi
`WORK_START_HOUR`	8 (08:00)	Jam mulai kerja standar
`LATE_THRESHOLD_MINUTES`	15	Toleransi keterlambatan

Jika clock_in_time ≤ 08:15 → status = "present", late_minutes = 0
Jika clock_in_time > 08:15 → status = "late", late_minutes = selisih menit dari 08:00

Contoh Deteksi Keterlambatan

Clock-In Time	Status	Late Minutes	Penjelasan
07:55	present	0	Datang sebelum jam kerja
08:00	present	0	Tepat waktu
08:10	present	0	Dalam toleransi 15 menit
08:15	present	0	Batas toleransi
08:20	late	20	Melebihi toleransi 5 menit
08:45	late	45	Terlambat 45 menit
09:30	late	90	Sangat terlambat

Clock-Out: Perhitungan Jam Kerja

Saat clock-out, sistem menghitung:

Metrik	Perhitungan	Deskripsi
`total_hours`	`(clock_out_time - clock_in_time) / 3600000`	Selisih waktu dalam jam
`overtime_hours`	`max(0, total_hours - 9)`	Lembur setelah 9 jam kerja

Contoh Perhitungan

Clock-In	Clock-Out	Total Hours	Overtime	Status
08:00	17:00	9.0	0.0	Normal
08:00	18:00	10.0	1.0	1 jam lembur
08:30	17:30	9.0	0.0	Normal (terlambat 30 menit)
07:00	19:00	12.0	3.0	3 jam lembur
08:00	12:00	4.0	0.0	Setengah hari

Tab Riwayat: Kalender Bulanan

Kalender grid bulanan menampilkan status absensi setiap hari dengan color coding:

Warna	Ikon	Status	Arti
Hijau	🟢	Present	Hadir tepat waktu
Kuning	🟡	Late	Hadir terlambat
Abu-abu	⬜	Absent	Tidak hadir / hari libur
Biru	🔵	Leave	Cuti / izin

Tab Statistik

Metrik	Perhitungan	Deskripsi
Total Hari	Jumlah hari kerja dalam periode	Hari kerja (exclude weekend/holiday)
Hadir	`count(status === 'present')`	Hari hadir tepat waktu
Terlambat	`count(status === 'late')`	Hari hadir terlambat
Total Jam	`Σ total_hours`	Akumulasi jam kerja
Rata-rata Jam/Hari	`total_hours / total_hadir`	Rata-rata durasi kerja per hari
Total Menit Terlambat	`Σ late_minutes`	Akumulasi keterlambatan
Total Jam Lembur	`Σ overtime_hours`	Akumulasi lembur
Tingkat Ketepatan Waktu	`(hadir / total_hari) × 100%`	Persentase ketepatan

Upload Foto

Langkah	Detail
Capture	Dari kamera depan (selfie)
Compress	Resize ke max 800px, kualitas 0.8
Upload	Cloudinary path: `snishop_erp/attendance`
Storage	URL disimpan di `clock_in_photo_url` / `clock_out_photo_url`

Integrasi dengan Payroll

Data absensi personal mengalir ke perhitungan payroll:

Data Absensi	Digunakan di Payroll Untuk	Impact
`attendance_days`	Menghitung hari kerja untuk prorata gaji	直接影响 gaji pokok
`late_count`	Potongan keterlambatan	Mengurangi gaji
`overtime_hours`	Perhitungan upah lembur	Menambah gaji

Tips Penggunaan

Pastikan GPS aktif dan izin lokasi browser diberikan sebelum clock-in
Foto harus jelas terlihat untuk verifikasi — sistem menolak foto blur atau gelap
Clock-in sebelum 08:15 untuk status “present” (dalam toleransi)
Jangan lupa clock-out agar total jam kerja tercatat — jika lupa, hubungi HR admin
Cek tab Statistik secara berkala untuk memantau kehadiran dan lembur
Jika ada masalah dengan GPS atau kamera, gunakan notes untuk mencatat kendala

Entity Relationship Diagram

Tabel Schema: CompanyAttendance

Entitas absensi tingkat perusahaan yang menyimpan seluruh data clock-in/clock-out karyawan beserta verifikasi GPS dan foto.

Field	Tipe	Wajib	Default	Deskripsi
`company_id`	string	Ya	—	ID perusahaan (multi-tenant)
`employee_id`	string	Ya	—	ID karyawan (FK ke Employee)
`employee_name`	string	Tidak	—	Nama karyawan (denormalized)
`employee_email`	string	Tidak	—	Email karyawan (denormalized)
`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 clock-in (Cloudinary)
`clock_out_photo_url`	string	Tidak	—	URL foto clock-out (Cloudinary)
`clock_in_location`	object	Tidak	—	`{ latitude, longitude, accuracy }` GPS clock-in
`clock_out_location`	object	Tidak	—	`{ latitude, longitude, accuracy }` GPS clock-out
`status`	enum	Tidak	`present`	Status kehadiran: `present`, `late`, `absent`, `sick`, `leave`, `wfh`
`notes`	string	Tidak	—	Catatan tambahan dari karyawan
`total_hours`	number	Tidak	—	Total jam kerja (dihitung saat clock-out)
`overtime_hours`	number	Tidak	`0`	Jam lembur (total_hours - threshold)
`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 (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	`false`	Flag absensi ini hasil koreksi manual berizin
`override_reason`	string	Tidak	—	Alasan pengajuan koreksi manual absensi
`override_approved_by`	string	Tidak	—	ID user/manager yang menyetujui koreksi
`override_approved_at`	datetime	Tidak	—	Waktu persetujuan koreksi manual

Tabel Schema: CompanyLeave

Entitas pengajuan cuti tingkat perusahaan yang menyimpan data pengajuan, approval, dan dokumen pendukung cuti karyawan.

Field	Tipe	Wajib	Default	Deskripsi
`company_id`	string	Ya	—	ID perusahaan (multi-tenant)
`employee_id`	string	Ya	—	ID karyawan (FK ke Employee)
`employee_name`	string	Tidak	—	Nama karyawan (denormalized)
`employee_email`	string	Tidak	—	Email karyawan (denormalized)
`leave_type`	enum	Ya	`annual`	Jenis cuti: `annual`, `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 dari rentang tanggal)
`reason`	string	Ya	—	Alasan 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	`pending`	Status pengajuan: `pending`, `approved`, `rejected`, `cancelled`
`approver_id`	string	Tidak	—	ID approver (manager/HR)
`approver_notes`	string	Tidak	—	Catatan dari approver saat approve/reject
`approved_at`	datetime	Tidak	—	Timestamp keputusan approval

State Machine: Siklus Hidup Pengajuan Cuti

Transisi Status Cuti

Dari	Ke	Trigger	Kondisi
—	`pending`	Karyawan submit form pengajuan	Field wajib terisi: `company_id`, `employee_id`, `leave_type`, `start_date`, `end_date`, `reason`
`pending`	`approved`	Approver klik “Setujui”	Approver memiliki akses ke company yang sama
`pending`	`rejected`	Approver klik “Tolak”	Approver wajib mengisi `approver_notes`
`pending`	`cancelled`	Karyawan klik “Batalkan”	Hanya bisa dilakukan oleh pembuat pengajuan
`approved`	—	Sistem (cron)	Saat tanggal cuti berakhir, status tetap `approved` (histori)

Sequence Diagram: Ringkasan Absensi

Sequence Diagram: Pengajuan Cuti

Sequence Diagram: Approval Cuti

Tabel Enum: leave_type (Jenis Cuti)

Nilai	Label	Deskripsi
`annual`	Cuti Tahunan	Cuti reguler yang diambil dari jatah cuti tahunan karyawan
`sick`	Cuti Sakit	Cuti karena sakit, umumnya memerlukan surat dokter
`unpaid`	Cuti Tanpa Bayaran	Cuti di luar tanggungan perusahaan
`maternity`	Cuti Melahirkan	Cuti khusus untuk karyawan yang melahirkan
`paternity`	Cuti Ayah	Cuti khusus untuk karyawan yang istrinya melahirkan
`emergency`	Cuti Darurat	Cuti mendadak untuk keperluan darurat keluarga

Tabel Enum: leave_status (Status Pengajuan Cuti)

Nilai	Label	Deskripsi
`pending`	Menunggu Approval	Pengajuan baru diajukan, menunggu keputusan approver
`approved`	Disetujui	Pengajuan disetujui oleh approver
`rejected`	Ditolak	Pengajuan ditolak oleh approver
`cancelled`	Dibatalkan	Pengajuan dibatalkan oleh karyawan sebelum ada keputusan

Tabel Enum: attendance_status (Status Kehadiran)

Nilai	Label	Deskripsi
`present`	Hadir	Karyawan hadir tepat waktu (dalam toleransi)
`late`	Terlambat	Karyawan hadir melebihi toleransi keterlambatan
`absent`	Absen	Karyawan tidak hadir tanpa keterangan
`sick`	Sakit	Karyawan sakit (dengan atau tanpa surat dokter)
`leave`	Cuti	Karyawan sedang menjalani cuti yang disetujui
`wfh`	Work From Home	Karyawan bekerja dari rumah

Tabel Enum: employment_type (Tipe Karyawan)

Nilai	Label	Deskripsi
`full_time`	Penuh Waktu	Karyawan tetap dengan jam kerja penuh
`part_time`	Paruh Waktu	Karyawan dengan jam kerja kurang dari penuh
`contract`	Kontrak	Karyawan berbasis kontrak jangka waktu tertentu
`intern`	Magang	Karyawan magang/pelatihan

Tabel Enum: employee_status (Status Karyawan)

Nilai	Label	Deskripsi
`active`	Aktif	Karyawan aktif bekerja
`on_leave`	Cuti	Karyawan sedang cuti jangka panjang
`terminated`	Nonaktif	Karyawan sudah tidak bekerja

Tabel Enum: department (Departemen)

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

RBAC: Hak Akses Modul Attendance

Aksi	Admin	Manager/HR	Karyawan (sendiri)
Clock-in (create CompanyAttendance)	Ya	Ya	Ya (milik sendiri)
Lihat absensi sendiri (read)	Ya	Ya (timnya)	Ya (milik sendiri)
Lihat semua absensi perusahaan (read)	Ya	Ya	Tidak
Koreksi absensi manual (update)	Ya	Ya (dengan approval)	Tidak
Hapus record absensi (delete)	Ya	Ya	Tidak
Ajukan cuti (create CompanyLeave)	Ya	Ya	Ya (milik sendiri)
Lihat cuti sendiri (read)	Ya	Ya (timnya)	Ya (milik sendiri)
Lihat semua cuti perusahaan (read)	Ya	Ya	Tidak
Approve/reject cuti (update)	Ya	Ya	Tidak
Batalkan cuti sendiri (update → cancelled)	Ya	Ya	Ya (milik sendiri, hanya status pending)
Ubah pengaturan absensi (CompanyAttendanceSettings)	Ya	Tidak	Tidak

Aturan RLS (Row-Level Security)

Semua entitas attendance menggunakan RLS berbasis company_id dan user:

Kondisi	Aturan
Multi-tenant isolation	`data.company_id === user.data.active_company_id` — data hanya bisa diakses dalam scope perusahaan aktif
Owner access	`created_by_id === user.id` — pembuat record selalu bisa mengakses
Employee self-access	`data.employee_email === user.email` — karyawan bisa mengakses record atas nama email-nya
Admin override	`user.role === "admin"` — admin memiliki akses penuh lintas perusahaan

State Diagram: Siklus Hidup Absensi (Attendance Lifecycle)

Transisi Status Absensi

Dari	Ke	Trigger	Kondisi
—	`belum_absen`	Awal hari kerja (midnight cron)	Hari kerja berdasarkan `working_days` di CompanyAttendanceSettings
`belum_absen`	`clock_in`	Karyawan klik “Clock In”	GPS valid + foto berhasil diupload
`belum_absen`	`absent`	Cron job akhir hari	Tidak ada record clock-in pada hari tersebut
`belum_absen`	`sick`	Karyawan/HR input manual	Status sickness dengan atau tanpa surat dokter
`belum_absen`	`leave`	Pengajuan cuti approved	CompanyLeave status = `approved` mencakup tanggal tersebut
`belum_absen`	`wfh`	Karyawan/HR input manual	Work from home diizinkan oleh kebijakan perusahaan
`clocked_in`	`clock_out`	Karyawan klik “Clock Out”	GPS valid + foto berhasil diupload
`clocked_in`	`manual_override`	Karyawan ajukan koreksi	Clock-out lupa atau data GPS tidak akurat
`manual_override`	`approved_override`	Manager/HR approve	`is_manual_override = true`, `override_approved_by` terisi
`manual_override`	`rejected_override`	Manager/HR reject	`override_reason` ditolak dengan catatan
`clock_out`	`calculated`	Otomatis setelah clock-out	`total_hours` dan `overtime_hours` dihitung

Sequence Diagram: Clock-In (Verifikasi GPS + Foto)

Sequence Diagram: Clock-Out (Perhitungan Jam + Lembur)

Sequence Diagram: Koreksi Manual Absensi (Override)

Sequence Diagram: Perhitungan Lembur (Overtime)

Tabel Schema: CompanyAttendanceSettings

Entitas pengaturan absensi tingkat perusahaan yang menyimpan konfigurasi geofence, jam kerja, shift, lembur, dan kebijakan absensi.

Grup: Identitas & Lokasi Kantor

Field	Tipe	Wajib	Default	Deskripsi
`company_id`	string	Ya	—	ID perusahaan (multi-tenant)
`description`	string	Tidak	—	Penjelasan kebijakan absensi perusahaan (max 1000 karakter)
`office_location`	object	Tidak	—	Lokasi kantor utama: `{ latitude, longitude, address }`
`office_radius_meters`	number	Tidak	`100`	Radius geofence kantor utama dalam meter (legacy fallback)
`require_office_location`	boolean	Tidak	`false`	Wajib absen dari lokasi kantor
`default_accuracy_tolerance_meters`	number	Tidak	`150`	Batas toleransi akurasi GPS dalam meter

Grup: Multi-Lokasi Geofence (`locations[]`)

Field	Tipe	Wajib	Default	Deskripsi
`locations`	array	Tidak	`[]`	Daftar multi-lokasi geofence absensi perusahaan
`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	`100`	Radius lingkaran geofence dalam meter
`locations[].accuracy_tolerance_meters`	number	Tidak	`150`	Toleransi akurasi GPS maksimum untuk lokasi ini (meter)
`locations[].assigned_employee_ids`	array	Tidak	`[]`	Daftar ID karyawan yang ditugaskan ke lokasi ini (kosong = semua)
`locations[].is_active`	boolean	Tidak	`true`	Status aktif lokasi geofence

Grup: Jam Kerja (`working_hours`)

Field	Tipe	Wajib	Default	Deskripsi
`working_hours`	object	Tidak	—	Konfigurasi jam kerja standar
`working_hours.start_time`	string	Tidak	`"09:00"`	Jam mulai kerja (format HH:MM)
`working_hours.end_time`	string	Tidak	`"17:00"`	Jam selesai kerja (format HH:MM)
`working_hours.break_duration_minutes`	number	Tidak	`60`	Durasi istirahat dalam menit

Grup: Shift Kerja (`shifts[]`)

Field	Tipe	Wajib	Default	Deskripsi
`shifts`	array	Tidak	`[]`	Daftar shift kerja yang tersedia untuk karyawan
`shifts[].shift_id`	string	Ya	—	ID unik shift
`shifts[].shift_name`	string	Ya	—	Nama shift (misal: Shift Pagi, Shift Siang, Shift Malam)
`shifts[].start_time`	string	Ya	—	Jam mulai shift (format HH:MM)
`shifts[].end_time`	string	Ya	—	Jam selesai shift (format HH:MM)
`shifts[].break_duration_minutes`	number	Tidak	`60`	Durasi istirahat shift dalam menit

Grup: Pengaturan Lembur (`overtime_settings`)

Field	Tipe	Wajib	Default	Deskripsi
`overtime_settings`	object	Tidak	—	Konfigurasi perhitungan lembur
`overtime_settings.enabled`	boolean	Tidak	`true`	Apakah perhitungan lembur diaktifkan
`overtime_settings.start_after_hours`	number	Tidak	`8`	Lembur dimulai setelah X jam kerja
`overtime_settings.max_overtime_hours_per_day`	number	Tidak	`4`	Maksimal jam lembur per hari

Grup: Kebijakan Absensi

Field	Tipe	Wajib	Default	Deskripsi
`late_tolerance_minutes`	number	Tidak	`15`	Toleransi keterlambatan dalam menit
`working_days`	array	Tidak	`[1,2,3,4,5]`	Hari kerja (1=Senin, 7=Minggu)
`auto_clock_out_enabled`	boolean	Tidak	`false`	Otomatis clock-out jika karyawan lupa
`auto_clock_out_time`	string	Tidak	`"18:00"`	Jam auto clock-out (format HH:MM)
`require_photo`	boolean	Tidak	`true`	Wajib foto selfie saat absen
`require_notes`	boolean	Tidak	`false`	Wajib mengisi catatan saat absen

Tabel Schema: AttendanceRecord (Absensi Personal)

Entitas absensi personal (non-perusahaan) yang menyimpan data clock-in/clock-out mandiri karyawan.

Field	Tipe	Wajib	Default	Deskripsi
`user_id`	string	Ya	—	ID user (PK, pemilik record absensi)
`workspace_id`	string	Ya	—	ID workspace
`date`	date	Ya	—	Tanggal absensi
`clock_in_time`	datetime	Ya	—	Waktu clock-in
`clock_out_time`	datetime	Tidak	—	Waktu clock-out
`clock_in_photo_url`	string	Tidak	—	URL foto saat clock-in
`clock_out_photo_url`	string	Tidak	—	URL foto saat clock-out
`clock_in_location`	object	Tidak	—	`{ latitude, longitude, address }` lokasi GPS clock-in
`clock_out_location`	object	Tidak	—	`{ latitude, longitude, address }` lokasi GPS clock-out
`status`	enum	Tidak	`present`	Status kehadiran: `present`, `late`, `absent`, `sick`, `leave`
`notes`	string	Tidak	—	Catatan tambahan
`total_hours`	number	Tidak	—	Total jam kerja (dihitung saat clock-out)

Tabel Schema: Employee (Karyawan)

Entitas karyawan yang menyimpan data profil, jabatan, kompensasi, dan informasi kontak.

Grup: Identitas & Kontak

Field	Tipe	Wajib	Default	Deskripsi
`company_id`	string	Ya	—	ID perusahaan (multi-tenant)
`employee_id`	string	Ya	—	ID unik karyawan (UK)
`user_id`	string	Tidak	—	Link ke entitas User (FK)
`full_name`	string	Ya	—	Nama lengkap karyawan
`email`	string	Ya	—	Email karyawan
`phone`	string	Tidak	—	Nomor telepon karyawan
`address`	string	Tidak	—	Alamat tempat tinggal
`date_of_birth`	date	Tidak	—	Tanggal lahir
`avatar_url`	string	Tidak	—	URL foto profil karyawan

Grup: Jabatan & Kepegawaian

Field	Tipe	Wajib	Default	Deskripsi
`department`	enum	Ya	—	Departemen: `Management`, `Sales`, `Marketing`, `Operations`, `Finance`, `IT`, `HR`, `Customer Service`
`position`	string	Ya	—	Jabatan/posisi karyawan
`description`	string	Tidak	—	Catatan/deskripsi tambahan termasuk keahlian dan tanggung jawab (max 1000 karakter)
`employment_type`	enum	Tidak	`full_time`	Tipe kepegawaian: `full_time`, `part_time`, `contract`, `intern`
`hire_date`	date	Ya	—	Tanggal mulai bekerja
`status`	enum	Tidak	`active`	Status karyawan: `active`, `on_leave`, `terminated`

Grup: Kompensasi

Field	Tipe	Wajib	Default	Deskripsi
`salary`	number	Tidak	—	Gaji bulanan karyawan
`bank_account`	object	Tidak	—	Data rekening bank: `{ bank_name, account_number, account_name }`

Grup: Darurat

Field	Tipe	Wajib	Default	Deskripsi
`emergency_contact`	object	Tidak	—	Kontak darurat: `{ name, relationship, phone }`

Tabel Schema: Leave (Cuti Personal)

Entitas pengajuan cuti personal yang menyimpan data pengajuan cuti mandiri karyawan (non-perusahaan).

Field	Tipe	Wajib	Default	Deskripsi
`company_id`	string	Ya	—	ID perusahaan (multi-tenant)
`employee_id`	string	Ya	—	ID karyawan (FK ke Employee)
`employee_name`	string	Tidak	—	Nama karyawan (denormalized)
`leave_type`	enum	Ya	`annual`	Jenis cuti: `annual`, `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 dari rentang tanggal)
`reason`	string	Ya	—	Alasan pengajuan cuti
`description`	string	Tidak	—	Detail tambahan atau keterangan lebih lanjut (max 1000 karakter)
`attachment_url`	string	Tidak	—	URL file pendukung (surat dokter, dll)
`status`	enum	Tidak	`pending`	Status pengajuan: `pending`, `approved`, `rejected`, `cancelled`
`approver_id`	string	Tidak	—	ID approver (manager/HR)
`approver_notes`	string	Tidak	—	Catatan dari approver saat approve/reject
`approved_at`	datetime	Tidak	—	Timestamp keputusan approval

Tabel Enum: shift_name (Nama Shift)

Nilai	Label	Deskripsi
`pagi`	Shift Pagi	Shift pagi, umumnya 06:00–14:00
`siang`	Shift Siang	Shift siang, umumnya 14:00–22:00
`malam`	Shift Malam	Shift malam, umumnya 22:00–06:00
`reguler`	Shift Reguler	Shift standar, umumnya 09:00–17:00

Tabel Enum: override_status (Status Koreksi Manual)

Nilai	Label	Deskripsi
`false`	Belum Dikoreksi	Absensi asli tanpa koreksi manual
`true`	Sedang/Awal Dikoreksi	Absensi telah diajukan koreksi manual, menunggu approval
`approved`	Koreksi Disetujui	Koreksi manual disetujui oleh manager/HR
`rejected`	Koreksi Ditolak	Koreksi manual ditolak, record tetap asli

Tabel Enum: work_day (Hari Kerja)

Nilai Numerik	Hari	Deskripsi
`1`	Senin	Hari kerja default
`2`	Selasa	Hari kerja default
`3`	Rabu	Hari kerja default
`4`	Kamis	Hari kerja default
`5`	Jumat	Hari kerja default
`6`	Sabtu	Hari kerja opsional (non-default)
`7`	Minggu	Akhir pekan (non-default)

Matriks RLS Lengkap: Entitas Attendance

CompanyAttendance — Row-Level Security

Operasi	Kondisi Akses
Create	`data.company_id === user.data.active_company_id` (dalam perusahaan aktif) ATAU `created_by_id === user.id` (pembuat) ATAU `data.employee_email === user.email` (email sendiri) ATAU `user.role === "admin"`
Read	`data.company_id === user.data.active_company_id` ATAU `created_by_id === user.id` ATAU `data.employee_email === user.email` ATAU `user.role === "admin"`
Update	`data.company_id === user.data.active_company_id` ATAU `created_by_id === user.id` ATAU `data.employee_email === user.email` ATAU `user.role === "admin"`
Delete	`data.company_id === user.data.active_company_id` ATAU `created_by_id === user.id` ATAU `data.employee_email === user.email` ATAU `user.role === "admin"`

CompanyLeave — Row-Level Security

Operasi	Kondisi Akses
Create	`data.company_id === user.data.active_company_id` ATAU `created_by_id === user.id` ATAU `data.employee_email === user.email` ATAU `user.role === "admin"`
Read	`data.company_id === user.data.active_company_id` ATAU `created_by_id === user.id` ATAU `data.employee_email === user.email` ATAU `user.role === "admin"`
Update	`data.company_id === user.data.active_company_id` ATAU `created_by_id === user.id` ATAU `data.employee_email === user.email` ATAU `user.role === "admin"`
Delete	`data.company_id === user.data.active_company_id` ATAU `created_by_id === user.id` ATAU `data.employee_email === user.email` ATAU `user.role === "admin"`

AttendanceRecord — Row-Level Security

Operasi	Kondisi Akses
Create	`data.user_id === user.id` ATAU `created_by_id === user.id` ATAU `user.role === "admin"`
Read	`data.user_id === user.id` ATAU `created_by_id === user.id` ATAU `user.role === "admin"`
Update	`data.user_id === user.id` ATAU `created_by_id === user.id` ATAU `user.role === "admin"`
Delete	`data.user_id === user.id` ATAU `created_by_id === user.id` ATAU `user.role === "admin"`

Employee — Row-Level Security

Operasi	Kondisi Akses
Create	`data.company_id === user.data.active_company_id` ATAU `created_by_id === user.id` ATAU `data.user_id === user.id` ATAU `user.role === "admin"`
Read	`data.company_id === user.data.active_company_id` ATAU `created_by_id === user.id` ATAU `data.user_id === user.id` ATAU `user.role === "admin"`
Update	`data.company_id === user.data.active_company_id` ATAU `created_by_id === user.id` ATAU `data.user_id === user.id` ATAU `user.role === "admin"`
Delete	`data.company_id === user.data.active_company_id` ATAU `created_by_id === user.id` ATAU `data.user_id === user.id` ATAU `user.role === "admin"`

CompanyAttendanceSettings — Row-Level Security

Operasi	Kondisi Akses
Create	Tanpa batasan RLS (dikelola oleh sistem)
Read	Tanpa batasan RLS (dikelola oleh sistem)
Update	Tanpa batasan RLS (dikelola oleh sistem)
Delete	Tanpa batasan RLS (dikelola oleh sistem)

Ringkasan Relasi Entitas Attendance

┌─────────────────────────────────────────────────────────────────────────────────┐
│                         ALUR DATA MODUL ATTENDANCE                              │
├─────────────────────────────────────────────────────────────────────────────────┤
│                                                                                 │
│  Employee ──1:N──▶ CompanyAttendance ◀──N:1── CompanyAttendanceSettings        │
│  (Karyawan)         (Absensi Perusahaan)       (Pengaturan Absensi)             │
│       │                    │                         │                          │
│       │                    │                         ├── locations[] (geofence) │
│       │                    │                         ├── shifts[] (shift kerja) │
│       │                    │                         ├── working_hours          │
│       │                    │                         └── overtime_settings      │
│       │                    │                                                  │
│       │                    └──▶ Payroll Module (integrasi gaji)                │
│       │                                                                      │
│       ├──1:N──▶ CompanyLeave (Cuti Perusahaan)                               │
│       │             │                                                        │
│       │             └──▶ Approval Workflow (Manager/HR)                      │
│       │                                                                      │
│       ├──1:N──▶ Leave (Cuti Personal)                                        │
│       │                                                                      │
│       └──1:N──▶ AttendanceRecord (Absensi Personal)                          │
│                                                                                 │
└─────────────────────────────────────────────────────────────────────────────────┘

​title: “Attendance — Absensi Personal” description: “Absensi personal dengan GPS+foto, kalender bulanan, dan statistik kehadiran di SNISHOP ERP.”

​Attendance — Absensi Personal

​Arsitektur Absensi

​Akses Halaman

​Tiga Tab Utama

​Entitas: AttendanceRecord

​Clock-In: Deteksi Keterlambatan

​Contoh Deteksi Keterlambatan

​Clock-Out: Perhitungan Jam Kerja

​Contoh Perhitungan

​Tab Riwayat: Kalender Bulanan

​Tab Statistik

​Upload Foto

​Integrasi dengan Payroll

​Tips Penggunaan

​Entity Relationship Diagram

​Tabel Schema: CompanyAttendance

​Tabel Schema: CompanyLeave

​State Machine: Siklus Hidup Pengajuan Cuti

​Transisi Status Cuti

​Sequence Diagram: Ringkasan Absensi

​Sequence Diagram: Pengajuan Cuti

​Sequence Diagram: Approval Cuti

​Tabel Enum: leave_type (Jenis Cuti)

​Tabel Enum: leave_status (Status Pengajuan Cuti)

​Tabel Enum: attendance_status (Status Kehadiran)

​Tabel Enum: employment_type (Tipe Karyawan)

​Tabel Enum: employee_status (Status Karyawan)

​Tabel Enum: department (Departemen)

​RBAC: Hak Akses Modul Attendance

​Aturan RLS (Row-Level Security)

​State Diagram: Siklus Hidup Absensi (Attendance Lifecycle)

​Transisi Status Absensi

​Sequence Diagram: Clock-In (Verifikasi GPS + Foto)

​Sequence Diagram: Clock-Out (Perhitungan Jam + Lembur)

​Sequence Diagram: Koreksi Manual Absensi (Override)

​Sequence Diagram: Perhitungan Lembur (Overtime)

​Tabel Schema: CompanyAttendanceSettings

​Grup: Identitas & Lokasi Kantor

​Grup: Multi-Lokasi Geofence (locations[])

​Grup: Jam Kerja (working_hours)

​Grup: Shift Kerja (shifts[])

​Grup: Pengaturan Lembur (overtime_settings)

​Grup: Kebijakan Absensi

​Tabel Schema: AttendanceRecord (Absensi Personal)

​Tabel Schema: Employee (Karyawan)

​Grup: Identitas & Kontak

​Grup: Jabatan & Kepegawaian

​Grup: Kompensasi

​Grup: Darurat

​Tabel Schema: Leave (Cuti Personal)

​Tabel Enum: shift_name (Nama Shift)

​Tabel Enum: override_status (Status Koreksi Manual)

​Tabel Enum: work_day (Hari Kerja)

​Matriks RLS Lengkap: Entitas Attendance

​CompanyAttendance — Row-Level Security

​CompanyLeave — Row-Level Security

​AttendanceRecord — Row-Level Security

​Employee — Row-Level Security

​CompanyAttendanceSettings — Row-Level Security

​Ringkasan Relasi Entitas Attendance