How sampathvulli7/paypulsepayrollsystem works
PayPulse is a Java payroll-management CLI. Users enter through the role-selection portal: managers authenticate to administer staff, configure perks and attendance, run payroll, and import or export records; employees can access only their own payslip, benefits, and attendance. Payroll uses polymorphic employee models, then produces payslips and file-based exports. The README documents the wider feature set; some connections to unsampled modules are therefore documented rather than source-verified.
Main entry points: PayrollRouter.java Role portals · FileStorageService.java File import/export · Employee.java Employee models · PaySlip.java Payslip model
Components 20
Application and portals
- Application entry
src/edu/gitam/oop/payroll/MainApp.java - Role portals
src/edu/gitam/oop/payroll/ui/PayrollRouter.java - Input handling
src/edu/gitam/oop/payroll/ui/InputHelper.java - Terminal theme
src/edu/gitam/oop/payroll/ui/PayrollTheme.java
Payroll domain
- Employee models
src/edu/gitam/oop/payroll/model/Employee.java - Role pay models
src/edu/gitam/oop/payroll/model - Payslip model
src/edu/gitam/oop/payroll/model/PaySlip.java - Payroll contracts
src/edu/gitam/oop/payroll/contract - Payroll exceptions
src/edu/gitam/oop/payroll/exception - Payroll constants
src/edu/gitam/oop/payroll/util/PayrollConstants.java - Perk bitmasks
src/edu/gitam/oop/payroll/util/PerkBitmaskUtil.java
Payroll operations
- Attendance tracking
src/edu/gitam/oop/payroll/service/AttendanceTracker.java - Payroll calculations
src/edu/gitam/oop/payroll/service/PayrollCalculator.java - Batch workers
src/edu/gitam/oop/payroll/service/PayrollBatchWorker.java
Payroll records
- Payslip formatting
src/edu/gitam/oop/payroll/service/PayslipFormatter.java - File import/export
src/edu/gitam/oop/payroll/service/FileStorageService.java - CSV export
data/payroll_export.csv - Payslip archive
data/payslips_archive.txt - HTML audit ledger
data/payroll_dashboard.html
Other components
- CLI user
Connections 25
- CLI user → Application entry: starts
README.md - Application entry → Role portals: launches
src/edu/gitam/oop/payroll/MainApp.java - Role portals → Input handling: reads input
src/edu/gitam/oop/payroll/ui/PayrollRouter.java - Role portals → Terminal theme: prints portal
src/edu/gitam/oop/payroll/MainApp.java - Role portals → Employee models: authenticates staff
src/edu/gitam/oop/payroll/ui/PayrollRouter.java - Role pay models → Employee models: extends
src/edu/gitam/oop/payroll/model/Manager.java - Employee models → Payroll contracts: implements
src/edu/gitam/oop/payroll/model/Employee.java - Employee models → Perk bitmasks: calculates perks
src/edu/gitam/oop/payroll/model/Employee.java - Perk bitmasks → Payroll constants: uses masks
src/edu/gitam/oop/payroll/util/PerkBitmaskUtil.java - Role portals → Perk bitmasks: configures perks
src/edu/gitam/oop/payroll/ui/PayrollRouter.java - Role portals → Attendance tracking: logs overtime
src/edu/gitam/oop/payroll/ui/PayrollRouter.java - Attendance tracking → Employee models: updates attendance
src/edu/gitam/oop/payroll/service/AttendanceTracker.java - Role portals → Payroll calculations: awards bonuses
README.md - Role portals → Batch workers: starts workers
src/edu/gitam/oop/payroll/ui/PayrollRouter.java - Batch workers → Payslip model: creates slips
src/edu/gitam/oop/payroll/service/PayrollBatchWorker.java - Payslip model → Employee models: calculates breakdown
src/edu/gitam/oop/payroll/model/PaySlip.java - Role portals → File import/export: imports roster
src/edu/gitam/oop/payroll/ui/PayrollRouter.java - Role portals → File import/export: exports payroll
README.md - File import/export → Employee models: reconstructs roster
src/edu/gitam/oop/payroll/service/FileStorageService.java - File import/export → Payslip model: generates missing slips
src/edu/gitam/oop/payroll/service/FileStorageService.java - File import/export → Payslip formatting: formats archive
src/edu/gitam/oop/payroll/service/FileStorageService.java - Payslip formatting → Payslip model: renders slip
src/edu/gitam/oop/payroll/service/PayslipFormatter.java - File import/export → CSV export: writes CSV
src/edu/gitam/oop/payroll/service/FileStorageService.java - File import/export → Payslip archive: writes archive
src/edu/gitam/oop/payroll/service/FileStorageService.java - File import/export → HTML audit ledger: syncs ledger
src/edu/gitam/oop/payroll/service/FileStorageService.java