# udaradg/sample-java-project architecture

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

- Interactive diagram: https://gitdiagram.com/udaradg/sample-java-project
- Repository: https://github.com/udaradg/sample-java-project

## Overview

The source tree describes a Spring-based employee and department system with separate employee, department, reporting, scheduling, discovery, and configuration services. The principal workflow is employee API requests handled by the employee service, with department data available separately; reporting combines employee records with department data and can produce an Excel file. The supplied README instead documents an agentic vulnerability-remediation harness, which is not represented in the supplied tree, so it cannot ground this architecture. Some service internals are unsampled; uncertain service-to-service links are omitted or marked unverified.

Main entry points: [`employee-service/src/main/java/com/aura/vihanga/employeeservice/service/implementation/EmployeeServiceImpl.java`](https://github.com/udaradg/sample-java-project/blob/develop/employee-service/src/main/java/com/aura/vihanga/employeeservice/service/implementation/EmployeeServiceImpl.java) (Employee operations), [`department-service/src/main/java/com/aura/vihanga/departmentservice/controller/DepartmentController.java`](https://github.com/udaradg/sample-java-project/blob/develop/department-service/src/main/java/com/aura/vihanga/departmentservice/controller/DepartmentController.java) (Department API), [`department-service/src/main/java/com/aura/vihanga/departmentservice/service/implementation/DepartmentServiceImpl.java`](https://github.com/udaradg/sample-java-project/blob/develop/department-service/src/main/java/com/aura/vihanga/departmentservice/service/implementation/DepartmentServiceImpl.java) (Department operations), [`report-service/src/main/java/com/aura/vihanga/reportservice/service/implementation/EmployeeReportServiceImpl.java`](https://github.com/udaradg/sample-java-project/blob/develop/report-service/src/main/java/com/aura/vihanga/reportservice/service/implementation/EmployeeReportServiceImpl.java) (Report generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_employee["Employee Service"]
  node_employee_api["Employee API"]
  node_employee_logic["Employee operations"]
  node_employee_contract["Employee service contract"]
  node_employee_store[("Employee records")]
  node_employee_search["Employee search"]
  node_employee_model["Employee model<br/>[Employee.java]"]
  node_excel_upload["Excel import"]
end

subgraph group_department["Department Service"]
  node_department_api["Department API"]
  node_department_logic["Department operations"]
  node_department_contract["Department contract"]
  node_department_store[("Department records")]
  node_department_model["Department model<br/>[Department.java]"]
end

subgraph group_report["Reporting Service"]
  node_report_api["Report API"]
  node_report_logic["Report generation"]
  node_report_contract["Report contract"]
  node_report_store[("Report employee records")]
end

subgraph group_scheduler["Scheduler Service"]
  node_scheduler_api["Scheduler API"]
  node_scheduler_logic["Scheduler operations"]
  node_scheduler_store[("Scheduler employee records")]
end

subgraph group_platform["Service Platform"]
  node_config_service["Configuration service"]
  node_discovery_service["Discovery service"]
end

node_user(("API client"))

node_user -->|"requests"| node_employee_api
node_employee_api -->|"delegates"| node_employee_contract
node_employee_logic -->|"implements"| node_employee_contract
node_employee_logic -->|"uses"| node_employee_store
node_employee_logic -->|"searches"| node_employee_search
node_employee_search -->|"queries"| node_employee_model
node_employee_logic -->|"uses"| node_employee_model
node_employee_logic -->|"delegates"| node_excel_upload
node_employee_api -.->|"may fetch department data"| node_department_api
node_user -->|"requests"| node_department_api
node_department_api -->|"delegates"| node_department_contract
node_department_logic -->|"implements"| node_department_contract
node_department_logic -->|"uses"| node_department_store
node_department_logic -->|"maps"| node_department_model
node_user -->|"requests"| node_report_api
node_report_api -->|"delegates"| node_report_contract
node_report_logic -->|"implements"| node_report_contract
node_report_logic -->|"reads"| node_report_store
node_report_logic -.->|"fetches departments"| node_department_api
node_user -->|"requests"| node_scheduler_api
node_scheduler_api -->|"delegates"| node_scheduler_logic
node_scheduler_logic -.->|"uses"| node_scheduler_store

click node_employee_api "https://github.com/udaradg/sample-java-project/blob/develop/employee-service/src/main/java/com/aura/vihanga/employeeservice/controller/EmployeeController.java"
click node_employee_logic "https://github.com/udaradg/sample-java-project/blob/develop/employee-service/src/main/java/com/aura/vihanga/employeeservice/service/implementation/EmployeeServiceImpl.java"
click node_employee_contract "https://github.com/udaradg/sample-java-project/blob/develop/employee-service/src/main/java/com/aura/vihanga/employeeservice/service/EmployeeService.java"
click node_employee_store "https://github.com/udaradg/sample-java-project/blob/develop/employee-service/src/main/java/com/aura/vihanga/employeeservice/repository/EmployeeRepository.java"
click node_employee_search "https://github.com/udaradg/sample-java-project/blob/develop/employee-service/src/main/java/com/aura/vihanga/employeeservice/repository/EmployeeSearchRepository.java"
click node_employee_model "https://github.com/udaradg/sample-java-project/blob/develop/employee-service/src/main/java/com/aura/vihanga/employeeservice/model/Employee.java"
click node_excel_upload "https://github.com/udaradg/sample-java-project/blob/develop/employee-service/src/main/java/com/aura/vihanga/employeeservice/service/implementation/ExcelUploadImpl.java"
click node_department_api "https://github.com/udaradg/sample-java-project/blob/develop/department-service/src/main/java/com/aura/vihanga/departmentservice/controller/DepartmentController.java"
click node_department_logic "https://github.com/udaradg/sample-java-project/blob/develop/department-service/src/main/java/com/aura/vihanga/departmentservice/service/implementation/DepartmentServiceImpl.java"
click node_department_contract "https://github.com/udaradg/sample-java-project/blob/develop/department-service/src/main/java/com/aura/vihanga/departmentservice/service/DepartmentService.java"
click node_department_store "https://github.com/udaradg/sample-java-project/blob/develop/department-service/src/main/java/com/aura/vihanga/departmentservice/repository/DepartmentRepository.java"
click node_department_model "https://github.com/udaradg/sample-java-project/blob/develop/department-service/src/main/java/com/aura/vihanga/departmentservice/model/Department.java"
click node_report_api "https://github.com/udaradg/sample-java-project/blob/develop/report-service/src/main/java/com/aura/vihanga/reportservice/controller/EmployeeReportController.java"
click node_report_logic "https://github.com/udaradg/sample-java-project/blob/develop/report-service/src/main/java/com/aura/vihanga/reportservice/service/implementation/EmployeeReportServiceImpl.java"
click node_report_contract "https://github.com/udaradg/sample-java-project/blob/develop/report-service/src/main/java/com/aura/vihanga/reportservice/service/EmployeeReportService.java"
click node_report_store "https://github.com/udaradg/sample-java-project/blob/develop/report-service/src/main/java/com/aura/vihanga/reportservice/repository/EmployeeReportRepository.java"
click node_scheduler_api "https://github.com/udaradg/sample-java-project/blob/develop/sheduler-service/src/main/java/com/aura/vihanga/shedulerservice/controller/EmployeeSchedulerController.java"
click node_scheduler_logic "https://github.com/udaradg/sample-java-project/blob/develop/sheduler-service/src/main/java/com/aura/vihanga/shedulerservice/service/implementation/EmployeeSchedulerServiceImpl.java"
click node_scheduler_store "https://github.com/udaradg/sample-java-project/blob/develop/sheduler-service/src/main/java/com/aura/vihanga/shedulerservice/repository/EmployeeSchedulerRepository.java"
click node_config_service "https://github.com/udaradg/sample-java-project/blob/develop/configuaration-server/src/main/java/com/aura/vihanga/configuarationserver/ConfiguarationServerApplication.java"
click node_discovery_service "https://github.com/udaradg/sample-java-project/blob/develop/discovery-service/src/main/java/com/aura/vihanga/discoveryservice/DiscoveryServiceApplication.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_employee_api,node_employee_logic,node_employee_contract,node_employee_store,node_employee_search,node_employee_model,node_excel_upload,node_user toneBlue
class node_department_api,node_department_logic,node_department_contract,node_department_store,node_department_model toneAmber
class node_report_api,node_report_logic,node_report_contract,node_report_store toneMint
class node_scheduler_api,node_scheduler_logic,node_scheduler_store toneRose
class node_config_service,node_discovery_service toneIndigo
```

## Components

### Employee Service

- [Employee API](https://github.com/udaradg/sample-java-project/blob/develop/employee-service/src/main/java/com/aura/vihanga/employeeservice/controller/EmployeeController.java): `employee-service/src/main/java/com/aura/vihanga/employeeservice/controller/EmployeeController.java`
- [Employee operations](https://github.com/udaradg/sample-java-project/blob/develop/employee-service/src/main/java/com/aura/vihanga/employeeservice/service/implementation/EmployeeServiceImpl.java): `employee-service/src/main/java/com/aura/vihanga/employeeservice/service/implementation/EmployeeServiceImpl.java`
- [Employee service contract](https://github.com/udaradg/sample-java-project/blob/develop/employee-service/src/main/java/com/aura/vihanga/employeeservice/service/EmployeeService.java): `employee-service/src/main/java/com/aura/vihanga/employeeservice/service/EmployeeService.java`
- [Employee records](https://github.com/udaradg/sample-java-project/blob/develop/employee-service/src/main/java/com/aura/vihanga/employeeservice/repository/EmployeeRepository.java): `employee-service/src/main/java/com/aura/vihanga/employeeservice/repository/EmployeeRepository.java`
- [Employee search](https://github.com/udaradg/sample-java-project/blob/develop/employee-service/src/main/java/com/aura/vihanga/employeeservice/repository/EmployeeSearchRepository.java): `employee-service/src/main/java/com/aura/vihanga/employeeservice/repository/EmployeeSearchRepository.java`
- [Employee model](https://github.com/udaradg/sample-java-project/blob/develop/employee-service/src/main/java/com/aura/vihanga/employeeservice/model/Employee.java): `employee-service/src/main/java/com/aura/vihanga/employeeservice/model/Employee.java`
- [Excel import](https://github.com/udaradg/sample-java-project/blob/develop/employee-service/src/main/java/com/aura/vihanga/employeeservice/service/implementation/ExcelUploadImpl.java): `employee-service/src/main/java/com/aura/vihanga/employeeservice/service/implementation/ExcelUploadImpl.java`

### Department Service

- [Department API](https://github.com/udaradg/sample-java-project/blob/develop/department-service/src/main/java/com/aura/vihanga/departmentservice/controller/DepartmentController.java): `department-service/src/main/java/com/aura/vihanga/departmentservice/controller/DepartmentController.java`
- [Department operations](https://github.com/udaradg/sample-java-project/blob/develop/department-service/src/main/java/com/aura/vihanga/departmentservice/service/implementation/DepartmentServiceImpl.java): `department-service/src/main/java/com/aura/vihanga/departmentservice/service/implementation/DepartmentServiceImpl.java`
- [Department contract](https://github.com/udaradg/sample-java-project/blob/develop/department-service/src/main/java/com/aura/vihanga/departmentservice/service/DepartmentService.java): `department-service/src/main/java/com/aura/vihanga/departmentservice/service/DepartmentService.java`
- [Department records](https://github.com/udaradg/sample-java-project/blob/develop/department-service/src/main/java/com/aura/vihanga/departmentservice/repository/DepartmentRepository.java): `department-service/src/main/java/com/aura/vihanga/departmentservice/repository/DepartmentRepository.java`
- [Department model](https://github.com/udaradg/sample-java-project/blob/develop/department-service/src/main/java/com/aura/vihanga/departmentservice/model/Department.java): `department-service/src/main/java/com/aura/vihanga/departmentservice/model/Department.java`

### Reporting Service

- [Report API](https://github.com/udaradg/sample-java-project/blob/develop/report-service/src/main/java/com/aura/vihanga/reportservice/controller/EmployeeReportController.java): `report-service/src/main/java/com/aura/vihanga/reportservice/controller/EmployeeReportController.java`
- [Report generation](https://github.com/udaradg/sample-java-project/blob/develop/report-service/src/main/java/com/aura/vihanga/reportservice/service/implementation/EmployeeReportServiceImpl.java): `report-service/src/main/java/com/aura/vihanga/reportservice/service/implementation/EmployeeReportServiceImpl.java`
- [Report contract](https://github.com/udaradg/sample-java-project/blob/develop/report-service/src/main/java/com/aura/vihanga/reportservice/service/EmployeeReportService.java): `report-service/src/main/java/com/aura/vihanga/reportservice/service/EmployeeReportService.java`
- [Report employee records](https://github.com/udaradg/sample-java-project/blob/develop/report-service/src/main/java/com/aura/vihanga/reportservice/repository/EmployeeReportRepository.java): `report-service/src/main/java/com/aura/vihanga/reportservice/repository/EmployeeReportRepository.java`

### Scheduler Service

- [Scheduler API](https://github.com/udaradg/sample-java-project/blob/develop/sheduler-service/src/main/java/com/aura/vihanga/shedulerservice/controller/EmployeeSchedulerController.java): `sheduler-service/src/main/java/com/aura/vihanga/shedulerservice/controller/EmployeeSchedulerController.java`
- [Scheduler operations](https://github.com/udaradg/sample-java-project/blob/develop/sheduler-service/src/main/java/com/aura/vihanga/shedulerservice/service/implementation/EmployeeSchedulerServiceImpl.java): `sheduler-service/src/main/java/com/aura/vihanga/shedulerservice/service/implementation/EmployeeSchedulerServiceImpl.java`
- [Scheduler employee records](https://github.com/udaradg/sample-java-project/blob/develop/sheduler-service/src/main/java/com/aura/vihanga/shedulerservice/repository/EmployeeSchedulerRepository.java): `sheduler-service/src/main/java/com/aura/vihanga/shedulerservice/repository/EmployeeSchedulerRepository.java`

### Service Platform

- [Configuration service](https://github.com/udaradg/sample-java-project/blob/develop/configuaration-server/src/main/java/com/aura/vihanga/configuarationserver/ConfiguarationServerApplication.java): `configuaration-server/src/main/java/com/aura/vihanga/configuarationserver/ConfiguarationServerApplication.java`
- [Discovery service](https://github.com/udaradg/sample-java-project/blob/develop/discovery-service/src/main/java/com/aura/vihanga/discoveryservice/DiscoveryServiceApplication.java): `discovery-service/src/main/java/com/aura/vihanga/discoveryservice/DiscoveryServiceApplication.java`

### Other components

- **API client**

## Connections

- API client → Employee API: requests (evidence: `employee-service/src/main/java/com/aura/vihanga/employeeservice/controller/EmployeeController.java`)
- Employee API → Employee service contract: delegates (evidence: `employee-service/src/main/java/com/aura/vihanga/employeeservice/controller/EmployeeController.java`)
- Employee operations → Employee service contract: implements (evidence: `employee-service/src/main/java/com/aura/vihanga/employeeservice/service/implementation/EmployeeServiceImpl.java`)
- Employee operations → Employee records: uses (evidence: `employee-service/src/main/java/com/aura/vihanga/employeeservice/service/implementation/EmployeeServiceImpl.java`)
- Employee operations → Employee search: searches (evidence: `employee-service/src/main/java/com/aura/vihanga/employeeservice/service/implementation/EmployeeServiceImpl.java`)
- Employee search → Employee model: queries (evidence: `employee-service/src/main/java/com/aura/vihanga/employeeservice/repository/EmployeeSearchRepository.java`)
- Employee operations → Employee model: uses (evidence: `employee-service/src/main/java/com/aura/vihanga/employeeservice/service/implementation/EmployeeServiceImpl.java`)
- Employee operations → Excel import: delegates (evidence: `employee-service/src/main/java/com/aura/vihanga/employeeservice/service/implementation/EmployeeServiceImpl.java`)
- Employee API → Department API: may fetch department data
- API client → Department API: requests (evidence: `department-service/src/main/java/com/aura/vihanga/departmentservice/controller/DepartmentController.java`)
- Department API → Department contract: delegates (evidence: `department-service/src/main/java/com/aura/vihanga/departmentservice/controller/DepartmentController.java`)
- Department operations → Department contract: implements (evidence: `department-service/src/main/java/com/aura/vihanga/departmentservice/service/implementation/DepartmentServiceImpl.java`)
- Department operations → Department records: uses (evidence: `department-service/src/main/java/com/aura/vihanga/departmentservice/service/implementation/DepartmentServiceImpl.java`)
- Department operations → Department model: maps (evidence: `department-service/src/main/java/com/aura/vihanga/departmentservice/service/implementation/DepartmentServiceImpl.java`)
- API client → Report API: requests (evidence: `report-service/src/main/java/com/aura/vihanga/reportservice/controller/EmployeeReportController.java`)
- Report API → Report contract: delegates (evidence: `report-service/src/main/java/com/aura/vihanga/reportservice/controller/EmployeeReportController.java`)
- Report generation → Report contract: implements (evidence: `report-service/src/main/java/com/aura/vihanga/reportservice/service/implementation/EmployeeReportServiceImpl.java`)
- Report generation → Report employee records: reads (evidence: `report-service/src/main/java/com/aura/vihanga/reportservice/service/implementation/EmployeeReportServiceImpl.java`)
- Report generation → Department API: fetches departments
- API client → Scheduler API: requests (evidence: `sheduler-service/src/main/java/com/aura/vihanga/shedulerservice/controller/EmployeeSchedulerController.java`)
- Scheduler API → Scheduler operations: delegates (evidence: `sheduler-service/src/main/java/com/aura/vihanga/shedulerservice/controller/EmployeeSchedulerController.java`)
- Scheduler operations → Scheduler employee records: uses (evidence: `sheduler-service/src/main/java/com/aura/vihanga/shedulerservice/service/implementation/EmployeeSchedulerServiceImpl.java`)
