XERPIUM ESS

Ringkasan

Aplikasi Mobile Self-Service Karyawan

XERPIUM ESS adalah aplikasi mobile cross-platform (iOS & Android) berbasis Flutter yang memberi karyawan akses mandiri ke semua layanan HR — check-in/out, pengajuan cuti, klaim expense, lembur, slip gaji, pinjaman, dokumen, hingga resignasi — semuanya dari satu aplikasi.

🕒

CLOCK-IN

Attendance + Geotag

🎫

LEAVE

Request + Balance

💰

PAYSLIP

View + PDF Download

✅

APPROVAL

Approve/Reject Mobile

Dashboard

Dashboard & Navigasi

🏠

Home Dashboard

Greeting — Nama karyawan + jabatan, tampil avatar dengan inisial
Today's Attendance — Status check-in/out hari ini real-time
Quick Actions — 4 tombol cepat: Check In, Check Out, Leave, Expense
Menu Grid — 6 shortcut: Attendance, Leave Request, Expenses, Timesheet, Office Map, BPJS
Bottom Navigation — 5 tab: Home, Attendance, Leave, Overtime, Profile
Dark/Light Toggle — Ganti tema langsung dari dashboard header

🎨

Liquid Glass Theme

Glassmorphism — Desain modern semi-transparan dengan blur & border halus
Light Mode — Gradien pastel #E8EDF2 → #F4F6F9, teks biru slate
Dark Mode — Gradien gelap #111122 → #1A1D28, teks putih elegan
Primary Color — Teal/Emerald #06BEA0, gradien ke #0AA08C
Material 3 — ColorScheme.fromSeed, komponen M3 native
Card Glass — Opacity adaptif (75% light, 50% dark) + border 0.4-0.5 alpha

🔑

Login & Autentikasi

Server URL — Konfigurasi endpoint XERPIUM (cloud/on-premise)
Database — Pilih database XERPIUM target
Email + Password — Login dengan kredensial XERPIUM
Token-based Auth — Token JWT/session disimpan di memori app
Forgot Password — Link reset password
Splash Screen — Branding XERPIUM ESS, tombol "Get Started"

👤

Profil Karyawan

Avatar & Inisial — Foto profil atau inisial nama
Data Diri — Nama, jabatan, perusahaan, departemen
Kontak — Email kerja, nomor telepon — bisa diedit
BPJS — Nomor BPJS Kesehatan & BPJS Ketenagakerjaan
Edit Profile — Update work email & work phone langsung
Menu Hub — 8 menu: Payslip, Loan, Salary Advance, Documents, Resignation, Announcements, Approvals, Edit Profile
Logout — Hapus token, kembali ke login screen

📷

Screenshot: Dashboard & Profile

Home Dashboard, Today's Attendance, Quick Actions, Menu Grid, Dark Mode, Profile Screen, BPJS Card

Attendance & Leave

Absensi & Cuti — Mobile-First

Check-in/out langsung dari HP, riwayat absensi bulanan, saldo cuti, pengajuan cuti — semua dengan workflow approval terintegrasi.

Workflow Check-in/out

Buka App

→

Check In

→

Geolokasi + Foto

→

Status: Present

→

Check Out

→

Tercatat

🕒

Attendance

Check In — Absen masuk via mobile, kirim latitude/longitude & foto (base64)
Check Out — Absen pulang, data geolokasi & foto tersimpan
Real-time Status — Dashboard langsung tampil status "Present" / "Not Checked In"
Jam Lokal — Konversi UTC ke timezone user (Asia/Jakarta, WITA, WIT, dll)
Riwayat Bulanan — List lengkap dengan tanggal, jam in/out, status late/present
Summary Card — Total Present, Late, Days dalam sebulan
Late Detection — Flag otomatis is_late per record

🎫

Leave Request

