# dhwlpandey/career-forge architecture

> Architecture diagram of the GitHub repository dhwlpandey/career-forge, 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/dhwlpandey/career-forge
- Repository: https://github.com/dhwlpandey/career-forge

## Overview

Career-Forge is a small Spring Boot backend whose sampled runtime centers on user creation and lookup: UserService checks email uniqueness, persists a user, and maps between request/response DTOs and the User entity. JPA repositories and entities define persistence for users, profiles, and skills. The README provides no additional product capabilities, and the tree shows no controller or API-routing layer, so the initiating request path is not established; unsampled wiring is not assumed.

Main entry points: [`backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/service/UserService.java`](https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/service/UserService.java) (User Service), [`backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/entity/User.java`](https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/entity/User.java) (User Entity), [`backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/repository/UserRepository.java`](https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/repository/UserRepository.java) (User Repository), [`backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/repository/ProfileRepository.java`](https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/repository/ProfileRepository.java) (Profile Repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_entry["Spring Boot Entry"]
end

subgraph group_users["User Workflow"]
  node_service["User Service<br/>[UserService.java]"]
  node_create["Create Request"]
  node_response["User Response<br/>[UserResponse.java]"]
end

subgraph group_persistence["Persistence Model"]
  node_userrepo["User Repository"]
  node_profilerepo["Profile Repository"]
  node_skillrepo["Skill Repository"]
  node_user["User Entity<br/>[User.java]"]
  node_profile["Profile Entity<br/>[Profile.java]"]
  node_skill["Skill Entity<br/>[Skill.java]"]
end

node_client(("Client"))
node_database[("Relational Database")]

node_client -.->|"submits request"| node_service
node_service -->|"reads fields"| node_create
node_service -->|"maps user"| node_user
node_service -->|"checks and saves"| node_userrepo
node_service -->|"builds response"| node_response
node_userrepo -->|"persists entity"| node_user
node_profilerepo -->|"persists entity"| node_profile
node_skillrepo -->|"persists entity"| node_skill
node_user -->|"has profile"| node_profile
node_user -->|"has skills"| node_skill
node_userrepo -.->|"JPA persistence"| node_database
node_profilerepo -.->|"JPA persistence"| node_database
node_skillrepo -.->|"JPA persistence"| node_database

click node_entry "https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/CareerforgeapplicationApplication.java"
click node_service "https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/service/UserService.java"
click node_create "https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/dto/UserCreateRequest.java"
click node_response "https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/dto/UserResponse.java"
click node_userrepo "https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/repository/UserRepository.java"
click node_profilerepo "https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/repository/ProfileRepository.java"
click node_skillrepo "https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/repository/SkillRepository.java"
click node_user "https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/entity/User.java"
click node_profile "https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/entity/Profile.java"
click node_skill "https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/entity/Skill.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_entry,node_client toneBlue
class node_service,node_create,node_response,node_database toneAmber
class node_userrepo,node_profilerepo,node_skillrepo,node_user,node_profile,node_skill toneMint
```

## Components

### Application

- [Spring Boot Entry](https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/CareerforgeapplicationApplication.java): `backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/CareerforgeapplicationApplication.java`

### User Workflow

- [User Service](https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/service/UserService.java): `backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/service/UserService.java`
- [Create Request](https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/dto/UserCreateRequest.java): `backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/dto/UserCreateRequest.java`
- [User Response](https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/dto/UserResponse.java): `backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/dto/UserResponse.java`

### Persistence Model

- [User Repository](https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/repository/UserRepository.java): `backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/repository/UserRepository.java`
- [Profile Repository](https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/repository/ProfileRepository.java): `backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/repository/ProfileRepository.java`
- [Skill Repository](https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/repository/SkillRepository.java): `backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/repository/SkillRepository.java`
- [User Entity](https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/entity/User.java): `backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/entity/User.java`
- [Profile Entity](https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/entity/Profile.java): `backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/entity/Profile.java`
- [Skill Entity](https://github.com/dhwlpandey/career-forge/blob/main/backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/entity/Skill.java): `backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/entity/Skill.java`

### Other components

- **Client**
- **Relational Database**

## Connections

- Client → User Service: submits request
- User Service → Create Request: reads fields (evidence: `backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/service/UserService.java`)
- User Service → User Entity: maps user (evidence: `backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/service/UserService.java`)
- User Service → User Repository: checks and saves (evidence: `backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/service/UserService.java`)
- User Service → User Response: builds response (evidence: `backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/service/UserService.java`)
- User Repository → User Entity: persists entity (evidence: `backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/repository/UserRepository.java`)
- Profile Repository → Profile Entity: persists entity (evidence: `backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/repository/ProfileRepository.java`)
- Skill Repository → Skill Entity: persists entity (evidence: `backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/repository/SkillRepository.java`)
- User Entity → Profile Entity: has profile (evidence: `backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/entity/User.java`)
- User Entity → Skill Entity: has skills (evidence: `backend/careerforgeapplication/src/main/java/com/dhwl/careerforge/entity/User.java`)
- User Repository → Relational Database: JPA persistence
- Profile Repository → Relational Database: JPA persistence
- Skill Repository → Relational Database: JPA persistence
