# mariadiazcardoso/nexum architecture

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

- Interactive diagram: https://gitdiagram.com/mariadiazcardoso/nexum
- Repository: https://github.com/mariadiazcardoso/nexum

## Overview

NEXUM is a web learning platform: learners browse courses, register and verify an account, enroll, study lessons, complete evaluations, track progress, and earn certificates. Angular provides the user-facing routes; a Spring Boot API handles domain operations and PostgreSQL persists application data. The README documents this main workflow and also notes email verification, administration, and that real payments and AI remain pending. Several subsystems are represented by their exact source directories because their implementation was not sampled; dashed links mark unverified integration points.

Main entry points: [`NEXUM-frontend/src/app/app.routes.ts`](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-frontend/src/app/app.routes.ts) (Pages and routes), [`NEXUM-backend/src/main/java/com/nexum/service/EvaluacionService.java`](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-backend/src/main/java/com/nexum/service/EvaluacionService.java) (Evaluations), [`NEXUM-frontend/src/app/app.ts`](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-frontend/src/app/app.ts) (Angular application), [`NEXUM-frontend/src/app/pages/lesson/lesson.page.ts`](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-frontend/src/app/pages/lesson/lesson.page.ts) (Lesson experience)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_webapp["Angular application<br/>[app.ts]"]
  node_routes["Pages and routes<br/>[app.routes.ts]"]
  node_catalog["Course catalog<br/>[catalog.page.ts]"]
  node_course_detail["Course details"]
  node_checkout["Enrollment checkout<br/>[checkout.page.ts]"]
  node_lesson_ui["Lesson experience<br/>[lesson.page.ts]"]
end

subgraph group_identity["Identity and access"]
  node_auth_ui["Sign-in and registration<br/>[auth.service.ts]"]
  node_auth_api["Authentication API"]
  node_email["Email verification"]
  node_access["Access and authorization<br/>[AccesoService.java]"]
end

subgraph group_learning["Learning domain"]
  node_course_domain["Course management"]
  node_enrollment["Enrollment"]
  node_lesson_domain["Lessons and resources"]
  node_evaluation["Evaluations"]
end

subgraph group_engagement["Learner outcomes"]
  node_progress["Progress tracking"]
  node_certificates["Certificates"]
end

subgraph group_platform["API and persistence"]
  node_api["Spring REST API"]
  node_db[("PostgreSQL")]
  node_user_data["User persistence"]
end

node_learner(("Learner or admin"))

node_learner -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_routes
node_routes -->|"opens"| node_catalog
node_routes -->|"opens"| node_course_detail
node_routes -->|"opens"| node_checkout
node_routes -->|"opens"| node_lesson_ui
node_learner -->|"registers or signs in"| node_auth_ui
node_auth_ui -.->|"requests authentication"| node_auth_api
node_auth_api -.->|"sends verification"| node_email
node_webapp -.->|"calls API"| node_api
node_api -->|"reads and writes"| node_db
node_course_detail -.->|"starts enrollment"| node_enrollment
node_checkout -.->|"submits enrollment"| node_enrollment
node_lesson_ui -.->|"loads lesson"| node_lesson_domain
node_lesson_ui -.->|"submits answers"| node_evaluation
node_evaluation -.->|"records outcome"| node_progress
node_evaluation -->|"loads learner"| node_user_data
node_evaluation -.->|"persists attempts"| node_db
node_learner -->|"views certificates"| node_certificates
node_lesson_domain -->|"checks lesson owner"| node_user_data

