# mayuresh-2601/mk-portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/mayuresh-2601/mk-portfolio
- Repository: https://github.com/mayuresh-2601/mk-portfolio

## Overview

MAYURESH.DEV is a full-stack portfolio platform: visitors browse API-backed portfolio content, submit contact messages, request AI explanations, and view live system telemetry; an administrator signs in to manage content. The graph separates the React experience, API/domain handlers, persistence and security, and integrations. Some page and controller behavior is unsampled; edges are included only where the README or source index supports the relationship.

Main entry points: [`client/src/App.jsx`](https://github.com/mayuresh-2601/mk-portfolio/blob/main/client/src/App.jsx) (Route application), [`client/src/api/axios.js`](https://github.com/mayuresh-2601/mk-portfolio/blob/main/client/src/api/axios.js) (API client), [`server/server.js`](https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/server.js) (Express API), [`server/routes/authRoutes.js`](https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/routes/authRoutes.js) (Authentication routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Portfolio experience"]
  node_app["Route application<br/>[App.jsx]"]
  node_public["Public portfolio pages"]
  node_adminui["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_clientapi["API client<br/>[axios.js]"]
  node_pagination["Paginated lists"]
end

subgraph group_api["API and domain"]
  node_server["Express API<br/>[server.js]"]
  node_authroutes["Authentication routes<br/>[authRoutes.js]"]
  node_authcontroller["Authentication handlers<br/>[authController.js]"]
  node_contentroutes["Portfolio routes<br/>[projectRoutes.js]"]
  node_contentcontrollers["Content handlers"]
  node_messages["Contact messages"]
  node_ai["AI explanations<br/>[aiController.js]"]
  node_system["System telemetry"]
end

subgraph group_core["Persistence and security"]
  node_authmiddleware["Session protection<br/>[authMiddleware.js]"]
  node_contentmodels["Content models"]
  node_sessions[("Session store<br/>[sessionModel.js]")]
  node_database[("MySQL / TiDB<br/>[db.js]")]
  node_uploads["Upload processing"]
end

subgraph group_integrations["External integrations"]
  node_aiservice["Gemini service<br/>[aiService.js]"]
  node_cloudinary["Cloudinary assets<br/>[cloudinary.js]"]
  node_email["Email notifications<br/>[sendEmail.js]"]
end

node_visitor(("Visitor"))
node_admin(("Administrator"))
node_gemini{{"Google Gemini"}}

node_visitor -->|"opens pages"| node_app
node_admin -->|"opens dashboard"| node_app
node_app -->|"routes to"| node_public
node_app -->|"routes to"| node_adminui
node_public -.->|"requests content"| node_clientapi
node_adminui -->|"calls API"| node_clientapi
node_pagination -->|"requests pages"| node_clientapi
node_clientapi -->|"sends API requests"| node_server
node_server -->|"mounts routes"| node_authroutes
node_server -->|"mounts routes"| node_contentroutes
node_authroutes -->|"dispatches to"| node_authcontroller
node_authroutes -->|"protects routes"| node_authmiddleware
node_authcontroller -->|"creates sessions"| node_sessions
node_authmiddleware -->|"checks sessions"| node_sessions
node_sessions -->|"executes queries"| node_database
node_contentroutes -->|"dispatches to"| node_contentcontrollers
node_contentcontrollers -->|"reads and writes"| node_contentmodels
node_contentmodels -.->|"uses database"| node_database
node_messages -->|"sends notifications"| node_email
node_messages -->|"accepts attachments"| node_uploads
node_uploads -->|"uploads assets"| node_cloudinary
node_ai -->|"requests explanations"| node_aiservice
node_aiservice -.->|"generates explanations"| node_gemini
node_visitor -->|"requests explanation"| node_ai
node_visitor -->|"views telemetry"| node_system

click node_app "https://github.com/mayuresh-2601/mk-portfolio/blob/main/client/src/App.jsx"
click node_public "https://github.com/mayuresh-2601/mk-portfolio/tree/main/client/src/pages/public"
click node_adminui "https://github.com/mayuresh-2601/mk-portfolio/blob/main/client/src/pages/admin/AdminDashboard.jsx"
click node_clientapi "https://github.com/mayuresh-2601/mk-portfolio/blob/main/client/src/api/axios.js"
click node_pagination "https://github.com/mayuresh-2601/mk-portfolio/blob/main/client/src/hooks/usePaginatedList.js"
click node_server "https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/server.js"
click node_authroutes "https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/routes/authRoutes.js"
click node_authcontroller "https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/controllers/authController.js"
click node_authmiddleware "https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/middleware/authMiddleware.js"
click node_contentroutes "https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/routes/projectRoutes.js"
click node_contentcontrollers "https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/controllers/projectController.js"
click node_contentmodels "https://github.com/mayuresh-2601/mk-portfolio/tree/main/server/models"
click node_messages "https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/controllers/messageController.js"
click node_ai "https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/controllers/aiController.js"
click node_aiservice "https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/services/aiService.js"
click node_system "https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/controllers/systemController.js"
click node_sessions "https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/models/sessionModel.js"
click node_database "https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/config/db.js"
click node_uploads "https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/middleware/uploadMiddleware.js"
click node_cloudinary "https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/config/cloudinary.js"
click node_email "https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/utils/sendEmail.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_public,node_adminui,node_clientapi,node_pagination toneBlue
class node_server,node_authroutes,node_authcontroller,node_contentroutes,node_contentcontrollers,node_messages,node_ai,node_system toneAmber
class node_authmiddleware,node_contentmodels,node_sessions,node_database,node_uploads toneMint
class node_aiservice,node_cloudinary,node_email toneRose
class node_visitor,node_admin,node_gemini toneIndigo
```

## Components

### Portfolio experience

- [Route application](https://github.com/mayuresh-2601/mk-portfolio/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Public portfolio pages](https://github.com/mayuresh-2601/mk-portfolio/tree/main/client/src/pages/public): `client/src/pages/public`
- [Admin dashboard](https://github.com/mayuresh-2601/mk-portfolio/blob/main/client/src/pages/admin/AdminDashboard.jsx): `client/src/pages/admin/AdminDashboard.jsx`
- [API client](https://github.com/mayuresh-2601/mk-portfolio/blob/main/client/src/api/axios.js): `client/src/api/axios.js`
- [Paginated lists](https://github.com/mayuresh-2601/mk-portfolio/blob/main/client/src/hooks/usePaginatedList.js): `client/src/hooks/usePaginatedList.js`

### API and domain

- [Express API](https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/server.js): `server/server.js`
- [Authentication routes](https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [Authentication handlers](https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [Portfolio routes](https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/routes/projectRoutes.js): `server/routes/projectRoutes.js`
- [Content handlers](https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/controllers/projectController.js): `server/controllers/projectController.js`
- [Contact messages](https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/controllers/messageController.js): `server/controllers/messageController.js`
- [AI explanations](https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/controllers/aiController.js): `server/controllers/aiController.js`
- [System telemetry](https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/controllers/systemController.js): `server/controllers/systemController.js`

### Persistence and security

- [Session protection](https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`
- [Content models](https://github.com/mayuresh-2601/mk-portfolio/tree/main/server/models): `server/models`
- [Session store](https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/models/sessionModel.js): `server/models/sessionModel.js`
- [MySQL / TiDB](https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/config/db.js): `server/config/db.js`
- [Upload processing](https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/middleware/uploadMiddleware.js): `server/middleware/uploadMiddleware.js`

### External integrations

- [Gemini service](https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/services/aiService.js): `server/services/aiService.js`
- [Cloudinary assets](https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/config/cloudinary.js): `server/config/cloudinary.js`
- [Email notifications](https://github.com/mayuresh-2601/mk-portfolio/blob/main/server/utils/sendEmail.js): `server/utils/sendEmail.js`

### Other components

- **Visitor**
- **Administrator**
- **Google Gemini**

## Connections

- Visitor → Route application: opens pages (evidence: `README.md`)
- Administrator → Route application: opens dashboard (evidence: `README.md`)
- Route application → Public portfolio pages: routes to (evidence: `client/src/App.jsx`)
- Route application → Admin dashboard: routes to (evidence: `client/src/App.jsx`)
- Public portfolio pages → API client: requests content (evidence: `README.md`)
- Admin dashboard → API client: calls API (evidence: `client/src/pages/admin/AdminDashboard.jsx`)
- Paginated lists → API client: requests pages (evidence: `client/src/hooks/usePaginatedList.js`)
- API client → Express API: sends API requests (evidence: `README.md`)
- Express API → Authentication routes: mounts routes (evidence: `server/server.js`)
- Express API → Portfolio routes: mounts routes (evidence: `server/server.js`)
- Authentication routes → Authentication handlers: dispatches to (evidence: `server/routes/authRoutes.js`)
- Authentication routes → Session protection: protects routes (evidence: `server/routes/authRoutes.js`)
- Authentication handlers → Session store: creates sessions (evidence: `server/controllers/authController.js`)
- Session protection → Session store: checks sessions (evidence: `server/middleware/authMiddleware.js`)
- Session store → MySQL / TiDB: executes queries (evidence: `server/models/sessionModel.js`)
- Portfolio routes → Content handlers: dispatches to (evidence: `server/routes/projectRoutes.js`)
- Content handlers → Content models: reads and writes (evidence: `server/controllers/projectController.js`)
- Content models → MySQL / TiDB: uses database (evidence: `server/models/skillModel.js`)
- Contact messages → Email notifications: sends notifications (evidence: `server/controllers/messageController.js`)
- Contact messages → Upload processing: accepts attachments (evidence: `server/routes/messageRoutes.js`)
- Upload processing → Cloudinary assets: uploads assets (evidence: `server/middleware/uploadMiddleware.js`)
- AI explanations → Gemini service: requests explanations (evidence: `server/controllers/aiController.js`)
- Gemini service → Google Gemini: generates explanations (evidence: `README.md`)
- Visitor → AI explanations: requests explanation (evidence: `README.md`)
- Visitor → System telemetry: views telemetry (evidence: `README.md`)
