# michelpfeifer2334/picture_classification architecture

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

## Overview

This local web app turns travel photos into a print-ready photo book. The user uploads photos, runs local AI analysis, reviews scores and group-based selections, then optionally edits chapters and page layouts, designs a cover, checks print readiness, and downloads PDFs. The graph combines explicit README workflow and capability descriptions with the provided source excerpts and SOURCE INDEX references; unsampled links are omitted where their invocation is not established.

Main entry points: [`backend/app/api/albums.py`](https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/api/albums.py) (Album API), [`backend/app/services/jobs.py`](https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/jobs.py) (Analysis jobs), [`backend/app/services/pdf/export.py`](https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/pdf/export.py) (PDF exporter), [`backend/app/services/cover.py`](https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/cover.py) (Cover generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Photo book interface"]
  node_app["App interface<br/>[App.vue]"]
  node_album_state["Album workflow state<br/>[useAlbum.ts]"]
  node_api_client["HTTP API client<br/>[api.ts]"]
  node_editor["Book editor<br/>[BookEditor.vue]"]
  node_preview["Book preview<br/>[BookPreview.vue]"]
  node_cover_ui["Cover editor<br/>[CoverPanel.vue]"]
  node_export_ui["Export and preflight<br/>[ExportPanel.vue]"]
end

subgraph group_analysis["Photo analysis"]
  node_image_processing["Image measurements"]
  node_analysis_jobs["Analysis jobs<br/>[jobs.py]"]
  node_classifier["Vision classifier"]
  node_selection["Photo selection<br/>[selection.py]"]
end

subgraph group_book["Book design and print"]
  node_chapters["Trip chapters<br/>[chapters.py]"]
  node_layout["Page layout<br/>[layout.py]"]
  node_styles["Design styles<br/>[styles.py]"]
  node_cover["Cover generator<br/>[cover.py]"]
  node_print_profile["Print profile<br/>[print_profile.py]"]
  node_preflight["Print preflight<br/>[preflight.py]"]
  node_pdf_export["PDF exporter<br/>[export.py]"]
end

subgraph group_backend["Backend and album data"]
  node_albums_api["Album API<br/>[albums.py]"]
  node_album_model["Album data model<br/>[album.py]"]
  node_album_store[("Album file store<br/>[storage.py]")]
  node_config["App configuration<br/>[config.py]"]
end

node_user(("Traveler"))
node_ollama["Ollama model"]

node_user -->|"uses"| node_app
node_app -->|"uses state"| node_album_state
node_album_state -->|"requests data"| node_api_client
node_editor -->|"loads and saves"| node_api_client
node_preview -->|"loads preview"| node_api_client
node_cover_ui -->|"updates cover"| node_api_client
node_export_ui -->|"requests checks"| node_api_client
node_api_client -->|"HTTP requests"| node_albums_api
node_albums_api -->|"reads and writes"| node_album_store
node_albums_api -->|"starts analysis"| node_analysis_jobs
node_albums_api -->|"processes uploads"| node_image_processing
node_albums_api -->|"updates selection"| node_selection
node_albums_api -->|"requests layout"| node_layout
node_albums_api -->|"requests cover"| node_cover
node_albums_api -->|"checks print"| node_preflight
node_albums_api -->|"exports PDFs"| node_pdf_export
node_album_store -->|"persists JSON"| node_album_model
node_analysis_jobs -->|"measures images"| node_image_processing
node_analysis_jobs -->|"classifies images"| node_classifier
node_analysis_jobs -->|"ranks photos"| node_selection
node_analysis_jobs -->|"builds chapters"| node_chapters
node_analysis_jobs -->|"saves progress"| node_album_store
node_classifier -->|"analyzes photos"| node_ollama
node_selection -->|"organizes timeline"| node_chapters
node_layout -->|"lays out chapters"| node_chapters
node_layout -->|"applies style"| node_styles
node_cover -->|"uses dimensions"| node_print_profile
node_cover -->|"applies style"| node_styles
node_cover -->|"uses trip titles"| node_chapters
node_preflight -->|"checks pages"| node_layout
node_preflight -->|"checks export"| node_pdf_export
node_preflight -->|"checks cover"| node_cover
node_pdf_export -->|"renders pages"| node_layout
node_pdf_export -->|"renders cover"| node_cover
node_pdf_export -->|"uses print specs"| node_print_profile
node_pdf_export -->|"reads images"| node_album_store
node_albums_api -->|"uses settings"| node_config

click node_app "https://github.com/michelpfeifer2334/picture_classification/blob/main/frontend/src/App.vue"
click node_album_state "https://github.com/michelpfeifer2334/picture_classification/blob/main/frontend/src/useAlbum.ts"
click node_api_client "https://github.com/michelpfeifer2334/picture_classification/blob/main/frontend/src/api.ts"
click node_editor "https://github.com/michelpfeifer2334/picture_classification/blob/main/frontend/src/components/BookEditor.vue"
click node_preview "https://github.com/michelpfeifer2334/picture_classification/blob/main/frontend/src/components/BookPreview.vue"
click node_cover_ui "https://github.com/michelpfeifer2334/picture_classification/blob/main/frontend/src/components/CoverPanel.vue"
click node_export_ui "https://github.com/michelpfeifer2334/picture_classification/blob/main/frontend/src/components/ExportPanel.vue"
click node_albums_api "https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/api/albums.py"
click node_album_model "https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/models/album.py"
click node_album_store "https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/storage.py"
click node_image_processing "https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/image_processing.py"
click node_analysis_jobs "https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/jobs.py"
click node_classifier "https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/classifier/ollama_classifier.py"
click node_selection "https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/selection.py"
click node_chapters "https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/chapters.py"
click node_layout "https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/layout.py"
click node_styles "https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/styles.py"
click node_cover "https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/cover.py"
click node_print_profile "https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/print_profile.py"
click node_preflight "https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/preflight.py"
click node_pdf_export "https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/pdf/export.py"
click node_config "https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/core/config.py"

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_album_state,node_api_client,node_editor,node_preview,node_cover_ui,node_export_ui toneBlue
class node_image_processing,node_analysis_jobs,node_classifier,node_selection toneAmber
class node_chapters,node_layout,node_styles,node_cover,node_print_profile,node_preflight,node_pdf_export toneMint
class node_albums_api,node_album_model,node_album_store,node_config toneRose
class node_user,node_ollama toneIndigo
```

## Components

### Photo book interface

- [App interface](https://github.com/michelpfeifer2334/picture_classification/blob/main/frontend/src/App.vue): `frontend/src/App.vue`
- [Album workflow state](https://github.com/michelpfeifer2334/picture_classification/blob/main/frontend/src/useAlbum.ts): `frontend/src/useAlbum.ts`
- [HTTP API client](https://github.com/michelpfeifer2334/picture_classification/blob/main/frontend/src/api.ts): `frontend/src/api.ts`
- [Book editor](https://github.com/michelpfeifer2334/picture_classification/blob/main/frontend/src/components/BookEditor.vue): `frontend/src/components/BookEditor.vue`
- [Book preview](https://github.com/michelpfeifer2334/picture_classification/blob/main/frontend/src/components/BookPreview.vue): `frontend/src/components/BookPreview.vue`
- [Cover editor](https://github.com/michelpfeifer2334/picture_classification/blob/main/frontend/src/components/CoverPanel.vue): `frontend/src/components/CoverPanel.vue`
- [Export and preflight](https://github.com/michelpfeifer2334/picture_classification/blob/main/frontend/src/components/ExportPanel.vue): `frontend/src/components/ExportPanel.vue`

### Photo analysis

- [Image measurements](https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/image_processing.py): `backend/app/services/image_processing.py`
- [Analysis jobs](https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/jobs.py): `backend/app/services/jobs.py`
- [Vision classifier](https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/classifier/ollama_classifier.py): `backend/app/services/classifier/ollama_classifier.py`
- [Photo selection](https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/selection.py): `backend/app/services/selection.py`

### Book design and print

- [Trip chapters](https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/chapters.py): `backend/app/services/chapters.py`
- [Page layout](https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/layout.py): `backend/app/services/layout.py`
- [Design styles](https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/styles.py): `backend/app/services/styles.py`
- [Cover generator](https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/cover.py): `backend/app/services/cover.py`
- [Print profile](https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/print_profile.py): `backend/app/services/print_profile.py`
- [Print preflight](https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/preflight.py): `backend/app/services/preflight.py`
- [PDF exporter](https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/pdf/export.py): `backend/app/services/pdf/export.py`

### Backend and album data

- [Album API](https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/api/albums.py): `backend/app/api/albums.py`
- [Album data model](https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/models/album.py): `backend/app/models/album.py`
- [Album file store](https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/services/storage.py): `backend/app/services/storage.py`
- [App configuration](https://github.com/michelpfeifer2334/picture_classification/blob/main/backend/app/core/config.py): `backend/app/core/config.py`

### Other components

- **Traveler**
- **Ollama model**

## Connections

- Traveler → App interface: uses
- App interface → Album workflow state: uses state (evidence: `frontend/src/App.vue`)
- Album workflow state → HTTP API client: requests data (evidence: `frontend/src/useAlbum.ts`)
- Book editor → HTTP API client: loads and saves (evidence: `frontend/src/components/BookEditor.vue`)
- Book preview → HTTP API client: loads preview (evidence: `frontend/src/components/BookPreview.vue`)
- Cover editor → HTTP API client: updates cover (evidence: `frontend/src/components/CoverPanel.vue`)
- Export and preflight → HTTP API client: requests checks (evidence: `frontend/src/components/ExportPanel.vue`)
- HTTP API client → Album API: HTTP requests
- Album API → Album file store: reads and writes (evidence: `backend/app/api/albums.py`)
- Album API → Analysis jobs: starts analysis (evidence: `backend/app/api/albums.py`)
- Album API → Image measurements: processes uploads (evidence: `backend/app/api/albums.py`)
- Album API → Photo selection: updates selection (evidence: `backend/app/api/albums.py`)
- Album API → Page layout: requests layout (evidence: `backend/app/api/albums.py`)
- Album API → Cover generator: requests cover (evidence: `backend/app/api/albums.py`)
- Album API → Print preflight: checks print (evidence: `backend/app/api/albums.py`)
- Album API → PDF exporter: exports PDFs (evidence: `backend/app/api/albums.py`)
- Album file store → Album data model: persists JSON (evidence: `backend/app/services/storage.py`)
- Analysis jobs → Image measurements: measures images (evidence: `backend/app/services/jobs.py`)
- Analysis jobs → Vision classifier: classifies images (evidence: `backend/app/services/jobs.py`)
- Analysis jobs → Photo selection: ranks photos (evidence: `backend/app/services/jobs.py`)
- Analysis jobs → Trip chapters: builds chapters (evidence: `backend/app/services/jobs.py`)
- Analysis jobs → Album file store: saves progress (evidence: `backend/app/services/jobs.py`)
- Vision classifier → Ollama model: analyzes photos
- Photo selection → Trip chapters: organizes timeline (evidence: `backend/app/services/selection.py`)
- Page layout → Trip chapters: lays out chapters (evidence: `backend/app/services/layout.py`)
- Page layout → Design styles: applies style (evidence: `backend/app/services/layout.py`)
- Cover generator → Print profile: uses dimensions (evidence: `backend/app/services/cover.py`)
- Cover generator → Design styles: applies style (evidence: `backend/app/services/cover.py`)
- Cover generator → Trip chapters: uses trip titles (evidence: `backend/app/services/cover.py`)
- Print preflight → Page layout: checks pages (evidence: `backend/app/services/preflight.py`)
- Print preflight → PDF exporter: checks export (evidence: `backend/app/services/preflight.py`)
- Print preflight → Cover generator: checks cover (evidence: `backend/app/services/preflight.py`)
- PDF exporter → Page layout: renders pages (evidence: `backend/app/services/pdf/export.py`)
- PDF exporter → Cover generator: renders cover (evidence: `backend/app/services/pdf/export.py`)
- PDF exporter → Print profile: uses print specs (evidence: `backend/app/services/pdf/export.py`)
- PDF exporter → Album file store: reads images (evidence: `backend/app/services/pdf/export.py`)
- Album API → App configuration: uses settings (evidence: `backend/app/api/albums.py`)
