# bhavadharani412/personal_portfolio_v2 architecture

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

- Interactive diagram: https://gitdiagram.com/bhavadharani412/personal_portfolio_v2
- Repository: https://github.com/bhavadharani412/personal_portfolio_v2

## Overview

This repository is an interactive personal portfolio with a grounded AI digital twin and anonymous engagement analytics. Visitors discover the engineer through portfolio sections, can ask the chatbot questions, and can follow contact links; the app also sends attribution and engagement events to an edge API. The Worker retrieves portfolio evidence, calls Groq, and records chat and analytics data in D1. Component-to-app and Worker-to-service links are supported by excerpts or README statements; unsampled implementation details are not expanded.

Main entry points: [`src/App.tsx`](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/App.tsx) (Portfolio App), [`worker/index.ts`](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/worker/index.ts) (Worker API), [`src/data/portfolioData.ts`](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/data/portfolioData.ts) (Portfolio Data), [`src/components/Blogs.tsx`](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/Blogs.tsx) (Articles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Portfolio Experience"]
  node_app["Portfolio App<br/>[App.tsx]"]
  node_nav["Navigation<br/>[Navbar.tsx]"]
  node_hero["Hero<br/>[Hero.tsx]"]
  node_contact["Contact<br/>[Contact.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
end

subgraph group_content["Portfolio Content"]
  node_about["About<br/>[AboutMe.tsx]"]
  node_journey["Journey<br/>[Journey.tsx]"]
  node_projects["Projects<br/>[Projects.tsx]"]
  node_blogs["Articles<br/>[Blogs.tsx]"]
  node_article["Article Modal<br/>[ArticleModal.tsx]"]
  node_open_source["Open Source<br/>[OpenSource.tsx]"]
  node_skills["Skills<br/>[Skills.tsx]"]
  node_portfolio_data["Portfolio Data<br/>[portfolioData.ts]"]
end

subgraph group_assistant["AI Digital Twin"]
  node_chat_ui["Chat Interface<br/>[Chatbot.tsx]"]
  node_retrieval["Knowledge Retrieval<br/>[knowledge.ts]"]
  node_groq["Groq Inference<br/>[groq.ts]"]
end

subgraph group_edge["Edge Services"]
  node_worker_api["Worker API<br/>[index.ts]"]
  node_limiter["Rate Limiter<br/>[rateLimiter.ts]"]
end

subgraph group_telemetry["Telemetry"]
  node_analytics_client["Analytics Client<br/>[analytics.ts]"]
  node_worker_analytics["Event and Chat Logging<br/>[analytics.ts]"]
  node_d1[("Cloudflare D1")]
end

node_visitor(("Visitor"))
node_groq_service["Groq API"]

node_visitor -->|"visits"| node_app
node_app -->|"renders"| node_nav
node_app -->|"renders"| node_hero
node_app -->|"renders"| node_about
node_app -->|"renders"| node_journey
node_app -->|"renders"| node_projects
node_app -->|"renders"| node_blogs
node_app -->|"renders"| node_open_source
node_app -->|"renders"| node_skills
node_app -->|"renders"| node_contact
node_app -->|"renders"| node_footer
node_app -->|"renders"| node_chat_ui
node_app -->|"tracks page view"| node_analytics_client
node_hero -->|"reads"| node_portfolio_data
node_journey -->|"reads"| node_portfolio_data
node_projects -->|"reads"| node_portfolio_data
node_blogs -->|"reads"| node_portfolio_data
node_blogs -->|"opens"| node_article
node_chat_ui -->|"tracks chat"| node_analytics_client
node_analytics_client -->|"posts events"| node_worker_api
node_chat_ui -->|"sends questions"| node_worker_api
node_worker_api -->|"checks limits"| node_limiter
node_worker_api -->|"retrieves evidence"| node_retrieval
node_worker_api -->|"requests answers"| node_groq
node_groq -->|"calls inference"| node_groq_service
node_worker_api -->|"records events and chat"| node_worker_analytics
node_worker_analytics -->|"writes records"| node_d1

click node_app "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/App.tsx"
click node_nav "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/Navbar.tsx"
click node_hero "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/Hero.tsx"
click node_about "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/AboutMe.tsx"
click node_journey "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/Journey.tsx"
click node_projects "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/Projects.tsx"
click node_blogs "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/Blogs.tsx"
click node_article "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/ArticleModal.tsx"
click node_open_source "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/OpenSource.tsx"
click node_skills "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/Skills.tsx"
click node_contact "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/Contact.tsx"
click node_footer "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/Footer.tsx"
click node_portfolio_data "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/data/portfolioData.ts"
click node_chat_ui "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/Chatbot.tsx"
click node_analytics_client "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/utils/analytics.ts"
click node_worker_api "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/worker/index.ts"
click node_limiter "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/worker/rateLimiter.ts"
click node_retrieval "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/worker/knowledge.ts"
click node_groq "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/worker/groq.ts"
click node_worker_analytics "https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/worker/analytics.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_app,node_nav,node_hero,node_contact,node_footer toneBlue
class node_about,node_journey,node_projects,node_blogs,node_article,node_open_source,node_skills,node_portfolio_data toneAmber
class node_chat_ui,node_retrieval,node_groq,node_groq_service toneMint
class node_worker_api,node_limiter toneRose
class node_analytics_client,node_worker_analytics,node_d1,node_visitor toneIndigo
```

## Components

### Portfolio Experience

- [Portfolio App](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/App.tsx): `src/App.tsx`
- [Navigation](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Hero](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/Hero.tsx): `src/components/Hero.tsx`
- [Contact](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/Contact.tsx): `src/components/Contact.tsx`
- [Footer](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/Footer.tsx): `src/components/Footer.tsx`

### Portfolio Content

- [About](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/AboutMe.tsx): `src/components/AboutMe.tsx`
- [Journey](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/Journey.tsx): `src/components/Journey.tsx`
- [Projects](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/Projects.tsx): `src/components/Projects.tsx`
- [Articles](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/Blogs.tsx): `src/components/Blogs.tsx`
- [Article Modal](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/ArticleModal.tsx): `src/components/ArticleModal.tsx`
- [Open Source](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/OpenSource.tsx): `src/components/OpenSource.tsx`
- [Skills](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/Skills.tsx): `src/components/Skills.tsx`
- [Portfolio Data](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/data/portfolioData.ts): `src/data/portfolioData.ts`

### AI Digital Twin

- [Chat Interface](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/components/Chatbot.tsx): `src/components/Chatbot.tsx`
- [Knowledge Retrieval](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/worker/knowledge.ts): `worker/knowledge.ts`
- [Groq Inference](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/worker/groq.ts): `worker/groq.ts`

### Edge Services

- [Worker API](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/worker/index.ts): `worker/index.ts`
- [Rate Limiter](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/worker/rateLimiter.ts): `worker/rateLimiter.ts`

### Telemetry

- [Analytics Client](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/src/utils/analytics.ts): `src/utils/analytics.ts`
- [Event and Chat Logging](https://github.com/bhavadharani412/personal_portfolio_v2/blob/main/worker/analytics.ts): `worker/analytics.ts`
- **Cloudflare D1**

### Other components

- **Visitor**
- **Groq API**

## Connections

- Visitor → Portfolio App: visits (evidence: `README.md`)
- Portfolio App → Navigation: renders (evidence: `src/App.tsx`)
- Portfolio App → Hero: renders (evidence: `src/App.tsx`)
- Portfolio App → About: renders (evidence: `src/App.tsx`)
- Portfolio App → Journey: renders (evidence: `src/App.tsx`)
- Portfolio App → Projects: renders (evidence: `src/App.tsx`)
- Portfolio App → Articles: renders (evidence: `src/App.tsx`)
- Portfolio App → Open Source: renders (evidence: `src/App.tsx`)
- Portfolio App → Skills: renders (evidence: `src/App.tsx`)
- Portfolio App → Contact: renders (evidence: `src/App.tsx`)
- Portfolio App → Footer: renders (evidence: `src/App.tsx`)
- Portfolio App → Chat Interface: renders (evidence: `src/App.tsx`)
- Portfolio App → Analytics Client: tracks page view (evidence: `src/App.tsx`)
- Hero → Portfolio Data: reads (evidence: `src/components/Hero.tsx`)
- Journey → Portfolio Data: reads (evidence: `src/components/Journey.tsx`)
- Projects → Portfolio Data: reads (evidence: `src/components/Projects.tsx`)
- Articles → Portfolio Data: reads (evidence: `src/components/Blogs.tsx`)
- Articles → Article Modal: opens (evidence: `src/components/Blogs.tsx`)
- Chat Interface → Analytics Client: tracks chat (evidence: `src/components/Chatbot.tsx`)
- Analytics Client → Worker API: posts events (evidence: `src/utils/analytics.ts`)
- Chat Interface → Worker API: sends questions (evidence: `README.md`)
- Worker API → Rate Limiter: checks limits (evidence: `worker/index.ts`)
- Worker API → Knowledge Retrieval: retrieves evidence (evidence: `worker/index.ts`)
- Worker API → Groq Inference: requests answers (evidence: `worker/index.ts`)
- Groq Inference → Groq API: calls inference (evidence: `worker/groq.ts`)
- Worker API → Event and Chat Logging: records events and chat (evidence: `worker/index.ts`)
- Event and Chat Logging → Cloudflare D1: writes records (evidence: `README.md`)
