# henrybeedham/portfolio-gallery architecture

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

- Interactive diagram: https://gitdiagram.com/henrybeedham/portfolio-gallery
- Repository: https://github.com/henrybeedham/portfolio-gallery

## Overview

Client Gallery is a self-hosted photography portfolio and client-delivery platform. Visitors browse public albums, unlock private galleries, view and share photos/videos, and download originals or ZIP selections; administrators manage media and settings, then track shoots, invoices, and analytics. The map separates gallery presentation, media processing and persistence, and business administration. The README documents the major capabilities and domain relationships; sampled source confirms selected component and media-processing responsibilities, but many route-to-service connections are not shown, so those are not asserted.

Main entry points: [`src/routes/admin`](https://github.com/henrybeedham/portfolio-gallery/tree/main/src/routes/admin) (Admin routes), [`src/lib/server/images.ts`](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/images.ts) (Photo processing), [`src/lib/server/jobs.ts`](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/jobs.ts) (Shoot scheduling), [`src/lib/server/db.ts`](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/db.ts) (SQLite database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public galleries"]
  node_public_routes["Public routes"]
  node_album_view["Album experience<br/>[AlbumView.svelte]"]
  node_photo_views["Photo and gallery views"]
  node_download_routes["Gallery downloads<br/>[+server.ts]"]
end

subgraph group_admin["Gallery administration"]
  node_admin_routes["Admin routes"]
  node_album_editor["Album and photo editor"]
  node_upload_widget["Chunked uploader<br/>[Uploader.svelte]"]
  node_theme_manager["Theme management"]
  node_auth["Session and access<br/>[auth.ts]"]
end

subgraph group_business["Jobs and finance"]
  node_jobs["Shoot scheduling<br/>[jobs.ts]"]
  node_invoices["Invoice accounting<br/>[invoices.ts]"]
  node_analytics["Business analytics<br/>[analytics.ts]"]
  node_calendar["Calendar feed<br/>[+server.ts]"]
end

subgraph group_media["Media processing"]
  node_media_ingest["Photo processing<br/>[images.ts]"]
  node_video_processing["Video previews<br/>[video-preview.ts]"]
  node_media_routes["Media delivery<br/>[+server.ts]"]
end

subgraph group_platform["Persistence and integrations"]
  node_album_domain["Album management<br/>[albums.ts]"]
  node_database[("SQLite database<br/>[db.ts]")]
  node_backups["Backups<br/>[backup-files.ts]"]
  node_lightroom["Lightroom integration<br/>[lightroom.ts]"]
  node_widgets["Scriptable widgets<br/>[Gallery.js]"]
end

node_visitor(("Gallery visitor"))
node_administrator(("Administrator"))

node_visitor -->|"browses"| node_public_routes
node_public_routes -->|"presents albums"| node_album_view
node_album_view -->|"shows photos"| node_photo_views
node_visitor -->|"requests downloads"| node_download_routes
node_download_routes -.->|"serves media"| node_media_routes
node_administrator -->|"manages galleries"| node_admin_routes
node_administrator -->|"signs in"| node_auth
node_admin_routes -.->|"checks access"| node_auth
node_admin_routes -->|"edits albums"| node_album_editor
node_album_editor -->|"uploads media"| node_upload_widget
node_administrator -->|"customizes themes"| node_theme_manager
node_admin_routes -->|"manages shoots"| node_jobs
node_admin_routes -->|"manages invoices"| node_invoices
node_admin_routes -->|"views analytics"| node_analytics
node_jobs -->|"links billing"| node_invoices
node_jobs -->|"links albums"| node_album_domain
node_upload_widget -.->|"sends uploads"| node_media_ingest
node_media_ingest -.->|"records media"| node_database
node_media_ingest -->|"creates video previews"| node_video_processing
node_video_processing -->|"generates variants"| node_media_ingest
node_media_routes -.->|"reads media records"| node_database
node_database -->|"writes backups"| node_backups
node_administrator -->|"publishes collections"| node_lightroom
node_administrator -->|"configures widgets"| node_widgets
node_administrator -->|"subscribes to jobs"| node_calendar

click node_public_routes "https://github.com/henrybeedham/portfolio-gallery/tree/main/src/routes"
click node_album_view "https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/components/AlbumView.svelte"
click node_photo_views "https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/components/PhotoGallery.svelte"
click node_download_routes "https://github.com/henrybeedham/portfolio-gallery/blob/main/src/routes/%5Bslug%5D/download/%2Bserver.ts"
click node_admin_routes "https://github.com/henrybeedham/portfolio-gallery/tree/main/src/routes/admin"
click node_album_editor "https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/components/admin/PhotoManager.svelte"
click node_upload_widget "https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/components/admin/Uploader.svelte"
click node_theme_manager "https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/components/admin/ThemeManager.svelte"
click node_auth "https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/auth.ts"
click node_album_domain "https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/albums.ts"
click node_jobs "https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/jobs.ts"
click node_invoices "https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/invoices.ts"
click node_analytics "https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/analytics.ts"
click node_media_ingest "https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/images.ts"
click node_video_processing "https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/video-preview.ts"
click node_media_routes "https://github.com/henrybeedham/portfolio-gallery/blob/main/src/routes/media/%5Bkey%5D/%5Bvariant%5D/%2Bserver.ts"
click node_database "https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/db.ts"
click node_backups "https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/backup-files.ts"
click node_lightroom "https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/lightroom.ts"
click node_widgets "https://github.com/henrybeedham/portfolio-gallery/blob/main/scriptable/Gallery.js"
click node_calendar "https://github.com/henrybeedham/portfolio-gallery/blob/main/src/routes/site/calendar/%5Btoken%5D.ics/%2Bserver.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_public_routes,node_album_view,node_photo_views,node_download_routes toneBlue
class node_admin_routes,node_album_editor,node_upload_widget,node_theme_manager,node_auth toneAmber
class node_jobs,node_invoices,node_analytics,node_calendar toneMint
class node_media_ingest,node_video_processing,node_media_routes toneRose
class node_album_domain,node_database,node_backups,node_lightroom,node_widgets,node_visitor,node_administrator toneIndigo
```

## Components

### Public galleries

- [Public routes](https://github.com/henrybeedham/portfolio-gallery/tree/main/src/routes): `src/routes`
- [Album experience](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/components/AlbumView.svelte): `src/lib/components/AlbumView.svelte`
- [Photo and gallery views](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/components/PhotoGallery.svelte): `src/lib/components/PhotoGallery.svelte`
- [Gallery downloads](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/routes/%5Bslug%5D/download/%2Bserver.ts): `src/routes/[slug]/download/+server.ts`

### Gallery administration

- [Admin routes](https://github.com/henrybeedham/portfolio-gallery/tree/main/src/routes/admin): `src/routes/admin`
- [Album and photo editor](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/components/admin/PhotoManager.svelte): `src/lib/components/admin/PhotoManager.svelte`
- [Chunked uploader](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/components/admin/Uploader.svelte): `src/lib/components/admin/Uploader.svelte`
- [Theme management](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/components/admin/ThemeManager.svelte): `src/lib/components/admin/ThemeManager.svelte`
- [Session and access](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/auth.ts): `src/lib/server/auth.ts`

### Jobs and finance

- [Shoot scheduling](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/jobs.ts): `src/lib/server/jobs.ts`
- [Invoice accounting](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/invoices.ts): `src/lib/server/invoices.ts`
- [Business analytics](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/analytics.ts): `src/lib/server/analytics.ts`
- [Calendar feed](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/routes/site/calendar/%5Btoken%5D.ics/%2Bserver.ts): `src/routes/site/calendar/[token].ics/+server.ts`

### Media processing

- [Photo processing](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/images.ts): `src/lib/server/images.ts`
- [Video previews](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/video-preview.ts): `src/lib/server/video-preview.ts`
- [Media delivery](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/routes/media/%5Bkey%5D/%5Bvariant%5D/%2Bserver.ts): `src/routes/media/[key]/[variant]/+server.ts`

### Persistence and integrations

- [Album management](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/albums.ts): `src/lib/server/albums.ts`
- [SQLite database](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/db.ts): `src/lib/server/db.ts`
- [Backups](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/backup-files.ts): `src/lib/server/backup-files.ts`
- [Lightroom integration](https://github.com/henrybeedham/portfolio-gallery/blob/main/src/lib/server/lightroom.ts): `src/lib/server/lightroom.ts`
- [Scriptable widgets](https://github.com/henrybeedham/portfolio-gallery/blob/main/scriptable/Gallery.js): `scriptable/Gallery.js`

### Other components

- **Gallery visitor**
- **Administrator**

## Connections

- Gallery visitor → Public routes: browses
- Public routes → Album experience: presents albums
- Album experience → Photo and gallery views: shows photos (evidence: `src/lib/components/AlbumView.svelte`)
- Gallery visitor → Gallery downloads: requests downloads
- Gallery downloads → Media delivery: serves media
- Administrator → Admin routes: manages galleries
- Administrator → Session and access: signs in
- Admin routes → Session and access: checks access
- Admin routes → Album and photo editor: edits albums
- Album and photo editor → Chunked uploader: uploads media (evidence: `src/lib/components/admin/PhotoManager.svelte`)
- Administrator → Theme management: customizes themes
- Admin routes → Shoot scheduling: manages shoots
- Admin routes → Invoice accounting: manages invoices
- Admin routes → Business analytics: views analytics
- Shoot scheduling → Invoice accounting: links billing
- Shoot scheduling → Album management: links albums
- Chunked uploader → Photo processing: sends uploads
- Photo processing → SQLite database: records media
- Photo processing → Video previews: creates video previews (evidence: `src/lib/server/video-preview.ts`)
- Video previews → Photo processing: generates variants (evidence: `src/lib/server/video-preview.ts`)
- Media delivery → SQLite database: reads media records
- SQLite database → Backups: writes backups (evidence: `src/lib/server/db.ts`)
- Administrator → Lightroom integration: publishes collections
- Administrator → Scriptable widgets: configures widgets
- Administrator → Calendar feed: subscribes to jobs
