# abhighyanmishra-gthb/careerpilot architecture

> Architecture diagram of the GitHub repository abhighyanmishra-gthb/careerpilot, 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/abhighyanmishra-gthb/careerpilot
- Repository: https://github.com/abhighyanmishra-gthb/careerpilot

## Overview

This Spring backend supports a question bank organized by company, category, and difficulty, plus mock/practice attempts. The main workflow starts an attempt, selects questions, serves them without revealing correct answers, and accepts submissions for scoring. Separate endpoints manage questions and companies. The graph reflects the sampled services and repository references; unsampled controller and persistence details are not expanded, and no database or external integrations are inferred.

Main entry points: [`backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/QuestionService.java`](https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/QuestionService.java) (Question catalog), [`backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/AttemptService.java`](https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/AttemptService.java) (Attempt lifecycle and scoring), [`backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/QuestionSelectionService.java`](https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/QuestionSelectionService.java) (Question selection), [`backendcodebase/src/main/java/com/careerpilot/backendcodebase/controller/AttemptController.java`](https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/controller/AttemptController.java) (Attempt endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_attempt_api["Attempt endpoints"]
  node_question_api["Question endpoints"]
  node_company_api["Company endpoints"]
  node_api_dtos["Request and response DTOs"]
end

subgraph group_question["Question Management"]
  node_question_service["Question catalog"]
  node_company_service["Company lookup"]
end

subgraph group_attempt["Practice Attempts"]
  node_selection_service["Question selection"]
  node_attempt_service["Attempt lifecycle and scoring"]
end

subgraph group_data["Domain and Persistence"]
  node_question_repo["Question queries"]
  node_company_question_repo["Company-question links"]
  node_company_repo["Company records"]
  node_attempt_repos["Attempt repositories"]
  node_other_repos["Supporting repositories"]
  node_domain_entities["Domain entities and enums"]
end

node_client(("API client"))

node_attempt_api -->|"delegates to"| node_attempt_service
node_question_api -->|"delegates to"| node_question_service
node_company_api -->|"delegates to"| node_company_service
node_attempt_service -->|"selects questions"| node_selection_service
node_attempt_service -->|"reads and writes"| node_attempt_repos
node_attempt_service -->|"loads users and options"| node_other_repos
node_selection_service -->|"queries questions"| node_question_repo
node_selection_service -->|"queries company links"| node_company_question_repo
node_question_service -->|"queries and saves"| node_question_repo
node_question_service -->|"saves company links"| node_company_question_repo
node_question_service -->|"loads companies"| node_company_repo
node_company_service -->|"accesses companies"| node_company_repo
node_question_service -->|"maps question data"| node_domain_entities
node_attempt_service -->|"builds attempt data"| node_domain_entities
node_attempt_api -->|"uses request and response types"| node_api_dtos
node_question_api -->|"uses question DTOs"| node_api_dtos

click node_attempt_api "https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/controller/AttemptController.java"
click node_question_api "https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/controller/QuestionController.java"
click node_company_api "https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/controller/CompanyController.java"
click node_question_service "https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/QuestionService.java"
click node_company_service "https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/CompanyService.java"
click node_selection_service "https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/QuestionSelectionService.java"
click node_attempt_service "https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/AttemptService.java"
click node_question_repo "https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/repository/QuestionRepository.java"
click node_company_question_repo "https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/repository/CompanyQuestionRepository.java"
click node_company_repo "https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/repository/CompanyRepository.java"
click node_attempt_repos "https://github.com/abhighyanmishra-gthb/careerpilot/tree/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/repository"
click node_other_repos "https://github.com/abhighyanmishra-gthb/careerpilot/tree/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/repository"
click node_domain_entities "https://github.com/abhighyanmishra-gthb/careerpilot/tree/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/entity"
click node_api_dtos "https://github.com/abhighyanmishra-gthb/careerpilot/tree/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/dtos"

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_attempt_api,node_question_api,node_company_api,node_api_dtos,node_client toneBlue
class node_question_service,node_company_service toneAmber
class node_selection_service,node_attempt_service toneMint
class node_question_repo,node_company_question_repo,node_company_repo,node_attempt_repos,node_other_repos,node_domain_entities toneRose
```

## Components

### REST API

- [Attempt endpoints](https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/controller/AttemptController.java): `backendcodebase/src/main/java/com/careerpilot/backendcodebase/controller/AttemptController.java`
- [Question endpoints](https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/controller/QuestionController.java): `backendcodebase/src/main/java/com/careerpilot/backendcodebase/controller/QuestionController.java`
- [Company endpoints](https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/controller/CompanyController.java): `backendcodebase/src/main/java/com/careerpilot/backendcodebase/controller/CompanyController.java`
- [Request and response DTOs](https://github.com/abhighyanmishra-gthb/careerpilot/tree/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/dtos): `backendcodebase/src/main/java/com/careerpilot/backendcodebase/dtos`

### Question Management

- [Question catalog](https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/QuestionService.java): `backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/QuestionService.java`
- [Company lookup](https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/CompanyService.java): `backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/CompanyService.java`

### Practice Attempts

- [Question selection](https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/QuestionSelectionService.java): `backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/QuestionSelectionService.java`
- [Attempt lifecycle and scoring](https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/AttemptService.java): `backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/AttemptService.java`

### Domain and Persistence

- [Question queries](https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/repository/QuestionRepository.java): `backendcodebase/src/main/java/com/careerpilot/backendcodebase/repository/QuestionRepository.java`
- [Company-question links](https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/repository/CompanyQuestionRepository.java): `backendcodebase/src/main/java/com/careerpilot/backendcodebase/repository/CompanyQuestionRepository.java`
- [Company records](https://github.com/abhighyanmishra-gthb/careerpilot/blob/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/repository/CompanyRepository.java): `backendcodebase/src/main/java/com/careerpilot/backendcodebase/repository/CompanyRepository.java`
- [Attempt repositories](https://github.com/abhighyanmishra-gthb/careerpilot/tree/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/repository): `backendcodebase/src/main/java/com/careerpilot/backendcodebase/repository`
- [Supporting repositories](https://github.com/abhighyanmishra-gthb/careerpilot/tree/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/repository): `backendcodebase/src/main/java/com/careerpilot/backendcodebase/repository`
- [Domain entities and enums](https://github.com/abhighyanmishra-gthb/careerpilot/tree/main/backendcodebase/src/main/java/com/careerpilot/backendcodebase/entity): `backendcodebase/src/main/java/com/careerpilot/backendcodebase/entity`

### Other components

- **API client**

## Connections

- Attempt endpoints → Attempt lifecycle and scoring: delegates to (evidence: `backendcodebase/src/main/java/com/careerpilot/backendcodebase/controller/AttemptController.java`)
- Question endpoints → Question catalog: delegates to (evidence: `backendcodebase/src/main/java/com/careerpilot/backendcodebase/controller/QuestionController.java`)
- Company endpoints → Company lookup: delegates to (evidence: `backendcodebase/src/main/java/com/careerpilot/backendcodebase/controller/CompanyController.java`)
- Attempt lifecycle and scoring → Question selection: selects questions (evidence: `backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/AttemptService.java`)
- Attempt lifecycle and scoring → Attempt repositories: reads and writes (evidence: `backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/AttemptService.java`)
- Attempt lifecycle and scoring → Supporting repositories: loads users and options (evidence: `backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/AttemptService.java`)
- Question selection → Question queries: queries questions (evidence: `backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/QuestionSelectionService.java`)
- Question selection → Company-question links: queries company links (evidence: `backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/QuestionSelectionService.java`)
- Question catalog → Question queries: queries and saves (evidence: `backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/QuestionService.java`)
- Question catalog → Company-question links: saves company links (evidence: `backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/QuestionService.java`)
- Question catalog → Company records: loads companies (evidence: `backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/QuestionService.java`)
- Company lookup → Company records: accesses companies (evidence: `backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/CompanyService.java`)
- Question catalog → Domain entities and enums: maps question data (evidence: `backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/QuestionService.java`)
- Attempt lifecycle and scoring → Domain entities and enums: builds attempt data (evidence: `backendcodebase/src/main/java/com/careerpilot/backendcodebase/service/AttemptService.java`)
- Attempt endpoints → Request and response DTOs: uses request and response types (evidence: `backendcodebase/src/main/java/com/careerpilot/backendcodebase/controller/AttemptController.java`)
- Question endpoints → Request and response DTOs: uses question DTOs (evidence: `backendcodebase/src/main/java/com/careerpilot/backendcodebase/controller/QuestionController.java`)