Leave Balance — Card gradien oranye: remaining/max per tipe cuti, taken
Multi Leave Type — Cuti tahunan, sakit, izin, cuti hamil, cuti bersama
Pengajuan Cuti — Form: pilih tipe cuti, date from-to (date picker), reason
Validation — Tipe cuti wajib, tanggal from-to wajib, dateTo ≥ dateFrom
Riwayat Cuti — List pengajuan dengan status: Draft → To Approve → Approved → Refused
Workflow Status — 6 state: draft, confirm, validate1, validate, refuse, cancel
Cancel Leave — Batalkan pengajuan yang masih pending

📷

Screenshot: Attendance & Leave

Attendance History, Summary Card, Check-in Button, Leave Balance Card, Leave Request Form, Leave History

Expense & Overtime

Klaim Biaya & Lembur

Karyawan submit expense & overtime langsung dari HP. Manager approve/reject dari mobile. Semua tercatat di XERPIUM backend.

💰

Expense Management

Submit Expense — Form: deskripsi, jumlah (Rp), catatan, tanggal otomatis hari ini
Receipt Upload — Lampirkan foto struk sebagai base64 (field receipt_base64)
Summary Dashboard — Total Rp, jumlah Pending, jumlah Approved
Riwayat Expense — List lengkap dengan status warna: Draft, Submitted, Approved, Done, Rejected
Format Rupiah — Angka diformat dengan pemisah ribuan (1.000.000)
Workflow Approval — Draft → Submitted → Approved → Done (posting akuntansi)

⏰

Overtime

Overtime Types — Load jenis lembur dari XERPIUM (hari kerja, hari libur, split shift)
Request Form — Pilih tipe lembur, tanggal, catatan
Riwayat Lembur — List: tipe, tanggal, jam mulai-selesai, durasi (jam), status
Status Tracking — Draft → Confirmed → Done (warna abu → oranye → hijau)
Durasi Otomatis — Overtime hours dihitung oleh XERPIUM backend
Integrasi Payslip — Lembur yang approved masuk ke perhitungan gaji

📷

Screenshot: Expense & Overtime

Expense Summary, Expense List, Expense Form, Overtime List, Overtime Request Form

Payroll & Finance

Slip Gaji, Pinjaman & Uang Muka

Karyawan akses slip gaji digital, download PDF, ajukan pinjaman & salary advance — semua dari mobile.

📄

Payslip

Daftar Slip Gaji — List: nama periode, nomor, date from-to, gross, net
Detail Slip — Bottom sheet: gross amount, net amount, status, periode
Download PDF — Buka payslip PDF di tab baru (web) atau download
Status — Draft / Done / Waiting / Rejected dengan warna hijau/oranye
Format Rupiah — Gross & net diformat dengan pemisah ribuan

🏦

Loan (Pinjaman)

Daftar Pinjaman — List dengan expansion tile: nama, jumlah, balance, status
Detail Angsuran — Jumlah angsuran, total dibayar, rincian per bulan (tanggal + Rp + status lunas)
Request Form — Jumlah pinjaman, tenor (bulan), alasan
Default Tenor — 6 bulan, bisa diubah
Status — approve (hijau) / refuse + cancel (merah) / pending (oranye)
Auto Deduction — Angsuran otomatis dipotong dari payslip (XERPIUM backend)

💸

Salary Advance (Uang Muka Gaji)

Daftar Uang Muka — List: nama, jumlah Rp, alasan, status
Request Form — Jumlah uang muka, alasan
Status Tracking — approve / reject / cancel / pending
Potong Gaji — Otomatis dipotong dari payslip berikutnya (XERPIUM backend)

📋

Integrasi Backend XERPIUM

Payslip — Data dari hr.payslip XERPIUM, PDF generated server-side
Loan — hr.loan + installment schedule, auto accounting journal
Salary Advance — hr.salary.advance, deduct dari next payslip
BPJS & PPh21 — Semua kalkulasi pajak & BPJS dihitung di XERPIUM backend
Akuntansi — Jurnal otomatis: beban gaji, utang BPJS, utang PPh21, kas/bank

