How jayrousjr/backend-with-nestjs works
This is a NestJS backend template exposing GraphQL and REST APIs. The main user workflow spans account registration and verification, authentication/session management, then protected user and role operations; additional product branches cover content and SEO, newsletter/campaign delivery, files, notifications, and visitor analytics. Services mediate between API handlers and persistence or integrations. The source excerpts support several service-level calls; other capabilities and connections below are included only where documented by the README or SOURCE INDEX. Some subsystems are represented at their directory path because their implementation was not sampled.
Main entry points: auth.service.ts Auth workflows · users.service.ts User management · storage.service.ts File operations · mail.service.ts Mail queueing
Components 23
Identity & access
- Auth endpoints
src/auth/auth.controller.ts - Auth workflows
src/auth/auth.service.ts - Google OAuth
src/auth/google-oauth.service.ts - Session records
src/auth/session.repository.ts
Content & outreach
- Post management
src/content/content.service.ts - Post records
src/content/post.repository.ts - SEO redirects
src/seo/seo.service.ts - Newsletter subscriptions
src/newsletter/newsletter.service.ts - Campaign management
src/campaigns/campaigns.service.ts
User administration
- User management
src/users/users.service.ts - User records
src/users/user.repository.ts - Role management
src/roles/roles.service.ts - Permission checks
src/permissions/permissions.service.ts
Platform services
- Mail queueing
src/mail/mail.service.ts - File endpoints
src/storage/storage.controller.ts - File operations
src/storage/storage.service.ts - File records
src/storage/storage.repository.ts - Health endpoint
src/health/health.controller.ts - Prisma database access
src/prisma/prisma.service.ts
Events & analytics
- Notifications
src/notifications/notifications.service.ts - Live event gateway
src/events/events.gateway.ts - Visitor analytics
src/visitors
Other components
- API client
Connections 30
- API client → Auth endpoints: registers or logs in
- Auth endpoints → Auth workflows: delegates auth
src/auth/auth.controller.ts - Auth endpoints → Google OAuth: starts OAuth
src/auth/auth.controller.ts - Auth workflows → User records: looks up users
src/auth/auth.service.ts - Auth workflows → Session records: manages sessions
src/auth/auth.service.ts - Auth workflows → Mail queueing: queues auth mail
src/auth/auth.service.ts - Auth workflows → Notifications: notifies users
src/auth/auth.service.ts - User management → User records: reads and updates
src/users/users.service.ts - User management → Permission checks: resolves permissions
src/users/users.service.ts - User management → File operations: manages avatars
src/users/users.service.ts - API client → User management: manages profiles
- API client → Role management: manages roles
- API client → Post management: manages posts
- Post management → Post records: queries posts
src/content/content.service.ts - Post management → SEO redirects: uses redirects
src/content/content.service.ts - SEO redirects → Post records: checks post URLs
src/seo/seo.service.ts - API client → Newsletter subscriptions: subscribes
- Newsletter subscriptions → Mail queueing: queues confirmations
src/newsletter/newsletter.service.ts - API client → Campaign management: administers campaigns
- Campaign management → Mail queueing: queues campaign mail
src/campaigns/campaigns.service.ts - Campaign management → Notifications: notifies creator
src/campaigns/campaigns.service.ts - API client → File endpoints: uploads files
src/storage/storage.controller.ts - File endpoints → File operations: delegates uploads
src/storage/storage.controller.ts - File operations → File records: stores metadata
src/storage/storage.service.ts - File operations → Prisma database access: uses Prisma
- Notifications → Live event gateway: emits notifications
src/notifications/notifications.service.ts - API client → Visitor analytics: tracks page views
- API client → Health endpoint: checks health
- API client → Prisma database access: persists domain data
- Mail queueing → API client: delivers email