How iqbalussain/payroll-mobile-app works
Site Payroll Manager is an offline-first native Android payroll app. Users manage workers, enter monthly site payroll, track advances, and review worker statements, payslips, and project costs; exports and role-based controls support those workflows. The README describes a Compose/MVVM, repository, and Room architecture, but source excerpts do not expose runtime calls. Edges therefore show only documented architectural or feature relationships; unverified wiring is omitted.
Main entry points: PayrollViewModel.kt Payroll state · EmployeesScreen.kt Worker directory · AppDatabase.kt Room database · PayrollScreen.kt Monthly payroll
Components 23
Payroll operations
- Worker directory
app/src/main/java/com/example/payrollsheet/ui/screens/EmployeesScreen.kt - Worker editing
app/src/main/java/com/example/payrollsheet/ui/screens/AddEmployeeScreen.kt - Monthly payroll
app/src/main/java/com/example/payrollsheet/ui/screens/PayrollScreen.kt - Advance management
app/src/main/java/com/example/payrollsheet/ui/screens/AdvancesScreen.kt
Payroll insights
- Worker history
app/src/main/java/com/example/payrollsheet/ui/screens/HistoryScreen.kt - Salary payslips
app/src/main/java/com/example/payrollsheet/ui/screens/SalarySlipsScreen.kt - Payslip details
app/src/main/java/com/example/payrollsheet/ui/components/SalarySlipDetailDialog.kt - Cost allocation
app/src/main/java/com/example/payrollsheet/ui/screens/CostAllocationScreen.kt - Payroll summary
app/src/main/java/com/example/payrollsheet/ui/screens/PayrollSummaryScreen.kt - Disbursement chart
app/src/main/java/com/example/payrollsheet/ui/components/PayrollDisbursementLineChart.kt - CSV export
app/src/main/java/com/example/payrollsheet/util/CsvExporter.kt
App presentation
- Home dashboard
app/src/main/java/com/example/payrollsheet/ui/screens/HomeScreen.kt - Login screen
app/src/main/java/com/example/payrollsheet/ui/screens/LoginScreen.kt - Activity entry
app/src/main/java/com/example/payrollsheet/MainActivity.kt - Compose app root
app/src/main/java/com/example/payrollsheet/PayrollApp.kt
Domain and state
- Payroll state
app/src/main/java/com/example/payrollsheet/ui/viewmodel/PayrollViewModel.kt - Payroll models
app/src/main/java/com/example/payrollsheet/data/model/Models.kt
Local persistence
- Employee repository
app/src/main/java/com/example/payrollsheet/data/repository/EmployeeRepository.kt - Payroll repository
app/src/main/java/com/example/payrollsheet/data/repository/PayrollRepository.kt - Room database
app/src/main/java/com/example/payrollsheet/data/local/AppDatabase.kt - Employee DAO
app/src/main/java/com/example/payrollsheet/data/local/EmployeeDao.kt - Payroll DAOs
app/src/main/java/com/example/payrollsheet/data/local/PayrollDao.kt
Other components
- Payroll user
Connections 21
- Payroll user → Worker directory: manages staff
README.md - Payroll user → Monthly payroll: enters payroll
README.md - Payroll user → Advance management: records advances
README.md - Payroll user → Worker history: reviews history
README.md - Payroll user → Salary payslips: reviews slips
README.md - Payroll user → Cost allocation: reviews costs
README.md - Payroll user → CSV export: exports reports
README.md - Worker directory → Worker editing: opens editing
README.md - Salary payslips → Payslip details: opens details
README.md - Payroll summary → Disbursement chart: shows disbursements
- Worker directory → Payroll state: uses state
- Monthly payroll → Payroll state: uses state
- Advance management → Payroll state: uses state
- Payroll state → Employee repository: accesses employees
- Payroll state → Payroll repository: accesses payroll
- Employee repository → Employee DAO: uses DAO
- Payroll repository → Payroll DAOs: uses DAOs
- Room database → Employee DAO: provides DAO
- Room database → Payroll DAOs: provides DAOs
- Payroll state → Payroll models: uses models
- Activity entry → Compose app root: launches app