# 333ian/my-portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/333ian/my-portfolio
- Repository: https://github.com/333ian/my-portfolio

## Overview

This repository is a personal portfolio SPA with a Django REST contact-message backend. Visitors browse the introduction, biography, credentials and project showcase, then may submit a message; the API validates and stores it before attempting email delivery. The frontend component wiring and contact API flow are visible in excerpts. The README documents PostgreSQL and the email integration, but the database configuration and several supporting modules were not sampled, so those links reflect documentation rather than inspected implementation.

Main entry points: [`frontend/src/App.jsx`](https://github.com/333ian/my-portfolio/blob/main/frontend/src/App.jsx) (Portfolio App), [`frontend/src/components/Header.jsx`](https://github.com/333ian/my-portfolio/blob/main/frontend/src/components/Header.jsx) (Navigation), [`backend/portcontact/contactapp/views.py`](https://github.com/333ian/my-portfolio/blob/main/backend/portcontact/contactapp/views.py) (Contact Handler), [`frontend/src/pages/Contact.jsx`](https://github.com/333ian/my-portfolio/blob/main/frontend/src/pages/Contact.jsx) (Contact Form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portfolio["Portfolio Experience"]
  node_spa["Portfolio App<br/>[App.jsx]"]
  node_header["Navigation<br/>[Header.jsx]"]
  node_footer["Footer<br/>[Footer.jsx]"]
end

subgraph group_content["Portfolio Content"]
  node_home["Introduction<br/>[Home.jsx]"]
  node_about["Biography &amp; Skills<br/>[About.jsx]"]
  node_certs["Certifications<br/>[Certifications.jsx]"]
  node_projects["Project Showcase<br/>[Projects.jsx]"]
  node_contactform["Contact Form<br/>[Contact.jsx]"]
end

subgraph group_contact["Contact API"]
  node_api_routes["Contact Routes<br/>[urls.py]"]
  node_api_view["Contact Handler<br/>[views.py]"]
  node_serializer["Message Validation<br/>[serializers.py]"]
  node_contact_record[("Contact Record<br/>[models.py]")]
  node_postgres[("PostgreSQL")]
end

subgraph group_delivery["Message Delivery"]
  node_email_task["Email Sender<br/>[tasks.py]"]
  node_resend["Resend Email API"]
end

node_visitor(("Visitor"))
node_portfolio_owner(("Portfolio Owner"))

node_visitor -->|"opens"| node_spa
node_spa -->|"renders"| node_header
node_spa -->|"renders"| node_home
node_spa -->|"renders"| node_about
node_spa -->|"renders"| node_certs
node_spa -->|"renders"| node_projects
node_spa -->|"renders"| node_contactform
node_spa -->|"renders"| node_footer
node_header -->|"scrolls to"| node_home
node_header -->|"scrolls to"| node_about
node_header -->|"scrolls to"| node_certs
node_header -->|"scrolls to"| node_projects
node_header -->|"scrolls to"| node_contactform
node_contactform -->|"posts message"| node_api_routes
node_api_routes -->|"routes to"| node_api_view
node_api_view -->|"validates with"| node_serializer
node_serializer -->|"serializes"| node_contact_record
node_api_view -->|"invokes"| node_email_task
node_contact_record -.->|"stored in"| node_postgres
node_email_task -->|"sends through"| node_resend
node_resend -.->|"delivers email"| node_portfolio_owner

click node_spa "https://github.com/333ian/my-portfolio/blob/main/frontend/src/App.jsx"
click node_header "https://github.com/333ian/my-portfolio/blob/main/frontend/src/components/Header.jsx"
click node_footer "https://github.com/333ian/my-portfolio/blob/main/frontend/src/components/Footer.jsx"
click node_home "https://github.com/333ian/my-portfolio/blob/main/frontend/src/pages/Home.jsx"
click node_about "https://github.com/333ian/my-portfolio/blob/main/frontend/src/pages/About.jsx"
click node_certs "https://github.com/333ian/my-portfolio/blob/main/frontend/src/pages/Certifications.jsx"
click node_projects "https://github.com/333ian/my-portfolio/blob/main/frontend/src/pages/Projects.jsx"
click node_contactform "https://github.com/333ian/my-portfolio/blob/main/frontend/src/pages/Contact.jsx"
click node_api_routes "https://github.com/333ian/my-portfolio/blob/main/backend/portcontact/contactapp/urls.py"
click node_api_view "https://github.com/333ian/my-portfolio/blob/main/backend/portcontact/contactapp/views.py"
click node_serializer "https://github.com/333ian/my-portfolio/blob/main/backend/portcontact/contactapp/serializers.py"
click node_contact_record "https://github.com/333ian/my-portfolio/blob/main/backend/portcontact/contactapp/models.py"
click node_email_task "https://github.com/333ian/my-portfolio/blob/main/backend/portcontact/contactapp/tasks.py"

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_spa,node_header,node_footer toneBlue
class node_home,node_about,node_certs,node_projects,node_contactform toneAmber
class node_api_routes,node_api_view,node_serializer,node_contact_record,node_postgres toneMint
class node_email_task,node_resend toneRose
class node_visitor,node_portfolio_owner toneIndigo
```

## Components

### Portfolio Experience

- [Portfolio App](https://github.com/333ian/my-portfolio/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Navigation](https://github.com/333ian/my-portfolio/blob/main/frontend/src/components/Header.jsx): `frontend/src/components/Header.jsx`
- [Footer](https://github.com/333ian/my-portfolio/blob/main/frontend/src/components/Footer.jsx): `frontend/src/components/Footer.jsx`

### Portfolio Content

- [Introduction](https://github.com/333ian/my-portfolio/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`
- [Biography & Skills](https://github.com/333ian/my-portfolio/blob/main/frontend/src/pages/About.jsx): `frontend/src/pages/About.jsx`
- [Certifications](https://github.com/333ian/my-portfolio/blob/main/frontend/src/pages/Certifications.jsx): `frontend/src/pages/Certifications.jsx`
- [Project Showcase](https://github.com/333ian/my-portfolio/blob/main/frontend/src/pages/Projects.jsx): `frontend/src/pages/Projects.jsx`
- [Contact Form](https://github.com/333ian/my-portfolio/blob/main/frontend/src/pages/Contact.jsx): `frontend/src/pages/Contact.jsx`

### Contact API

- [Contact Routes](https://github.com/333ian/my-portfolio/blob/main/backend/portcontact/contactapp/urls.py): `backend/portcontact/contactapp/urls.py`
- [Contact Handler](https://github.com/333ian/my-portfolio/blob/main/backend/portcontact/contactapp/views.py): `backend/portcontact/contactapp/views.py`
- [Message Validation](https://github.com/333ian/my-portfolio/blob/main/backend/portcontact/contactapp/serializers.py): `backend/portcontact/contactapp/serializers.py`
- [Contact Record](https://github.com/333ian/my-portfolio/blob/main/backend/portcontact/contactapp/models.py): `backend/portcontact/contactapp/models.py`
- **PostgreSQL**

### Message Delivery

- [Email Sender](https://github.com/333ian/my-portfolio/blob/main/backend/portcontact/contactapp/tasks.py): `backend/portcontact/contactapp/tasks.py`
- **Resend Email API**

### Other components

- **Visitor**
- **Portfolio Owner**

## Connections

- Visitor → Portfolio App: opens (evidence: `README.md`)
- Portfolio App → Navigation: renders (evidence: `frontend/src/App.jsx`)
- Portfolio App → Introduction: renders (evidence: `frontend/src/App.jsx`)
- Portfolio App → Biography & Skills: renders (evidence: `frontend/src/App.jsx`)
- Portfolio App → Certifications: renders (evidence: `frontend/src/App.jsx`)
- Portfolio App → Project Showcase: renders (evidence: `frontend/src/App.jsx`)
- Portfolio App → Contact Form: renders (evidence: `frontend/src/App.jsx`)
- Portfolio App → Footer: renders (evidence: `frontend/src/App.jsx`)
- Navigation → Introduction: scrolls to (evidence: `frontend/src/components/Header.jsx`)
- Navigation → Biography & Skills: scrolls to (evidence: `frontend/src/components/Header.jsx`)
- Navigation → Certifications: scrolls to (evidence: `frontend/src/components/Header.jsx`)
- Navigation → Project Showcase: scrolls to (evidence: `frontend/src/components/Header.jsx`)
- Navigation → Contact Form: scrolls to (evidence: `frontend/src/components/Header.jsx`)
- Contact Form → Contact Routes: posts message (evidence: `frontend/src/pages/Contact.jsx`)
- Contact Routes → Contact Handler: routes to (evidence: `backend/portcontact/contactapp/urls.py`)
- Contact Handler → Message Validation: validates with (evidence: `backend/portcontact/contactapp/views.py`)
- Message Validation → Contact Record: serializes (evidence: `backend/portcontact/contactapp/serializers.py`)
- Contact Handler → Email Sender: invokes (evidence: `backend/portcontact/contactapp/views.py`)
- Contact Record → PostgreSQL: stored in (evidence: `README.md`)
- Email Sender → Resend Email API: sends through (evidence: `backend/portcontact/contactapp/tasks.py`)
- Resend Email API → Portfolio Owner: delivers email (evidence: `README.md`)
