How raghul-ramar-08/salary-management-system works
ACME’s application manages employee profiles and versioned compensation, then provides salary-history search and normalized compensation analytics. The main user flow runs from the Angular directory, profile, salary-history, or dashboard screens through API services to Spring controllers and domain services, with repositories persisting employee and salary-period data. Reports cover country and department summaries, salary bands, and departmental pay extremes. The README documents database and deployment options; the sampled source does not show the full startup or infrastructure wiring.
Main entry points: app.routes.ts App routes · salary-api.service.ts Salary API client · SalaryRecordService.java Salary period workflows · SalaryRecordRepository.java Salary repository
Components 25
Angular application
- App routes
frontend/src/app/app.routes.ts - Employee directory
frontend/src/app/employee-directory.component.ts - Employee profile
frontend/src/app/employee-profile.component.ts - Employee API client
frontend/src/app/services/employee-api.service.ts - Employee models
frontend/src/app/models/employee.ts - Salary history search
frontend/src/app/features/salary-records/salary-records.component.ts - Salary API client
frontend/src/app/features/salary-records/salary-api.service.ts - Salary record models
frontend/src/app/features/salary-records/salary-record.ts - Compensation dashboard
frontend/src/app/features/dashboard/compensation-dashboard.component.ts - Report API client
frontend/src/app/services/report-api.service.ts - Report models
frontend/src/app/models/reports.ts
Spring API
- Employee endpoints
backend/src/main/java/com/acme/salary/controller/EmployeeController.java - Salary endpoints
backend/src/main/java/com/acme/salary/controller/SalaryRecordController.java - Salary search endpoint
backend/src/main/java/com/acme/salary/controller/SalaryRecordSearchController.java - Report endpoints
backend/src/main/java/com/acme/salary/controller/CompensationReportController.java
Compensation domain
- Employee workflows
backend/src/main/java/com/acme/salary/service/EmployeeService.java - Salary period workflows
backend/src/main/java/com/acme/salary/service/SalaryRecordService.java - Compensation analytics
backend/src/main/java/com/acme/salary/service/CompensationReportService.java - Currency and country rules
backend/src/main/java/com/acme/salary/validation/SupportedCompensationCatalog.java
Persistence
- Employee entity
backend/src/main/java/com/acme/salary/entity/Employee.java - Salary period entity
backend/src/main/java/com/acme/salary/entity/SalaryRecord.java - Employee repository
backend/src/main/java/com/acme/salary/repository/EmployeeRepository.java - Salary repository
backend/src/main/java/com/acme/salary/repository/SalaryRecordRepository.java
Other components
- HR user
- Relational database
Connections 34
- HR user → App routes: uses
- App routes → Employee directory: routes to
frontend/src/app/app.routes.ts - App routes → Employee profile: routes to
frontend/src/app/app.routes.ts - App routes → Salary history search: routes to
frontend/src/app/app.routes.ts - App routes → Compensation dashboard: routes to
frontend/src/app/app.routes.ts - Employee directory → Employee API client: queries
frontend/src/app/employee-directory.component.ts - Employee profile → Employee API client: loads profile
frontend/src/app/employee-profile.component.ts - Employee profile → Salary API client: records changes
frontend/src/app/employee-profile.component.ts - Employee API client → Employee models: uses types
frontend/src/app/services/employee-api.service.ts - Salary history search → Salary API client: searches
frontend/src/app/features/salary-records/salary-records.component.ts - Salary API client → Salary record models: uses types
frontend/src/app/features/salary-records/salary-api.service.ts - Compensation dashboard → Report API client: loads reports
frontend/src/app/features/dashboard/compensation-dashboard.component.ts - Compensation dashboard → Report models: uses types
frontend/src/app/features/dashboard/compensation-dashboard.component.ts - Employee API client → Employee endpoints: HTTP requests
- Salary API client → Salary endpoints: creates records
frontend/src/app/features/salary-records/salary-api.service.ts - Salary API client → Salary search endpoint: searches records
frontend/src/app/features/salary-records/salary-api.service.ts - Report API client → Report endpoints: HTTP requests
- Employee endpoints → Employee workflows: delegates
backend/src/main/java/com/acme/salary/controller/EmployeeController.java - Salary endpoints → Salary period workflows: delegates
backend/src/main/java/com/acme/salary/controller/SalaryRecordController.java - Salary search endpoint → Salary period workflows: delegates
backend/src/main/java/com/acme/salary/controller/SalaryRecordSearchController.java - Report endpoints → Compensation analytics: delegates
backend/src/main/java/com/acme/salary/controller/CompensationReportController.java - Employee workflows → Employee repository: searches and saves
backend/src/main/java/com/acme/salary/service/EmployeeService.java - Employee workflows → Salary repository: loads salary history
backend/src/main/java/com/acme/salary/service/EmployeeService.java - Salary period workflows → Employee repository: finds employee
backend/src/main/java/com/acme/salary/service/SalaryRecordService.java - Salary period workflows → Salary repository: searches and saves
backend/src/main/java/com/acme/salary/service/SalaryRecordService.java - Compensation analytics → Salary repository: reads active periods
backend/src/main/java/com/acme/salary/service/CompensationReportService.java - Employee workflows → Currency and country rules: validates rules
backend/src/main/java/com/acme/salary/service/EmployeeService.java - Salary period workflows → Currency and country rules: validates rules
backend/src/main/java/com/acme/salary/service/SalaryRecordService.java - Compensation analytics → Currency and country rules: converts currency
backend/src/main/java/com/acme/salary/service/CompensationReportService.java - Employee repository → Employee entity: queries
backend/src/main/java/com/acme/salary/repository/EmployeeRepository.java - Salary repository → Salary period entity: queries
backend/src/main/java/com/acme/salary/repository/SalaryRecordRepository.java - Salary period entity → Employee entity: references employee
backend/src/main/java/com/acme/salary/entity/SalaryRecord.java - Employee repository → Relational database: persists data
- Salary repository → Relational database: persists data