# cedzzzzzzzzz/cedz-portfoliowebsite architecture

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

- Interactive diagram: https://gitdiagram.com/cedzzzzzzzzz/cedz-portfoliowebsite
- Repository: https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite

## Overview

This repository is a static personal portfolio with a Netlify-hosted AI chat backend. A visitor browses portfolio content and can use the chat interface to ask questions; the chat handler validates and rate-limits requests, supplies approved portfolio facts to a Gemini-backed provider, and returns a reply. The site also presents projects, skills, experience, and credentials, with downloadable CV/certificate documents and project imagery. Frontend/backend chat wiring is only partially shown, so that link is marked unverified; other edges follow the excerpts or README.

Main entry points: [`index.html`](https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/index.html) (Portfolio page), [`netlify/functions/chat.ts`](https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/netlify/functions/chat.ts) (Chat endpoint), [`netlify/lib/gemini.ts`](https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/netlify/lib/gemini.ts) (Gemini provider), [`script.js`](https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/script.js) (Chat interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Portfolio site"]
  node_webpage["Portfolio page<br/>[index.html]"]
  node_site_style["Responsive styling<br/>[styles.css]"]
  node_site_behavior["Site interactions<br/>[script.js]"]
  node_chat_ui["Chat interface<br/>[script.js]"]
end

subgraph group_content["Portfolio content"]
  node_project_media["Project imagery"]
  node_portrait["Portrait images"]
  node_credentials["CV and certificates"]
  node_portfolio_facts["Portfolio facts<br/>[facts.ts]"]
end

subgraph group_chat["Chat service"]
  node_chat_handler["Chat endpoint<br/>[chat.ts]"]
  node_health_endpoint["Health endpoint<br/>[health.ts]"]
  node_rate_limit["Request limiter<br/>[rateLimiter.ts]"]
  node_provider_contract["Provider contract<br/>[provider.ts]"]
  node_gemini_provider["Gemini provider<br/>[gemini.ts]"]
end

subgraph group_integrations["External services"]
  node_gemini_service{{"Google Gemini"}}
end

node_visitor(("Visitor"))

node_visitor -->|"browses"| node_webpage
node_webpage -->|"styled by"| node_site_style
node_webpage -->|"enhanced by"| node_site_behavior
node_webpage -->|"presents"| node_project_media
node_webpage -->|"presents"| node_portrait
node_webpage -->|"links to"| node_credentials
node_visitor -.->|"asks questions"| node_chat_ui
node_chat_ui -.->|"posts message"| node_chat_handler
node_chat_handler -->|"checks limit"| node_rate_limit
node_chat_handler -->|"serializes facts"| node_portfolio_facts
node_chat_handler -->|"requests reply"| node_gemini_provider
node_gemini_provider -->|"implements"| node_provider_contract
node_gemini_provider -->|"generates response"| node_gemini_service
node_chat_handler -->|"returns response"| node_visitor

click node_webpage "https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/index.html"
click node_site_style "https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/styles.css"
click node_site_behavior "https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/script.js"
click node_project_media "https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/tree/main/Project_Screenshots"
click node_portrait "https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/tree/main/Myself_Pics"
click node_credentials "https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/tree/main/CV"
click node_chat_ui "https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/script.js"
click node_chat_handler "https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/netlify/functions/chat.ts"
click node_health_endpoint "https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/netlify/functions/health.ts"
click node_rate_limit "https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/netlify/lib/rateLimiter.ts"
click node_portfolio_facts "https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/netlify/data/facts.ts"
click node_provider_contract "https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/netlify/lib/provider.ts"
click node_gemini_provider "https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/netlify/lib/gemini.ts"

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_webpage,node_site_style,node_site_behavior,node_chat_ui toneBlue
class node_project_media,node_portrait,node_credentials,node_portfolio_facts toneAmber
class node_chat_handler,node_health_endpoint,node_rate_limit,node_provider_contract,node_gemini_provider toneMint
class node_gemini_service toneRose
class node_visitor toneIndigo
```

## Components

### Portfolio site

- [Portfolio page](https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/index.html): `index.html`
- [Responsive styling](https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/styles.css): `styles.css`
- [Site interactions](https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/script.js): `script.js`
- [Chat interface](https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/script.js): `script.js`

### Portfolio content

- [Project imagery](https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/tree/main/Project_Screenshots): `Project_Screenshots`
- [Portrait images](https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/tree/main/Myself_Pics): `Myself_Pics`
- [CV and certificates](https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/tree/main/CV): `CV`
- [Portfolio facts](https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/netlify/data/facts.ts): `netlify/data/facts.ts`

### Chat service

- [Chat endpoint](https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/netlify/functions/chat.ts): `netlify/functions/chat.ts`
- [Health endpoint](https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/netlify/functions/health.ts): `netlify/functions/health.ts`
- [Request limiter](https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/netlify/lib/rateLimiter.ts): `netlify/lib/rateLimiter.ts`
- [Provider contract](https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/netlify/lib/provider.ts): `netlify/lib/provider.ts`
- [Gemini provider](https://github.com/cedzzzzzzzzz/cedz-portfoliowebsite/blob/main/netlify/lib/gemini.ts): `netlify/lib/gemini.ts`

### External services

- **Google Gemini**

### Other components

- **Visitor**

## Connections

- Visitor → Portfolio page: browses (evidence: `README.md`)
- Portfolio page → Responsive styling: styled by (evidence: `README.md`)
- Portfolio page → Site interactions: enhanced by (evidence: `README.md`)
- Portfolio page → Project imagery: presents (evidence: `README.md`)
- Portfolio page → Portrait images: presents (evidence: `README.md`)
- Portfolio page → CV and certificates: links to (evidence: `README.md`)
- Visitor → Chat interface: asks questions
- Chat interface → Chat endpoint: posts message
- Chat endpoint → Request limiter: checks limit (evidence: `netlify/functions/chat.ts`)
- Chat endpoint → Portfolio facts: serializes facts (evidence: `netlify/functions/chat.ts`)
- Chat endpoint → Gemini provider: requests reply (evidence: `netlify/functions/chat.ts`)
- Gemini provider → Provider contract: implements (evidence: `netlify/lib/gemini.ts`)
- Gemini provider → Google Gemini: generates response (evidence: `netlify/lib/gemini.ts`)
- Chat endpoint → Visitor: returns response (evidence: `netlify/functions/chat.ts`)
