# nullablev1/employee-service-api architecture

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

- Interactive diagram: https://gitdiagram.com/nullablev1/employee-service-api
- Repository: https://github.com/nullablev1/employee-service-api

## Overview

Employee Management API is a layered Spring Boot REST backend. Clients authenticate or sign up, then call protected employee, department, and leave-request endpoints; services apply business rules and repositories persist UUID-backed entities in PostgreSQL. JWT filtering and method/route authorization protect requests, including employee ownership checks. The README documents the package architecture and security relationships, but no source excerpts were provided, so finer-grained call paths are not asserted.

Main entry points: [`src/main/java/com/example/demo/repos/UserAccountRepo.java`](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/repos/UserAccountRepo.java) (Account Store), [`src/main/java/com/example/demo/controllers/EmployeeController.java`](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/controllers/EmployeeController.java) (Employee Endpoints), [`src/main/java/com/example/demo/services/AuthService.java`](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/services/AuthService.java) (Account Auth), [`src/main/java/com/example/demo/config/JwtAuthFilter.java`](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/config/JwtAuthFilter.java) (JWT Request Filter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_auth_controller["Auth Endpoints"]
  node_employee_controller["Employee Endpoints"]
  node_department_controller["Department Endpoints"]
end

subgraph group_domain["Domain Services"]
  node_employee_service["Employee Logic"]
  node_department_service["Department Logic"]
  node_leave_service["Leave Requests"]
end

subgraph group_security["Authentication &amp; Authorization"]
  node_auth_service["Account Auth<br/>[AuthService.java]"]
  node_user_details["User Loading"]
  node_security_config["Security Setup"]
  node_jwt_filter["JWT Request Filter<br/>[JwtAuthFilter.java]"]
  node_jwt_helper["JWT Operations<br/>[JwtHelper.java]"]
  node_ownership["Ownership Checks<br/>[SecurityUtils.java]"]
end

subgraph group_persistence["Persistence"]
  node_employee_repo["Employee Store<br/>[EmployeeRepo.java]"]
  node_department_repo["Department Store"]
  node_leave_repo["Leave Store"]
  node_account_repo["Account Store"]
  node_domain_models["JPA Entities"]
end

subgraph group_shared["Responses &amp; Errors"]
  node_response_errors["Error Handling"]
  node_response_wrapper["Response Wrapper"]
end

node_client(("API Client"))
node_postgres[("PostgreSQL")]

node_client -->|"submits auth"| node_auth_controller
node_client -->|"calls endpoints"| node_employee_controller
node_client -->|"calls endpoints"| node_department_controller
node_auth_controller -->|"handles auth"| node_auth_service
node_employee_controller -->|"delegates operations"| node_employee_service
node_department_controller -->|"delegates operations"| node_department_service
node_employee_controller -->|"handles leave requests"| node_leave_service
node_auth_service -->|"uses account data"| node_account_repo
node_auth_service -->|"links employee signup"| node_employee_repo
node_user_details -->|"loads users"| node_account_repo
node_jwt_filter -->|"validates tokens"| node_jwt_helper
node_jwt_filter -->|"loads identity"| node_user_details
node_security_config -->|"registers filter"| node_jwt_filter
node_security_config -->|"configures authentication"| node_user_details
node_ownership -->|"checks ownership"| node_account_repo
node_employee_service -->|"uses repository"| node_employee_repo
node_department_service -->|"uses repository"| node_department_repo
node_leave_service -->|"uses repository"| node_leave_repo
node_employee_repo -->|"persists records"| node_postgres
node_department_repo -->|"persists records"| node_postgres
node_leave_repo -->|"persists records"| node_postgres
node_account_repo -->|"persists records"| node_postgres
node_response_errors -->|"wraps errors"| node_response_wrapper

click node_auth_controller "https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/controllers/AuthControllers.java"
click node_employee_controller "https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/controllers/EmployeeController.java"
click node_department_controller "https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/controllers/DepartmentController.java"
click node_auth_service "https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/services/AuthService.java"
click node_employee_service "https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/services/EmployeeServiceImpl.java"
click node_department_service "https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/services/DepartmentServiceImpl.java"
click node_leave_service "https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/services/LeaveRequestServiceImpl.java"
click node_user_details "https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/services/UserDetailsServiceImpl.java"
click node_security_config "https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/config/SecurityConfig.java"
click node_jwt_filter "https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/config/JwtAuthFilter.java"
click node_jwt_helper "https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/config/JwtHelper.java"
click node_ownership "https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/utils/SecurityUtils.java"
click node_employee_repo "https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/repos/EmployeeRepo.java"
click node_department_repo "https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/repos/DepartmentRepo.java"
click node_leave_repo "https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/repos/LeaveRequestRepo.java"
click node_account_repo "https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/repos/UserAccountRepo.java"
click node_domain_models "https://github.com/nullablev1/employee-service-api/tree/master/src/main/java/com/example/demo/models"
click node_response_errors "https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/shared/GlobalExceptionResponse.java"
click node_response_wrapper "https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/shared/GlobalResponse.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_auth_controller,node_employee_controller,node_department_controller,node_client toneBlue
class node_employee_service,node_department_service,node_leave_service,node_postgres toneAmber
class node_auth_service,node_user_details,node_security_config,node_jwt_filter,node_jwt_helper,node_ownership toneMint
class node_employee_repo,node_department_repo,node_leave_repo,node_account_repo,node_domain_models toneRose
class node_response_errors,node_response_wrapper toneIndigo
```

## Components

### REST API

- [Auth Endpoints](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/controllers/AuthControllers.java): `src/main/java/com/example/demo/controllers/AuthControllers.java`
- [Employee Endpoints](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/controllers/EmployeeController.java): `src/main/java/com/example/demo/controllers/EmployeeController.java`
- [Department Endpoints](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/controllers/DepartmentController.java): `src/main/java/com/example/demo/controllers/DepartmentController.java`

### Domain Services

- [Employee Logic](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/services/EmployeeServiceImpl.java): `src/main/java/com/example/demo/services/EmployeeServiceImpl.java`
- [Department Logic](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/services/DepartmentServiceImpl.java): `src/main/java/com/example/demo/services/DepartmentServiceImpl.java`
- [Leave Requests](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/services/LeaveRequestServiceImpl.java): `src/main/java/com/example/demo/services/LeaveRequestServiceImpl.java`

### Authentication & Authorization

- [Account Auth](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/services/AuthService.java): `src/main/java/com/example/demo/services/AuthService.java`
- [User Loading](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/services/UserDetailsServiceImpl.java): `src/main/java/com/example/demo/services/UserDetailsServiceImpl.java`
- [Security Setup](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/config/SecurityConfig.java): `src/main/java/com/example/demo/config/SecurityConfig.java`
- [JWT Request Filter](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/config/JwtAuthFilter.java): `src/main/java/com/example/demo/config/JwtAuthFilter.java`
- [JWT Operations](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/config/JwtHelper.java): `src/main/java/com/example/demo/config/JwtHelper.java`
- [Ownership Checks](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/utils/SecurityUtils.java): `src/main/java/com/example/demo/utils/SecurityUtils.java`

### Persistence

- [Employee Store](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/repos/EmployeeRepo.java): `src/main/java/com/example/demo/repos/EmployeeRepo.java`
- [Department Store](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/repos/DepartmentRepo.java): `src/main/java/com/example/demo/repos/DepartmentRepo.java`
- [Leave Store](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/repos/LeaveRequestRepo.java): `src/main/java/com/example/demo/repos/LeaveRequestRepo.java`
- [Account Store](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/repos/UserAccountRepo.java): `src/main/java/com/example/demo/repos/UserAccountRepo.java`
- [JPA Entities](https://github.com/nullablev1/employee-service-api/tree/master/src/main/java/com/example/demo/models): `src/main/java/com/example/demo/models`

### Responses & Errors

- [Error Handling](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/shared/GlobalExceptionResponse.java): `src/main/java/com/example/demo/shared/GlobalExceptionResponse.java`
- [Response Wrapper](https://github.com/nullablev1/employee-service-api/blob/master/src/main/java/com/example/demo/shared/GlobalResponse.java): `src/main/java/com/example/demo/shared/GlobalResponse.java`

### Other components

- **API Client**
- **PostgreSQL**

## Connections

- API Client → Auth Endpoints: submits auth (evidence: `README.md`)
- API Client → Employee Endpoints: calls endpoints (evidence: `README.md`)
- API Client → Department Endpoints: calls endpoints (evidence: `README.md`)
- Auth Endpoints → Account Auth: handles auth (evidence: `README.md`)
- Employee Endpoints → Employee Logic: delegates operations (evidence: `README.md`)
- Department Endpoints → Department Logic: delegates operations (evidence: `README.md`)
- Employee Endpoints → Leave Requests: handles leave requests (evidence: `README.md`)
- Account Auth → Account Store: uses account data (evidence: `README.md`)
- Account Auth → Employee Store: links employee signup (evidence: `README.md`)
- User Loading → Account Store: loads users (evidence: `README.md`)
- JWT Request Filter → JWT Operations: validates tokens (evidence: `README.md`)
- JWT Request Filter → User Loading: loads identity (evidence: `README.md`)
- Security Setup → JWT Request Filter: registers filter (evidence: `README.md`)
- Security Setup → User Loading: configures authentication (evidence: `README.md`)
- Ownership Checks → Account Store: checks ownership (evidence: `README.md`)
- Employee Logic → Employee Store: uses repository (evidence: `README.md`)
- Department Logic → Department Store: uses repository (evidence: `README.md`)
- Leave Requests → Leave Store: uses repository (evidence: `README.md`)
- Employee Store → PostgreSQL: persists records (evidence: `README.md`)
- Department Store → PostgreSQL: persists records (evidence: `README.md`)
- Leave Store → PostgreSQL: persists records (evidence: `README.md`)
- Account Store → PostgreSQL: persists records (evidence: `README.md`)
- Error Handling → Response Wrapper: wraps errors (evidence: `README.md`)
