# pronoybanik/next.js-portfolio-backend architecture

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

- Interactive diagram: https://gitdiagram.com/pronoybanik/next.js-portfolio-backend
- Repository: https://github.com/pronoybanik/next.js-portfolio-backend

## Overview

This is a portfolio backend API: clients submit requests to the Express server, which dispatches them to feature routes and controllers; controllers call services or, for portfolio settings, the model directly. The domain workflows cover project, blog, portfolio-settings, contact, and user/auth operations. Services use Mongoose models for persistence; contact creation also invokes an email-sending helper. The excerpts show server registration and most controller/service calls. Route-to-controller wiring and some model/schema details are supported by the source index; the README is empty.

Main entry points: [`src/server.ts`](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/server.ts) (Express server), [`src/modules/projects/project.service.ts`](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/projects/project.service.ts) (Project service), [`src/modules/blogs/blog.service.ts`](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/blogs/blog.service.ts) (Blog service), [`src/modules/contact/contact.service.ts`](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/contact/contact.service.ts) (Contact service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["API runtime"]
  node_server["Express server<br/>[server.ts]"]
end

subgraph group_projects["Projects"]
  node_project_route["Project routes<br/>[project.route.ts]"]
  node_project_controller["Project controller"]
  node_project_service["Project service<br/>[project.service.ts]"]
  node_project_model["Project model<br/>[project.modules.ts]"]
  node_project_contract["Project contract"]
end

subgraph group_content["Content management"]
  node_blog_route["Blog routes<br/>[blog.route.ts]"]
  node_blog_controller["Blog controller<br/>[blog.controller.ts]"]
  node_blog_service["Blog service<br/>[blog.service.ts]"]
  node_blog_model["Blog model<br/>[blog.module.ts]"]
  node_blog_contract["Blog contract<br/>[blog.interface.ts]"]
  node_portfolio_route["Portfolio routes<br/>[portfolio.route.ts]"]
  node_portfolio_controller["Portfolio settings"]
  node_portfolio_model["Portfolio model<br/>[portfolio.model.ts]"]
end

subgraph group_engagement["Contact submissions"]
  node_contact_route["Contact routes<br/>[contact.route.ts]"]
  node_contact_controller["Contact controller"]
  node_contact_service["Contact service<br/>[contact.service.ts]"]
  node_contact_model["Contact model<br/>[contact.module.ts]"]
  node_email_sender["Email sender<br/>[emailSender.ts]"]
  node_contact_contract["Contact contract"]
end

subgraph group_identity["Users and authentication"]
  node_user_route["User routes<br/>[user.route.ts]"]
  node_user_controller["User controller<br/>[user.controller.ts]"]
  node_user_service["User service<br/>[user.service.ts]"]
  node_user_model["User model<br/>[user.module.ts]"]
  node_user_contract["User contract<br/>[user.interface.ts]"]
end

node_client(("API client"))
node_mongo[("MongoDB")]
node_mail_service["Mail service"]

node_client -->|"sends requests"| node_server
node_server -->|"dispatches to"| node_project_route
node_server -->|"dispatches to"| node_blog_route
node_server -->|"dispatches to"| node_portfolio_route
node_server -->|"dispatches to"| node_contact_route
node_server -->|"dispatches to"| node_user_route
node_server -->|"connects to"| node_mongo
node_project_route -->|"routes requests"| node_project_controller
node_project_controller -->|"calls"| node_project_service
node_project_service -->|"queries"| node_project_model
node_project_service -->|"uses types"| node_project_contract
node_blog_route -->|"routes requests"| node_blog_controller
node_blog_controller -->|"calls"| node_blog_service
node_blog_service -->|"queries"| node_blog_model
node_blog_service -->|"uses types"| node_blog_contract
node_portfolio_route -->|"routes requests"| node_portfolio_controller
node_portfolio_controller -->|"reads and writes"| node_portfolio_model
node_contact_route -->|"routes requests"| node_contact_controller
node_contact_controller -->|"calls"| node_contact_service
node_contact_service -->|"queries"| node_contact_model
node_contact_service -->|"sends mail via"| node_email_sender
node_contact_service -.->|"uses types"| node_contact_contract
node_email_sender -.->|"sends email"| node_mail_service
node_user_route -->|"routes requests"| node_user_controller
node_user_controller -->|"calls"| node_user_service
node_user_service -->|"queries"| node_user_model
node_user_service -.->|"persists through model"| node_mongo
node_blog_service -.->|"persists through model"| node_mongo
node_project_service -.->|"persists through model"| node_mongo
node_portfolio_controller -.->|"persists through model"| node_mongo

click node_server "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/server.ts"
click node_project_route "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/projects/project.route.ts"
click node_project_controller "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/projects/project.controller.ts"
click node_project_service "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/projects/project.service.ts"
click node_project_model "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/projects/project.modules.ts"
click node_project_contract "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/projects/project.interface.ts"
click node_blog_route "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/blogs/blog.route.ts"
click node_blog_controller "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/blogs/blog.controller.ts"
click node_blog_service "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/blogs/blog.service.ts"
click node_blog_model "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/blogs/blog.module.ts"
click node_blog_contract "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/blogs/blog.interface.ts"
click node_portfolio_route "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/portfolio/portfolio.route.ts"
click node_portfolio_controller "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/portfolio/portfolio.controller.ts"
click node_portfolio_model "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/portfolio/portfolio.model.ts"
click node_contact_route "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/contact/contact.route.ts"
click node_contact_controller "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/contact/contact.controller.ts"
click node_contact_service "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/contact/contact.service.ts"
click node_contact_model "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/contact/contact.module.ts"
click node_email_sender "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/contact/emailSender.ts"
click node_contact_contract "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/contact/contact.interface.ts"
click node_user_route "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/users/user.route.ts"
click node_user_controller "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/users/user.controller.ts"
click node_user_service "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/users/user.service.ts"
click node_user_model "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/users/user.module.ts"
click node_user_contract "https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/users/user.interface.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_server,node_client toneBlue
class node_project_route,node_project_controller,node_project_service,node_project_model,node_project_contract,node_mongo toneAmber
class node_blog_route,node_blog_controller,node_blog_service,node_blog_model,node_blog_contract,node_portfolio_route,node_portfolio_controller,node_portfolio_model toneMint
class node_contact_route,node_contact_controller,node_contact_service,node_contact_model,node_email_sender,node_contact_contract toneRose
class node_user_route,node_user_controller,node_user_service,node_user_model,node_user_contract,node_mail_service toneIndigo
```

## Components

### API runtime

- [Express server](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/server.ts): `src/server.ts`

### Projects

- [Project routes](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/projects/project.route.ts): `src/modules/projects/project.route.ts`
- [Project controller](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/projects/project.controller.ts): `src/modules/projects/project.controller.ts`
- [Project service](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/projects/project.service.ts): `src/modules/projects/project.service.ts`
- [Project model](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/projects/project.modules.ts): `src/modules/projects/project.modules.ts`
- [Project contract](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/projects/project.interface.ts): `src/modules/projects/project.interface.ts`

### Content management

- [Blog routes](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/blogs/blog.route.ts): `src/modules/blogs/blog.route.ts`
- [Blog controller](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/blogs/blog.controller.ts): `src/modules/blogs/blog.controller.ts`
- [Blog service](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/blogs/blog.service.ts): `src/modules/blogs/blog.service.ts`
- [Blog model](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/blogs/blog.module.ts): `src/modules/blogs/blog.module.ts`
- [Blog contract](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/blogs/blog.interface.ts): `src/modules/blogs/blog.interface.ts`
- [Portfolio routes](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/portfolio/portfolio.route.ts): `src/modules/portfolio/portfolio.route.ts`
- [Portfolio settings](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/portfolio/portfolio.controller.ts): `src/modules/portfolio/portfolio.controller.ts`
- [Portfolio model](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/portfolio/portfolio.model.ts): `src/modules/portfolio/portfolio.model.ts`

### Contact submissions

- [Contact routes](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/contact/contact.route.ts): `src/modules/contact/contact.route.ts`
- [Contact controller](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/contact/contact.controller.ts): `src/modules/contact/contact.controller.ts`
- [Contact service](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/contact/contact.service.ts): `src/modules/contact/contact.service.ts`
- [Contact model](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/contact/contact.module.ts): `src/modules/contact/contact.module.ts`
- [Email sender](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/contact/emailSender.ts): `src/modules/contact/emailSender.ts`
- [Contact contract](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/contact/contact.interface.ts): `src/modules/contact/contact.interface.ts`

### Users and authentication

- [User routes](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/users/user.route.ts): `src/modules/users/user.route.ts`
- [User controller](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/users/user.controller.ts): `src/modules/users/user.controller.ts`
- [User service](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/users/user.service.ts): `src/modules/users/user.service.ts`
- [User model](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/users/user.module.ts): `src/modules/users/user.module.ts`
- [User contract](https://github.com/pronoybanik/next.js-portfolio-backend/blob/main/src/modules/users/user.interface.ts): `src/modules/users/user.interface.ts`

### Other components

- **API client**
- **MongoDB**
- **Mail service**

## Connections

- API client → Express server: sends requests (evidence: `src/server.ts`)
- Express server → Project routes: dispatches to (evidence: `src/server.ts`)
- Express server → Blog routes: dispatches to (evidence: `src/server.ts`)
- Express server → Portfolio routes: dispatches to (evidence: `src/server.ts`)
- Express server → Contact routes: dispatches to (evidence: `src/server.ts`)
- Express server → User routes: dispatches to (evidence: `src/server.ts`)
- Express server → MongoDB: connects to (evidence: `src/server.ts`)
- Project routes → Project controller: routes requests (evidence: `src/modules/projects/project.route.ts`)
- Project controller → Project service: calls (evidence: `src/modules/projects/project.controller.ts`)
- Project service → Project model: queries (evidence: `src/modules/projects/project.service.ts`)
- Project service → Project contract: uses types (evidence: `src/modules/projects/project.service.ts`)
- Blog routes → Blog controller: routes requests (evidence: `src/modules/blogs/blog.route.ts`)
- Blog controller → Blog service: calls (evidence: `src/modules/blogs/blog.controller.ts`)
- Blog service → Blog model: queries (evidence: `src/modules/blogs/blog.service.ts`)
- Blog service → Blog contract: uses types (evidence: `src/modules/blogs/blog.service.ts`)
- Portfolio routes → Portfolio settings: routes requests (evidence: `src/modules/portfolio/portfolio.route.ts`)
- Portfolio settings → Portfolio model: reads and writes (evidence: `src/modules/portfolio/portfolio.controller.ts`)
- Contact routes → Contact controller: routes requests (evidence: `src/modules/contact/contact.route.ts`)
- Contact controller → Contact service: calls (evidence: `src/modules/contact/contact.controller.ts`)
- Contact service → Contact model: queries (evidence: `src/modules/contact/contact.service.ts`)
- Contact service → Email sender: sends mail via (evidence: `src/modules/contact/contact.service.ts`)
- Contact service → Contact contract: uses types
- Email sender → Mail service: sends email
- User routes → User controller: routes requests (evidence: `src/modules/users/user.route.ts`)
- User controller → User service: calls (evidence: `src/modules/users/user.controller.ts`)
- User service → User model: queries (evidence: `src/modules/users/user.service.ts`)
- User service → MongoDB: persists through model
- Blog service → MongoDB: persists through model
- Project service → MongoDB: persists through model
- Portfolio settings → MongoDB: persists through model
