# gustavoolsantos/skill-up architecture

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

- Interactive diagram: https://gitdiagram.com/gustavoolsantos/skill-up
- Repository: https://github.com/gustavoolsantos/skill-up

## Overview

Skill Up is a full-stack EAD platform: learners browse courses, authenticate, add courses to a cart and purchase them, then watch lessons with saved progress; the product also includes favorites, course reviews, certificates and course administration. React feature pages use a shared Axios client to reach the Spring REST API, whose controllers delegate business operations to services and repositories. The README documents MySQL for relational records, MongoDB for reviews and Cloudinary for images. Some backend capabilities are represented from documented features and the file tree; their internal wiring was not sampled, so those links are omitted.

Main entry points: [`frontend/src/services/api.js`](https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/services/api.js) (API client), [`frontend/src/app/routes/index.js`](https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/app/routes/index.js) (Route map), [`backend/src/main/java/com/plataforma/cursos/service/CursosService.java`](https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/service/CursosService.java) (Course rules), [`backend/src/main/java/com/plataforma/cursos/service/CarrinhoService.java`](https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/service/CarrinhoService.java) (Cart rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Learner interface"]
  node_routes["Route map<br/>[index.js]"]
  node_authpages["Sign-in and signup<br/>[index.js]"]
  node_usercontext["User context<br/>[user-context.js]"]
  node_apiclient["API client<br/>[api.js]"]
end

subgraph group_catalog["Course catalog"]
  node_catalogui["Browse courses<br/>[index.js]"]
  node_coursedetail["Course details<br/>[index.js]"]
  node_coursesapi["Course endpoints"]
  node_coursesservice["Course rules<br/>[CursosService.java]"]
  node_coursemodel["Course model<br/>[Cursos.java]"]
  node_courserepo["Course repository"]
end

subgraph group_learning["Learning and engagement"]
  node_reviews["Course reviews"]
  node_reviewstore["Review store"]
  node_player["Lesson player<br/>[index.js]"]
  node_progressapi["Progress endpoints"]
  node_progressservice["Progress rules"]
  node_progressrepo["Progress repository"]
  node_favorites["Favorites<br/>[index.js]"]
end

subgraph group_commerce["Commerce"]
  node_cartui["Shopping cart<br/>[index.js]"]
  node_cartapi["Cart endpoints"]
  node_cartservice["Cart rules"]
  node_purchase["Purchase endpoints"]
end

subgraph group_backend["API and identity"]
  node_authapi["Identity endpoints"]
  node_token["JWT handling<br/>[TokenService.java]"]
  node_userrepo["User repository"]
end

node_learner(("Learner"))
node_mysqldb[("MySQL")]
node_mongodb[("MongoDB")]
node_youtube(("YouTube"))
node_cloudinary(("Cloudinary"))

node_learner -->|"opens app"| node_routes
node_routes -->|"routes to"| node_authpages
node_routes -->|"routes to"| node_catalogui
node_routes -->|"routes to"| node_coursedetail
node_routes -->|"protects route"| node_player
node_authpages -->|"sends requests"| node_apiclient
node_usercontext -->|"loads user"| node_apiclient
node_catalogui -->|"fetches courses"| node_apiclient
node_coursedetail -.->|"loads details"| node_apiclient
node_cartui -.->|"uses API"| node_apiclient
node_player -.->|"saves progress"| node_apiclient
node_apiclient -.->|"calls REST API"| node_coursesapi
node_apiclient -.->|"calls REST API"| node_authapi
node_coursesapi -->|"delegates"| node_coursesservice
node_coursesservice -->|"queries courses"| node_courserepo
node_coursesservice -->|"loads summaries"| node_reviews
node_courserepo -.->|"persists"| node_coursemodel
node_reviews -.->|"reads reviews"| node_reviewstore
node_cartapi -->|"delegates"| node_cartservice
node_cartservice -->|"loads course"| node_courserepo
node_cartservice -->|"loads user"| node_userrepo
node_purchase -.->|"records purchase"| node_mysqldb
node_progressapi -->|"delegates"| node_progressservice
node_progressservice -->|"reads and saves"| node_progressrepo
node_authapi -.->|"issues JWT"| node_token
node_token -->|"uses user"| node_userrepo
node_mysqldb -.->|"stores records"| node_learner
node_mongodb -.->|"stores reviews"| node_reviewstore
node_youtube -.->|"provides video"| node_player
node_cloudinary -.->|"hosts images"| node_learner

click node_routes "https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/app/routes/index.js"
click node_authpages "https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/features/auth/login/index.js"
click node_usercontext "https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/app/providers/user-context.js"
click node_apiclient "https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/services/api.js"
click node_catalogui "https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/features/cursos/index.js"
click node_coursedetail "https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/features/cursos/cursoPage/index.js"
click node_coursesapi "https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/controller/CursosController.java"
click node_coursesservice "https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/service/CursosService.java"
click node_coursemodel "https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/domain/entities/Cursos.java"
click node_courserepo "https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/repository/CursosRepository.java"
click node_reviews "https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/service/AvaliacoesCursoService.java"
click node_reviewstore "https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/domain/documents/AvaliacoesCurso.java"
click node_player "https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/features/cursos/verCursoPage/index.js"
click node_progressapi "https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/controller/ProgressoAulaController.java"
click node_progressservice "https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/service/ProgressoAulaService.java"
click node_progressrepo "https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/repository/ProgressoAulaRepository.java"
click node_favorites "https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/features/cursos/favoritos/index.js"
click node_cartui "https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/features/cursos/carrinho/index.js"
click node_cartapi "https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/controller/CarrinhoController.java"
click node_cartservice "https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/service/CarrinhoService.java"
click node_purchase "https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/controller/CompraController.java"
click node_authapi "https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/controller/UserController.java"
click node_token "https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/security/service/TokenService.java"
click node_userrepo "https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/repository/UserRepository.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_routes,node_authpages,node_usercontext,node_apiclient toneBlue
class node_catalogui,node_coursedetail,node_coursesapi,node_coursesservice,node_coursemodel,node_courserepo,node_mysqldb,node_mongodb toneAmber
class node_reviews,node_reviewstore,node_player,node_progressapi,node_progressservice,node_progressrepo,node_favorites toneMint
class node_cartui,node_cartapi,node_cartservice,node_purchase toneRose
class node_authapi,node_token,node_userrepo,node_learner,node_youtube,node_cloudinary toneIndigo
```

## Components

### Learner interface

- [Route map](https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/app/routes/index.js): `frontend/src/app/routes/index.js`
- [Sign-in and signup](https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/features/auth/login/index.js): `frontend/src/features/auth/login/index.js`
- [User context](https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/app/providers/user-context.js): `frontend/src/app/providers/user-context.js`
- [API client](https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### Course catalog

- [Browse courses](https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/features/cursos/index.js): `frontend/src/features/cursos/index.js`
- [Course details](https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/features/cursos/cursoPage/index.js): `frontend/src/features/cursos/cursoPage/index.js`
- [Course endpoints](https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/controller/CursosController.java): `backend/src/main/java/com/plataforma/cursos/controller/CursosController.java`
- [Course rules](https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/service/CursosService.java): `backend/src/main/java/com/plataforma/cursos/service/CursosService.java`
- [Course model](https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/domain/entities/Cursos.java): `backend/src/main/java/com/plataforma/cursos/domain/entities/Cursos.java`
- [Course repository](https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/repository/CursosRepository.java): `backend/src/main/java/com/plataforma/cursos/repository/CursosRepository.java`

### Learning and engagement

- [Course reviews](https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/service/AvaliacoesCursoService.java): `backend/src/main/java/com/plataforma/cursos/service/AvaliacoesCursoService.java`
- [Review store](https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/domain/documents/AvaliacoesCurso.java): `backend/src/main/java/com/plataforma/cursos/domain/documents/AvaliacoesCurso.java`
- [Lesson player](https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/features/cursos/verCursoPage/index.js): `frontend/src/features/cursos/verCursoPage/index.js`
- [Progress endpoints](https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/controller/ProgressoAulaController.java): `backend/src/main/java/com/plataforma/cursos/controller/ProgressoAulaController.java`
- [Progress rules](https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/service/ProgressoAulaService.java): `backend/src/main/java/com/plataforma/cursos/service/ProgressoAulaService.java`
- [Progress repository](https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/repository/ProgressoAulaRepository.java): `backend/src/main/java/com/plataforma/cursos/repository/ProgressoAulaRepository.java`
- [Favorites](https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/features/cursos/favoritos/index.js): `frontend/src/features/cursos/favoritos/index.js`

### Commerce

- [Shopping cart](https://github.com/gustavoolsantos/skill-up/blob/main/frontend/src/features/cursos/carrinho/index.js): `frontend/src/features/cursos/carrinho/index.js`
- [Cart endpoints](https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/controller/CarrinhoController.java): `backend/src/main/java/com/plataforma/cursos/controller/CarrinhoController.java`
- [Cart rules](https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/service/CarrinhoService.java): `backend/src/main/java/com/plataforma/cursos/service/CarrinhoService.java`
- [Purchase endpoints](https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/controller/CompraController.java): `backend/src/main/java/com/plataforma/cursos/controller/CompraController.java`

### API and identity

- [Identity endpoints](https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/controller/UserController.java): `backend/src/main/java/com/plataforma/cursos/controller/UserController.java`
- [JWT handling](https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/security/service/TokenService.java): `backend/src/main/java/com/plataforma/cursos/security/service/TokenService.java`
- [User repository](https://github.com/gustavoolsantos/skill-up/blob/main/backend/src/main/java/com/plataforma/cursos/repository/UserRepository.java): `backend/src/main/java/com/plataforma/cursos/repository/UserRepository.java`

### Other components

- **Learner**
- **MySQL**
- **MongoDB**
- **YouTube**
- **Cloudinary**

## Connections

- Learner → Route map: opens app
- Route map → Sign-in and signup: routes to
- Route map → Browse courses: routes to
- Route map → Course details: routes to
- Route map → Lesson player: protects route
- Sign-in and signup → API client: sends requests
- User context → API client: loads user (evidence: `frontend/src/app/providers/user-context.js`)
- Browse courses → API client: fetches courses (evidence: `frontend/src/features/cursos/index.js`)
- Course details → API client: loads details (evidence: `frontend/src/features/cursos/cursoPage/index.js`)
- Shopping cart → API client: uses API
- Lesson player → API client: saves progress (evidence: `frontend/src/features/cursos/verCursoPage/index.js`)
- API client → Course endpoints: calls REST API
- API client → Identity endpoints: calls REST API
- Course endpoints → Course rules: delegates (evidence: `backend/src/main/java/com/plataforma/cursos/controller/CursosController.java`)
- Course rules → Course repository: queries courses (evidence: `backend/src/main/java/com/plataforma/cursos/service/CursosService.java`)
- Course rules → Course reviews: loads summaries (evidence: `backend/src/main/java/com/plataforma/cursos/service/CursosService.java`)
- Course repository → Course model: persists (evidence: `backend/src/main/java/com/plataforma/cursos/repository/CursosRepository.java`)
- Course reviews → Review store: reads reviews (evidence: `backend/src/main/java/com/plataforma/cursos/service/AvaliacoesCursoService.java`)
- Cart endpoints → Cart rules: delegates (evidence: `backend/src/main/java/com/plataforma/cursos/controller/CarrinhoController.java`)
- Cart rules → Course repository: loads course (evidence: `backend/src/main/java/com/plataforma/cursos/service/CarrinhoService.java`)
- Cart rules → User repository: loads user (evidence: `backend/src/main/java/com/plataforma/cursos/service/CarrinhoService.java`)
- Purchase endpoints → MySQL: records purchase
- Progress endpoints → Progress rules: delegates (evidence: `backend/src/main/java/com/plataforma/cursos/controller/ProgressoAulaController.java`)
- Progress rules → Progress repository: reads and saves (evidence: `backend/src/main/java/com/plataforma/cursos/service/ProgressoAulaService.java`)
- Identity endpoints → JWT handling: issues JWT
- JWT handling → User repository: uses user (evidence: `backend/src/main/java/com/plataforma/cursos/security/service/TokenService.java`)
- MySQL → Learner: stores records
- MongoDB → Review store: stores reviews
- YouTube → Lesson player: provides video
- Cloudinary → Learner: hosts images
