How benavidesandres/skill_vibe_backend works
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: app.module.ts Application modules · users.service.ts User management · auth.service.ts Auth service · bookings.service.ts Booking workflow
Components 24
API and setup
- API bootstrap
src/main.ts - Application modules
src/app.module.ts - Database config
src/config/database.config.ts - PostgreSQL
Identity and users
- Auth endpoints
src/modules/auth/auth.controller.ts - Auth service
src/modules/auth/auth.service.ts - User endpoints
src/modules/users/users.controller.ts - User management
src/modules/users/users.service.ts - User record
src/modules/users/entities/user.entity.ts
Tutoring marketplace
- Offer endpoints
src/modules/skills/skills.controller.ts - Tutor profiles
src/modules/skills/tutors.controller.ts - Offer catalog
src/modules/skills/skills.service.ts - Tutoring offer
src/modules/skills/entities/skill.entity.ts
Bookings and reviews
- Booking endpoints
src/modules/bookings/bookings.controller.ts - Booking workflow
src/modules/bookings/bookings.service.ts - Booking record
src/modules/bookings/entities/booking.entity.ts - Review endpoints
src/modules/reviews/reviews.controller.ts - Review service
src/modules/reviews/reviews.service.ts - Review record
src/modules/reviews/entities/review.entity.ts
Recommendations and video
- Recommendation endpoint
src/modules/recommendations/recommendations.controller.ts - Recommendation service
src/modules/recommendations/recommendations.service.ts - Video room provider
src/modules/video/video-room.provider.ts - Simulated room
src/modules/video/simulated-video-room.provider.ts
Other components
- API client
Connections 27
- API client → API bootstrap: sends requests
- API bootstrap → Application modules: starts
src/main.ts - Application modules → Database config: configures
src/app.module.ts - Database config → PostgreSQL: connects
- Application modules → Auth endpoints: registers module
src/app.module.ts - Application modules → User endpoints: registers module
src/app.module.ts - Application modules → Offer endpoints: registers module
src/app.module.ts - Application modules → Booking endpoints: registers module
src/app.module.ts - Application modules → Review endpoints: registers module
src/app.module.ts - Application modules → Recommendation endpoint: registers module
src/app.module.ts - Auth endpoints → Auth service: delegates to
src/modules/auth/auth.controller.ts - Auth service → User management: uses
src/modules/auth/auth.service.ts - User endpoints → User management: delegates to
src/modules/users/users.controller.ts - Offer endpoints → Offer catalog: delegates to
src/modules/skills/skills.controller.ts - Tutor profiles → Offer catalog: queries offers
src/modules/skills/tutors.controller.ts - Tutor profiles → User management: queries users
src/modules/skills/tutors.controller.ts - Booking endpoints → Booking workflow: delegates to
src/modules/bookings/bookings.controller.ts - Booking workflow → Video room provider: requests room
src/modules/bookings/bookings.service.ts - Review endpoints → Review service: delegates to
src/modules/reviews/reviews.controller.ts - Review service → Tutoring offer: updates rating
src/modules/reviews/reviews.service.ts - Review service → Review record: creates and queries
src/modules/reviews/reviews.service.ts - Recommendation endpoint → Recommendation service: delegates to
src/modules/recommendations/recommendations.controller.ts - Simulated room → Video room provider: implements provider
src/modules/video/simulated-video-room.provider.ts - Auth service → User record: uses
src/modules/auth/auth.service.ts - User management → User record: persists users
src/modules/users/users.service.ts - Offer catalog → Tutoring offer: manages offers
src/modules/skills/skills.service.ts - Booking workflow → Booking record: manages bookings
src/modules/bookings/bookings.service.ts