# sunnyspringwind/portfolio-site architecture

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

- Interactive diagram: https://gitdiagram.com/sunnyspringwind/portfolio-site
- Repository: https://github.com/sunnyspringwind/portfolio-site

## Overview

##### Project type and purpose
- This is a full-stack portfolio site (“JAMstack”-style) with
- A React + TypeScript + Vite + Tailwind frontend
- A Node/TypeScript + Express backend exposing a “message” REST API
- A serverless function (Netlify Functions/sendEmail.ts) for handling outbound emails
- A MongoDB (via Mongoose) datastore for persisting incoming messages

##### File structure
- Top level splits into `frontend/` and `backend/`
- backend/src/config – app & DB config (db.ts likely uses Mongoose to connect MongoDB)
- backend/src/controllers & models & routes – classic MVC arrangement
- backend/src/server.ts – Express app entrypoint
- frontend/src – React component tree, pages, services, and assets
- frontend/netlify/functions – serverless function(s) to send email directly from browser requests
- Config and build files
- tsconfig.json in both tiers, package.json scripts, Vite config, Netlify redirect rules

##### Insights from README
- It’s deployed as a portfolio on GitHub Pages (static) but contains Netlify function config – likely deployed on Netlify or similar CDN+serverless platform
- Core features: show projects, roadmap, contact form

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Frontend Layer"
        direction TB
        Browser["User Browser"]:::external
        CDN["CDN/Static Host"]:::frontend
        index["index.html"]:::frontend
        main["main.tsx"]:::frontend
        App["App.tsx"]:::frontend
        Browser --> CDN --> index --> main --> App
    end

    subgraph "Backend Layer"
        direction TB
        API["Express API"]:::backend
        server["server.ts"]:::backend
        configApp["config/app.ts"]:::backend
        configDb["config/db.ts"]:::backend
        routes["message.routes.ts"]:::backend
        controller["message.controller.ts"]:::backend
        model["message.schema.ts"]:::backend
        server --> configApp --> routes --> controller --> model
        server --> configDb --> model
        API --> server
    end

    subgraph "Serverless Functions"
        direction TB
        NetlifyFunc["Netlify Function: sendEmail"]:::serverless
    end

    subgraph "External Services"
        direction TB
        DB["MongoDB (Atlas)"]:::database
        EmailSvc["Email Service (SMTP/API)"]:::external
    end

    App -->|"REST API Calls"| API
    App -->|"Invoke Email Function"| NetlifyFunc
    API -->|"Read/Write"| DB
    NetlifyFunc -->|"Store Log"| DB
    NetlifyFunc -->|"Send Email"| EmailSvc

    click index "https://github.com/sunnyspringwind/portfolio-site/blob/master/frontend/index.html"
    click main "https://github.com/sunnyspringwind/portfolio-site/blob/master/frontend/src/main.tsx"
    click App "https://github.com/sunnyspringwind/portfolio-site/blob/master/frontend/src/App.tsx"
    click server "https://github.com/sunnyspringwind/portfolio-site/blob/master/backend/src/server.ts"
    click configApp "https://github.com/sunnyspringwind/portfolio-site/blob/master/backend/src/config/app.ts"
    click configDb "https://github.com/sunnyspringwind/portfolio-site/blob/master/backend/src/config/db.ts"
    click routes "https://github.com/sunnyspringwind/portfolio-site/blob/master/backend/src/routes/message.routes.ts"
    click controller "https://github.com/sunnyspringwind/portfolio-site/blob/master/backend/src/controllers/message.controller.ts"
    click model "https://github.com/sunnyspringwind/portfolio-site/blob/master/backend/src/models/message.schema.ts"
    click NetlifyFunc "https://github.com/sunnyspringwind/portfolio-site/blob/master/frontend/netlify/functions/sendEmail.ts"

    classDef frontend fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef backend fill:#90EE90,stroke:#000,stroke-width:1px
    classDef serverless fill:#D8BFD8,stroke:#000,stroke-width:1px
    classDef database fill:#FFA500,stroke:#000,stroke-width:1px
    classDef external fill:#F5F5F5,stroke:#000,stroke-width:1px
```