📷

Screenshot: Payslip, Loan & Salary Advance

Payslip List, Payslip Detail + Download PDF, Loan List + Installment Detail, Salary Advance List, Request Forms

HR Advanced

Resignasi, Dokumen, Pengumuman & Approval

Fitur lanjutan HR: pengajuan resign, tracking dokumen dengan expiry alert, pengumuman perusahaan, dan approval manager — semua dari mobile.

🚫

Resignation

Daftar Pengajuan — List: nama, last day, status (approved/cancel/pending)
Request Form — Alasan resign, last working day (date picker), tipe
Resignation Type — Normal Resignation / Fired by Company
Workflow — Submit → Manager Approval → Exit Checklist (XERPIUM backend)
Auto Status Update — Employee status: Active → Resigned → Terminated

📁

My Documents

Summary Dashboard — Total dokumen, Expiring (≤30 hari), Expired
Expiry Tracking — Hitung otomatis hari tersisa, flag: Valid / In Xd / Expired
Daftar Dokumen — Nama, tipe dokumen, tanggal terbit, tanggal kadaluarsa
Detail View — Tipe, issued date, expiry date, jumlah attachment, deskripsi
Color Coding — Hijau (valid), Oranye (expiring ≤30 hari), Merah (expired)
Pull-to-Refresh — Refresh data dengan gesture tarik layar

📢

Announcements

Daftar Pengumuman — List: judul, referensi, tanggal
Detail Popup — Judul, nomor referensi, tanggal terbit
Company-wide — Pengumuman dari HR/management untuk semua karyawan
Notifikasi — Icon notifikasi di header dashboard

✅

Approvals (Manager)

Pending Approvals — List permintaan yang perlu disetujui: leave & expense
Konteks per Item — Nama karyawan, detail (tanggal cuti / nama expense)
Approve/Reject — Dua tombol: hijau (Approve), merah (Reject)
Multi-type — Support leave approval & expense approval
Instant Sync — Approve/reject langsung update status di XERPIUM backend
Workflow-aware — Multi-level approval (validate1 → validate) di-handle backend

📷

Screenshot: Resignation, Documents, Announcements & Approvals

Resignation Form, Document List with Expiry Tags, Announcement Detail, Approval Cards with Approve/Reject

Arsitektur

Arsitektur Teknis & API

Flutter frontend + XERPIUM REST API backend. Arsitektur bersih, terstruktur, mudah dikustomisasi.

🔧

Tech Stack

Layer	Teknologi
Frontend Framework	Flutter 3.x (Dart)
State Management	StatefulWidget + setState
HTTP Client	package:http (native Dart)
Icons	flutter_svg + Material Icons
Theme	Liquid Glass — Custom glassmorphism
Backend	XERPIUM REST API (JSON-RPC)
Auth	Token-based (JWT/session via /api/hr/auth/login)
Timezone	Multi-TZ support (Asia/Jakarta, WITA, WIT, UTC, dll)
Platform	iOS + Android + Web (Flutter cross-platform)

📡

API Endpoints — 30+ Endpoint

Kategori	Endpoint
Auth	POST /api/hr/auth/login
Dashboard	/api/hr/dashboard
Attendance	/api/hr/attendance/status, checkin, checkout, history
Leave	/api/hr/leave/balances, request, history, cancel
Expense	/api/hr/expense/submit, history
Overtime	/api/hr/advanced/overtimes, overtime/request, overtime/types
Profile	/api/hr/profile, profile/update
Payslip	/api/hr/payroll/payslips, payslip/detail, payslip/pdf/{id}
Loan	/api/hr/payroll/loans, loan/request
Salary Advance	/api/hr/payroll/salary-advances, salary-advance/request
Resignation	/api/hr/advanced/resignations, resignation/request
Announcements	/api/hr/advanced/announcements
Documents	/api/hr/advanced/documents
Approvals	/api/hr/advanced/approvals, approval/action

