# anupdudhe/cdec-alpha-app architecture

> Architecture diagram of the GitHub repository anupdudhe/cdec-alpha-app, 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/anupdudhe/cdec-alpha-app
- Repository: https://github.com/anupdudhe/cdec-alpha-app

## Overview

CloudBlitz is a course-enrollment platform: users register or log in, browse a course catalog, enroll, and view their enrollments. The React SPA centralizes authentication and service calls; three Spring services handle identity, course catalog operations, and enrollment persistence. The README documents MongoDB Atlas and API routing. One notable implementation caveat: the enrollment GET controller currently returns an empty list, and its JWT validation is commented out; enrollment creation does validate a token. Unsampled modules are represented only where the tree and README establish their capabilities.

Main entry points: [`application/frontend/src/utils/api.ts`](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/frontend/src/utils/api.ts) (API clients), [`application/frontend/src/App.tsx`](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/frontend/src/App.tsx) (Application shell), [`application/backend/auth-service/src/main/java/in/cloudblitz/auth/service/AuthService.java`](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/auth-service/src/main/java/in/cloudblitz/auth/service/AuthService.java) (Identity logic), [`application/backend/auth-service/src/main/java/in/cloudblitz/auth/controller/AuthController.java`](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/auth-service/src/main/java/in/cloudblitz/auth/controller/AuthController.java) (Auth endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["React application"]
  node_app["Application shell<br/>[App.tsx]"]
  node_authui["Login and registration<br/>[LoginForm.tsx]"]
  node_authstate["Auth context<br/>[AuthContext.tsx]"]
  node_catalogui["Course browser<br/>[CourseList.tsx]"]
  node_enrollui["Enrollment view"]
  node_apiclient["API clients<br/>[api.ts]"]
end

subgraph group_identity["Identity service"]
  node_authapi["Auth endpoints"]
  node_authlogic["Identity logic<br/>[AuthService.java]"]
  node_jwt["JWT utilities<br/>[JwtUtil.java]"]
  node_userrepo["User repository"]
  node_usermodel["User records<br/>[User.java]"]
  node_authdto["Auth DTOs"]
end

subgraph group_catalog["Course catalog"]
  node_courseapi["Course endpoints"]
  node_courselogic["Catalog operations<br/>[CourseService.java]"]
  node_courserepo["Course repository"]
  node_coursemodel["Course records<br/>[Course.java]"]
  node_coursedto["Course request<br/>[CourseRequest.java]"]
end

subgraph group_enrollment["Enrollment service"]
  node_enrollapi["Enrollment endpoints"]
  node_enrolllogic["Enrollment logic"]
  node_enrollrepo["Enrollment repository"]
  node_enrollmodel["Enrollment records"]
  node_enrolldto["Enrollment request"]
end

subgraph group_data["Persistence"]
  node_mongo[("MongoDB Atlas")]
end

node_user(("Learner"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_authui
node_app -->|"renders"| node_catalogui
node_app -->|"renders"| node_enrollui
node_authui -->|"uses"| node_authstate
node_authstate -->|"calls"| node_apiclient
node_catalogui -->|"calls"| node_apiclient
node_enrollui -->|"calls"| node_apiclient
node_apiclient -->|"sends REST"| node_authapi
node_apiclient -->|"sends REST"| node_courseapi
node_apiclient -->|"sends REST"| node_enrollapi
node_authapi -->|"delegates to"| node_authlogic
node_authapi -->|"validates with"| node_jwt
node_authlogic -->|"reads and saves"| node_userrepo
node_authlogic -->|"issues tokens"| node_jwt
node_userrepo -->|"stores"| node_usermodel
node_courseapi -->|"delegates to"| node_courselogic
node_courselogic -->|"operates on"| node_courserepo
node_courserepo -->|"stores"| node_coursemodel
node_enrollapi -->|"delegates to"| node_enrolllogic
node_enrollapi -->|"validates token"| node_jwt
node_enrolllogic -->|"checks and saves"| node_enrollrepo
node_enrollrepo -->|"stores"| node_enrollmodel
node_authlogic -->|"persists users"| node_mongo
node_courselogic -->|"persists courses"| node_mongo
node_enrolllogic -->|"persists enrollments"| node_mongo

click node_app "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/frontend/src/App.tsx"
click node_authui "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/frontend/src/components/LoginForm.tsx"
click node_authstate "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/frontend/src/contexts/AuthContext.tsx"
click node_catalogui "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/frontend/src/components/CourseList.tsx"
click node_enrollui "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/frontend/src/components/EnrollmentsTable.tsx"
click node_apiclient "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/frontend/src/utils/api.ts"
click node_authapi "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/auth-service/src/main/java/in/cloudblitz/auth/controller/AuthController.java"
click node_authlogic "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/auth-service/src/main/java/in/cloudblitz/auth/service/AuthService.java"
click node_jwt "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/auth-service/src/main/java/in/cloudblitz/auth/util/JwtUtil.java"
click node_userrepo "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/auth-service/src/main/java/in/cloudblitz/auth/repository/UserRepository.java"
click node_usermodel "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/auth-service/src/main/java/in/cloudblitz/auth/entity/User.java"
click node_authdto "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/auth-service/src/main/java/in/cloudblitz/auth/dto/RegisterRequest.java"
click node_courseapi "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/course-service/src/main/java/in/cloudblitz/course/controller/CourseController.java"
click node_courselogic "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/course-service/src/main/java/in/cloudblitz/course/service/CourseService.java"
click node_courserepo "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/course-service/src/main/java/in/cloudblitz/course/repository/CourseRepository.java"
click node_coursemodel "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/course-service/src/main/java/in/cloudblitz/course/entity/Course.java"
click node_coursedto "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/course-service/src/main/java/in/cloudblitz/course/dto/CourseRequest.java"
click node_enrollapi "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/enrollment-service/src/main/java/in/cloudblitz/enrollment/controller/EnrollmentController.java"
click node_enrolllogic "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/enrollment-service/src/main/java/in/cloudblitz/enrollment/service/EnrollmentService.java"
click node_enrollrepo "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/enrollment-service/src/main/java/in/cloudblitz/enrollment/repository/EnrollmentRepository.java"
click node_enrolldto "https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/enrollment-service/src/main/java/in/cloudblitz/enrollment/dto/EnrollmentRequest.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_app,node_authui,node_authstate,node_catalogui,node_enrollui,node_apiclient toneBlue
class node_authapi,node_authlogic,node_jwt,node_userrepo,node_usermodel,node_authdto toneAmber
class node_courseapi,node_courselogic,node_courserepo,node_coursemodel,node_coursedto toneMint
class node_enrollapi,node_enrolllogic,node_enrollrepo,node_enrollmodel,node_enrolldto toneRose
class node_mongo,node_user toneIndigo
```

## Components

### React application

- [Application shell](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/frontend/src/App.tsx): `application/frontend/src/App.tsx`
- [Login and registration](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/frontend/src/components/LoginForm.tsx): `application/frontend/src/components/LoginForm.tsx`
- [Auth context](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/frontend/src/contexts/AuthContext.tsx): `application/frontend/src/contexts/AuthContext.tsx`
- [Course browser](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/frontend/src/components/CourseList.tsx): `application/frontend/src/components/CourseList.tsx`
- [Enrollment view](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/frontend/src/components/EnrollmentsTable.tsx): `application/frontend/src/components/EnrollmentsTable.tsx`
- [API clients](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/frontend/src/utils/api.ts): `application/frontend/src/utils/api.ts`

### Identity service

- [Auth endpoints](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/auth-service/src/main/java/in/cloudblitz/auth/controller/AuthController.java): `application/backend/auth-service/src/main/java/in/cloudblitz/auth/controller/AuthController.java`
- [Identity logic](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/auth-service/src/main/java/in/cloudblitz/auth/service/AuthService.java): `application/backend/auth-service/src/main/java/in/cloudblitz/auth/service/AuthService.java`
- [JWT utilities](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/auth-service/src/main/java/in/cloudblitz/auth/util/JwtUtil.java): `application/backend/auth-service/src/main/java/in/cloudblitz/auth/util/JwtUtil.java`
- [User repository](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/auth-service/src/main/java/in/cloudblitz/auth/repository/UserRepository.java): `application/backend/auth-service/src/main/java/in/cloudblitz/auth/repository/UserRepository.java`
- [User records](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/auth-service/src/main/java/in/cloudblitz/auth/entity/User.java): `application/backend/auth-service/src/main/java/in/cloudblitz/auth/entity/User.java`
- [Auth DTOs](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/auth-service/src/main/java/in/cloudblitz/auth/dto/RegisterRequest.java): `application/backend/auth-service/src/main/java/in/cloudblitz/auth/dto/RegisterRequest.java`

### Course catalog

- [Course endpoints](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/course-service/src/main/java/in/cloudblitz/course/controller/CourseController.java): `application/backend/course-service/src/main/java/in/cloudblitz/course/controller/CourseController.java`
- [Catalog operations](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/course-service/src/main/java/in/cloudblitz/course/service/CourseService.java): `application/backend/course-service/src/main/java/in/cloudblitz/course/service/CourseService.java`
- [Course repository](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/course-service/src/main/java/in/cloudblitz/course/repository/CourseRepository.java): `application/backend/course-service/src/main/java/in/cloudblitz/course/repository/CourseRepository.java`
- [Course records](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/course-service/src/main/java/in/cloudblitz/course/entity/Course.java): `application/backend/course-service/src/main/java/in/cloudblitz/course/entity/Course.java`
- [Course request](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/course-service/src/main/java/in/cloudblitz/course/dto/CourseRequest.java): `application/backend/course-service/src/main/java/in/cloudblitz/course/dto/CourseRequest.java`

### Enrollment service

- [Enrollment endpoints](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/enrollment-service/src/main/java/in/cloudblitz/enrollment/controller/EnrollmentController.java): `application/backend/enrollment-service/src/main/java/in/cloudblitz/enrollment/controller/EnrollmentController.java`
- [Enrollment logic](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/enrollment-service/src/main/java/in/cloudblitz/enrollment/service/EnrollmentService.java): `application/backend/enrollment-service/src/main/java/in/cloudblitz/enrollment/service/EnrollmentService.java`
- [Enrollment repository](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/enrollment-service/src/main/java/in/cloudblitz/enrollment/repository/EnrollmentRepository.java): `application/backend/enrollment-service/src/main/java/in/cloudblitz/enrollment/repository/EnrollmentRepository.java`
- **Enrollment records**
- [Enrollment request](https://github.com/anupdudhe/cdec-alpha-app/blob/main/application/backend/enrollment-service/src/main/java/in/cloudblitz/enrollment/dto/EnrollmentRequest.java): `application/backend/enrollment-service/src/main/java/in/cloudblitz/enrollment/dto/EnrollmentRequest.java`

### Persistence

- **MongoDB Atlas**

### Other components

- **Learner**

## Connections

- Learner → Application shell: uses (evidence: `README.md`)
- Application shell → Login and registration: renders (evidence: `application/frontend/src/App.tsx`)
- Application shell → Course browser: renders (evidence: `application/frontend/src/App.tsx`)
- Application shell → Enrollment view: renders (evidence: `application/frontend/src/App.tsx`)
- Login and registration → Auth context: uses (evidence: `application/frontend/src/components/LoginForm.tsx`)
- Auth context → API clients: calls (evidence: `application/frontend/src/contexts/AuthContext.tsx`)
- Course browser → API clients: calls (evidence: `application/frontend/src/components/CourseList.tsx`)
- Enrollment view → API clients: calls (evidence: `application/frontend/src/components/EnrollmentsTable.tsx`)
- API clients → Auth endpoints: sends REST (evidence: `README.md`)
- API clients → Course endpoints: sends REST (evidence: `README.md`)
- API clients → Enrollment endpoints: sends REST (evidence: `README.md`)
- Auth endpoints → Identity logic: delegates to (evidence: `application/backend/auth-service/src/main/java/in/cloudblitz/auth/controller/AuthController.java`)
- Auth endpoints → JWT utilities: validates with (evidence: `application/backend/auth-service/src/main/java/in/cloudblitz/auth/controller/AuthController.java`)
- Identity logic → User repository: reads and saves (evidence: `application/backend/auth-service/src/main/java/in/cloudblitz/auth/service/AuthService.java`)
- Identity logic → JWT utilities: issues tokens (evidence: `application/backend/auth-service/src/main/java/in/cloudblitz/auth/service/AuthService.java`)
- User repository → User records: stores (evidence: `application/backend/auth-service/src/main/java/in/cloudblitz/auth/repository/UserRepository.java`)
- Course endpoints → Catalog operations: delegates to (evidence: `application/backend/course-service/src/main/java/in/cloudblitz/course/controller/CourseController.java`)
- Catalog operations → Course repository: operates on (evidence: `application/backend/course-service/src/main/java/in/cloudblitz/course/service/CourseService.java`)
- Course repository → Course records: stores (evidence: `application/backend/course-service/src/main/java/in/cloudblitz/course/repository/CourseRepository.java`)
- Enrollment endpoints → Enrollment logic: delegates to (evidence: `application/backend/enrollment-service/src/main/java/in/cloudblitz/enrollment/controller/EnrollmentController.java`)
- Enrollment endpoints → JWT utilities: validates token (evidence: `application/backend/enrollment-service/src/main/java/in/cloudblitz/enrollment/controller/EnrollmentController.java`)
- Enrollment logic → Enrollment repository: checks and saves (evidence: `application/backend/enrollment-service/src/main/java/in/cloudblitz/enrollment/service/EnrollmentService.java`)
- Enrollment repository → Enrollment records: stores
- Identity logic → MongoDB Atlas: persists users (evidence: `README.md`)
- Catalog operations → MongoDB Atlas: persists courses (evidence: `README.md`)
- Enrollment logic → MongoDB Atlas: persists enrollments (evidence: `README.md`)
