# adityamullaguri/portfolio architecture

> Architecture diagram of the GitHub repository adityamullaguri/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/adityamullaguri/portfolio
- Repository: https://github.com/adityamullaguri/portfolio

## Overview

This repository is a portfolio website with an administrative CMS. Visitors browse portfolio content and can submit a contact message; an administrator logs in, edits content or uploads media, and reviews messages. The Express server routes these requests to SQLite-backed public and protected APIs, while the browser scripts provide the public experience and dashboard. Backup/restore and optional GitHub persistence support content durability. The README is empty, and some source excerpts are partial, so links from the public frontend to particular API endpoints are not asserted without direct evidence.

Main entry points: [`server/server.js`](https://github.com/adityamullaguri/portfolio/blob/main/server/server.js) (Express Server), [`server/routes/admin.js`](https://github.com/adityamullaguri/portfolio/blob/main/server/routes/admin.js) (Admin API), [`server/db.js`](https://github.com/adityamullaguri/portfolio/blob/main/server/db.js) (Portfolio Database), [`server/backup.js`](https://github.com/adityamullaguri/portfolio/blob/main/server/backup.js) (Backup and Restore)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Public Portfolio"]
  node_portfolio["Portfolio Page<br/>[index.html]"]
  node_public_ui["Portfolio Interactions<br/>[script.js]"]
end

subgraph group_admin["Admin CMS"]
  node_admin_ui["Dashboard SPA<br/>[admin.js]"]
  node_admin_pages["Admin Pages<br/>[dashboard.html]"]
end

subgraph group_backend["Application Backend"]
  node_auth_routes["Authentication<br/>[auth.js]"]
  node_admin_routes["Admin API<br/>[admin.js]"]
  node_public_routes["Public API<br/>[public.js]"]
  node_auth_middleware["JWT Guard<br/>[auth.js]"]
  node_uploads["Media Uploads<br/>[upload.js]"]
  node_app_server["Express Server<br/>[server.js]"]
end

subgraph group_persistence["Persistence"]
  node_sqlite[("Portfolio Database<br/>[db.js]")]
  node_backup["Backup and Restore<br/>[backup.js]"]
  node_seed["Initial Content Seed<br/>[seed.js]"]
  node_state_file["State Snapshot"]
  node_media_store[("Uploaded Media")]
end

node_visitor(("Visitor"))
node_admin_user(("Administrator"))
node_github["GitHub"]

node_visitor -->|"visits"| node_portfolio
node_app_server -->|"serves"| node_portfolio
node_app_server -->|"serves"| node_admin_pages
node_admin_user -->|"opens"| node_admin_pages
node_admin_pages -->|"loads"| node_admin_ui
node_admin_ui -.->|"authenticates"| node_auth_routes
node_admin_ui -->|"calls"| node_admin_routes
node_portfolio -.->|"loads"| node_public_ui
node_public_ui -.->|"fetches content"| node_public_routes
node_public_ui -.->|"submits contact"| node_public_routes
node_app_server -->|"mounts"| node_auth_routes
node_app_server -->|"mounts"| node_public_routes
node_app_server -->|"mounts"| node_admin_routes
node_auth_routes -->|"reads and writes"| node_sqlite
node_auth_routes -->|"guards session"| node_auth_middleware
node_admin_routes -->|"guards routes"| node_auth_middleware
node_admin_routes -->|"reads and writes"| node_sqlite
node_admin_routes -->|"handles media"| node_uploads
node_uploads -->|"writes files"| node_media_store
node_app_server -->|"serves files"| node_media_store
node_public_routes -->|"reads and writes"| node_sqlite
node_app_server -->|"runs seed"| node_seed
node_seed -->|"initializes content"| node_sqlite
node_seed -->|"restores state"| node_backup
node_backup -.->|"exports and imports"| node_sqlite
node_backup -.->|"persists snapshot"| node_state_file
node_backup -->|"publishes content"| node_github

click node_portfolio "https://github.com/adityamullaguri/portfolio/blob/main/index.html"
click node_public_ui "https://github.com/adityamullaguri/portfolio/blob/main/script.js"
click node_admin_ui "https://github.com/adityamullaguri/portfolio/blob/main/admin/admin.js"
click node_admin_pages "https://github.com/adityamullaguri/portfolio/blob/main/admin/dashboard.html"
click node_auth_routes "https://github.com/adityamullaguri/portfolio/blob/main/server/routes/auth.js"
click node_admin_routes "https://github.com/adityamullaguri/portfolio/blob/main/server/routes/admin.js"
click node_public_routes "https://github.com/adityamullaguri/portfolio/blob/main/server/routes/public.js"
click node_auth_middleware "https://github.com/adityamullaguri/portfolio/blob/main/server/middleware/auth.js"
click node_uploads "https://github.com/adityamullaguri/portfolio/blob/main/server/middleware/upload.js"
click node_app_server "https://github.com/adityamullaguri/portfolio/blob/main/server/server.js"
click node_sqlite "https://github.com/adityamullaguri/portfolio/blob/main/server/db.js"
click node_backup "https://github.com/adityamullaguri/portfolio/blob/main/server/backup.js"
click node_seed "https://github.com/adityamullaguri/portfolio/blob/main/server/seed.js"
click node_state_file "https://github.com/adityamullaguri/portfolio/blob/main/data/portfolio-state.json"
click node_media_store "https://github.com/adityamullaguri/portfolio/tree/main/data/uploads"

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_portfolio,node_public_ui toneBlue
class node_admin_ui,node_admin_pages toneAmber
class node_auth_routes,node_admin_routes,node_public_routes,node_auth_middleware,node_uploads,node_app_server toneMint
class node_sqlite,node_backup,node_seed,node_state_file,node_media_store toneRose
class node_visitor,node_admin_user,node_github toneIndigo
```

## Components

### Public Portfolio

- [Portfolio Page](https://github.com/adityamullaguri/portfolio/blob/main/index.html): `index.html`
- [Portfolio Interactions](https://github.com/adityamullaguri/portfolio/blob/main/script.js): `script.js`

### Admin CMS

- [Dashboard SPA](https://github.com/adityamullaguri/portfolio/blob/main/admin/admin.js): `admin/admin.js`
- [Admin Pages](https://github.com/adityamullaguri/portfolio/blob/main/admin/dashboard.html): `admin/dashboard.html`

### Application Backend

- [Authentication](https://github.com/adityamullaguri/portfolio/blob/main/server/routes/auth.js): `server/routes/auth.js`
- [Admin API](https://github.com/adityamullaguri/portfolio/blob/main/server/routes/admin.js): `server/routes/admin.js`
- [Public API](https://github.com/adityamullaguri/portfolio/blob/main/server/routes/public.js): `server/routes/public.js`
- [JWT Guard](https://github.com/adityamullaguri/portfolio/blob/main/server/middleware/auth.js): `server/middleware/auth.js`
- [Media Uploads](https://github.com/adityamullaguri/portfolio/blob/main/server/middleware/upload.js): `server/middleware/upload.js`
- [Express Server](https://github.com/adityamullaguri/portfolio/blob/main/server/server.js): `server/server.js`

### Persistence

- [Portfolio Database](https://github.com/adityamullaguri/portfolio/blob/main/server/db.js): `server/db.js`
- [Backup and Restore](https://github.com/adityamullaguri/portfolio/blob/main/server/backup.js): `server/backup.js`
- [Initial Content Seed](https://github.com/adityamullaguri/portfolio/blob/main/server/seed.js): `server/seed.js`
- [State Snapshot](https://github.com/adityamullaguri/portfolio/blob/main/data/portfolio-state.json): `data/portfolio-state.json`
- [Uploaded Media](https://github.com/adityamullaguri/portfolio/tree/main/data/uploads): `data/uploads`

### Other components

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

## Connections

- Visitor → Portfolio Page: visits
- Express Server → Portfolio Page: serves (evidence: `server/server.js`)
- Express Server → Admin Pages: serves (evidence: `server/server.js`)
- Administrator → Admin Pages: opens
- Admin Pages → Dashboard SPA: loads (evidence: `admin/admin.js`)
- Dashboard SPA → Authentication: authenticates
- Dashboard SPA → Admin API: calls (evidence: `admin/admin.js`)
- Portfolio Page → Portfolio Interactions: loads
- Portfolio Interactions → Public API: fetches content
- Portfolio Interactions → Public API: submits contact
- Express Server → Authentication: mounts (evidence: `server/server.js`)
- Express Server → Public API: mounts (evidence: `server/server.js`)
- Express Server → Admin API: mounts (evidence: `server/server.js`)
- Authentication → Portfolio Database: reads and writes (evidence: `server/routes/auth.js`)
- Authentication → JWT Guard: guards session (evidence: `server/routes/auth.js`)
- Admin API → JWT Guard: guards routes (evidence: `server/routes/admin.js`)
- Admin API → Portfolio Database: reads and writes (evidence: `server/routes/admin.js`)
- Admin API → Media Uploads: handles media (evidence: `server/routes/admin.js`)
- Media Uploads → Uploaded Media: writes files (evidence: `server/middleware/upload.js`)
- Express Server → Uploaded Media: serves files (evidence: `server/server.js`)
- Public API → Portfolio Database: reads and writes (evidence: `server/routes/public.js`)
- Express Server → Initial Content Seed: runs seed (evidence: `server/server.js`)
- Initial Content Seed → Portfolio Database: initializes content (evidence: `server/seed.js`)
- Initial Content Seed → Backup and Restore: restores state (evidence: `server/seed.js`)
- Backup and Restore → Portfolio Database: exports and imports
- Backup and Restore → State Snapshot: persists snapshot
- Backup and Restore → GitHub: publishes content (evidence: `server/backup.js`)
