How henrybeedham/portfolio-gallery works
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: admin Admin routes · images.ts Photo processing · jobs.ts Shoot scheduling · db.ts SQLite database
Components 23
Public galleries
- Public routes
src/routes - Album experience
src/lib/components/AlbumView.svelte - Photo and gallery views
src/lib/components/PhotoGallery.svelte - Gallery downloads
src/routes/[slug]/download/+server.ts
Gallery administration
- Admin routes
src/routes/admin - Album and photo editor
src/lib/components/admin/PhotoManager.svelte - Chunked uploader
src/lib/components/admin/Uploader.svelte - Theme management
src/lib/components/admin/ThemeManager.svelte - Session and access
src/lib/server/auth.ts
Jobs and finance
- Shoot scheduling
src/lib/server/jobs.ts - Invoice accounting
src/lib/server/invoices.ts - Business analytics
src/lib/server/analytics.ts - Calendar feed
src/routes/site/calendar/[token].ics/+server.ts
Media processing
- Photo processing
src/lib/server/images.ts - Video previews
src/lib/server/video-preview.ts - Media delivery
src/routes/media/[key]/[variant]/+server.ts
Persistence and integrations
- Album management
src/lib/server/albums.ts - SQLite database
src/lib/server/db.ts - Backups
src/lib/server/backup-files.ts - Lightroom integration
src/lib/server/lightroom.ts - Scriptable widgets
scriptable/Gallery.js
Other components
- Gallery visitor
- Administrator
Connections 25
- Gallery visitor → Public routes: browses
- Public routes → Album experience: presents albums
- Album experience → Photo and gallery views: shows photos
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
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
src/lib/server/video-preview.ts - Video previews → Photo processing: generates variants
src/lib/server/video-preview.ts - Media delivery → SQLite database: reads media records
- SQLite database → Backups: writes backups
src/lib/server/db.ts - Administrator → Lightroom integration: publishes collections
- Administrator → Scriptable widgets: configures widgets
- Administrator → Calendar feed: subscribes to jobs