# bpatrik/pigallery2 architecture

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

- Interactive diagram: https://gitdiagram.com/bpatrik/pigallery2
- Repository: https://github.com/bpatrik/pigallery2

## Overview

PiGallery2 is a directory-first, read-only photo gallery for low-resource servers. Users browse their photo folders, search media, and use related features such as albums, faces, sharing, and extensions. The frontend routes these experiences; the backend server provides the application runtime, with managers coordinating indexing, search, users, and other domain services over a database. The README documents the product capabilities, while source excerpts and the source index support only selected internal relationships; unsampled subsystem links are therefore omitted.

Main entry points: [`src/frontend/app/app.routing.ts`](https://github.com/bpatrik/pigallery2/blob/master/src/frontend/app/app.routing.ts) (Frontend routes), [`src/backend/model/ObjectManagers.ts`](https://github.com/bpatrik/pigallery2/blob/master/src/backend/model/ObjectManagers.ts) (Manager registry), [`src/backend/model/database/SearchManager.ts`](https://github.com/bpatrik/pigallery2/blob/master/src/backend/model/database/SearchManager.ts) (Search manager), [`src/backend/model/database/SQLConnection.ts`](https://github.com/bpatrik/pigallery2/blob/master/src/backend/model/database/SQLConnection.ts) (SQL connection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Gallery client"]
  node_routing["Frontend routes<br/>[app.routing.ts]"]
  node_gallery["Gallery browsing"]
  node_searchui["Search interface"]
  node_albums["Albums"]
  node_faces["Face browsing"]
  node_sharing["Sharing<br/>[share.service.ts]"]
  node_adminui["Administration<br/>[admin.component.ts]"]
  node_extensionsettings["Extension settings"]
end

subgraph group_runtime["Server runtime"]
  node_server["Backend server<br/>[server.ts]"]
  node_router["HTTP routing<br/>[Router.ts]"]
  node_managers["Manager registry<br/>[ObjectManagers.ts]"]
  node_config["Server configuration<br/>[Config.ts]"]
end

subgraph group_media["Media and search"]
  node_disk["Directory scanning<br/>[DiskManager.ts]"]
  node_jobs["Background jobs<br/>[JobManager.ts]"]
  node_search["Search manager<br/>[SearchManager.ts]"]
  node_query["Search query model<br/>[SearchQueryDTO.ts]"]
  node_directorydto["Directory data<br/>[DirectoryDTO.ts]"]
end

subgraph group_persistence["Persistence"]
  node_sql[("SQL connection<br/>[SQLConnection.ts]")]
  node_directoryentity[("Directory entity<br/>[DirectoryEntity.ts]")]
end

subgraph group_extensions["Extensions"]
  node_extensionmgr["Extension manager"]
end

node_visitor(("Gallery user"))

node_visitor -.->|"opens app"| node_routing
node_routing -->|"routes to"| node_gallery
node_routing -->|"routes to"| node_albums
node_routing -->|"routes to"| node_faces
node_routing -->|"routes to"| node_adminui
node_server -->|"initializes"| node_managers
node_server -->|"imports"| node_router
node_managers -->|"initializes"| node_sql
node_managers -->|"creates"| node_search
node_managers -->|"creates"| node_jobs
node_managers -->|"creates"| node_extensionmgr
node_search -->|"queries"| node_sql
node_search -->|"accepts"| node_query
node_disk -->|"builds"| node_directorydto
node_sql -->|"registers"| node_directoryentity
node_config -->|"configures"| node_extensionmgr
node_extensionsettings -.->|"installs"| node_extensionmgr
node_searchui -.->|"submits queries"| node_search
node_gallery -.->|"browses folders"| node_disk
node_sharing -.->|"uses sharing routes"| node_router

click node_routing "https://github.com/bpatrik/pigallery2/blob/master/src/frontend/app/app.routing.ts"
click node_gallery "https://github.com/bpatrik/pigallery2/tree/master/src/frontend/app/ui/gallery"
click node_searchui "https://github.com/bpatrik/pigallery2/tree/master/src/frontend/app/ui/gallery/search"
click node_albums "https://github.com/bpatrik/pigallery2/tree/master/src/frontend/app/ui/albums"
click node_faces "https://github.com/bpatrik/pigallery2/tree/master/src/frontend/app/ui/faces"
click node_sharing "https://github.com/bpatrik/pigallery2/blob/master/src/frontend/app/ui/gallery/share.service.ts"
click node_adminui "https://github.com/bpatrik/pigallery2/blob/master/src/frontend/app/ui/admin/admin.component.ts"
click node_server "https://github.com/bpatrik/pigallery2/blob/master/src/backend/server.ts"
click node_router "https://github.com/bpatrik/pigallery2/blob/master/src/backend/routes/Router.ts"
click node_managers "https://github.com/bpatrik/pigallery2/blob/master/src/backend/model/ObjectManagers.ts"
click node_disk "https://github.com/bpatrik/pigallery2/blob/master/src/backend/model/fileaccess/DiskManager.ts"
click node_jobs "https://github.com/bpatrik/pigallery2/blob/master/src/backend/model/jobs/JobManager.ts"
click node_search "https://github.com/bpatrik/pigallery2/blob/master/src/backend/model/database/SearchManager.ts"
click node_query "https://github.com/bpatrik/pigallery2/blob/master/src/common/entities/SearchQueryDTO.ts"
click node_directorydto "https://github.com/bpatrik/pigallery2/blob/master/src/common/entities/DirectoryDTO.ts"
click node_sql "https://github.com/bpatrik/pigallery2/blob/master/src/backend/model/database/SQLConnection.ts"
click node_directoryentity "https://github.com/bpatrik/pigallery2/blob/master/src/backend/model/database/enitites/DirectoryEntity.ts"
click node_config "https://github.com/bpatrik/pigallery2/blob/master/src/common/config/private/Config.ts"
click node_extensionmgr "https://github.com/bpatrik/pigallery2/blob/master/src/backend/model/extension/ExtensionManager.ts"
click node_extensionsettings "https://github.com/bpatrik/pigallery2/tree/master/src/frontend/app/ui/settings/extension-installer"

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_routing,node_gallery,node_searchui,node_albums,node_faces,node_sharing,node_adminui,node_extensionsettings,node_visitor toneBlue
class node_server,node_router,node_managers,node_config toneAmber
class node_disk,node_jobs,node_search,node_query,node_directorydto toneMint
class node_sql,node_directoryentity toneRose
class node_extensionmgr toneIndigo
```

## Components

### Gallery client

- [Frontend routes](https://github.com/bpatrik/pigallery2/blob/master/src/frontend/app/app.routing.ts): `src/frontend/app/app.routing.ts`
- [Gallery browsing](https://github.com/bpatrik/pigallery2/tree/master/src/frontend/app/ui/gallery): `src/frontend/app/ui/gallery`
- [Search interface](https://github.com/bpatrik/pigallery2/tree/master/src/frontend/app/ui/gallery/search): `src/frontend/app/ui/gallery/search`
- [Albums](https://github.com/bpatrik/pigallery2/tree/master/src/frontend/app/ui/albums): `src/frontend/app/ui/albums`
- [Face browsing](https://github.com/bpatrik/pigallery2/tree/master/src/frontend/app/ui/faces): `src/frontend/app/ui/faces`
- [Sharing](https://github.com/bpatrik/pigallery2/blob/master/src/frontend/app/ui/gallery/share.service.ts): `src/frontend/app/ui/gallery/share.service.ts`
- [Administration](https://github.com/bpatrik/pigallery2/blob/master/src/frontend/app/ui/admin/admin.component.ts): `src/frontend/app/ui/admin/admin.component.ts`
- [Extension settings](https://github.com/bpatrik/pigallery2/tree/master/src/frontend/app/ui/settings/extension-installer): `src/frontend/app/ui/settings/extension-installer`

### Server runtime

- [Backend server](https://github.com/bpatrik/pigallery2/blob/master/src/backend/server.ts): `src/backend/server.ts`
- [HTTP routing](https://github.com/bpatrik/pigallery2/blob/master/src/backend/routes/Router.ts): `src/backend/routes/Router.ts`
- [Manager registry](https://github.com/bpatrik/pigallery2/blob/master/src/backend/model/ObjectManagers.ts): `src/backend/model/ObjectManagers.ts`
- [Server configuration](https://github.com/bpatrik/pigallery2/blob/master/src/common/config/private/Config.ts): `src/common/config/private/Config.ts`

### Media and search

- [Directory scanning](https://github.com/bpatrik/pigallery2/blob/master/src/backend/model/fileaccess/DiskManager.ts): `src/backend/model/fileaccess/DiskManager.ts`
- [Background jobs](https://github.com/bpatrik/pigallery2/blob/master/src/backend/model/jobs/JobManager.ts): `src/backend/model/jobs/JobManager.ts`
- [Search manager](https://github.com/bpatrik/pigallery2/blob/master/src/backend/model/database/SearchManager.ts): `src/backend/model/database/SearchManager.ts`
- [Search query model](https://github.com/bpatrik/pigallery2/blob/master/src/common/entities/SearchQueryDTO.ts): `src/common/entities/SearchQueryDTO.ts`
- [Directory data](https://github.com/bpatrik/pigallery2/blob/master/src/common/entities/DirectoryDTO.ts): `src/common/entities/DirectoryDTO.ts`

### Persistence

- [SQL connection](https://github.com/bpatrik/pigallery2/blob/master/src/backend/model/database/SQLConnection.ts): `src/backend/model/database/SQLConnection.ts`
- [Directory entity](https://github.com/bpatrik/pigallery2/blob/master/src/backend/model/database/enitites/DirectoryEntity.ts): `src/backend/model/database/enitites/DirectoryEntity.ts`

### Extensions

- [Extension manager](https://github.com/bpatrik/pigallery2/blob/master/src/backend/model/extension/ExtensionManager.ts): `src/backend/model/extension/ExtensionManager.ts`

### Other components

- **Gallery user**

## Connections

- Gallery user → Frontend routes: opens app (evidence: `README.md`)
- Frontend routes → Gallery browsing: routes to (evidence: `src/frontend/app/app.routing.ts`)
- Frontend routes → Albums: routes to (evidence: `src/frontend/app/app.routing.ts`)
- Frontend routes → Face browsing: routes to (evidence: `src/frontend/app/app.routing.ts`)
- Frontend routes → Administration: routes to (evidence: `src/frontend/app/app.routing.ts`)
- Backend server → Manager registry: initializes (evidence: `src/backend/server.ts`)
- Backend server → HTTP routing: imports (evidence: `src/backend/server.ts`)
- Manager registry → SQL connection: initializes (evidence: `src/backend/model/ObjectManagers.ts`)
- Manager registry → Search manager: creates (evidence: `src/backend/model/ObjectManagers.ts`)
- Manager registry → Background jobs: creates (evidence: `src/backend/model/ObjectManagers.ts`)
- Manager registry → Extension manager: creates (evidence: `src/backend/model/ObjectManagers.ts`)
- Search manager → SQL connection: queries (evidence: `src/backend/model/database/SearchManager.ts`)
- Search manager → Search query model: accepts (evidence: `src/backend/model/database/SearchManager.ts`)
- Directory scanning → Directory data: builds (evidence: `src/backend/model/fileaccess/DiskManager.ts`)
- SQL connection → Directory entity: registers (evidence: `src/backend/model/database/SQLConnection.ts`)
- Server configuration → Extension manager: configures (evidence: `src/common/config/private/Config.ts`)
- Extension settings → Extension manager: installs (evidence: `README.md`)
- Search interface → Search manager: submits queries
- Gallery browsing → Directory scanning: browses folders
- Sharing → HTTP routing: uses sharing routes
