# tud8951/tbed architecture

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

- Interactive diagram: https://gitdiagram.com/tud8951/tbed
- Repository: https://github.com/tud8951/tbed

## Overview

tbed is a Cloudflare Pages shared-image site. Visitors browse paginated latest or popular images, upload JPEG/PNG files, view/share or download them through an image proxy, and like images. Uploads are validated and optionally moderated before storage and notification. Administrators authenticate to manage images, likes, upload/filter settings, and filtering-account selection. README capabilities such as the browser UI, pagination, and settings endpoints are included, but their source was not sampled; edges are limited to documented or excerpted relationships.

Main entry points: [`functions/api/upload.js`](https://github.com/tud8951/tbed/blob/main/functions/api/upload.js) (Upload handler), [`d1/schema.sql`](https://github.com/tud8951/tbed/blob/main/d1/schema.sql) (D1 image index), [`assets/app.js`](https://github.com/tud8951/tbed/blob/main/assets/app.js) (Gallery and upload UI), [`assets/admin.js`](https://github.com/tud8951/tbed/blob/main/assets/admin.js) (Admin console)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_visitor["Visitor experience"]
  node_public_ui["Gallery and upload UI<br/>[app.js]"]
  node_gallery_api["Image listing<br/>[images.js]"]
  node_like_api["Like counter<br/>[like.js]"]
end

subgraph group_upload["Upload processing"]
  node_upload_api["Upload handler<br/>[upload.js]"]
  node_moderation["Image moderation<br/>[upload.js]"]
  node_image_hosts["Telegraph image hosts"]
  node_telegram["Telegram Bot"]
end

subgraph group_admin["Administration"]
  node_admin_ui["Admin console<br/>[admin.js]"]
  node_admin_images["Image management<br/>[images.js]"]
  node_admin_delete["Image deletion<br/>[delete.js]"]
  node_admin_settings["Admin settings<br/>[settings.js]"]
  node_admin_geo["IP geolocation<br/>[geo.js]"]
  node_geo_services["Geolocation services"]
end

subgraph group_data["Persistence and delivery"]
  node_public_settings["Public settings<br/>[settings.js]"]
  node_proxy["Image proxy<br/>[&#91;id&#93;.js]"]
  node_count["Image count<br/>[count.js]"]
  node_env_status["Environment status<br/>[env.js]"]
  node_d1[("D1 image index<br/>[schema.sql]")]
  node_kv[("KV metadata and settings")]
  node_edge_cache[("Cloudflare cache")]
end

node_visitor_actor(("Visitor"))
node_admin_actor(("Administrator"))

node_visitor_actor -->|"browses and uploads"| node_public_ui
node_public_ui -->|"requests images"| node_gallery_api
node_public_ui -->|"submits image"| node_upload_api
node_public_ui -->|"sends likes"| node_like_api
node_public_ui -->|"loads image"| node_proxy
node_upload_api -->|"checks when enabled"| node_moderation
node_moderation -->|"allows upload"| node_image_hosts
node_upload_api -->|"uploads image"| node_image_hosts
node_upload_api -->|"fallback or notifies"| node_telegram
node_upload_api -->|"inserts image"| node_d1
node_upload_api -->|"stores metadata and image"| node_kv
node_upload_api -->|"reads upload and filter flags"| node_admin_settings
node_admin_actor -->|"manages site"| node_admin_ui
node_admin_ui -->|"requests image pages"| node_admin_images
node_admin_ui -->|"deletes image"| node_admin_delete
node_admin_ui -->|"reads and changes settings"| node_admin_settings
node_admin_ui -.->|"looks up uploader IP"| node_admin_geo
node_admin_geo -->|"queries location"| node_geo_services
node_admin_images -->|"reads image pages"| node_d1
node_admin_images -->|"reads IP metadata"| node_kv
node_admin_delete -->|"deletes image row"| node_d1
node_admin_delete -->|"deletes image record"| node_kv
node_admin_settings -->|"reads and writes settings"| node_kv
node_admin_settings -->|"updates likes"| node_d1
node_gallery_api -->|"queries sorted pages"| node_d1
node_gallery_api -->|"fallback listing"| node_kv
node_gallery_api -->|"caches responses"| node_edge_cache
node_like_api -->|"increments likes"| node_d1
node_like_api -->|"mirrors likes or fallback"| node_kv
node_proxy -->|"looks up image URL"| node_d1
node_proxy -->|"fallback URL and image bytes"| node_kv
node_proxy -->|"fetches image"| node_image_hosts
node_proxy -->|"caches image response"| node_edge_cache
node_public_settings -.->|"reads public configuration"| node_kv
node_count -.->|"counts images"| node_d1
node_env_status -->|"tests bot token"| node_telegram

click node_public_ui "https://github.com/tud8951/tbed/blob/main/assets/app.js"
click node_gallery_api "https://github.com/tud8951/tbed/blob/main/functions/api/images.js"
click node_like_api "https://github.com/tud8951/tbed/blob/main/functions/api/like.js"
click node_upload_api "https://github.com/tud8951/tbed/blob/main/functions/api/upload.js"
click node_moderation "https://github.com/tud8951/tbed/blob/main/functions/api/upload.js"
click node_admin_ui "https://github.com/tud8951/tbed/blob/main/assets/admin.js"
click node_admin_images "https://github.com/tud8951/tbed/blob/main/functions/api/admin/images.js"
click node_admin_delete "https://github.com/tud8951/tbed/blob/main/functions/api/admin/delete.js"
click node_admin_settings "https://github.com/tud8951/tbed/blob/main/functions/api/admin/settings.js"
click node_admin_geo "https://github.com/tud8951/tbed/blob/main/functions/api/admin/geo.js"
click node_public_settings "https://github.com/tud8951/tbed/blob/main/functions/api/settings.js"
click node_proxy "https://github.com/tud8951/tbed/blob/main/functions/api/i/%5Bid%5D.js"
click node_count "https://github.com/tud8951/tbed/blob/main/functions/api/count.js"
click node_env_status "https://github.com/tud8951/tbed/blob/main/functions/api/env.js"
click node_d1 "https://github.com/tud8951/tbed/blob/main/d1/schema.sql"

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_ui,node_gallery_api,node_like_api toneBlue
class node_upload_api,node_moderation,node_image_hosts,node_telegram toneAmber
class node_admin_ui,node_admin_images,node_admin_delete,node_admin_settings,node_admin_geo,node_geo_services toneMint
class node_public_settings,node_proxy,node_count,node_env_status,node_d1,node_kv,node_edge_cache toneRose
class node_visitor_actor,node_admin_actor toneIndigo
```

## Components

### Visitor experience

- [Gallery and upload UI](https://github.com/tud8951/tbed/blob/main/assets/app.js): `assets/app.js`
- [Image listing](https://github.com/tud8951/tbed/blob/main/functions/api/images.js): `functions/api/images.js`
- [Like counter](https://github.com/tud8951/tbed/blob/main/functions/api/like.js): `functions/api/like.js`

### Upload processing

- [Upload handler](https://github.com/tud8951/tbed/blob/main/functions/api/upload.js): `functions/api/upload.js`
- [Image moderation](https://github.com/tud8951/tbed/blob/main/functions/api/upload.js): `functions/api/upload.js`
- **Telegraph image hosts**
- **Telegram Bot**

### Administration

- [Admin console](https://github.com/tud8951/tbed/blob/main/assets/admin.js): `assets/admin.js`
- [Image management](https://github.com/tud8951/tbed/blob/main/functions/api/admin/images.js): `functions/api/admin/images.js`
- [Image deletion](https://github.com/tud8951/tbed/blob/main/functions/api/admin/delete.js): `functions/api/admin/delete.js`
- [Admin settings](https://github.com/tud8951/tbed/blob/main/functions/api/admin/settings.js): `functions/api/admin/settings.js`
- [IP geolocation](https://github.com/tud8951/tbed/blob/main/functions/api/admin/geo.js): `functions/api/admin/geo.js`
- **Geolocation services**

### Persistence and delivery

- [Public settings](https://github.com/tud8951/tbed/blob/main/functions/api/settings.js): `functions/api/settings.js`
- [Image proxy](https://github.com/tud8951/tbed/blob/main/functions/api/i/%5Bid%5D.js): `functions/api/i/[id].js`
- [Image count](https://github.com/tud8951/tbed/blob/main/functions/api/count.js): `functions/api/count.js`
- [Environment status](https://github.com/tud8951/tbed/blob/main/functions/api/env.js): `functions/api/env.js`
- [D1 image index](https://github.com/tud8951/tbed/blob/main/d1/schema.sql): `d1/schema.sql`
- **KV metadata and settings**
- **Cloudflare cache**

### Other components

- **Visitor**
- **Administrator**

## Connections

- Visitor → Gallery and upload UI: browses and uploads (evidence: `README.md`)
- Gallery and upload UI → Image listing: requests images (evidence: `README.md`)
- Gallery and upload UI → Upload handler: submits image (evidence: `README.md`)
- Gallery and upload UI → Like counter: sends likes (evidence: `README.md`)
- Gallery and upload UI → Image proxy: loads image (evidence: `README.md`)
- Upload handler → Image moderation: checks when enabled (evidence: `functions/api/upload.js`)
- Image moderation → Telegraph image hosts: allows upload (evidence: `functions/api/upload.js`)
- Upload handler → Telegraph image hosts: uploads image (evidence: `functions/api/upload.js`)
- Upload handler → Telegram Bot: fallback or notifies (evidence: `functions/api/upload.js`)
- Upload handler → D1 image index: inserts image (evidence: `functions/api/upload.js`)
- Upload handler → KV metadata and settings: stores metadata and image (evidence: `functions/api/upload.js`)
- Upload handler → Admin settings: reads upload and filter flags (evidence: `functions/api/upload.js`)
- Administrator → Admin console: manages site (evidence: `README.md`)
- Admin console → Image management: requests image pages (evidence: `README.md`)
- Admin console → Image deletion: deletes image (evidence: `README.md`)
- Admin console → Admin settings: reads and changes settings (evidence: `README.md`)
- Admin console → IP geolocation: looks up uploader IP
- IP geolocation → Geolocation services: queries location (evidence: `functions/api/admin/geo.js`)
- Image management → D1 image index: reads image pages (evidence: `functions/api/admin/images.js`)
- Image management → KV metadata and settings: reads IP metadata (evidence: `functions/api/admin/images.js`)
- Image deletion → D1 image index: deletes image row (evidence: `functions/api/admin/delete.js`)
- Image deletion → KV metadata and settings: deletes image record (evidence: `functions/api/admin/delete.js`)
- Admin settings → KV metadata and settings: reads and writes settings (evidence: `functions/api/admin/settings.js`)
- Admin settings → D1 image index: updates likes (evidence: `functions/api/admin/settings.js`)
- Image listing → D1 image index: queries sorted pages (evidence: `functions/api/images.js`)
- Image listing → KV metadata and settings: fallback listing (evidence: `functions/api/images.js`)
- Image listing → Cloudflare cache: caches responses (evidence: `functions/api/images.js`)
- Like counter → D1 image index: increments likes (evidence: `functions/api/like.js`)
- Like counter → KV metadata and settings: mirrors likes or fallback (evidence: `functions/api/like.js`)
- Image proxy → D1 image index: looks up image URL (evidence: `functions/api/i/[id].js`)
- Image proxy → KV metadata and settings: fallback URL and image bytes (evidence: `functions/api/i/[id].js`)
- Image proxy → Telegraph image hosts: fetches image (evidence: `functions/api/i/[id].js`)
- Image proxy → Cloudflare cache: caches image response (evidence: `functions/api/i/[id].js`)
- Public settings → KV metadata and settings: reads public configuration
- Image count → D1 image index: counts images
- Environment status → Telegram Bot: tests bot token (evidence: `functions/api/env.js`)
