# benavidesandres/skill_vibe_backend architecture

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

- Interactive diagram: https://gitdiagram.com/benavidesandres/skill_vibe_backend
- Repository: https://github.com/benavidesandres/skill_vibe_backend

## Overview

SkillVibes is a NestJS API for a one-to-one tutoring marketplace. Students discover tutoring offers, book a session, and can review completed bookings; tutors publish and manage offers and handle bookings. Authentication and user management support protected actions, while recommendations are a separate advertised module. PostgreSQL persists marketplace data, and confirmed bookings use a video-room provider. The main workflow is documented in the README; recommendations behavior is not described in the available excerpt, so its internal links are limited to indexed references.

Main entry points: [`src/app.module.ts`](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/app.module.ts) (Application modules), [`src/modules/users/users.service.ts`](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/users/users.service.ts) (User management), [`src/modules/auth/auth.service.ts`](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/auth/auth.service.ts) (Auth service), [`src/modules/bookings/bookings.service.ts`](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/bookings/bookings.service.ts) (Booking workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and setup"]
  node_bootstrap["API bootstrap<br/>[main.ts]"]
  node_app["Application modules<br/>[app.module.ts]"]
  node_dbconfig["Database config<br/>[database.config.ts]"]
  node_postgres[("PostgreSQL")]
end

subgraph group_identity["Identity and users"]
  node_authapi["Auth endpoints<br/>[auth.controller.ts]"]
  node_authlogic["Auth service<br/>[auth.service.ts]"]
  node_usersapi["User endpoints"]
  node_userslogic["User management<br/>[users.service.ts]"]
  node_userrecord["User record<br/>[user.entity.ts]"]
end

subgraph group_marketplace["Tutoring marketplace"]
  node_skillsapi["Offer endpoints"]
  node_tutorsapi["Tutor profiles"]
  node_skillslogic["Offer catalog<br/>[skills.service.ts]"]
  node_skillrecord["Tutoring offer<br/>[skill.entity.ts]"]
end

subgraph group_sessions["Bookings and reviews"]
  node_bookingsapi["Booking endpoints"]
  node_bookingslogic["Booking workflow"]
  node_bookingrecord["Booking record<br/>[booking.entity.ts]"]
  node_reviewsapi["Review endpoints"]
  node_reviewslogic["Review service<br/>[reviews.service.ts]"]
  node_reviewrecord["Review record<br/>[review.entity.ts]"]
end

subgraph group_extensions["Recommendations and video"]
  node_recommendationsapi["Recommendation endpoint"]
  node_recommendationslogic["Recommendation service"]
  node_video["Video room provider"]
  node_simvideo["Simulated room"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_bootstrap
node_bootstrap -->|"starts"| node_app
node_app -->|"configures"| node_dbconfig
node_dbconfig -->|"connects"| node_postgres
node_app -->|"registers module"| node_authapi
node_app -->|"registers module"| node_usersapi
node_app -->|"registers module"| node_skillsapi
node_app -->|"registers module"| node_bookingsapi
node_app -->|"registers module"| node_reviewsapi
node_app -->|"registers module"| node_recommendationsapi
node_authapi -->|"delegates to"| node_authlogic
node_authlogic -->|"uses"| node_userslogic
node_usersapi -->|"delegates to"| node_userslogic
node_skillsapi -->|"delegates to"| node_skillslogic
node_tutorsapi -->|"queries offers"| node_skillslogic
node_tutorsapi -->|"queries users"| node_userslogic
node_bookingsapi -->|"delegates to"| node_bookingslogic
node_bookingslogic -->|"requests room"| node_video
node_reviewsapi -->|"delegates to"| node_reviewslogic
node_reviewslogic -->|"updates rating"| node_skillrecord
node_reviewslogic -->|"creates and queries"| node_reviewrecord
node_recommendationsapi -->|"delegates to"| node_recommendationslogic
node_simvideo -->|"implements provider"| node_video
node_authlogic -->|"uses"| node_userrecord
node_userslogic -->|"persists users"| node_userrecord
node_skillslogic -->|"manages offers"| node_skillrecord
node_bookingslogic -->|"manages bookings"| node_bookingrecord

click node_bootstrap "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/main.ts"
click node_app "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/app.module.ts"
click node_dbconfig "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/config/database.config.ts"
click node_authapi "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/auth/auth.controller.ts"
click node_authlogic "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/auth/auth.service.ts"
click node_usersapi "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/users/users.controller.ts"
click node_userslogic "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/users/users.service.ts"
click node_userrecord "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/users/entities/user.entity.ts"
click node_skillsapi "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/skills/skills.controller.ts"
click node_tutorsapi "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/skills/tutors.controller.ts"
click node_skillslogic "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/skills/skills.service.ts"
click node_skillrecord "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/skills/entities/skill.entity.ts"
click node_bookingsapi "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/bookings/bookings.controller.ts"
click node_bookingslogic "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/bookings/bookings.service.ts"
click node_bookingrecord "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/bookings/entities/booking.entity.ts"
click node_reviewsapi "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/reviews/reviews.controller.ts"
click node_reviewslogic "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/reviews/reviews.service.ts"
click node_reviewrecord "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/reviews/entities/review.entity.ts"
click node_recommendationsapi "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/recommendations/recommendations.controller.ts"
click node_recommendationslogic "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/recommendations/recommendations.service.ts"
click node_video "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/video/video-room.provider.ts"
click node_simvideo "https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/video/simulated-video-room.provider.ts"

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_bootstrap,node_app,node_dbconfig,node_postgres,node_client toneBlue
class node_authapi,node_authlogic,node_usersapi,node_userslogic,node_userrecord toneAmber
class node_skillsapi,node_tutorsapi,node_skillslogic,node_skillrecord toneMint
class node_bookingsapi,node_bookingslogic,node_bookingrecord,node_reviewsapi,node_reviewslogic,node_reviewrecord toneRose
class node_recommendationsapi,node_recommendationslogic,node_video,node_simvideo toneIndigo
```

## Components

### API and setup

- [API bootstrap](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/main.ts): `src/main.ts`
- [Application modules](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/app.module.ts): `src/app.module.ts`
- [Database config](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/config/database.config.ts): `src/config/database.config.ts`
- **PostgreSQL**

### Identity and users

- [Auth endpoints](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/auth/auth.controller.ts): `src/modules/auth/auth.controller.ts`
- [Auth service](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/auth/auth.service.ts): `src/modules/auth/auth.service.ts`
- [User endpoints](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/users/users.controller.ts): `src/modules/users/users.controller.ts`
- [User management](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/users/users.service.ts): `src/modules/users/users.service.ts`
- [User record](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/users/entities/user.entity.ts): `src/modules/users/entities/user.entity.ts`

### Tutoring marketplace

- [Offer endpoints](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/skills/skills.controller.ts): `src/modules/skills/skills.controller.ts`
- [Tutor profiles](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/skills/tutors.controller.ts): `src/modules/skills/tutors.controller.ts`
- [Offer catalog](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/skills/skills.service.ts): `src/modules/skills/skills.service.ts`
- [Tutoring offer](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/skills/entities/skill.entity.ts): `src/modules/skills/entities/skill.entity.ts`

### Bookings and reviews

- [Booking endpoints](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/bookings/bookings.controller.ts): `src/modules/bookings/bookings.controller.ts`
- [Booking workflow](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/bookings/bookings.service.ts): `src/modules/bookings/bookings.service.ts`
- [Booking record](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/bookings/entities/booking.entity.ts): `src/modules/bookings/entities/booking.entity.ts`
- [Review endpoints](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/reviews/reviews.controller.ts): `src/modules/reviews/reviews.controller.ts`
- [Review service](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/reviews/reviews.service.ts): `src/modules/reviews/reviews.service.ts`
- [Review record](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/reviews/entities/review.entity.ts): `src/modules/reviews/entities/review.entity.ts`

### Recommendations and video

- [Recommendation endpoint](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/recommendations/recommendations.controller.ts): `src/modules/recommendations/recommendations.controller.ts`
- [Recommendation service](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/recommendations/recommendations.service.ts): `src/modules/recommendations/recommendations.service.ts`
- [Video room provider](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/video/video-room.provider.ts): `src/modules/video/video-room.provider.ts`
- [Simulated room](https://github.com/benavidesandres/skill_vibe_backend/blob/develop/src/modules/video/simulated-video-room.provider.ts): `src/modules/video/simulated-video-room.provider.ts`

### Other components

- **API client**

## Connections

- API client → API bootstrap: sends requests
- API bootstrap → Application modules: starts (evidence: `src/main.ts`)
- Application modules → Database config: configures (evidence: `src/app.module.ts`)
- Database config → PostgreSQL: connects
- Application modules → Auth endpoints: registers module (evidence: `src/app.module.ts`)
- Application modules → User endpoints: registers module (evidence: `src/app.module.ts`)
- Application modules → Offer endpoints: registers module (evidence: `src/app.module.ts`)
- Application modules → Booking endpoints: registers module (evidence: `src/app.module.ts`)
- Application modules → Review endpoints: registers module (evidence: `src/app.module.ts`)
- Application modules → Recommendation endpoint: registers module (evidence: `src/app.module.ts`)
- Auth endpoints → Auth service: delegates to (evidence: `src/modules/auth/auth.controller.ts`)
- Auth service → User management: uses (evidence: `src/modules/auth/auth.service.ts`)
- User endpoints → User management: delegates to (evidence: `src/modules/users/users.controller.ts`)
- Offer endpoints → Offer catalog: delegates to (evidence: `src/modules/skills/skills.controller.ts`)
- Tutor profiles → Offer catalog: queries offers (evidence: `src/modules/skills/tutors.controller.ts`)
- Tutor profiles → User management: queries users (evidence: `src/modules/skills/tutors.controller.ts`)
- Booking endpoints → Booking workflow: delegates to (evidence: `src/modules/bookings/bookings.controller.ts`)
- Booking workflow → Video room provider: requests room (evidence: `src/modules/bookings/bookings.service.ts`)
- Review endpoints → Review service: delegates to (evidence: `src/modules/reviews/reviews.controller.ts`)
- Review service → Tutoring offer: updates rating (evidence: `src/modules/reviews/reviews.service.ts`)
- Review service → Review record: creates and queries (evidence: `src/modules/reviews/reviews.service.ts`)
- Recommendation endpoint → Recommendation service: delegates to (evidence: `src/modules/recommendations/recommendations.controller.ts`)
- Simulated room → Video room provider: implements provider (evidence: `src/modules/video/simulated-video-room.provider.ts`)
- Auth service → User record: uses (evidence: `src/modules/auth/auth.service.ts`)
- User management → User record: persists users (evidence: `src/modules/users/users.service.ts`)
- Offer catalog → Tutoring offer: manages offers (evidence: `src/modules/skills/skills.service.ts`)
- Booking workflow → Booking record: manages bookings (evidence: `src/modules/bookings/bookings.service.ts`)
