XERPIUMESS

Home Dashboard

• Greeting — Employee name + position, avatar with initials shown
• Today's Attendance — Real-time check-in/out status today
• Quick Actions — 4 quick buttons: Check In, Check Out, Leave, Expense
• Menu Grid — 6 shortcuts: Attendance, Leave Request, Expenses, Timesheet, Office Map, BPJS
• Bottom Navigation — 5 tab: Home, Attendance, Leave, Overtime, Profile
• Dark/Light Toggle — Switch theme straight from the dashboard header

Liquid Glass Theme

• Glassmorphism — Modern semi-transparent design with blur & subtle borders
• Light Mode — Pastel gradient #E8EDF2 → #F4F6F9, slate blue text
• Dark Mode — Dark gradient #111122 → #1A1D28, elegant white text
• Primary Color — Teal/Emerald #06BEA0, gradient to #0AA08C
• Material 3 — ColorScheme.fromSeed, native M3 components
• Card Glass — Adaptive opacity (75% light, 50% dark) + border 0.4-0.5 alpha

Login & Autentikasi

• Server URL — XERPIUM endpoint configuration (cloud/on-premise)
• Database — Select target XERPIUM database
• Email + Password — Log in with XERPIUM credentials
• Token-based Auth — JWT/session token stored in app memory
• Forgot Password — Link reset password
• Splash Screen — XERPIUM ESS branding, "Get Started" button

Employee Profile

• Avatar & Initials — Profile photo or name initials
• Personal Data — Name, position, company, department
• Contact — Work email, phone number — editable
• BPJS — BPJS Health & BPJS Employment numbers
• Edit Profile — Update work email & work phone directly
• Menu Hub — 8 menus: Payslip, Loan, Salary Advance, Documents, Resignation, Announcements, Approvals, Edit Profile
• Logout — Delete token, return to login screen

Expense Management

• Submit Expense — Form: description, amount (Rp), notes, date auto-filled with today
• Receipt Upload — Attach receipt photo as base64 (receipt_base64 field)
• Summary Dashboard — Total Rp, Pending count, Approved count
• Expense History — Full list with color status: Draft, Submitted, Approved, Done, Rejected
• Format Rupiah — Numbers formatted with thousand separators (1,000,000)
• Workflow Approval — Draft → Submitted → Approved → Done (accounting posting)

Overtime

• Overtime Types — Load overtime types from XERPIUM (workday, holiday, split shift)
• Request Form — Select overtime type, date, notes
• Overtime History — List: type, date, start-end time, duration (hours), status
• Status Tracking — Draft → Confirmed → Done (gray → orange → green)
• Automatic Duration — Overtime hours computed by the XERPIUM backend
• Payslip Integration — Approved overtime flows into payroll calculation

Payslip

• Payslip List — List: period name, number, date from-to, gross, net
• Detail Slip — Bottom sheet: gross amount, net amount, status, period
• Download PDF — Open payslip PDF in a new tab (web) or download
• Status — Draft / Done / Waiting / Rejected with green/orange colors
• Format Rupiah — Gross & net formatted with thousand separators

Loans

• Loan List — List with expansion tile: name, amount, balance, status
• Installment Details — Number of installments, total paid, breakdown per month (date + Rp + paid status)
• Request Form — Loan amount, tenor (months), reason
• Default Tenor — 6 months, adjustable
• Status — approve (green) / refuse + cancel (red) / pending (orange)
• Auto Deduction — Installments automatically deducted from payslip (XERPIUM backend)

Salary Advance

• Advance Payment List — List: name, amount Rp, reason, status
• Request Form — Advance amount, reason
• Status Tracking — approve / reject / cancel / pending
• Salary Deduction — Automatically deducted from the next payslip (XERPIUM backend)

XERPIUM Backend Integration

• Payslip — Data from XERPIUM hr.payslip, PDF generated server-side
• Loan — hr.loan + installment schedule, auto accounting journal
• Salary Advance — hr.salary.advance, deducted from next payslip
• BPJS & Income Tax Art. 21 — All tax & BPJS calculations are done in the XERPIUM backend
• Accounting — Automatic journals: salary expense, BPJS payable, income tax Art. 21 payable, cash/bank

Resignation

• Request List — List: name, last day, status (approved/cancel/pending)
• Request Form — Resignation reason, last working day (date picker), type
• 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 documents, Expiring (≤30 days), Expired
• Expiry Tracking — Automatically calculate days remaining, flag: Valid / In Xd / Expired
• Document List — Name, document type, issue date, expiry date
• Detail View — Type, issued date, expiry date, attachment count, description
• Color Coding — Green (valid), Orange (expiring ≤30 days), Red (expired)
• Pull-to-Refresh — Refresh data with a pull-down gesture

Announcements

• Announcement List — List: title, reference, date
• Detail Popup — Title, reference number, issue date
• Company-wide — Announcements from HR/management to all employees
• Notifications — Notification icon in dashboard header

Approvals (Manager)

• Pending Approvals — List of requests awaiting approval: leave & expense
• Context per Item — Employee name, detail (leave dates / expense name)
• Approve/Reject — Two buttons: green (Approve), red (Reject)
• Multi-type — Support leave approval & expense approval
• Instant Sync — Approve/reject immediately updates status in the XERPIUM backend
• Workflow-aware — Multi-level approval (validate1 → validate) handled by backend

Tech Stack

API Endpoints — 30+ Endpoint

Customization & Extensibility

• Add New Screen — Create a folder in screens/, register it in the ProfileScreen menu hub
• Add API — New method in ApiClient, call from screen
• Change Theme — Edit constants.dart: kPrimaryColor, gradient, light/dark colors
• Multi-language — Add Flutter localization delegate
• Push Notification — FCM integration for approval notifications, announcements
• Offline Mode — Add local DB (sqflite/Hive) for data caching
• Deep Link — Open payslip PDF / approval straight from the notification
• Biometric Auth — local_auth package for fingerprint/Face ID