# iqbalussain/payroll-mobile-app architecture

> Architecture diagram of the GitHub repository iqbalussain/payroll-mobile-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/iqbalussain/payroll-mobile-app
- Repository: https://github.com/iqbalussain/payroll-mobile-app

## Overview

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: [`app/src/main/java/com/example/payrollsheet/ui/viewmodel/PayrollViewModel.kt`](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/viewmodel/PayrollViewModel.kt) (Payroll state), [`app/src/main/java/com/example/payrollsheet/ui/screens/EmployeesScreen.kt`](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/EmployeesScreen.kt) (Worker directory), [`app/src/main/java/com/example/payrollsheet/data/local/AppDatabase.kt`](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/data/local/AppDatabase.kt) (Room database), [`app/src/main/java/com/example/payrollsheet/ui/screens/PayrollScreen.kt`](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/PayrollScreen.kt) (Monthly payroll)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operations["Payroll operations"]
  node_worker["Worker directory<br/>[EmployeesScreen.kt]"]
  node_worker_edit["Worker editing"]
  node_monthly_payroll["Monthly payroll<br/>[PayrollScreen.kt]"]
  node_advances["Advance management<br/>[AdvancesScreen.kt]"]
end

subgraph group_insights["Payroll insights"]
  node_worker_history["Worker history<br/>[HistoryScreen.kt]"]
  node_payslips["Salary payslips"]
  node_slip_detail["Payslip details"]
  node_cost_allocation["Cost allocation"]
  node_payroll_summary["Payroll summary"]
  node_payroll_chart["Disbursement chart"]
  node_csv_export["CSV export<br/>[CsvExporter.kt]"]
end

subgraph group_presentation["App presentation"]
  node_home["Home dashboard<br/>[HomeScreen.kt]"]
  node_login["Login screen<br/>[LoginScreen.kt]"]
  node_app_entry["Activity entry<br/>[MainActivity.kt]"]
  node_app_root["Compose app root<br/>[PayrollApp.kt]"]
end

subgraph group_domain["Domain and state"]
  node_viewmodel["Payroll state"]
  node_payroll_models["Payroll models<br/>[Models.kt]"]
end

subgraph group_persistence["Local persistence"]
  node_employee_repository["Employee repository"]
  node_payroll_repository["Payroll repository"]
  node_room_database[("Room database<br/>[AppDatabase.kt]")]
  node_employee_dao["Employee DAO<br/>[EmployeeDao.kt]"]
  node_payroll_dao["Payroll DAOs<br/>[PayrollDao.kt]"]
end

node_employee_actor(("Payroll user"))

node_employee_actor -->|"manages staff"| node_worker
node_employee_actor -->|"enters payroll"| node_monthly_payroll
node_employee_actor -->|"records advances"| node_advances
node_employee_actor -->|"reviews history"| node_worker_history
node_employee_actor -->|"reviews slips"| node_payslips
node_employee_actor -->|"reviews costs"| node_cost_allocation
node_employee_actor -->|"exports reports"| node_csv_export
node_worker -->|"opens editing"| node_worker_edit
node_payslips -->|"opens details"| node_slip_detail
node_payroll_summary -.->|"shows disbursements"| node_payroll_chart
node_worker -.->|"uses state"| node_viewmodel
node_monthly_payroll -.->|"uses state"| node_viewmodel
node_advances -.->|"uses state"| node_viewmodel
node_viewmodel -.->|"accesses employees"| node_employee_repository
node_viewmodel -.->|"accesses payroll"| node_payroll_repository
node_employee_repository -.->|"uses DAO"| node_employee_dao
node_payroll_repository -.->|"uses DAOs"| node_payroll_dao
node_room_database -.->|"provides DAO"| node_employee_dao
node_room_database -.->|"provides DAOs"| node_payroll_dao
node_viewmodel -.->|"uses models"| node_payroll_models
node_app_entry -.->|"launches app"| node_app_root