click node_webapp "https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-frontend/src/app/app.ts"
click node_routes "https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-frontend/src/app/app.routes.ts"
click node_catalog "https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-frontend/src/app/pages/catalog/catalog.page.ts"
click node_course_detail "https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-frontend/src/app/pages/course-detail/course-detail.page.ts"
click node_checkout "https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-frontend/src/app/pages/checkout/checkout.page.ts"
click node_lesson_ui "https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-frontend/src/app/pages/lesson/lesson.page.ts"
click node_auth_ui "https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-frontend/src/app/core/auth.service.ts"
click node_auth_api "https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-backend/src/main/java/com/nexum/controller/AuthController.java"
click node_email "https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-backend/src/main/java/com/nexum/service/CorreoVerificacionService.java"
click node_access "https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-backend/src/main/java/com/nexum/service/AccesoService.java"
click node_course_domain "https://github.com/mariadiazcardoso/nexum/tree/main/NEXUM-backend/src/main/java/com/nexum/service"
click node_enrollment "https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-backend/src/main/java/com/nexum/service/InscripcionService.java"
click node_lesson_domain "https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-backend/src/main/java/com/nexum/controller/ArchivoLeccionController.java"
click node_evaluation "https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-backend/src/main/java/com/nexum/service/EvaluacionService.java"
click node_progress "https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-backend/src/main/java/com/nexum/service/ProgresoLeccionService.java"
click node_certificates "https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-backend/src/main/java/com/nexum/service/CertificadoService.java"
click node_api "https://github.com/mariadiazcardoso/nexum/tree/main/NEXUM-backend/src/main/java/com/nexum/controller"
click node_user_data "https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-backend/src/main/java/com/nexum/repository/UsuarioRepository.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_webapp,node_routes,node_catalog,node_course_detail,node_checkout,node_lesson_ui toneBlue
class node_auth_ui,node_auth_api,node_email,node_access toneAmber
class node_course_domain,node_enrollment,node_lesson_domain,node_evaluation toneMint
class node_progress,node_certificates toneRose
class node_api,node_db,node_user_data,node_learner toneIndigo
```

## Components

### Web application

- [Angular application](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-frontend/src/app/app.ts): `NEXUM-frontend/src/app/app.ts`
- [Pages and routes](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-frontend/src/app/app.routes.ts): `NEXUM-frontend/src/app/app.routes.ts`
- [Course catalog](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-frontend/src/app/pages/catalog/catalog.page.ts): `NEXUM-frontend/src/app/pages/catalog/catalog.page.ts`
- [Course details](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-frontend/src/app/pages/course-detail/course-detail.page.ts): `NEXUM-frontend/src/app/pages/course-detail/course-detail.page.ts`
- [Enrollment checkout](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-frontend/src/app/pages/checkout/checkout.page.ts): `NEXUM-frontend/src/app/pages/checkout/checkout.page.ts`
- [Lesson experience](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-frontend/src/app/pages/lesson/lesson.page.ts): `NEXUM-frontend/src/app/pages/lesson/lesson.page.ts`

### Identity and access

- [Sign-in and registration](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-frontend/src/app/core/auth.service.ts): `NEXUM-frontend/src/app/core/auth.service.ts`
- [Authentication API](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-backend/src/main/java/com/nexum/controller/AuthController.java): `NEXUM-backend/src/main/java/com/nexum/controller/AuthController.java`
- [Email verification](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-backend/src/main/java/com/nexum/service/CorreoVerificacionService.java): `NEXUM-backend/src/main/java/com/nexum/service/CorreoVerificacionService.java`
- [Access and authorization](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-backend/src/main/java/com/nexum/service/AccesoService.java): `NEXUM-backend/src/main/java/com/nexum/service/AccesoService.java`

### Learning domain

- [Course management](https://github.com/mariadiazcardoso/nexum/tree/main/NEXUM-backend/src/main/java/com/nexum/service): `NEXUM-backend/src/main/java/com/nexum/service`
- [Enrollment](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-backend/src/main/java/com/nexum/service/InscripcionService.java): `NEXUM-backend/src/main/java/com/nexum/service/InscripcionService.java`
- [Lessons and resources](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-backend/src/main/java/com/nexum/controller/ArchivoLeccionController.java): `NEXUM-backend/src/main/java/com/nexum/controller/ArchivoLeccionController.java`
- [Evaluations](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-backend/src/main/java/com/nexum/service/EvaluacionService.java): `NEXUM-backend/src/main/java/com/nexum/service/EvaluacionService.java`

### Learner outcomes

- [Progress tracking](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-backend/src/main/java/com/nexum/service/ProgresoLeccionService.java): `NEXUM-backend/src/main/java/com/nexum/service/ProgresoLeccionService.java`
- [Certificates](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-backend/src/main/java/com/nexum/service/CertificadoService.java): `NEXUM-backend/src/main/java/com/nexum/service/CertificadoService.java`

### API and persistence

- [Spring REST API](https://github.com/mariadiazcardoso/nexum/tree/main/NEXUM-backend/src/main/java/com/nexum/controller): `NEXUM-backend/src/main/java/com/nexum/controller`
- **PostgreSQL**
- [User persistence](https://github.com/mariadiazcardoso/nexum/blob/main/NEXUM-backend/src/main/java/com/nexum/repository/UsuarioRepository.java): `NEXUM-backend/src/main/java/com/nexum/repository/UsuarioRepository.java`

### Other components

- **Learner or admin**

## Connections

- Learner or admin → Angular application: uses (evidence: `README.md`)
- Angular application → Pages and routes: routes to (evidence: `NEXUM-frontend/src/app/app.routes.ts`)
- Pages and routes → Course catalog: opens (evidence: `NEXUM-frontend/src/app/app.routes.ts`)
- Pages and routes → Course details: opens (evidence: `NEXUM-frontend/src/app/app.routes.ts`)
- Pages and routes → Enrollment checkout: opens (evidence: `NEXUM-frontend/src/app/app.routes.ts`)
- Pages and routes → Lesson experience: opens (evidence: `NEXUM-frontend/src/app/app.routes.ts`)
- Learner or admin → Sign-in and registration: registers or signs in (evidence: `README.md`)
- Sign-in and registration → Authentication API: requests authentication
- Authentication API → Email verification: sends verification
- Angular application → Spring REST API: calls API
- Spring REST API → PostgreSQL: reads and writes (evidence: `README.md`)
- Course details → Enrollment: starts enrollment
- Enrollment checkout → Enrollment: submits enrollment
- Lesson experience → Lessons and resources: loads lesson
- Lesson experience → Evaluations: submits answers
- Evaluations → Progress tracking: records outcome
- Evaluations → User persistence: loads learner (evidence: `NEXUM-backend/src/main/java/com/nexum/service/EvaluacionService.java`)
- Evaluations → PostgreSQL: persists attempts
- Learner or admin → Certificates: views certificates (evidence: `README.md`)
- Lessons and resources → User persistence: checks lesson owner (evidence: `NEXUM-backend/src/main/java/com/nexum/controller/ArchivoLeccionController.java`)
