# kushalramcyber/payrolltracker architecture

> Architecture diagram of the GitHub repository kushalramcyber/payrolltracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kushalramcyber/payrolltracker
- Repository: https://github.com/kushalramcyber/payrolltracker

## Overview

PayrollTracker is an admin-facing attendance and payroll web application. Administrators log in, manage employee records, submit monthly present and half-day counts, and receive an itemized salary result. The sampled servlet code confirms session checks, employee persistence, batch attendance logging, salary calculation, and JSP forwarding. The README describes the broader capabilities; JSP form wiring and deployment mappings were not sampled, so those connections are left unasserted or marked unverified.

Main entry points: [`src/java/com/payroll/controller/EmployeeServlet.java`](https://github.com/kushalramcyber/payrolltracker/blob/main/src/java/com/payroll/controller/EmployeeServlet.java) (Employee servlet), [`src/java/com/payroll/controller/PayrollServlet.java`](https://github.com/kushalramcyber/payrolltracker/blob/main/src/java/com/payroll/controller/PayrollServlet.java) (Payroll servlet), [`src/java/com/payroll/util/DBConnection.java`](https://github.com/kushalramcyber/payrolltracker/blob/main/src/java/com/payroll/util/DBConnection.java) (JDBC connection), [`web/login.jsp`](https://github.com/kushalramcyber/payrolltracker/blob/main/web/login.jsp) (Login page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_login_page["Login page<br/>[login.jsp]"]
  node_employee_page["Employee list<br/>[employeeList.jsp]"]
  node_salary_page["Salary result<br/>[salaryResult.jsp]"]
end

subgraph group_access["Access control"]
  node_login["Login servlet<br/>[LoginServlet.java]"]
  node_logout["Logout servlet<br/>[LogoutServlet.java]"]
end

subgraph group_operations["Payroll operations"]
  node_employees["Employee servlet"]
  node_payroll["Payroll servlet"]
end

subgraph group_persistence["Persistence"]
  node_employee_dao["Employee records<br/>[EmployeeDAO.java]"]
  node_attendance_dao["Attendance logger<br/>[AttendanceDAO.java]"]
  node_connection["JDBC connection<br/>[DBConnection.java]"]
end

node_admin(("Administrator"))
node_mysql[("MySQL database")]

node_admin -->|"opens portal"| node_login_page
node_admin -.->|"manages staff"| node_employee_page
node_admin -.->|"submits payroll"| node_payroll
node_login -->|"redirects on success"| node_employees
node_login -->|"forwards on failure"| node_login_page
node_logout -->|"redirects after logout"| node_login_page
node_employees -->|"reads and changes"| node_employee_dao
node_employees -->|"forwards employee list"| node_employee_page
node_payroll -->|"logs attendance"| node_attendance_dao
node_payroll -->|"forwards salary result"| node_salary_page
node_employee_dao -->|"opens JDBC connection"| node_connection
node_attendance_dao -->|"opens JDBC connection"| node_connection
node_connection -->|"connects to"| node_mysql

click node_login_page "https://github.com/kushalramcyber/payrolltracker/blob/main/web/login.jsp"
click node_employee_page "https://github.com/kushalramcyber/payrolltracker/blob/main/web/employeeList.jsp"
click node_salary_page "https://github.com/kushalramcyber/payrolltracker/blob/main/web/salaryResult.jsp"
click node_login "https://github.com/kushalramcyber/payrolltracker/blob/main/src/java/com/payroll/controller/LoginServlet.java"
click node_logout "https://github.com/kushalramcyber/payrolltracker/blob/main/src/java/com/payroll/controller/LogoutServlet.java"
click node_employees "https://github.com/kushalramcyber/payrolltracker/blob/main/src/java/com/payroll/controller/EmployeeServlet.java"
click node_payroll "https://github.com/kushalramcyber/payrolltracker/blob/main/src/java/com/payroll/controller/PayrollServlet.java"
click node_employee_dao "https://github.com/kushalramcyber/payrolltracker/blob/main/src/java/com/payroll/dao/EmployeeDAO.java"
click node_attendance_dao "https://github.com/kushalramcyber/payrolltracker/blob/main/src/java/com/payroll/dao/AttendanceDAO.java"
click node_connection "https://github.com/kushalramcyber/payrolltracker/blob/main/src/java/com/payroll/util/DBConnection.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_login_page,node_employee_page,node_salary_page toneBlue
class node_login,node_logout,node_mysql toneAmber
class node_employees,node_payroll toneMint
class node_employee_dao,node_attendance_dao,node_connection toneRose
class node_admin toneIndigo
```

## Components

### Web interface

- [Login page](https://github.com/kushalramcyber/payrolltracker/blob/main/web/login.jsp): `web/login.jsp`
- [Employee list](https://github.com/kushalramcyber/payrolltracker/blob/main/web/employeeList.jsp): `web/employeeList.jsp`
- [Salary result](https://github.com/kushalramcyber/payrolltracker/blob/main/web/salaryResult.jsp): `web/salaryResult.jsp`

### Access control

- [Login servlet](https://github.com/kushalramcyber/payrolltracker/blob/main/src/java/com/payroll/controller/LoginServlet.java): `src/java/com/payroll/controller/LoginServlet.java`
- [Logout servlet](https://github.com/kushalramcyber/payrolltracker/blob/main/src/java/com/payroll/controller/LogoutServlet.java): `src/java/com/payroll/controller/LogoutServlet.java`

### Payroll operations

- [Employee servlet](https://github.com/kushalramcyber/payrolltracker/blob/main/src/java/com/payroll/controller/EmployeeServlet.java): `src/java/com/payroll/controller/EmployeeServlet.java`
- [Payroll servlet](https://github.com/kushalramcyber/payrolltracker/blob/main/src/java/com/payroll/controller/PayrollServlet.java): `src/java/com/payroll/controller/PayrollServlet.java`

### Persistence

- [Employee records](https://github.com/kushalramcyber/payrolltracker/blob/main/src/java/com/payroll/dao/EmployeeDAO.java): `src/java/com/payroll/dao/EmployeeDAO.java`
- [Attendance logger](https://github.com/kushalramcyber/payrolltracker/blob/main/src/java/com/payroll/dao/AttendanceDAO.java): `src/java/com/payroll/dao/AttendanceDAO.java`
- [JDBC connection](https://github.com/kushalramcyber/payrolltracker/blob/main/src/java/com/payroll/util/DBConnection.java): `src/java/com/payroll/util/DBConnection.java`

### Other components

- **Administrator**
- **MySQL database**

## Connections

- Administrator → Login page: opens portal (evidence: `README.md`)
- Administrator → Employee list: manages staff (evidence: `README.md`)
- Administrator → Payroll servlet: submits payroll (evidence: `README.md`)
- Login servlet → Employee servlet: redirects on success (evidence: `src/java/com/payroll/controller/LoginServlet.java`)
- Login servlet → Login page: forwards on failure (evidence: `src/java/com/payroll/controller/LoginServlet.java`)
- Logout servlet → Login page: redirects after logout (evidence: `src/java/com/payroll/controller/LogoutServlet.java`)
- Employee servlet → Employee records: reads and changes (evidence: `src/java/com/payroll/controller/EmployeeServlet.java`)
- Employee servlet → Employee list: forwards employee list (evidence: `src/java/com/payroll/controller/EmployeeServlet.java`)
- Payroll servlet → Attendance logger: logs attendance (evidence: `src/java/com/payroll/controller/PayrollServlet.java`)
- Payroll servlet → Salary result: forwards salary result (evidence: `src/java/com/payroll/controller/PayrollServlet.java`)
- Employee records → JDBC connection: opens JDBC connection (evidence: `src/java/com/payroll/dao/EmployeeDAO.java`)
- Attendance logger → JDBC connection: opens JDBC connection (evidence: `src/java/com/payroll/dao/AttendanceDAO.java`)
- JDBC connection → MySQL database: connects to (evidence: `src/java/com/payroll/util/DBConnection.java`)