click node_worker "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/EmployeesScreen.kt"
click node_worker_edit "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/AddEmployeeScreen.kt"
click node_monthly_payroll "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/PayrollScreen.kt"
click node_advances "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/AdvancesScreen.kt"
click node_worker_history "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/HistoryScreen.kt"
click node_payslips "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/SalarySlipsScreen.kt"
click node_slip_detail "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/components/SalarySlipDetailDialog.kt"
click node_cost_allocation "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/CostAllocationScreen.kt"
click node_payroll_summary "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/PayrollSummaryScreen.kt"
click node_payroll_chart "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/components/PayrollDisbursementLineChart.kt"
click node_csv_export "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/util/CsvExporter.kt"
click node_home "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/HomeScreen.kt"
click node_login "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/LoginScreen.kt"
click node_app_entry "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/MainActivity.kt"
click node_app_root "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/PayrollApp.kt"
click node_viewmodel "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/viewmodel/PayrollViewModel.kt"
click node_payroll_models "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/data/model/Models.kt"
click node_employee_repository "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/data/repository/EmployeeRepository.kt"
click node_payroll_repository "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/data/repository/PayrollRepository.kt"
click node_room_database "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/data/local/AppDatabase.kt"
click node_employee_dao "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/data/local/EmployeeDao.kt"
click node_payroll_dao "https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/data/local/PayrollDao.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_worker,node_worker_edit,node_monthly_payroll,node_advances,node_employee_actor toneBlue
class node_worker_history,node_payslips,node_slip_detail,node_cost_allocation,node_payroll_summary,node_payroll_chart,node_csv_export toneAmber
class node_home,node_login,node_app_entry,node_app_root toneMint
class node_viewmodel,node_payroll_models toneRose
class node_employee_repository,node_payroll_repository,node_room_database,node_employee_dao,node_payroll_dao toneIndigo
```

## Components

### Payroll operations

- [Worker directory](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/EmployeesScreen.kt): `app/src/main/java/com/example/payrollsheet/ui/screens/EmployeesScreen.kt`
- [Worker editing](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/AddEmployeeScreen.kt): `app/src/main/java/com/example/payrollsheet/ui/screens/AddEmployeeScreen.kt`
- [Monthly payroll](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/PayrollScreen.kt): `app/src/main/java/com/example/payrollsheet/ui/screens/PayrollScreen.kt`
- [Advance management](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/AdvancesScreen.kt): `app/src/main/java/com/example/payrollsheet/ui/screens/AdvancesScreen.kt`

### Payroll insights

- [Worker history](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/HistoryScreen.kt): `app/src/main/java/com/example/payrollsheet/ui/screens/HistoryScreen.kt`
- [Salary payslips](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/SalarySlipsScreen.kt): `app/src/main/java/com/example/payrollsheet/ui/screens/SalarySlipsScreen.kt`
- [Payslip details](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/components/SalarySlipDetailDialog.kt): `app/src/main/java/com/example/payrollsheet/ui/components/SalarySlipDetailDialog.kt`
- [Cost allocation](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/CostAllocationScreen.kt): `app/src/main/java/com/example/payrollsheet/ui/screens/CostAllocationScreen.kt`
- [Payroll summary](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/PayrollSummaryScreen.kt): `app/src/main/java/com/example/payrollsheet/ui/screens/PayrollSummaryScreen.kt`
- [Disbursement chart](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/components/PayrollDisbursementLineChart.kt): `app/src/main/java/com/example/payrollsheet/ui/components/PayrollDisbursementLineChart.kt`
- [CSV export](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/util/CsvExporter.kt): `app/src/main/java/com/example/payrollsheet/util/CsvExporter.kt`

### App presentation

- [Home dashboard](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/HomeScreen.kt): `app/src/main/java/com/example/payrollsheet/ui/screens/HomeScreen.kt`
- [Login screen](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/screens/LoginScreen.kt): `app/src/main/java/com/example/payrollsheet/ui/screens/LoginScreen.kt`
- [Activity entry](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/MainActivity.kt): `app/src/main/java/com/example/payrollsheet/MainActivity.kt`
- [Compose app root](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/PayrollApp.kt): `app/src/main/java/com/example/payrollsheet/PayrollApp.kt`

### Domain and state

- [Payroll state](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/ui/viewmodel/PayrollViewModel.kt): `app/src/main/java/com/example/payrollsheet/ui/viewmodel/PayrollViewModel.kt`
- [Payroll models](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/data/model/Models.kt): `app/src/main/java/com/example/payrollsheet/data/model/Models.kt`

### Local persistence

- [Employee repository](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/data/repository/EmployeeRepository.kt): `app/src/main/java/com/example/payrollsheet/data/repository/EmployeeRepository.kt`
- [Payroll repository](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/data/repository/PayrollRepository.kt): `app/src/main/java/com/example/payrollsheet/data/repository/PayrollRepository.kt`
- [Room database](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/data/local/AppDatabase.kt): `app/src/main/java/com/example/payrollsheet/data/local/AppDatabase.kt`
- [Employee DAO](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/data/local/EmployeeDao.kt): `app/src/main/java/com/example/payrollsheet/data/local/EmployeeDao.kt`
- [Payroll DAOs](https://github.com/iqbalussain/payroll-mobile-app/blob/main/app/src/main/java/com/example/payrollsheet/data/local/PayrollDao.kt): `app/src/main/java/com/example/payrollsheet/data/local/PayrollDao.kt`

### Other components

- **Payroll user**

## Connections

- Payroll user → Worker directory: manages staff (evidence: `README.md`)
- Payroll user → Monthly payroll: enters payroll (evidence: `README.md`)
- Payroll user → Advance management: records advances (evidence: `README.md`)
- Payroll user → Worker history: reviews history (evidence: `README.md`)
- Payroll user → Salary payslips: reviews slips (evidence: `README.md`)
- Payroll user → Cost allocation: reviews costs (evidence: `README.md`)
- Payroll user → CSV export: exports reports (evidence: `README.md`)
- Worker directory → Worker editing: opens editing (evidence: `README.md`)
- Salary payslips → Payslip details: opens details (evidence: `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
