# ahmedbenkrarayc/nexus-backend-core architecture

> Architecture diagram of the GitHub repository ahmedbenkrarayc/nexus-backend-core, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ahmedbenkrarayc/nexus-backend-core
- Repository: https://github.com/ahmedbenkrarayc/nexus-backend-core

## Overview

Nexus is a Spring-based workforce and project staffing application. Its central workflow covers project staffing requests, candidate and availability assessment, resource-manager review, and employee engagements; surrounding capabilities manage employee profiles, skills, absences, responsibilities, campuses, and project records. The tree and source index establish these domain areas, but most implementations and staffing routes were not excerpted, so those relationships are shown as unverified dashed links. The visible controller-to-service edges are supported by the source index.

Main entry points: [`nexus-staffing/src/main/java/com/nexus/staffing/controller`](https://github.com/ahmedbenkrarayc/nexus-backend-core/tree/main/nexus-staffing/src/main/java/com/nexus/staffing/controller) (Staffing APIs), [`nexus-employee/src/main/java/com/nexus/employee/controller`](https://github.com/ahmedbenkrarayc/nexus-backend-core/tree/main/nexus-employee/src/main/java/com/nexus/employee/controller) (Employee APIs), [`src/main/java/com/nexus/core/NexusCoreApplication.java`](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/src/main/java/com/nexus/core/NexusCoreApplication.java) (Nexus application), [`nexus-staffing/src/main/java/com/nexus/staffing/service/impl/CandidateMatchingServiceImpl.java`](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-staffing/src/main/java/com/nexus/staffing/service/impl/CandidateMatchingServiceImpl.java) (Candidate matching)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_staffing["Staffing workflow"]
  node_staffing_api["Staffing APIs"]
  node_request_service["Request review"]
  node_candidate_service["Candidate matching"]
  node_scoring["Candidate scoring"]
  node_pm_service["Project staffing"]
  node_employee_self["Employee self-service"]
  node_dashboard["Staffing dashboard"]
  node_staffing_store[("Staffing records")]
end

subgraph group_workforce["Employee management"]
  node_employee_api["Employee APIs"]
  node_employee_service["Employee profiles"]
  node_absence_service["Absence management"]
  node_skill_service["Skill management"]
  node_responsibility_service["Manager assignments"]
  node_employee_store[("Employee records")]
  node_auth_client["Auth client"]
end

subgraph group_projects["Projects and organization"]
  node_project_api["Project API"]
  node_project_service["Project records"]
  node_project_store[("Project database")]
  node_campus_api["Campus API"]
  node_campus_service["Campus records"]
  node_campus_store[("Campus database")]
end

subgraph group_platform["Platform services"]
  node_jwt_filter["JWT authentication"]
  node_jwt_validation["JWT validation"]
  node_app["Nexus application"]
end

node_user(("Application user"))
node_auth_service["Auth service"]

node_user -.->|"submits requests"| node_staffing_api
node_staffing_api -.->|"routes review"| node_request_service
node_staffing_api -.->|"routes search"| node_candidate_service
node_staffing_api -.->|"routes staffing"| node_pm_service
node_staffing_api -.->|"routes self-service"| node_employee_self
node_staffing_api -.->|"routes dashboard"| node_dashboard
node_candidate_service -.->|"scores candidates"| node_scoring
node_request_service -.->|"reads and writes"| node_staffing_store
node_candidate_service -.->|"checks employees"| node_employee_store
node_user -.->|"manages profile"| node_employee_api
node_employee_api -->|"calls service"| node_absence_service
node_employee_api -.->|"routes employee work"| node_employee_service
node_employee_api -.->|"routes skill work"| node_skill_service
node_employee_api -.->|"routes assignments"| node_responsibility_service
node_employee_service -.->|"reads and writes"| node_employee_store
node_absence_service -.->|"stores absences"| node_employee_store
node_auth_client -.->|"calls auth API"| node_auth_service
node_user -.->|"manages projects"| node_project_api
node_project_api -->|"calls service"| node_project_service
node_project_service -.->|"reads and writes"| node_project_store
node_user -.->|"manages campuses"| node_campus_api
node_campus_api -->|"calls service"| node_campus_service
node_campus_service -.->|"reads and writes"| node_campus_store
node_user -.->|"presents cookie"| node_jwt_filter
node_jwt_filter -.->|"validates token"| node_jwt_validation
node_app -.->|"hosts module"| node_staffing_api
node_app -.->|"hosts module"| node_employee_api
node_app -.->|"hosts module"| node_project_api
node_app -.->|"hosts module"| node_campus_api

click node_staffing_api "https://github.com/ahmedbenkrarayc/nexus-backend-core/tree/main/nexus-staffing/src/main/java/com/nexus/staffing/controller"
click node_request_service "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-staffing/src/main/java/com/nexus/staffing/service/impl/ResourceManagerRequestServiceImpl.java"
click node_candidate_service "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-staffing/src/main/java/com/nexus/staffing/service/impl/CandidateMatchingServiceImpl.java"
click node_scoring "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-staffing/src/main/java/com/nexus/staffing/util/EmployeeScoringEngine.java"
click node_pm_service "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-staffing/src/main/java/com/nexus/staffing/service/impl/ProjectManagerStaffingServiceImpl.java"
click node_employee_self "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-staffing/src/main/java/com/nexus/staffing/service/impl/EmployeeSelfServiceServiceImpl.java"
click node_dashboard "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-staffing/src/main/java/com/nexus/staffing/service/impl/DashboardServiceImpl.java"
click node_staffing_store "https://github.com/ahmedbenkrarayc/nexus-backend-core/tree/main/nexus-staffing/src/main/java/com/nexus/staffing/repository"
click node_employee_api "https://github.com/ahmedbenkrarayc/nexus-backend-core/tree/main/nexus-employee/src/main/java/com/nexus/employee/controller"
click node_employee_service "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-employee/src/main/java/com/nexus/employee/service/impl/EmployeeServiceImpl.java"
click node_absence_service "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-employee/src/main/java/com/nexus/employee/service/AbsenseService.java"
click node_skill_service "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-employee/src/main/java/com/nexus/employee/service/impl/EmployeeSkillServiceImpl.java"
click node_responsibility_service "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-employee/src/main/java/com/nexus/employee/service/EmployeeResponsibilityService.java"
click node_employee_store "https://github.com/ahmedbenkrarayc/nexus-backend-core/tree/main/nexus-employee/src/main/java/com/nexus/employee/repository"
click node_auth_client "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-employee/src/main/java/com/nexus/employee/client/AuthServiceRestClient.java"
click node_project_api "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-project/src/main/java/com/nexus/project/controller/ProjectController.java"
click node_project_service "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-project/src/main/java/com/nexus/project/service/impl/ProjectServiceImpl.java"
click node_project_store "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-project/src/main/java/com/nexus/project/repository/ProjectRepository.java"
click node_campus_api "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-organization/src/main/java/com/nexus/organization/controller/CampusController.java"
click node_campus_service "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-organization/src/main/java/com/nexus/organization/service/impl/CampusServiceImpl.java"
click node_campus_store "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-organization/src/main/java/com/nexus/organization/repository/CampusRepository.java"
click node_jwt_filter "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-shared/src/main/java/com/nexus/shared/security/filter/JwtCookieAuthenticationFilter.java"
click node_jwt_validation "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-shared/src/main/java/com/nexus/shared/security/service/JwtValidationService.java"
click node_app "https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/src/main/java/com/nexus/core/NexusCoreApplication.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_staffing_api,node_request_service,node_candidate_service,node_scoring,node_pm_service,node_employee_self,node_dashboard,node_staffing_store,node_user toneBlue
class node_employee_api,node_employee_service,node_absence_service,node_skill_service,node_responsibility_service,node_employee_store,node_auth_client toneAmber
class node_project_api,node_project_service,node_project_store,node_campus_api,node_campus_service,node_campus_store toneMint
class node_jwt_filter,node_jwt_validation,node_app toneRose
class node_auth_service toneIndigo
```

## Components

### Staffing workflow

- [Staffing APIs](https://github.com/ahmedbenkrarayc/nexus-backend-core/tree/main/nexus-staffing/src/main/java/com/nexus/staffing/controller): `nexus-staffing/src/main/java/com/nexus/staffing/controller`
- [Request review](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-staffing/src/main/java/com/nexus/staffing/service/impl/ResourceManagerRequestServiceImpl.java): `nexus-staffing/src/main/java/com/nexus/staffing/service/impl/ResourceManagerRequestServiceImpl.java`
- [Candidate matching](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-staffing/src/main/java/com/nexus/staffing/service/impl/CandidateMatchingServiceImpl.java): `nexus-staffing/src/main/java/com/nexus/staffing/service/impl/CandidateMatchingServiceImpl.java`
- [Candidate scoring](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-staffing/src/main/java/com/nexus/staffing/util/EmployeeScoringEngine.java): `nexus-staffing/src/main/java/com/nexus/staffing/util/EmployeeScoringEngine.java`
- [Project staffing](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-staffing/src/main/java/com/nexus/staffing/service/impl/ProjectManagerStaffingServiceImpl.java): `nexus-staffing/src/main/java/com/nexus/staffing/service/impl/ProjectManagerStaffingServiceImpl.java`
- [Employee self-service](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-staffing/src/main/java/com/nexus/staffing/service/impl/EmployeeSelfServiceServiceImpl.java): `nexus-staffing/src/main/java/com/nexus/staffing/service/impl/EmployeeSelfServiceServiceImpl.java`
- [Staffing dashboard](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-staffing/src/main/java/com/nexus/staffing/service/impl/DashboardServiceImpl.java): `nexus-staffing/src/main/java/com/nexus/staffing/service/impl/DashboardServiceImpl.java`
- [Staffing records](https://github.com/ahmedbenkrarayc/nexus-backend-core/tree/main/nexus-staffing/src/main/java/com/nexus/staffing/repository): `nexus-staffing/src/main/java/com/nexus/staffing/repository`

### Employee management

- [Employee APIs](https://github.com/ahmedbenkrarayc/nexus-backend-core/tree/main/nexus-employee/src/main/java/com/nexus/employee/controller): `nexus-employee/src/main/java/com/nexus/employee/controller`
- [Employee profiles](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-employee/src/main/java/com/nexus/employee/service/impl/EmployeeServiceImpl.java): `nexus-employee/src/main/java/com/nexus/employee/service/impl/EmployeeServiceImpl.java`
- [Absence management](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-employee/src/main/java/com/nexus/employee/service/AbsenseService.java): `nexus-employee/src/main/java/com/nexus/employee/service/AbsenseService.java`
- [Skill management](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-employee/src/main/java/com/nexus/employee/service/impl/EmployeeSkillServiceImpl.java): `nexus-employee/src/main/java/com/nexus/employee/service/impl/EmployeeSkillServiceImpl.java`
- [Manager assignments](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-employee/src/main/java/com/nexus/employee/service/EmployeeResponsibilityService.java): `nexus-employee/src/main/java/com/nexus/employee/service/EmployeeResponsibilityService.java`
- [Employee records](https://github.com/ahmedbenkrarayc/nexus-backend-core/tree/main/nexus-employee/src/main/java/com/nexus/employee/repository): `nexus-employee/src/main/java/com/nexus/employee/repository`
- [Auth client](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-employee/src/main/java/com/nexus/employee/client/AuthServiceRestClient.java): `nexus-employee/src/main/java/com/nexus/employee/client/AuthServiceRestClient.java`

### Projects and organization

- [Project API](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-project/src/main/java/com/nexus/project/controller/ProjectController.java): `nexus-project/src/main/java/com/nexus/project/controller/ProjectController.java`
- [Project records](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-project/src/main/java/com/nexus/project/service/impl/ProjectServiceImpl.java): `nexus-project/src/main/java/com/nexus/project/service/impl/ProjectServiceImpl.java`
- [Project database](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-project/src/main/java/com/nexus/project/repository/ProjectRepository.java): `nexus-project/src/main/java/com/nexus/project/repository/ProjectRepository.java`
- [Campus API](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-organization/src/main/java/com/nexus/organization/controller/CampusController.java): `nexus-organization/src/main/java/com/nexus/organization/controller/CampusController.java`
- [Campus records](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-organization/src/main/java/com/nexus/organization/service/impl/CampusServiceImpl.java): `nexus-organization/src/main/java/com/nexus/organization/service/impl/CampusServiceImpl.java`
- [Campus database](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-organization/src/main/java/com/nexus/organization/repository/CampusRepository.java): `nexus-organization/src/main/java/com/nexus/organization/repository/CampusRepository.java`

### Platform services

- [JWT authentication](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-shared/src/main/java/com/nexus/shared/security/filter/JwtCookieAuthenticationFilter.java): `nexus-shared/src/main/java/com/nexus/shared/security/filter/JwtCookieAuthenticationFilter.java`
- [JWT validation](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/nexus-shared/src/main/java/com/nexus/shared/security/service/JwtValidationService.java): `nexus-shared/src/main/java/com/nexus/shared/security/service/JwtValidationService.java`
- [Nexus application](https://github.com/ahmedbenkrarayc/nexus-backend-core/blob/main/src/main/java/com/nexus/core/NexusCoreApplication.java): `src/main/java/com/nexus/core/NexusCoreApplication.java`

### Other components

- **Application user**
- **Auth service**

## Connections

- Application user → Staffing APIs: submits requests
- Staffing APIs → Request review: routes review
- Staffing APIs → Candidate matching: routes search
- Staffing APIs → Project staffing: routes staffing
- Staffing APIs → Employee self-service: routes self-service
- Staffing APIs → Staffing dashboard: routes dashboard
- Candidate matching → Candidate scoring: scores candidates
- Request review → Staffing records: reads and writes (evidence: `nexus-staffing/src/main/java/com/nexus/staffing/service/impl/ResourceManagerRequestServiceImpl.java`)
- Candidate matching → Employee records: checks employees
- Application user → Employee APIs: manages profile
- Employee APIs → Absence management: calls service (evidence: `nexus-employee/src/main/java/com/nexus/employee/controller/AbsenseController.java`)
- Employee APIs → Employee profiles: routes employee work
- Employee APIs → Skill management: routes skill work
- Employee APIs → Manager assignments: routes assignments
- Employee profiles → Employee records: reads and writes
- Absence management → Employee records: stores absences
- Auth client → Auth service: calls auth API
- Application user → Project API: manages projects
- Project API → Project records: calls service (evidence: `nexus-project/src/main/java/com/nexus/project/controller/ProjectController.java`)
- Project records → Project database: reads and writes (evidence: `nexus-project/src/main/java/com/nexus/project/service/impl/ProjectServiceImpl.java`)
- Application user → Campus API: manages campuses
- Campus API → Campus records: calls service (evidence: `nexus-organization/src/main/java/com/nexus/organization/controller/CampusController.java`)
- Campus records → Campus database: reads and writes
- Application user → JWT authentication: presents cookie
- JWT authentication → JWT validation: validates token
- Nexus application → Staffing APIs: hosts module
- Nexus application → Employee APIs: hosts module
- Nexus application → Project API: hosts module
- Nexus application → Campus API: hosts module
