# jhonka1006-prog/foto_logger architecture

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

- Interactive diagram: https://gitdiagram.com/jhonka1006-prog/foto_logger
- Repository: https://github.com/jhonka1006-prog/foto_logger

## Overview

foto_logger is a local-network Flask app for recording photos and videos with capture time and GPS burned into the processed media. The main workflow is browser upload, metadata extraction, user coordinate confirmation, media processing, and cataloging; users can then browse, delete, and export records. SQLite, local media directories, monthly exports, and rotating asynchronous backups provide persistence. The map uses README documentation and the shown source/index references; unsampled route details are represented only where the README documents them.

Main entry points: [`app/routes.py`](https://github.com/jhonka1006-prog/foto_logger/blob/main/app/routes.py) (HTTP routes), [`app/backup.py`](https://github.com/jhonka1006-prog/foto_logger/blob/main/app/backup.py) (Backup snapshots), [`app/database.py`](https://github.com/jhonka1006-prog/foto_logger/blob/main/app/database.py) (Media catalog), [`app/main.py`](https://github.com/jhonka1006-prog/foto_logger/blob/main/app/main.py) (App factory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app_factory["App factory<br/>[main.py]"]
  node_http_routes["HTTP routes<br/>[routes.py]"]
  node_web_templates["Web templates"]
end

subgraph group_media["Media workflow"]
  node_original_media["Original media"]
  node_metadata["Metadata extraction<br/>[routes.py]"]
  node_image_processing["Image processing<br/>[image_processor.py]"]
  node_video_processing["Video processing<br/>[video_processor.py]"]
  node_processed_media["Processed media"]
end

subgraph group_persistence["Persistence"]
  node_catalog["Media catalog<br/>[database.py]"]
  node_sqlite[("SQLite database")]
end

subgraph group_outputs["Exports and backups"]
  node_monthly_export["Monthly export<br/>[exporter.py]"]
  node_pdf_export["Monthly PDF<br/>[routes.py]"]
  node_export_files["Export files"]
  node_backup["Backup snapshots<br/>[backup.py]"]
  node_backup_files["Backup storage"]
end

node_browser(("Mobile / desktop browser"))
node_geocoder["Address geocoder"]

node_browser -->|"sends requests"| node_http_routes
node_http_routes -->|"renders pages"| node_web_templates
node_app_factory -->|"registers routes"| node_http_routes
node_app_factory -->|"initializes schema"| node_catalog
node_app_factory -->|"starts backup"| node_backup
node_http_routes -->|"stores uploads"| node_original_media
node_http_routes -->|"reads metadata"| node_metadata
node_metadata -->|"extracts image EXIF"| node_image_processing
node_metadata -->|"extracts video metadata"| node_video_processing
node_browser -->|"confirms coordinates"| node_http_routes
node_http_routes -->|"processes images"| node_image_processing
node_http_routes -->|"processes videos"| node_video_processing
node_image_processing -->|"writes JPEG"| node_processed_media
node_video_processing -->|"writes video"| node_processed_media
node_http_routes -->|"records media"| node_catalog
node_catalog -->|"reads and writes"| node_sqlite
node_http_routes -->|"queries and deletes"| node_catalog
node_http_routes -->|"requests raw export"| node_monthly_export
node_monthly_export -->|"copies processed files"| node_export_files
node_http_routes -->|"builds monthly PDF"| node_pdf_export
node_http_routes -->|"triggers backup"| node_backup
node_backup -->|"copies database"| node_sqlite
node_backup -->|"copies processed media"| node_processed_media
node_backup -->|"writes snapshots"| node_backup_files
node_http_routes -.->|"geocodes addresses"| node_geocoder

click node_app_factory "https://github.com/jhonka1006-prog/foto_logger/blob/main/app/main.py"
click node_http_routes "https://github.com/jhonka1006-prog/foto_logger/blob/main/app/routes.py"
click node_web_templates "https://github.com/jhonka1006-prog/foto_logger/tree/main/templates"
click node_metadata "https://github.com/jhonka1006-prog/foto_logger/blob/main/app/routes.py"
click node_image_processing "https://github.com/jhonka1006-prog/foto_logger/blob/main/app/image_processor.py"
click node_video_processing "https://github.com/jhonka1006-prog/foto_logger/blob/main/app/video_processor.py"
click node_catalog "https://github.com/jhonka1006-prog/foto_logger/blob/main/app/database.py"
click node_monthly_export "https://github.com/jhonka1006-prog/foto_logger/blob/main/app/exporter.py"
click node_pdf_export "https://github.com/jhonka1006-prog/foto_logger/blob/main/app/routes.py"
click node_backup "https://github.com/jhonka1006-prog/foto_logger/blob/main/app/backup.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_factory,node_http_routes,node_web_templates,node_browser toneBlue
class node_original_media,node_metadata,node_image_processing,node_video_processing,node_processed_media toneAmber
class node_catalog,node_sqlite toneMint
class node_monthly_export,node_pdf_export,node_export_files,node_backup,node_backup_files toneRose
class node_geocoder toneIndigo
```

## Components

### Web experience

- [App factory](https://github.com/jhonka1006-prog/foto_logger/blob/main/app/main.py): `app/main.py`
- [HTTP routes](https://github.com/jhonka1006-prog/foto_logger/blob/main/app/routes.py): `app/routes.py`
- [Web templates](https://github.com/jhonka1006-prog/foto_logger/tree/main/templates): `templates`

### Media workflow

- **Original media**
- [Metadata extraction](https://github.com/jhonka1006-prog/foto_logger/blob/main/app/routes.py): `app/routes.py`
- [Image processing](https://github.com/jhonka1006-prog/foto_logger/blob/main/app/image_processor.py): `app/image_processor.py`
- [Video processing](https://github.com/jhonka1006-prog/foto_logger/blob/main/app/video_processor.py): `app/video_processor.py`
- **Processed media**

### Persistence

- [Media catalog](https://github.com/jhonka1006-prog/foto_logger/blob/main/app/database.py): `app/database.py`
- **SQLite database**

### Exports and backups

- [Monthly export](https://github.com/jhonka1006-prog/foto_logger/blob/main/app/exporter.py): `app/exporter.py`
- [Monthly PDF](https://github.com/jhonka1006-prog/foto_logger/blob/main/app/routes.py): `app/routes.py`
- **Export files**
- [Backup snapshots](https://github.com/jhonka1006-prog/foto_logger/blob/main/app/backup.py): `app/backup.py`
- **Backup storage**

### Other components

- **Mobile / desktop browser**
- **Address geocoder**

## Connections

- Mobile / desktop browser → HTTP routes: sends requests (evidence: `README.md`)
- HTTP routes → Web templates: renders pages (evidence: `README.md`)
- App factory → HTTP routes: registers routes (evidence: `app/main.py`)
- App factory → Media catalog: initializes schema (evidence: `app/main.py`)
- App factory → Backup snapshots: starts backup (evidence: `app/main.py`)
- HTTP routes → Original media: stores uploads (evidence: `README.md`)
- HTTP routes → Metadata extraction: reads metadata (evidence: `README.md`)
- Metadata extraction → Image processing: extracts image EXIF (evidence: `README.md`)
- Metadata extraction → Video processing: extracts video metadata (evidence: `README.md`)
- Mobile / desktop browser → HTTP routes: confirms coordinates (evidence: `README.md`)
- HTTP routes → Image processing: processes images (evidence: `README.md`)
- HTTP routes → Video processing: processes videos (evidence: `README.md`)
- Image processing → Processed media: writes JPEG (evidence: `README.md`)
- Video processing → Processed media: writes video (evidence: `README.md`)
- HTTP routes → Media catalog: records media (evidence: `README.md`)
- Media catalog → SQLite database: reads and writes (evidence: `app/database.py`)
- HTTP routes → Media catalog: queries and deletes (evidence: `app/routes.py`)
- HTTP routes → Monthly export: requests raw export (evidence: `README.md`)
- Monthly export → Export files: copies processed files (evidence: `app/exporter.py`)
- HTTP routes → Monthly PDF: builds monthly PDF (evidence: `README.md`)
- HTTP routes → Backup snapshots: triggers backup (evidence: `app/backup.py`)
- Backup snapshots → SQLite database: copies database (evidence: `app/backup.py`)
- Backup snapshots → Processed media: copies processed media (evidence: `app/backup.py`)
- Backup snapshots → Backup storage: writes snapshots (evidence: `app/backup.py`)
- HTTP routes → Address geocoder: geocodes addresses (evidence: `README.md`)
