# raghul-ramar-08/salary-management-system architecture

> Architecture diagram of the GitHub repository raghul-ramar-08/salary-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/raghul-ramar-08/salary-management-system
- Repository: https://github.com/raghul-ramar-08/salary-management-system

## Overview

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: [`frontend/src/app/app.routes.ts`](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/app.routes.ts) (App routes), [`frontend/src/app/features/salary-records/salary-api.service.ts`](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/features/salary-records/salary-api.service.ts) (Salary API client), [`backend/src/main/java/com/acme/salary/service/SalaryRecordService.java`](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/service/SalaryRecordService.java) (Salary period workflows), [`backend/src/main/java/com/acme/salary/repository/SalaryRecordRepository.java`](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/repository/SalaryRecordRepository.java) (Salary repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Angular application"]
  node_routes["App routes<br/>[app.routes.ts]"]
  node_directory["Employee directory"]
  node_profile["Employee profile"]
  node_employee_api["Employee API client"]
  node_employee_model["Employee models<br/>[employee.ts]"]
  node_salary_ui["Salary history search"]
  node_salary_api["Salary API client"]
  node_salary_model["Salary record models<br/>[salary-record.ts]"]
  node_dashboard["Compensation dashboard"]
  node_report_api["Report API client"]
  node_report_model["Report models<br/>[reports.ts]"]
end

subgraph group_api["Spring API"]
  node_employee_controller["Employee endpoints"]
  node_salary_controller["Salary endpoints"]
  node_salary_search_controller["Salary search endpoint"]
  node_report_controller["Report endpoints"]
end

subgraph group_domain["Compensation domain"]
  node_employee_service["Employee workflows"]
  node_salary_service["Salary period workflows"]
  node_report_service["Compensation analytics"]
  node_catalog["Currency and country rules"]
end

subgraph group_persistence["Persistence"]
  node_employee_entity["Employee entity<br/>[Employee.java]"]
  node_salary_entity["Salary period entity<br/>[SalaryRecord.java]"]
  node_employee_repo["Employee repository"]
  node_salary_repo["Salary repository"]
end

node_hr(("HR user"))
node_database[("Relational database")]

node_hr -->|"uses"| node_routes
node_routes -->|"routes to"| node_directory
node_routes -->|"routes to"| node_profile
node_routes -->|"routes to"| node_salary_ui
node_routes -->|"routes to"| node_dashboard
node_directory -.->|"queries"| node_employee_api
node_profile -->|"loads profile"| node_employee_api
node_profile -->|"records changes"| node_salary_api
node_employee_api -->|"uses types"| node_employee_model
node_salary_ui -->|"searches"| node_salary_api
node_salary_api -->|"uses types"| node_salary_model
node_dashboard -->|"loads reports"| node_report_api
node_dashboard -->|"uses types"| node_report_model
node_employee_api -->|"HTTP requests"| node_employee_controller
node_salary_api -->|"creates records"| node_salary_controller
node_salary_api -->|"searches records"| node_salary_search_controller
node_report_api -->|"HTTP requests"| node_report_controller
node_employee_controller -->|"delegates"| node_employee_service
node_salary_controller -->|"delegates"| node_salary_service
node_salary_search_controller -->|"delegates"| node_salary_service
node_report_controller -->|"delegates"| node_report_service
node_employee_service -->|"searches and saves"| node_employee_repo
node_employee_service -->|"loads salary history"| node_salary_repo
node_salary_service -->|"finds employee"| node_employee_repo
node_salary_service -->|"searches and saves"| node_salary_repo
node_report_service -->|"reads active periods"| node_salary_repo
node_employee_service -.->|"validates rules"| node_catalog
node_salary_service -->|"validates rules"| node_catalog
node_report_service -->|"converts currency"| node_catalog
node_employee_repo -->|"queries"| node_employee_entity
node_salary_repo -->|"queries"| node_salary_entity
node_salary_entity -->|"references employee"| node_employee_entity
node_employee_repo -.->|"persists data"| node_database
node_salary_repo -.->|"persists data"| node_database

click node_routes "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/app.routes.ts"
click node_directory "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/employee-directory.component.ts"
click node_profile "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/employee-profile.component.ts"
click node_employee_api "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/services/employee-api.service.ts"
click node_employee_model "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/models/employee.ts"
click node_salary_ui "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/features/salary-records/salary-records.component.ts"
click node_salary_api "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/features/salary-records/salary-api.service.ts"
click node_salary_model "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/features/salary-records/salary-record.ts"
click node_dashboard "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/features/dashboard/compensation-dashboard.component.ts"
click node_report_api "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/services/report-api.service.ts"
click node_report_model "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/models/reports.ts"
click node_employee_controller "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/controller/EmployeeController.java"
click node_salary_controller "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/controller/SalaryRecordController.java"
click node_salary_search_controller "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/controller/SalaryRecordSearchController.java"
click node_report_controller "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/controller/CompensationReportController.java"
click node_employee_service "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/service/EmployeeService.java"
click node_salary_service "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/service/SalaryRecordService.java"
click node_report_service "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/service/CompensationReportService.java"
click node_catalog "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/validation/SupportedCompensationCatalog.java"
click node_employee_entity "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/entity/Employee.java"
click node_salary_entity "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/entity/SalaryRecord.java"
click node_employee_repo "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/repository/EmployeeRepository.java"
click node_salary_repo "https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/repository/SalaryRecordRepository.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_routes,node_directory,node_profile,node_employee_api,node_employee_model,node_salary_ui,node_salary_api,node_salary_model,node_dashboard,node_report_api,node_report_model,node_hr toneBlue
class node_employee_controller,node_salary_controller,node_salary_search_controller,node_report_controller,node_database toneAmber
class node_employee_service,node_salary_service,node_report_service,node_catalog toneMint
class node_employee_entity,node_salary_entity,node_employee_repo,node_salary_repo toneRose
```

## Components

### Angular application

- [App routes](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`
- [Employee directory](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/employee-directory.component.ts): `frontend/src/app/employee-directory.component.ts`
- [Employee profile](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/employee-profile.component.ts): `frontend/src/app/employee-profile.component.ts`
- [Employee API client](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/services/employee-api.service.ts): `frontend/src/app/services/employee-api.service.ts`
- [Employee models](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/models/employee.ts): `frontend/src/app/models/employee.ts`
- [Salary history search](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/features/salary-records/salary-records.component.ts): `frontend/src/app/features/salary-records/salary-records.component.ts`
- [Salary API client](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/features/salary-records/salary-api.service.ts): `frontend/src/app/features/salary-records/salary-api.service.ts`
- [Salary record models](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/features/salary-records/salary-record.ts): `frontend/src/app/features/salary-records/salary-record.ts`
- [Compensation dashboard](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/features/dashboard/compensation-dashboard.component.ts): `frontend/src/app/features/dashboard/compensation-dashboard.component.ts`
- [Report API client](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/services/report-api.service.ts): `frontend/src/app/services/report-api.service.ts`
- [Report models](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/frontend/src/app/models/reports.ts): `frontend/src/app/models/reports.ts`

### Spring API

- [Employee endpoints](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/controller/EmployeeController.java): `backend/src/main/java/com/acme/salary/controller/EmployeeController.java`
- [Salary endpoints](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/controller/SalaryRecordController.java): `backend/src/main/java/com/acme/salary/controller/SalaryRecordController.java`
- [Salary search endpoint](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/controller/SalaryRecordSearchController.java): `backend/src/main/java/com/acme/salary/controller/SalaryRecordSearchController.java`
- [Report endpoints](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/controller/CompensationReportController.java): `backend/src/main/java/com/acme/salary/controller/CompensationReportController.java`

### Compensation domain

- [Employee workflows](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/service/EmployeeService.java): `backend/src/main/java/com/acme/salary/service/EmployeeService.java`
- [Salary period workflows](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/service/SalaryRecordService.java): `backend/src/main/java/com/acme/salary/service/SalaryRecordService.java`
- [Compensation analytics](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/service/CompensationReportService.java): `backend/src/main/java/com/acme/salary/service/CompensationReportService.java`
- [Currency and country rules](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/validation/SupportedCompensationCatalog.java): `backend/src/main/java/com/acme/salary/validation/SupportedCompensationCatalog.java`

### Persistence

- [Employee entity](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/entity/Employee.java): `backend/src/main/java/com/acme/salary/entity/Employee.java`
- [Salary period entity](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/entity/SalaryRecord.java): `backend/src/main/java/com/acme/salary/entity/SalaryRecord.java`
- [Employee repository](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/repository/EmployeeRepository.java): `backend/src/main/java/com/acme/salary/repository/EmployeeRepository.java`
- [Salary repository](https://github.com/raghul-ramar-08/salary-management-system/blob/develop/backend/src/main/java/com/acme/salary/repository/SalaryRecordRepository.java): `backend/src/main/java/com/acme/salary/repository/SalaryRecordRepository.java`

### Other components

- **HR user**
- **Relational database**

## Connections

- HR user → App routes: uses
- App routes → Employee directory: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routes → Employee profile: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routes → Salary history search: routes to (evidence: `frontend/src/app/app.routes.ts`)
- App routes → Compensation dashboard: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Employee directory → Employee API client: queries (evidence: `frontend/src/app/employee-directory.component.ts`)
- Employee profile → Employee API client: loads profile (evidence: `frontend/src/app/employee-profile.component.ts`)
- Employee profile → Salary API client: records changes (evidence: `frontend/src/app/employee-profile.component.ts`)
- Employee API client → Employee models: uses types (evidence: `frontend/src/app/services/employee-api.service.ts`)
- Salary history search → Salary API client: searches (evidence: `frontend/src/app/features/salary-records/salary-records.component.ts`)
- Salary API client → Salary record models: uses types (evidence: `frontend/src/app/features/salary-records/salary-api.service.ts`)
- Compensation dashboard → Report API client: loads reports (evidence: `frontend/src/app/features/dashboard/compensation-dashboard.component.ts`)
- Compensation dashboard → Report models: uses types (evidence: `frontend/src/app/features/dashboard/compensation-dashboard.component.ts`)
- Employee API client → Employee endpoints: HTTP requests
- Salary API client → Salary endpoints: creates records (evidence: `frontend/src/app/features/salary-records/salary-api.service.ts`)
- Salary API client → Salary search endpoint: searches records (evidence: `frontend/src/app/features/salary-records/salary-api.service.ts`)
- Report API client → Report endpoints: HTTP requests
- Employee endpoints → Employee workflows: delegates (evidence: `backend/src/main/java/com/acme/salary/controller/EmployeeController.java`)
- Salary endpoints → Salary period workflows: delegates (evidence: `backend/src/main/java/com/acme/salary/controller/SalaryRecordController.java`)
- Salary search endpoint → Salary period workflows: delegates (evidence: `backend/src/main/java/com/acme/salary/controller/SalaryRecordSearchController.java`)
- Report endpoints → Compensation analytics: delegates (evidence: `backend/src/main/java/com/acme/salary/controller/CompensationReportController.java`)
- Employee workflows → Employee repository: searches and saves (evidence: `backend/src/main/java/com/acme/salary/service/EmployeeService.java`)
- Employee workflows → Salary repository: loads salary history (evidence: `backend/src/main/java/com/acme/salary/service/EmployeeService.java`)
- Salary period workflows → Employee repository: finds employee (evidence: `backend/src/main/java/com/acme/salary/service/SalaryRecordService.java`)
- Salary period workflows → Salary repository: searches and saves (evidence: `backend/src/main/java/com/acme/salary/service/SalaryRecordService.java`)
- Compensation analytics → Salary repository: reads active periods (evidence: `backend/src/main/java/com/acme/salary/service/CompensationReportService.java`)
- Employee workflows → Currency and country rules: validates rules (evidence: `backend/src/main/java/com/acme/salary/service/EmployeeService.java`)
- Salary period workflows → Currency and country rules: validates rules (evidence: `backend/src/main/java/com/acme/salary/service/SalaryRecordService.java`)
- Compensation analytics → Currency and country rules: converts currency (evidence: `backend/src/main/java/com/acme/salary/service/CompensationReportService.java`)
- Employee repository → Employee entity: queries (evidence: `backend/src/main/java/com/acme/salary/repository/EmployeeRepository.java`)
- Salary repository → Salary period entity: queries (evidence: `backend/src/main/java/com/acme/salary/repository/SalaryRecordRepository.java`)
- Salary period entity → Employee entity: references employee (evidence: `backend/src/main/java/com/acme/salary/entity/SalaryRecord.java`)
- Employee repository → Relational database: persists data
- Salary repository → Relational database: persists data
