# cerebrus-sys/employee-payroll-system architecture

> Architecture diagram of the GitHub repository cerebrus-sys/employee-payroll-system, 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/cerebrus-sys/employee-payroll-system
- Repository: https://github.com/cerebrus-sys/employee-payroll-system

## Overview

Employee Payroll System is a desktop Java Swing application. The principal workflow starts at login, verifies credentials against the shared database manager, and opens a payroll table; the main window dispatches employee, department, and account-management dialogs. Employee rows display net salary obtained from department data. The source excerpts show these operations and SQLite-backed storage, while the README only identifies the product and screenshots. Change-password behavior is represented from the menu wiring, but its implementation was not sampled.

Main entry points: [`sources/org/payroll/MainFrame.java`](https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/MainFrame.java) (Payroll dashboard), [`sources/org/payroll/DatabaseManager.java`](https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/DatabaseManager.java) (Payroll data access), [`sources/org/payroll/LoginFrame.java`](https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/LoginFrame.java) (Login window), [`sources/org/payroll/Main.java`](https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/Main.java) (Application startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_main["Application startup<br/>[Main.java]"]
  node_login["Login window<br/>[LoginFrame.java]"]
  node_dashboard["Payroll dashboard<br/>[MainFrame.java]"]
  node_database_manager["Payroll data access"]
end

subgraph group_workforce["Employee Management"]
  node_employee_new["Add employee"]
  node_employee_update["Update employee"]
  node_employee_delete["Delete employee"]
end

subgraph group_departments["Departments and Pay"]
  node_department_new["Add department"]
  node_department_update["Modify department"]
  node_department_delete["Delete department"]
end

subgraph group_accounts["Login Preferences"]
  node_login_new["Create login"]
  node_login_delete["Delete login"]
  node_password_change["Change password"]
end

node_user(("Payroll user"))
node_sqlite[("SQLite database")]

node_user -->|"starts app"| node_main
node_main -->|"initializes"| node_database_manager
node_main -->|"opens"| node_login
node_user -->|"enters credentials"| node_login
node_login -->|"verifies credentials"| node_database_manager
node_login -->|"opens on success"| node_dashboard
node_dashboard -->|"loads employee rows"| node_database_manager
node_dashboard -->|"opens"| node_employee_new
node_dashboard -->|"opens"| node_employee_update
node_dashboard -->|"opens"| node_employee_delete
node_dashboard -->|"opens"| node_department_new
node_dashboard -->|"opens"| node_department_update
node_dashboard -->|"opens"| node_department_delete
node_dashboard -->|"opens"| node_login_new
node_dashboard -->|"opens"| node_password_change
node_dashboard -->|"opens"| node_login_delete
node_employee_new -->|"creates employee"| node_database_manager
node_employee_update -->|"updates employee"| node_database_manager
node_employee_delete -->|"deletes employee"| node_database_manager
node_department_new -->|"creates department"| node_database_manager
node_department_update -->|"updates department"| node_database_manager
node_department_delete -->|"deletes department"| node_database_manager
node_login_new -->|"creates login"| node_database_manager
node_login_delete -->|"verifies and deletes"| node_database_manager
node_database_manager -->|"queries and updates"| node_sqlite

click node_main "https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/Main.java"
click node_login "https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/LoginFrame.java"
click node_dashboard "https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/MainFrame.java"
click node_employee_new "https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/employees/NewEmployeeFrame.java"
click node_employee_update "https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/employees/UpdateEmployeeFrame.java"
click node_employee_delete "https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/employees/DeleteEmployeeFrame.java"
click node_department_new "https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/departments/NewDepartmentFrame.java"
click node_department_update "https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/departments/ModifyDepartmentFrame.java"
click node_department_delete "https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/departments/DeleteDepartmentFrame.java"
click node_login_new "https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/preferences/NewLoginIdFrame.java"
click node_login_delete "https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/preferences/DeleteLoginIdFrame.java"
click node_password_change "https://github.com/cerebrus-sys/employee-payroll-system/tree/master/sources/org/payroll/preferences"
click node_database_manager "https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/DatabaseManager.java"

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_main,node_login,node_dashboard,node_database_manager,node_user toneBlue
class node_employee_new,node_employee_update,node_employee_delete,node_sqlite toneAmber
class node_department_new,node_department_update,node_department_delete toneMint
class node_login_new,node_login_delete,node_password_change toneRose
```

## Components

### Application

- [Application startup](https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/Main.java): `sources/org/payroll/Main.java`
- [Login window](https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/LoginFrame.java): `sources/org/payroll/LoginFrame.java`
- [Payroll dashboard](https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/MainFrame.java): `sources/org/payroll/MainFrame.java`
- [Payroll data access](https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/DatabaseManager.java): `sources/org/payroll/DatabaseManager.java`

### Employee Management

- [Add employee](https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/employees/NewEmployeeFrame.java): `sources/org/payroll/employees/NewEmployeeFrame.java`
- [Update employee](https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/employees/UpdateEmployeeFrame.java): `sources/org/payroll/employees/UpdateEmployeeFrame.java`
- [Delete employee](https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/employees/DeleteEmployeeFrame.java): `sources/org/payroll/employees/DeleteEmployeeFrame.java`

### Departments and Pay

- [Add department](https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/departments/NewDepartmentFrame.java): `sources/org/payroll/departments/NewDepartmentFrame.java`
- [Modify department](https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/departments/ModifyDepartmentFrame.java): `sources/org/payroll/departments/ModifyDepartmentFrame.java`
- [Delete department](https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/departments/DeleteDepartmentFrame.java): `sources/org/payroll/departments/DeleteDepartmentFrame.java`

### Login Preferences

- [Create login](https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/preferences/NewLoginIdFrame.java): `sources/org/payroll/preferences/NewLoginIdFrame.java`
- [Delete login](https://github.com/cerebrus-sys/employee-payroll-system/blob/master/sources/org/payroll/preferences/DeleteLoginIdFrame.java): `sources/org/payroll/preferences/DeleteLoginIdFrame.java`
- [Change password](https://github.com/cerebrus-sys/employee-payroll-system/tree/master/sources/org/payroll/preferences): `sources/org/payroll/preferences`

### Other components

- **Payroll user**
- **SQLite database**

## Connections

- Payroll user → Application startup: starts app (evidence: `sources/org/payroll/Main.java`)
- Application startup → Payroll data access: initializes (evidence: `sources/org/payroll/Main.java`)
- Application startup → Login window: opens (evidence: `sources/org/payroll/Main.java`)
- Payroll user → Login window: enters credentials (evidence: `sources/org/payroll/LoginFrame.java`)
- Login window → Payroll data access: verifies credentials (evidence: `sources/org/payroll/LoginFrame.java`)
- Login window → Payroll dashboard: opens on success (evidence: `sources/org/payroll/LoginFrame.java`)
- Payroll dashboard → Payroll data access: loads employee rows (evidence: `sources/org/payroll/MainFrame.java`)
- Payroll dashboard → Add employee: opens (evidence: `sources/org/payroll/MainFrame.java`)
- Payroll dashboard → Update employee: opens (evidence: `sources/org/payroll/MainFrame.java`)
- Payroll dashboard → Delete employee: opens (evidence: `sources/org/payroll/MainFrame.java`)
- Payroll dashboard → Add department: opens (evidence: `sources/org/payroll/MainFrame.java`)
- Payroll dashboard → Modify department: opens (evidence: `sources/org/payroll/MainFrame.java`)
- Payroll dashboard → Delete department: opens (evidence: `sources/org/payroll/MainFrame.java`)
- Payroll dashboard → Create login: opens (evidence: `sources/org/payroll/MainFrame.java`)
- Payroll dashboard → Change password: opens (evidence: `sources/org/payroll/MainFrame.java`)
- Payroll dashboard → Delete login: opens (evidence: `sources/org/payroll/MainFrame.java`)
- Add employee → Payroll data access: creates employee (evidence: `sources/org/payroll/employees/NewEmployeeFrame.java`)
- Update employee → Payroll data access: updates employee (evidence: `sources/org/payroll/employees/UpdateEmployeeFrame.java`)
- Delete employee → Payroll data access: deletes employee (evidence: `sources/org/payroll/employees/DeleteEmployeeFrame.java`)
- Add department → Payroll data access: creates department (evidence: `sources/org/payroll/departments/NewDepartmentFrame.java`)
- Modify department → Payroll data access: updates department (evidence: `sources/org/payroll/departments/ModifyDepartmentFrame.java`)
- Delete department → Payroll data access: deletes department (evidence: `sources/org/payroll/departments/DeleteDepartmentFrame.java`)
- Create login → Payroll data access: creates login (evidence: `sources/org/payroll/preferences/NewLoginIdFrame.java`)
- Delete login → Payroll data access: verifies and deletes (evidence: `sources/org/payroll/preferences/DeleteLoginIdFrame.java`)
- Payroll data access → SQLite database: queries and updates (evidence: `sources/org/payroll/DatabaseManager.java`)
