# munna-scriptz/portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/munna-scriptz/portfolio
- Repository: https://github.com/munna-scriptz/portfolio

## Overview

This is a portfolio site with a public-facing showcase and a protected admin interface for managing portfolio content and contact messages. Visitors browse home, about, and project pages or submit a contact message; administrators authenticate and manage projects, categories, and messages. The server routes requests through middleware and controllers to MongoDB models, with project images handled by a cloud-upload service. Source excerpts support the server’s internal calls and top-level routing; the client API implementation was not excerpted, so its server connection is left unverified.

Main entry points: [`client/src/App.jsx`](https://github.com/munna-scriptz/portfolio/blob/main/client/src/App.jsx) (Route application), [`server/routes/index.js`](https://github.com/munna-scriptz/portfolio/blob/main/server/routes/index.js) (Route registry), [`server/middleware/authMiddleware.js`](https://github.com/munna-scriptz/portfolio/blob/main/server/middleware/authMiddleware.js) (Authentication check), [`server/routes/projects.js`](https://github.com/munna-scriptz/portfolio/blob/main/server/routes/projects.js) (Project routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Portfolio frontend"]
  node_app["Route application<br/>[App.jsx]"]
  node_publiclayout["Public layout<br/>[LayoutOne.jsx]"]
  node_home["Home page<br/>[Home.jsx]"]
  node_about["About page<br/>[About.jsx]"]
  node_projects["Projects page<br/>[Projects.jsx]"]
  node_contact["Contact page<br/>[Contact.jsx]"]
  node_projectlisting["Project listing<br/>[AllProjects.jsx]"]
  node_contactform["Contact form<br/>[ContactMe.jsx]"]
end

subgraph group_admin["Admin experience"]
  node_adminlayout["Admin layout<br/>[AdminLayout.jsx]"]
  node_login["Admin login<br/>[AdminLogin.jsx]"]
  node_projectadmin["Project editor<br/>[AdminAdd.jsx]"]
  node_categoryadmin["Category editor<br/>[AdminCategory.jsx]"]
  node_messageadmin["Message inbox<br/>[AdminMessages.jsx]"]
  node_adminnav["Admin navigation<br/>[AdminNavbar.jsx]"]
  node_clientapi["Client API<br/>[index.js]"]
end

subgraph group_api["Application API"]
  node_server["HTTP server<br/>[server.js]"]
  node_routes["Route registry<br/>[index.js]"]
  node_authroutes["Auth routes<br/>[auth.js]"]
  node_projectroutes["Project routes<br/>[projects.js]"]
  node_categoryroutes["Category routes<br/>[category.js]"]
  node_contactroutes["Contact routes<br/>[contact.js]"]
  node_authcontroller["Authentication<br/>[authController.js]"]
  node_projectcontroller["Project management"]
  node_categorycontroller["Category management"]
  node_contactcontroller["Contact messages"]
  node_authmiddleware["Authentication check<br/>[authMiddleware.js]"]
  node_rolemiddleware["Role check"]
  node_tokens["Token service<br/>[tokens.js]"]
  node_responses["Response formatter<br/>[resHandler.js]"]
end

subgraph group_data["Persistence and media"]
  node_dbconfig[("Database connection<br/>[index.js]")]
  node_projectmodel[("Project records<br/>[projectSchema.js]")]
  node_categorymodel[("Category records<br/>[categorySchema.js]")]
end

node_visitor(("Visitor"))
node_administrator(("Administrator"))

node_visitor -->|"opens site"| node_app
node_administrator -->|"opens admin"| node_app
node_app -->|"routes public"| node_publiclayout
node_app -->|"routes admin"| node_adminlayout
node_app -->|"routes home"| node_home
node_app -->|"routes about"| node_about
node_app -->|"routes projects"| node_projects
node_app -->|"routes contact"| node_contact
node_app -->|"routes login"| node_login
node_app -->|"routes editor"| node_projectadmin
node_app -->|"routes categories"| node_categoryadmin
node_app -->|"routes inbox"| node_messageadmin
node_projects -.->|"renders listing"| node_projectlisting
node_contact -.->|"renders form"| node_contactform
node_adminlayout -->|"renders navigation"| node_adminnav
node_projectadmin -->|"calls API"| node_clientapi
node_messageadmin -->|"calls API"| node_clientapi
node_clientapi -.->|"HTTP requests"| node_routes
node_server -->|"mounts routes"| node_routes
node_server -->|"connects database"| node_dbconfig
node_routes -->|"mounts auth"| node_authroutes
node_routes -->|"mounts projects"| node_projectroutes
node_routes -->|"mounts categories"| node_categoryroutes
node_routes -->|"mounts contacts"| node_contactroutes
node_authroutes -->|"dispatches"| node_authcontroller
node_authroutes -->|"checks profile"| node_authmiddleware
node_projectroutes -->|"dispatches"| node_projectcontroller
node_projectroutes -->|"checks token"| node_authmiddleware
node_projectroutes -->|"checks role"| node_rolemiddleware
node_categoryroutes -->|"dispatches"| node_categorycontroller
node_categoryroutes -->|"checks token"| node_authmiddleware
node_categoryroutes -->|"checks role"| node_rolemiddleware
node_contactroutes -->|"dispatches"| node_contactcontroller
node_contactroutes -->|"checks token"| node_authmiddleware
node_contactroutes -->|"checks role"| node_rolemiddleware
node_authcontroller -->|"creates token"| node_tokens
node_authmiddleware -->|"verifies token"| node_tokens
node_authcontroller -->|"formats errors"| node_responses
node_rolemiddleware -->|"formats errors"| node_responses
node_projectcontroller -->|"reads writes"| node_projectmodel
node_projectcontroller -->|"formats results"| node_responses
node_categorycontroller -->|"reads writes"| node_categorymodel
node_categorycontroller -->|"formats results"| node_responses

click node_app "https://github.com/munna-scriptz/portfolio/blob/main/client/src/App.jsx"
click node_publiclayout "https://github.com/munna-scriptz/portfolio/blob/main/client/src/layout/LayoutOne.jsx"
click node_home "https://github.com/munna-scriptz/portfolio/blob/main/client/src/pages/Home.jsx"
click node_about "https://github.com/munna-scriptz/portfolio/blob/main/client/src/pages/About.jsx"
click node_projects "https://github.com/munna-scriptz/portfolio/blob/main/client/src/pages/Projects.jsx"
click node_contact "https://github.com/munna-scriptz/portfolio/blob/main/client/src/pages/Contact.jsx"
click node_projectlisting "https://github.com/munna-scriptz/portfolio/blob/main/client/src/components/Projects/AllProjects.jsx"
click node_contactform "https://github.com/munna-scriptz/portfolio/blob/main/client/src/components/home/ContactMe.jsx"
click node_adminlayout "https://github.com/munna-scriptz/portfolio/blob/main/client/src/layout/AdminLayout.jsx"
click node_login "https://github.com/munna-scriptz/portfolio/blob/main/client/src/pages/AdminLogin.jsx"
click node_projectadmin "https://github.com/munna-scriptz/portfolio/blob/main/client/src/pages/AdminAdd.jsx"
click node_categoryadmin "https://github.com/munna-scriptz/portfolio/blob/main/client/src/pages/AdminCategory.jsx"
click node_messageadmin "https://github.com/munna-scriptz/portfolio/blob/main/client/src/pages/AdminMessages.jsx"
click node_adminnav "https://github.com/munna-scriptz/portfolio/blob/main/client/src/components/navbar/AdminNavbar.jsx"
click node_clientapi "https://github.com/munna-scriptz/portfolio/blob/main/client/src/api/index.js"
click node_server "https://github.com/munna-scriptz/portfolio/blob/main/server/server.js"
click node_routes "https://github.com/munna-scriptz/portfolio/blob/main/server/routes/index.js"
click node_authroutes "https://github.com/munna-scriptz/portfolio/blob/main/server/routes/auth.js"
click node_projectroutes "https://github.com/munna-scriptz/portfolio/blob/main/server/routes/projects.js"
click node_categoryroutes "https://github.com/munna-scriptz/portfolio/blob/main/server/routes/category.js"
click node_contactroutes "https://github.com/munna-scriptz/portfolio/blob/main/server/routes/contact.js"
click node_authcontroller "https://github.com/munna-scriptz/portfolio/blob/main/server/controllers/authController.js"
click node_projectcontroller "https://github.com/munna-scriptz/portfolio/blob/main/server/controllers/ProjectsController.js"
click node_categorycontroller "https://github.com/munna-scriptz/portfolio/blob/main/server/controllers/categoryController.js"
click node_contactcontroller "https://github.com/munna-scriptz/portfolio/blob/main/server/controllers/contactController.js"
click node_authmiddleware "https://github.com/munna-scriptz/portfolio/blob/main/server/middleware/authMiddleware.js"
click node_rolemiddleware "https://github.com/munna-scriptz/portfolio/blob/main/server/middleware/roleCheckMiddleware.js"
click node_tokens "https://github.com/munna-scriptz/portfolio/blob/main/server/services/tokens.js"
click node_responses "https://github.com/munna-scriptz/portfolio/blob/main/server/utils/resHandler.js"
click node_dbconfig "https://github.com/munna-scriptz/portfolio/blob/main/server/dbConfig/index.js"
click node_projectmodel "https://github.com/munna-scriptz/portfolio/blob/main/server/models/projectSchema.js"
click node_categorymodel "https://github.com/munna-scriptz/portfolio/blob/main/server/models/categorySchema.js"

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_app,node_publiclayout,node_home,node_about,node_projects,node_contact,node_projectlisting,node_contactform toneBlue
class node_adminlayout,node_login,node_projectadmin,node_categoryadmin,node_messageadmin,node_adminnav,node_clientapi toneAmber
class node_server,node_routes,node_authroutes,node_projectroutes,node_categoryroutes,node_contactroutes,node_authcontroller,node_projectcontroller,node_categorycontroller,node_contactcontroller,node_authmiddleware,node_rolemiddleware,node_tokens,node_responses toneMint
class node_dbconfig,node_projectmodel,node_categorymodel toneRose
class node_visitor,node_administrator toneIndigo
```

## Components

### Portfolio frontend

- [Route application](https://github.com/munna-scriptz/portfolio/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Public layout](https://github.com/munna-scriptz/portfolio/blob/main/client/src/layout/LayoutOne.jsx): `client/src/layout/LayoutOne.jsx`
- [Home page](https://github.com/munna-scriptz/portfolio/blob/main/client/src/pages/Home.jsx): `client/src/pages/Home.jsx`
- [About page](https://github.com/munna-scriptz/portfolio/blob/main/client/src/pages/About.jsx): `client/src/pages/About.jsx`
- [Projects page](https://github.com/munna-scriptz/portfolio/blob/main/client/src/pages/Projects.jsx): `client/src/pages/Projects.jsx`
- [Contact page](https://github.com/munna-scriptz/portfolio/blob/main/client/src/pages/Contact.jsx): `client/src/pages/Contact.jsx`
- [Project listing](https://github.com/munna-scriptz/portfolio/blob/main/client/src/components/Projects/AllProjects.jsx): `client/src/components/Projects/AllProjects.jsx`
- [Contact form](https://github.com/munna-scriptz/portfolio/blob/main/client/src/components/home/ContactMe.jsx): `client/src/components/home/ContactMe.jsx`

### Admin experience

- [Admin layout](https://github.com/munna-scriptz/portfolio/blob/main/client/src/layout/AdminLayout.jsx): `client/src/layout/AdminLayout.jsx`
- [Admin login](https://github.com/munna-scriptz/portfolio/blob/main/client/src/pages/AdminLogin.jsx): `client/src/pages/AdminLogin.jsx`
- [Project editor](https://github.com/munna-scriptz/portfolio/blob/main/client/src/pages/AdminAdd.jsx): `client/src/pages/AdminAdd.jsx`
- [Category editor](https://github.com/munna-scriptz/portfolio/blob/main/client/src/pages/AdminCategory.jsx): `client/src/pages/AdminCategory.jsx`
- [Message inbox](https://github.com/munna-scriptz/portfolio/blob/main/client/src/pages/AdminMessages.jsx): `client/src/pages/AdminMessages.jsx`
- [Admin navigation](https://github.com/munna-scriptz/portfolio/blob/main/client/src/components/navbar/AdminNavbar.jsx): `client/src/components/navbar/AdminNavbar.jsx`
- [Client API](https://github.com/munna-scriptz/portfolio/blob/main/client/src/api/index.js): `client/src/api/index.js`

### Application API

- [HTTP server](https://github.com/munna-scriptz/portfolio/blob/main/server/server.js): `server/server.js`
- [Route registry](https://github.com/munna-scriptz/portfolio/blob/main/server/routes/index.js): `server/routes/index.js`
- [Auth routes](https://github.com/munna-scriptz/portfolio/blob/main/server/routes/auth.js): `server/routes/auth.js`
- [Project routes](https://github.com/munna-scriptz/portfolio/blob/main/server/routes/projects.js): `server/routes/projects.js`
- [Category routes](https://github.com/munna-scriptz/portfolio/blob/main/server/routes/category.js): `server/routes/category.js`
- [Contact routes](https://github.com/munna-scriptz/portfolio/blob/main/server/routes/contact.js): `server/routes/contact.js`
- [Authentication](https://github.com/munna-scriptz/portfolio/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [Project management](https://github.com/munna-scriptz/portfolio/blob/main/server/controllers/ProjectsController.js): `server/controllers/ProjectsController.js`
- [Category management](https://github.com/munna-scriptz/portfolio/blob/main/server/controllers/categoryController.js): `server/controllers/categoryController.js`
- [Contact messages](https://github.com/munna-scriptz/portfolio/blob/main/server/controllers/contactController.js): `server/controllers/contactController.js`
- [Authentication check](https://github.com/munna-scriptz/portfolio/blob/main/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`
- [Role check](https://github.com/munna-scriptz/portfolio/blob/main/server/middleware/roleCheckMiddleware.js): `server/middleware/roleCheckMiddleware.js`
- [Token service](https://github.com/munna-scriptz/portfolio/blob/main/server/services/tokens.js): `server/services/tokens.js`
- [Response formatter](https://github.com/munna-scriptz/portfolio/blob/main/server/utils/resHandler.js): `server/utils/resHandler.js`

### Persistence and media

- [Database connection](https://github.com/munna-scriptz/portfolio/blob/main/server/dbConfig/index.js): `server/dbConfig/index.js`
- [Project records](https://github.com/munna-scriptz/portfolio/blob/main/server/models/projectSchema.js): `server/models/projectSchema.js`
- [Category records](https://github.com/munna-scriptz/portfolio/blob/main/server/models/categorySchema.js): `server/models/categorySchema.js`

### Other components

- **Visitor**
- **Administrator**

## Connections

- Visitor → Route application: opens site
- Administrator → Route application: opens admin
- Route application → Public layout: routes public (evidence: `client/src/App.jsx`)
- Route application → Admin layout: routes admin (evidence: `client/src/App.jsx`)
- Route application → Home page: routes home (evidence: `client/src/App.jsx`)
- Route application → About page: routes about (evidence: `client/src/App.jsx`)
- Route application → Projects page: routes projects (evidence: `client/src/App.jsx`)
- Route application → Contact page: routes contact (evidence: `client/src/App.jsx`)
- Route application → Admin login: routes login (evidence: `client/src/App.jsx`)
- Route application → Project editor: routes editor (evidence: `client/src/App.jsx`)
- Route application → Category editor: routes categories (evidence: `client/src/App.jsx`)
- Route application → Message inbox: routes inbox (evidence: `client/src/App.jsx`)
- Projects page → Project listing: renders listing
- Contact page → Contact form: renders form
- Admin layout → Admin navigation: renders navigation (evidence: `client/src/layout/AdminLayout.jsx`)
- Project editor → Client API: calls API (evidence: `client/src/pages/AdminAdd.jsx`)
- Message inbox → Client API: calls API (evidence: `client/src/pages/AdminMessages.jsx`)
- Client API → Route registry: HTTP requests
- HTTP server → Route registry: mounts routes (evidence: `server/server.js`)
- HTTP server → Database connection: connects database (evidence: `server/server.js`)
- Route registry → Auth routes: mounts auth (evidence: `server/routes/index.js`)
- Route registry → Project routes: mounts projects (evidence: `server/routes/index.js`)
- Route registry → Category routes: mounts categories (evidence: `server/routes/index.js`)
- Route registry → Contact routes: mounts contacts (evidence: `server/routes/index.js`)
- Auth routes → Authentication: dispatches (evidence: `server/routes/auth.js`)
- Auth routes → Authentication check: checks profile (evidence: `server/routes/auth.js`)
- Project routes → Project management: dispatches (evidence: `server/routes/projects.js`)
- Project routes → Authentication check: checks token (evidence: `server/routes/projects.js`)
- Project routes → Role check: checks role (evidence: `server/routes/projects.js`)
- Category routes → Category management: dispatches (evidence: `server/routes/category.js`)
- Category routes → Authentication check: checks token (evidence: `server/routes/category.js`)
- Category routes → Role check: checks role (evidence: `server/routes/category.js`)
- Contact routes → Contact messages: dispatches (evidence: `server/routes/contact.js`)
- Contact routes → Authentication check: checks token (evidence: `server/routes/contact.js`)
- Contact routes → Role check: checks role (evidence: `server/routes/contact.js`)
- Authentication → Token service: creates token (evidence: `server/controllers/authController.js`)
- Authentication check → Token service: verifies token (evidence: `server/middleware/authMiddleware.js`)
- Authentication → Response formatter: formats errors (evidence: `server/controllers/authController.js`)
- Role check → Response formatter: formats errors (evidence: `server/middleware/roleCheckMiddleware.js`)
- Project management → Project records: reads writes (evidence: `server/controllers/ProjectsController.js`)
- Project management → Response formatter: formats results (evidence: `server/controllers/ProjectsController.js`)
- Category management → Category records: reads writes (evidence: `server/controllers/categoryController.js`)
- Category management → Response formatter: formats results (evidence: `server/controllers/categoryController.js`)
