# krishnachakilela/acme-salary-management architecture

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

- Interactive diagram: https://gitdiagram.com/krishnachakilela/acme-salary-management
- Repository: https://github.com/krishnachakilela/acme-salary-management

## Overview

ACME Employee Salary Management is a local HR application for managing employee records and compensation, with analytics across currency, country, department, and salary bands. HR users sign in, search or update employees, and view compensation history; active employees can receive salary changes. The Angular UI calls a Spring API backed by PostgreSQL. The graph reflects documented architecture and indexed source references; analytics controller wiring and some frontend feature-to-API calls were not shown, so those links are marked unverified rather than asserted.

Main entry points: [`frontend/src/app/app.routes.ts`](https://github.com/krishnachakilela/acme-salary-management/blob/main/frontend/src/app/app.routes.ts) (Feature routes), [`backend/src/main/java/com/acme/salary/service/EmployeeService.java`](https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/service/EmployeeService.java) (Employee operations), [`backend/src/main/java/com/acme/salary/service/AuthService.java`](https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/service/AuthService.java) (Login service), [`frontend/src/core/api.service.ts`](https://github.com/krishnachakilela/acme-salary-management/blob/main/frontend/src/core/api.service.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Angular application"]
  node_app["Application shell<br/>[app.component.ts]"]
  node_routes["Feature routes<br/>[app.routes.ts]"]
  node_login["Login screen<br/>[login.component.ts]"]
  node_employee_ui["Employee screens"]
  node_analytics_ui["Analytics dashboard"]
  node_auth_ui["UI authentication<br/>[auth.service.ts]"]
  node_api_client["API client<br/>[api.service.ts]"]
  node_auth_filter["JWT interceptor"]
end

subgraph group_api["Spring API"]
  node_employee_controller["Employee endpoints"]
  node_auth_controller["Authentication endpoint"]
  node_analytics_controller["Analytics endpoints"]
  node_employee_service["Employee operations"]
  node_auth_service["Login service<br/>[AuthService.java]"]
  node_analytics_service["Compensation analytics"]
  node_errors["API error handling"]
end

subgraph group_domain["HR domain"]
  node_domain_models["Employee and salary model"]
end

subgraph group_infra["Persistence and security"]
  node_employee_repo["Employee repository"]
  node_salary_repo["Salary repository"]
  node_hr_repo["HR user repository"]
  node_jwt["JWT service<br/>[JwtService.java]"]
end

node_hr(("HR user"))
node_browser(("Browser"))
node_database[("PostgreSQL")]

node_hr -->|"uses"| node_browser
node_browser -->|"opens UI"| node_app
node_app -->|"hosts routes"| node_routes
node_routes -->|"routes to"| node_login
node_routes -->|"routes to"| node_employee_ui
node_routes -->|"routes to"| node_analytics_ui
node_login -->|"calls"| node_auth_ui
node_auth_filter -->|"reads token"| node_auth_ui
node_employee_ui -->|"calls"| node_api_client
node_analytics_ui -.->|"requests data"| node_api_client
node_api_client -->|"HTTP requests"| node_employee_controller
node_api_client -->|"HTTP requests"| node_analytics_controller
node_auth_ui -->|"submits login"| node_auth_controller
node_employee_controller -->|"dispatches"| node_employee_service
node_auth_controller -->|"dispatches"| node_auth_service
node_analytics_controller -.->|"dispatches"| node_analytics_service
node_employee_service -->|"queries and saves"| node_employee_repo
node_employee_service -->|"queries and saves"| node_salary_repo
node_employee_service -->|"uses"| node_domain_models
node_analytics_service -->|"queries"| node_employee_repo
node_analytics_service -->|"aggregates"| node_salary_repo
node_auth_service -->|"loads user"| node_hr_repo
node_auth_service -->|"creates token"| node_jwt
node_auth_service -->|"uses user model"| node_domain_models
node_employee_repo -->|"persists employees"| node_database
node_salary_repo -->|"reads salary data"| node_database
node_hr_repo -->|"loads credentials"| node_database

click node_app "https://github.com/krishnachakilela/acme-salary-management/blob/main/frontend/src/app/app.component.ts"
click node_routes "https://github.com/krishnachakilela/acme-salary-management/blob/main/frontend/src/app/app.routes.ts"
click node_login "https://github.com/krishnachakilela/acme-salary-management/blob/main/frontend/src/features/auth/login/login.component.ts"
click node_employee_ui "https://github.com/krishnachakilela/acme-salary-management/tree/main/frontend/src/features/employees"
click node_analytics_ui "https://github.com/krishnachakilela/acme-salary-management/blob/main/frontend/src/features/analytics/analytics.component.ts"
click node_auth_ui "https://github.com/krishnachakilela/acme-salary-management/blob/main/frontend/src/core/auth.service.ts"
click node_api_client "https://github.com/krishnachakilela/acme-salary-management/blob/main/frontend/src/core/api.service.ts"
click node_auth_filter "https://github.com/krishnachakilela/acme-salary-management/blob/main/frontend/src/core/auth.interceptor.ts"
click node_employee_controller "https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/presentation/controller/EmployeeController.java"
click node_auth_controller "https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/presentation/controller/AuthController.java"
click node_analytics_controller "https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/presentation/controller/AnalyticsController.java"
click node_employee_service "https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/service/EmployeeService.java"
click node_auth_service "https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/service/AuthService.java"
click node_analytics_service "https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/service/AnalyticsService.java"
click node_errors "https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/exception/GlobalExceptionHandler.java"
click node_domain_models "https://github.com/krishnachakilela/acme-salary-management/tree/main/backend/src/main/java/com/acme/salary/domain"
click node_employee_repo "https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/infrastructure/persistence/EmployeeRepository.java"
click node_salary_repo "https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/infrastructure/persistence/SalaryRecordRepository.java"
click node_hr_repo "https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/infrastructure/persistence/HrUserRepository.java"
click node_jwt "https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/infrastructure/security/JwtService.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_app,node_routes,node_login,node_employee_ui,node_analytics_ui,node_auth_ui,node_api_client,node_auth_filter,node_hr,node_browser toneBlue
class node_employee_controller,node_auth_controller,node_analytics_controller,node_employee_service,node_auth_service,node_analytics_service,node_errors,node_database toneAmber
class node_domain_models toneMint
class node_employee_repo,node_salary_repo,node_hr_repo,node_jwt toneRose
```

## Components

### Angular application

- [Application shell](https://github.com/krishnachakilela/acme-salary-management/blob/main/frontend/src/app/app.component.ts): `frontend/src/app/app.component.ts`
- [Feature routes](https://github.com/krishnachakilela/acme-salary-management/blob/main/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`
- [Login screen](https://github.com/krishnachakilela/acme-salary-management/blob/main/frontend/src/features/auth/login/login.component.ts): `frontend/src/features/auth/login/login.component.ts`
- [Employee screens](https://github.com/krishnachakilela/acme-salary-management/tree/main/frontend/src/features/employees): `frontend/src/features/employees`
- [Analytics dashboard](https://github.com/krishnachakilela/acme-salary-management/blob/main/frontend/src/features/analytics/analytics.component.ts): `frontend/src/features/analytics/analytics.component.ts`
- [UI authentication](https://github.com/krishnachakilela/acme-salary-management/blob/main/frontend/src/core/auth.service.ts): `frontend/src/core/auth.service.ts`
- [API client](https://github.com/krishnachakilela/acme-salary-management/blob/main/frontend/src/core/api.service.ts): `frontend/src/core/api.service.ts`
- [JWT interceptor](https://github.com/krishnachakilela/acme-salary-management/blob/main/frontend/src/core/auth.interceptor.ts): `frontend/src/core/auth.interceptor.ts`

### Spring API

- [Employee endpoints](https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/presentation/controller/EmployeeController.java): `backend/src/main/java/com/acme/salary/presentation/controller/EmployeeController.java`
- [Authentication endpoint](https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/presentation/controller/AuthController.java): `backend/src/main/java/com/acme/salary/presentation/controller/AuthController.java`
- [Analytics endpoints](https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/presentation/controller/AnalyticsController.java): `backend/src/main/java/com/acme/salary/presentation/controller/AnalyticsController.java`
- [Employee operations](https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/service/EmployeeService.java): `backend/src/main/java/com/acme/salary/service/EmployeeService.java`
- [Login service](https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/service/AuthService.java): `backend/src/main/java/com/acme/salary/service/AuthService.java`
- [Compensation analytics](https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/service/AnalyticsService.java): `backend/src/main/java/com/acme/salary/service/AnalyticsService.java`
- [API error handling](https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/exception/GlobalExceptionHandler.java): `backend/src/main/java/com/acme/salary/exception/GlobalExceptionHandler.java`

### HR domain

- [Employee and salary model](https://github.com/krishnachakilela/acme-salary-management/tree/main/backend/src/main/java/com/acme/salary/domain): `backend/src/main/java/com/acme/salary/domain`

### Persistence and security

- [Employee repository](https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/infrastructure/persistence/EmployeeRepository.java): `backend/src/main/java/com/acme/salary/infrastructure/persistence/EmployeeRepository.java`
- [Salary repository](https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/infrastructure/persistence/SalaryRecordRepository.java): `backend/src/main/java/com/acme/salary/infrastructure/persistence/SalaryRecordRepository.java`
- [HR user repository](https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/infrastructure/persistence/HrUserRepository.java): `backend/src/main/java/com/acme/salary/infrastructure/persistence/HrUserRepository.java`
- [JWT service](https://github.com/krishnachakilela/acme-salary-management/blob/main/backend/src/main/java/com/acme/salary/infrastructure/security/JwtService.java): `backend/src/main/java/com/acme/salary/infrastructure/security/JwtService.java`

### Other components

- **HR user**
- **Browser**
- **PostgreSQL**

## Connections

- HR user → Browser: uses
- Browser → Application shell: opens UI
- Application shell → Feature routes: hosts routes (evidence: `frontend/src/app/app.routes.ts`)
- Feature routes → Login screen: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Feature routes → Employee screens: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Feature routes → Analytics dashboard: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Login screen → UI authentication: calls (evidence: `frontend/src/features/auth/login/login.component.ts`)
- JWT interceptor → UI authentication: reads token (evidence: `frontend/src/core/auth.interceptor.ts`)
- Employee screens → API client: calls (evidence: `frontend/src/features/employees/employee-detail.component.ts`)
- Analytics dashboard → API client: requests data
- API client → Employee endpoints: HTTP requests
- API client → Analytics endpoints: HTTP requests
- UI authentication → Authentication endpoint: submits login
- Employee endpoints → Employee operations: dispatches (evidence: `backend/src/main/java/com/acme/salary/presentation/controller/EmployeeController.java`)
- Authentication endpoint → Login service: dispatches (evidence: `backend/src/main/java/com/acme/salary/presentation/controller/AuthController.java`)
- Analytics endpoints → Compensation analytics: dispatches
- Employee operations → Employee repository: queries and saves (evidence: `backend/src/main/java/com/acme/salary/service/EmployeeService.java`)
- Employee operations → Salary repository: queries and saves (evidence: `backend/src/main/java/com/acme/salary/service/EmployeeService.java`)
- Employee operations → Employee and salary model: uses (evidence: `backend/src/main/java/com/acme/salary/service/EmployeeService.java`)
- Compensation analytics → Employee repository: queries (evidence: `backend/src/main/java/com/acme/salary/service/AnalyticsService.java`)
- Compensation analytics → Salary repository: aggregates (evidence: `backend/src/main/java/com/acme/salary/service/AnalyticsService.java`)
- Login service → HR user repository: loads user (evidence: `backend/src/main/java/com/acme/salary/service/AuthService.java`)
- Login service → JWT service: creates token (evidence: `backend/src/main/java/com/acme/salary/service/AuthService.java`)
- Login service → Employee and salary model: uses user model (evidence: `backend/src/main/java/com/acme/salary/service/AuthService.java`)
- Employee repository → PostgreSQL: persists employees
- Salary repository → PostgreSQL: reads salary data
- HR user repository → PostgreSQL: loads credentials
