# sippolajoose/personal-website architecture

> Architecture diagram of the GitHub repository sippolajoose/personal-website, 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/sippolajoose/personal-website
- Repository: https://github.com/sippolajoose/personal-website

## Overview

This monorepo serves a personal website backed by an Express API and MongoDB. Visitors navigate the frontend’s home, projects, architecture, and playground pages; profile and feedback data flow through the API, backend services, and repositories. The site also supports Finnish and English, theme switching, health checks, and deliberate profile seeding. Backend route and service wiring is supported by the source index; unsampled view and endpoint details are represented only at the documented module level.

Main entry points: [`frontend/src/App.vue`](https://github.com/sippolajoose/personal-website/blob/master/frontend/src/App.vue) (App shell), [`frontend/src/services/api.ts`](https://github.com/sippolajoose/personal-website/blob/master/frontend/src/services/api.ts) (HTTP client), [`backend/src/app.ts`](https://github.com/sippolajoose/personal-website/blob/master/backend/src/app.ts) (API application), [`frontend/src/components/SiteFooter.vue`](https://github.com/sippolajoose/personal-website/blob/master/frontend/src/components/SiteFooter.vue) (Site footer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Website experience"]
  node_app["App shell<br/>[App.vue]"]
  node_home["Home page<br/>[HomeView.vue]"]
  node_projects["Projects page<br/>[ProjectsView.vue]"]
  node_architecture["Architecture page"]
  node_playground["Playground pages<br/>[PlaygroundView.vue]"]
  node_playground_index["Playground index"]
  node_feedback_ui["Feedback display"]
  node_footer["Site footer<br/>[SiteFooter.vue]"]
end

subgraph group_client["Frontend data and localization"]
  node_profile_store["Profile store<br/>[profile.ts]"]
  node_client_api["HTTP client<br/>[api.ts]"]
  node_localization["Localization<br/>[index.ts]"]
  node_theme["Theme state<br/>[theme.ts]"]
end

subgraph group_api["Backend API"]
  node_backend_app["API application<br/>[app.ts]"]
  node_health["Health endpoint<br/>[health.ts]"]
  node_profile_route["Profile endpoint<br/>[profile.ts]"]
  node_feedback_route["Feedback endpoints<br/>[feedback.ts]"]
  node_profile_service["Profile service<br/>[profileService.ts]"]
  node_feedback_service["Feedback service<br/>[feedbackService.ts]"]
end

subgraph group_data["Persistence and profile data"]
  node_mongo["MongoDB access<br/>[mongo.ts]"]
  node_profile_repo["Profile repository"]
  node_feedback_repo["Feedback repository"]
  node_profile_data["Profile records<br/>[profile.ts]"]
  node_feedback_data["Feedback records<br/>[feedback.ts]"]
  node_seed["Profile seeding<br/>[seed.ts]"]
end

node_visitor(("Visitor"))
node_database[("MongoDB")]

node_visitor -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_projects
node_app -->|"routes to"| node_architecture
node_app -->|"routes to"| node_playground_index
node_app -->|"routes to"| node_playground
node_app -->|"renders"| node_footer
node_footer -->|"renders"| node_feedback_ui
node_home -->|"loads profile"| node_profile_store
node_projects -->|"loads profile"| node_profile_store
node_feedback_ui -->|"loads feedback"| node_client_api
node_footer -->|"submits feedback"| node_client_api
node_profile_store -->|"fetches profile"| node_client_api
node_client_api -->|"requests profile"| node_profile_route
node_client_api -->|"requests feedback"| node_feedback_route
node_app -->|"toggles locale"| node_localization
node_app -->|"uses theme"| node_theme
node_backend_app -->|"mounts"| node_health
node_backend_app -->|"mounts"| node_profile_route
node_backend_app -->|"mounts"| node_feedback_route
node_profile_route -->|"calls"| node_profile_service
node_feedback_route -->|"calls"| node_feedback_service
node_profile_service -->|"reads profile"| node_profile_repo
node_feedback_service -->|"reads and writes"| node_feedback_repo
node_profile_repo -->|"gets database"| node_mongo
node_feedback_repo -->|"gets database"| node_mongo
node_mongo -->|"connects"| node_database
node_profile_repo -->|"uses type"| node_profile_data
node_feedback_repo -->|"uses type"| node_feedback_data
node_seed -->|"seeds profile"| node_database
node_seed -->|"uses defaults"| node_profile_data

click node_app "https://github.com/sippolajoose/personal-website/blob/master/frontend/src/App.vue"
click node_home "https://github.com/sippolajoose/personal-website/blob/master/frontend/src/views/HomeView.vue"
click node_projects "https://github.com/sippolajoose/personal-website/blob/master/frontend/src/views/ProjectsView.vue"
click node_architecture "https://github.com/sippolajoose/personal-website/blob/master/frontend/src/views/ArchitectureView.vue"
click node_playground "https://github.com/sippolajoose/personal-website/blob/master/frontend/src/views/PlaygroundView.vue"
click node_playground_index "https://github.com/sippolajoose/personal-website/blob/master/frontend/src/views/PlaygroundIndexView.vue"
click node_feedback_ui "https://github.com/sippolajoose/personal-website/blob/master/frontend/src/components/FeedbackScroller.vue"
click node_footer "https://github.com/sippolajoose/personal-website/blob/master/frontend/src/components/SiteFooter.vue"
click node_profile_store "https://github.com/sippolajoose/personal-website/blob/master/frontend/src/stores/profile.ts"
click node_client_api "https://github.com/sippolajoose/personal-website/blob/master/frontend/src/services/api.ts"
click node_localization "https://github.com/sippolajoose/personal-website/blob/master/frontend/src/i18n/index.ts"
click node_theme "https://github.com/sippolajoose/personal-website/blob/master/frontend/src/composables/theme.ts"
click node_backend_app "https://github.com/sippolajoose/personal-website/blob/master/backend/src/app.ts"
click node_health "https://github.com/sippolajoose/personal-website/blob/master/backend/src/routes/health.ts"
click node_profile_route "https://github.com/sippolajoose/personal-website/blob/master/backend/src/routes/profile.ts"
click node_feedback_route "https://github.com/sippolajoose/personal-website/blob/master/backend/src/routes/feedback.ts"
click node_profile_service "https://github.com/sippolajoose/personal-website/blob/master/backend/src/services/profileService.ts"
click node_feedback_service "https://github.com/sippolajoose/personal-website/blob/master/backend/src/services/feedbackService.ts"
click node_mongo "https://github.com/sippolajoose/personal-website/blob/master/backend/src/db/mongo.ts"
click node_profile_repo "https://github.com/sippolajoose/personal-website/blob/master/backend/src/repositories/profileRepository.ts"
click node_feedback_repo "https://github.com/sippolajoose/personal-website/blob/master/backend/src/repositories/feedbackRepository.ts"
click node_profile_data "https://github.com/sippolajoose/personal-website/blob/master/backend/src/types/profile.ts"
click node_feedback_data "https://github.com/sippolajoose/personal-website/blob/master/backend/src/types/feedback.ts"
click node_seed "https://github.com/sippolajoose/personal-website/blob/master/backend/src/scripts/seed.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_home,node_projects,node_architecture,node_playground,node_playground_index,node_feedback_ui,node_footer toneBlue
class node_profile_store,node_client_api,node_localization,node_theme,node_database toneAmber
class node_backend_app,node_health,node_profile_route,node_feedback_route,node_profile_service,node_feedback_service toneMint
class node_mongo,node_profile_repo,node_feedback_repo,node_profile_data,node_feedback_data,node_seed toneRose
class node_visitor toneIndigo
```

## Components

### Website experience

- [App shell](https://github.com/sippolajoose/personal-website/blob/master/frontend/src/App.vue): `frontend/src/App.vue`
- [Home page](https://github.com/sippolajoose/personal-website/blob/master/frontend/src/views/HomeView.vue): `frontend/src/views/HomeView.vue`
- [Projects page](https://github.com/sippolajoose/personal-website/blob/master/frontend/src/views/ProjectsView.vue): `frontend/src/views/ProjectsView.vue`
- [Architecture page](https://github.com/sippolajoose/personal-website/blob/master/frontend/src/views/ArchitectureView.vue): `frontend/src/views/ArchitectureView.vue`
- [Playground pages](https://github.com/sippolajoose/personal-website/blob/master/frontend/src/views/PlaygroundView.vue): `frontend/src/views/PlaygroundView.vue`
- [Playground index](https://github.com/sippolajoose/personal-website/blob/master/frontend/src/views/PlaygroundIndexView.vue): `frontend/src/views/PlaygroundIndexView.vue`
- [Feedback display](https://github.com/sippolajoose/personal-website/blob/master/frontend/src/components/FeedbackScroller.vue): `frontend/src/components/FeedbackScroller.vue`
- [Site footer](https://github.com/sippolajoose/personal-website/blob/master/frontend/src/components/SiteFooter.vue): `frontend/src/components/SiteFooter.vue`

### Frontend data and localization

- [Profile store](https://github.com/sippolajoose/personal-website/blob/master/frontend/src/stores/profile.ts): `frontend/src/stores/profile.ts`
- [HTTP client](https://github.com/sippolajoose/personal-website/blob/master/frontend/src/services/api.ts): `frontend/src/services/api.ts`
- [Localization](https://github.com/sippolajoose/personal-website/blob/master/frontend/src/i18n/index.ts): `frontend/src/i18n/index.ts`
- [Theme state](https://github.com/sippolajoose/personal-website/blob/master/frontend/src/composables/theme.ts): `frontend/src/composables/theme.ts`

### Backend API

- [API application](https://github.com/sippolajoose/personal-website/blob/master/backend/src/app.ts): `backend/src/app.ts`
- [Health endpoint](https://github.com/sippolajoose/personal-website/blob/master/backend/src/routes/health.ts): `backend/src/routes/health.ts`
- [Profile endpoint](https://github.com/sippolajoose/personal-website/blob/master/backend/src/routes/profile.ts): `backend/src/routes/profile.ts`
- [Feedback endpoints](https://github.com/sippolajoose/personal-website/blob/master/backend/src/routes/feedback.ts): `backend/src/routes/feedback.ts`
- [Profile service](https://github.com/sippolajoose/personal-website/blob/master/backend/src/services/profileService.ts): `backend/src/services/profileService.ts`
- [Feedback service](https://github.com/sippolajoose/personal-website/blob/master/backend/src/services/feedbackService.ts): `backend/src/services/feedbackService.ts`

### Persistence and profile data

- [MongoDB access](https://github.com/sippolajoose/personal-website/blob/master/backend/src/db/mongo.ts): `backend/src/db/mongo.ts`
- [Profile repository](https://github.com/sippolajoose/personal-website/blob/master/backend/src/repositories/profileRepository.ts): `backend/src/repositories/profileRepository.ts`
- [Feedback repository](https://github.com/sippolajoose/personal-website/blob/master/backend/src/repositories/feedbackRepository.ts): `backend/src/repositories/feedbackRepository.ts`
- [Profile records](https://github.com/sippolajoose/personal-website/blob/master/backend/src/types/profile.ts): `backend/src/types/profile.ts`
- [Feedback records](https://github.com/sippolajoose/personal-website/blob/master/backend/src/types/feedback.ts): `backend/src/types/feedback.ts`
- [Profile seeding](https://github.com/sippolajoose/personal-website/blob/master/backend/src/scripts/seed.ts): `backend/src/scripts/seed.ts`

### Other components

- **Visitor**
- **MongoDB**

## Connections

- Visitor → App shell: uses (evidence: `frontend/src/App.vue`)
- App shell → Home page: routes to
- App shell → Projects page: routes to
- App shell → Architecture page: routes to
- App shell → Playground index: routes to
- App shell → Playground pages: routes to
- App shell → Site footer: renders (evidence: `frontend/src/App.vue`)
- Site footer → Feedback display: renders (evidence: `frontend/src/components/SiteFooter.vue`)
- Home page → Profile store: loads profile (evidence: `frontend/src/views/HomeView.vue`)
- Projects page → Profile store: loads profile (evidence: `frontend/src/views/ProjectsView.vue`)
- Feedback display → HTTP client: loads feedback (evidence: `frontend/src/components/FeedbackScroller.vue`)
- Site footer → HTTP client: submits feedback (evidence: `frontend/src/components/SiteFooter.vue`)
- Profile store → HTTP client: fetches profile (evidence: `frontend/src/stores/profile.ts`)
- HTTP client → Profile endpoint: requests profile (evidence: `frontend/src/services/api.ts`)
- HTTP client → Feedback endpoints: requests feedback (evidence: `frontend/src/services/api.ts`)
- App shell → Localization: toggles locale (evidence: `frontend/src/App.vue`)
- App shell → Theme state: uses theme (evidence: `frontend/src/App.vue`)
- API application → Health endpoint: mounts (evidence: `backend/src/app.ts`)
- API application → Profile endpoint: mounts (evidence: `backend/src/app.ts`)
- API application → Feedback endpoints: mounts (evidence: `backend/src/app.ts`)
- Profile endpoint → Profile service: calls (evidence: `backend/src/routes/profile.ts`)
- Feedback endpoints → Feedback service: calls (evidence: `backend/src/routes/feedback.ts`)
- Profile service → Profile repository: reads profile (evidence: `backend/src/services/profileService.ts`)
- Feedback service → Feedback repository: reads and writes (evidence: `backend/src/services/feedbackService.ts`)
- Profile repository → MongoDB access: gets database (evidence: `backend/src/repositories/profileRepository.ts`)
- Feedback repository → MongoDB access: gets database (evidence: `backend/src/repositories/feedbackRepository.ts`)
- MongoDB access → MongoDB: connects (evidence: `backend/src/db/mongo.ts`)
- Profile repository → Profile records: uses type (evidence: `backend/src/repositories/profileRepository.ts`)
- Feedback repository → Feedback records: uses type (evidence: `backend/src/repositories/feedbackRepository.ts`)
- Profile seeding → MongoDB: seeds profile (evidence: `backend/src/scripts/seed.ts`)
- Profile seeding → Profile records: uses defaults (evidence: `backend/src/scripts/seed.ts`)
