# we-are-nextgen/api architecture

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

- Interactive diagram: https://gitdiagram.com/we-are-nextgen/api
- Repository: https://github.com/we-are-nextgen/api

## Overview

nextgen-api is a Quarkus REST backend for a learning platform. Users discover domains and learning tracks, enroll in tracks or bootcamps, complete labs and exercises, and view progress; administrators can import track and bootcamp content from Git repositories. The graph separates these domain capabilities from their service layer and shared learning models. Relationships are limited to controller-to-service references and service/model interactions supported by the source index or excerpts; unsampled endpoints and integrations are not inferred.

Main entry points: [`src/main/java/org/nextgen/model`](https://github.com/we-are-nextgen/api/tree/main/src/main/java/org/nextgen/model) (Learning and progress models), [`src/main/java/org/nextgen/controller/LabController.java`](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/controller/LabController.java) (Lab submissions), [`src/main/java/org/nextgen/controller/ImportController.java`](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/controller/ImportController.java) (Import endpoint), [`src/main/java/org/nextgen/controller/DomainController.java`](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/controller/DomainController.java) (Discovery endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Learning discovery"]
  node_discovery_api["Discovery endpoints"]
  node_domain_service["Domain service<br/>[DomainService.java]"]
  node_journey_api["Journey endpoint"]
  node_journey_service["Journey service"]
end

subgraph group_tracks["Tracks and labs"]
  node_track_api["Track endpoints"]
  node_track_service["Track service"]
  node_lab_api["Lab submissions<br/>[LabController.java]"]
  node_lab_service["Lab service<br/>[LabService.java]"]
  node_grading["Auto grading"]
  node_progress_api["Track progress endpoint"]
  node_progress_service["Track progress service"]
  node_import_api["Import endpoint"]
  node_track_import["Track importer"]
end

subgraph group_bootcamps["Bootcamp programs"]
  node_bootcamp_api["Bootcamp endpoints"]
  node_bootcamp_service["Bootcamp service"]
  node_bootcamp_import["Bootcamp importer"]
end

subgraph group_platform["Platform services and models"]
  node_profile_api["Profile endpoint"]
  node_profile_service["Profile service"]
  node_learning_models["Learning and progress models"]
  node_postgres[("PostgreSQL database")]
end

node_user(("Learner"))

node_user -->|"requests discovery"| node_discovery_api
node_discovery_api -->|"delegates to"| node_domain_service
node_user -->|"requests journey"| node_journey_api
node_journey_api -->|"delegates to"| node_journey_service
node_user -->|"requests tracks"| node_track_api
node_track_api -->|"delegates to"| node_track_service
node_user -->|"submits work"| node_lab_api
node_lab_api -->|"delegates to"| node_lab_service
node_lab_api -->|"requests grading"| node_grading
node_user -->|"requests progress"| node_progress_api
node_progress_api -->|"delegates to"| node_progress_service
node_user -->|"submits import"| node_import_api
node_import_api -->|"delegates to"| node_track_import
node_import_api -->|"delegates to"| node_bootcamp_import
node_user -->|"requests bootcamp"| node_bootcamp_api
node_bootcamp_api -->|"delegates to"| node_bootcamp_service
node_user -->|"requests profile"| node_profile_api
node_profile_api -->|"delegates to"| node_profile_service
node_track_service -->|"queries models"| node_learning_models
node_progress_service -->|"updates progress"| node_learning_models
node_grading -->|"persists submissions"| node_learning_models
node_bootcamp_service -->|"manages enrollment"| node_learning_models
node_learning_models -.->|"ORM persistence"| node_postgres

click node_discovery_api "https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/controller/DomainController.java"
click node_domain_service "https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/DomainService.java"
click node_journey_api "https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/controller/JourneyController.java"
click node_journey_service "https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/JourneyService.java"
click node_track_api "https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/controller/LearningTrackController.java"
click node_track_service "https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/LearningTrackService.java"
click node_lab_api "https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/controller/LabController.java"
click node_lab_service "https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/LabService.java"
click node_grading "https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/AutoGradingService.java"
click node_progress_api "https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/controller/TrackProgressController.java"
click node_progress_service "https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/TrackProgressService.java"
click node_import_api "https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/controller/ImportController.java"
click node_track_import "https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/ImportTrackService.java"
click node_bootcamp_api "https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/controller/BootcampController.java"
click node_bootcamp_service "https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/BootcampService.java"
click node_bootcamp_import "https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/ImportBootcampService.java"
click node_profile_api "https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/controller/UserProfileController.java"
click node_profile_service "https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/UserProfileService.java"
click node_learning_models "https://github.com/we-are-nextgen/api/tree/main/src/main/java/org/nextgen/model"

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_discovery_api,node_domain_service,node_journey_api,node_journey_service toneBlue
class node_track_api,node_track_service,node_lab_api,node_lab_service,node_grading,node_progress_api,node_progress_service,node_import_api,node_track_import toneAmber
class node_bootcamp_api,node_bootcamp_service,node_bootcamp_import toneMint
class node_profile_api,node_profile_service,node_learning_models,node_postgres toneRose
class node_user toneIndigo
```

## Components

### Learning discovery

- [Discovery endpoints](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/controller/DomainController.java): `src/main/java/org/nextgen/controller/DomainController.java`
- [Domain service](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/DomainService.java): `src/main/java/org/nextgen/service/DomainService.java`
- [Journey endpoint](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/controller/JourneyController.java): `src/main/java/org/nextgen/controller/JourneyController.java`
- [Journey service](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/JourneyService.java): `src/main/java/org/nextgen/service/JourneyService.java`

### Tracks and labs

- [Track endpoints](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/controller/LearningTrackController.java): `src/main/java/org/nextgen/controller/LearningTrackController.java`
- [Track service](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/LearningTrackService.java): `src/main/java/org/nextgen/service/LearningTrackService.java`
- [Lab submissions](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/controller/LabController.java): `src/main/java/org/nextgen/controller/LabController.java`
- [Lab service](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/LabService.java): `src/main/java/org/nextgen/service/LabService.java`
- [Auto grading](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/AutoGradingService.java): `src/main/java/org/nextgen/service/AutoGradingService.java`
- [Track progress endpoint](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/controller/TrackProgressController.java): `src/main/java/org/nextgen/controller/TrackProgressController.java`
- [Track progress service](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/TrackProgressService.java): `src/main/java/org/nextgen/service/TrackProgressService.java`
- [Import endpoint](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/controller/ImportController.java): `src/main/java/org/nextgen/controller/ImportController.java`
- [Track importer](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/ImportTrackService.java): `src/main/java/org/nextgen/service/ImportTrackService.java`

### Bootcamp programs

- [Bootcamp endpoints](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/controller/BootcampController.java): `src/main/java/org/nextgen/controller/BootcampController.java`
- [Bootcamp service](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/BootcampService.java): `src/main/java/org/nextgen/service/BootcampService.java`
- [Bootcamp importer](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/ImportBootcampService.java): `src/main/java/org/nextgen/service/ImportBootcampService.java`

### Platform services and models

- [Profile endpoint](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/controller/UserProfileController.java): `src/main/java/org/nextgen/controller/UserProfileController.java`
- [Profile service](https://github.com/we-are-nextgen/api/blob/main/src/main/java/org/nextgen/service/UserProfileService.java): `src/main/java/org/nextgen/service/UserProfileService.java`
- [Learning and progress models](https://github.com/we-are-nextgen/api/tree/main/src/main/java/org/nextgen/model): `src/main/java/org/nextgen/model`
- **PostgreSQL database**

### Other components

- **Learner**

## Connections

- Learner → Discovery endpoints: requests discovery
- Discovery endpoints → Domain service: delegates to (evidence: `src/main/java/org/nextgen/controller/DomainController.java`)
- Learner → Journey endpoint: requests journey
- Journey endpoint → Journey service: delegates to (evidence: `src/main/java/org/nextgen/controller/JourneyController.java`)
- Learner → Track endpoints: requests tracks
- Track endpoints → Track service: delegates to (evidence: `src/main/java/org/nextgen/controller/LearningTrackController.java`)
- Learner → Lab submissions: submits work
- Lab submissions → Lab service: delegates to (evidence: `src/main/java/org/nextgen/controller/LabController.java`)
- Lab submissions → Auto grading: requests grading (evidence: `src/main/java/org/nextgen/controller/LabController.java`)
- Learner → Track progress endpoint: requests progress
- Track progress endpoint → Track progress service: delegates to (evidence: `src/main/java/org/nextgen/controller/TrackProgressController.java`)
- Learner → Import endpoint: submits import
- Import endpoint → Track importer: delegates to (evidence: `src/main/java/org/nextgen/controller/ImportController.java`)
- Import endpoint → Bootcamp importer: delegates to (evidence: `src/main/java/org/nextgen/controller/ImportController.java`)
- Learner → Bootcamp endpoints: requests bootcamp
- Bootcamp endpoints → Bootcamp service: delegates to (evidence: `src/main/java/org/nextgen/controller/BootcampController.java`)
- Learner → Profile endpoint: requests profile
- Profile endpoint → Profile service: delegates to (evidence: `src/main/java/org/nextgen/controller/UserProfileController.java`)
- Track service → Learning and progress models: queries models (evidence: `src/main/java/org/nextgen/service/LearningTrackService.java`)
- Track progress service → Learning and progress models: updates progress (evidence: `src/main/java/org/nextgen/service/TrackProgressService.java`)
- Auto grading → Learning and progress models: persists submissions (evidence: `src/main/java/org/nextgen/service/AutoGradingService.java`)
- Bootcamp service → Learning and progress models: manages enrollment (evidence: `src/main/java/org/nextgen/service/BootcampService.java`)
- Learning and progress models → PostgreSQL database: ORM persistence