⚙

Kustomisasi & Extensibility

Tambah Screen Baru — Buat folder di screens/, daftarkan di ProfileScreen menu hub
Tambah API — Method baru di ApiClient, panggil dari screen
Ganti Tema — Edit constants.dart: kPrimaryColor, gradien, warna light/dark
Multi-bahasa — Tambah localization delegate Flutter
Push Notification — Integrasi FCM untuk notifikasi approval, pengumuman
Offline Mode — Tambah local DB (sqflite/Hive) untuk cache data
Deep Link — Buka payslip PDF / approval langsung dari notifikasi
Biometric Auth — local_auth package untuk fingerprint/Face ID

Comparison

Mengapa XERPIUM ESS?

Aspek	Manual / WhatsApp / Email	XERPIUM ESS
Check-in/out	Manual di buku/form kertas	✓ Mobile + geolokasi + foto, real-time
Pengajuan Cuti	WhatsApp ke atasan, tidak tercatat	✓ Form terstruktur, saldo otomatis, workflow approval
Klaim Expense	Kertas + tanda tangan basah	✓ Submit + foto struk + approval mobile
Lembur	Catatan manual, sering dispute	✓ Request terstruktur, durasi auto, integrasi payslip
Slip Gaji	Print kertas, mudah hilang	✓ Digital + download PDF, akses kapan saja
Pinjaman	Form kertas, tracking manual	✓ Request + angsuran detail + auto potong gaji
Dokumen Karyawan	Fotokopi di lemari HR	✓ Digital + expiry alert otomatis (30 hari)
Approval Manager	Chat/email, lambat, tidak audit	✓ Mobile approve/reject, instant sync, audit trail
Pengumuman	Email blast, tidak terbaca	✓ In-app announcement + notifikasi
Resignasi	Surat manual, proses tidak jelas	✓ Form + workflow + exit checklist
Tema	✗ Tidak ada	✓ Liquid Glass dark/light, Material 3
Cross-Platform	✗ Terbatas	✓ iOS + Android + Web (Flutter)

Benefits

Manfaat untuk Bisnis

⏱

80%

Reduksi Waktu Proses HR

📈

100%

Audit Trail Digital

📱

24/7

Akses Karyawan

🎯 Untuk Karyawan

Self-service penuh — Tidak perlu kontak HR untuk hal rutin
Transparansi — Lihat saldo cuti, slip gaji, status pinjaman real-time
Mobilitas — Check-in, ajukan cuti, klaim expense dari mana saja
Notifikasi proaktif — Expiry dokumen, pengumuman, status approval
Paperless — Semua digital, tidak perlu print/fotokopi

🏢 Untuk HR & Manager

Approval mobile — Setujui/tolak cuti, expense, lembur dari HP
Data terpusat — Semua transaksi HR tercatat di XERPIUM backend
Akuntansi otomatis — Jurnal expense, payroll, loan auto-generated
Kepatuhan BPJS & PPh21 — Semua perhitungan sesuai regulasi Indonesia
Audit-ready — Full audit trail digital, siap untuk audit internal/eksternal

🌎 Untuk Bisnis

Produktivitas — Reduksi waktu admin HR hingga 80%
Karyawan happy — Self-service = kepuasan & engagement meningkat
Biaya rendah — Paperless, proses digital, tidak perlu infrastruktur tambahan
Scale-ready — Dari 10 sampai 10.000+ karyawan, arsitektur yang sama
Integrasi ERP — ESS adalah pintu masuk ke seluruh ekosistem XERPIUM

💻 Untuk IT & Developer

Flutter cross-platform — Satu codebase untuk iOS, Android, Web
Arsitektur bersih — Screen/service separation, mudah di-maintain
REST API standar — JSON-RPC 2.0, mudah di-test dengan Postman/curl
Extensible — Tambah fitur baru tanpa refactor besar
Open source ready — Bisa di-customize sesuai kebutuhan internal

XERPIUMESS