# vanixus/ai-product-photo-tagger architecture

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

- Interactive diagram: https://gitdiagram.com/vanixus/ai-product-photo-tagger
- Repository: https://github.com/vanixus/ai-product-photo-tagger

## Overview

AI Product Photo Tagger is a PHP application for uploading product images, generating AI tags and descriptions, and browsing the resulting catalog. Users authenticate, submit images (including camera captures), and receive analysis results; the application also tracks demo coins. Separate gallery and admin views support catalog review and management. The sampled code confirms the upload-to-analysis request, authentication, wallet operations, and gallery reads. Analysis persistence and some admin capabilities are documented, but their full implementation was not sampled.

Main entry points: [`api/analyze.php`](https://github.com/vanixus/ai-product-photo-tagger/blob/main/api/analyze.php) (Image Analysis Endpoint), [`config/db.php`](https://github.com/vanixus/ai-product-photo-tagger/blob/main/config/db.php) (PDO Connection), [`includes/auth.php`](https://github.com/vanixus/ai-product-photo-tagger/blob/main/includes/auth.php) (Session Authorization), [`admin.php`](https://github.com/vanixus/ai-product-photo-tagger/blob/main/admin.php) (Admin Management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and Sessions"]
  node_login["Password Login<br/>[login.php]"]
  node_session_auth["Session Authorization<br/>[auth.php]"]
  node_logout["Logout<br/>[logout.php]"]
end

subgraph group_tagging["Image Tagging"]
  node_upload_ui["Upload and Camera UI<br/>[index.php]"]
  node_analysis["Image Analysis Endpoint<br/>[analyze.php]"]
  node_image_prep["Image Preparation<br/>[analyze.php]"]
end

subgraph group_catalog["Catalog and Management"]
  node_gallery["Image Gallery<br/>[gallery.php]"]
  node_admin["Admin Management<br/>[admin.php]"]
  node_coin_api["Coin Balance API<br/>[coins.php]"]
  node_wallet["Wallet Operations<br/>[auth.php]"]
end

subgraph group_infrastructure["Runtime Infrastructure"]
  node_image_files[("Uploaded Images")]
  node_db_connection["PDO Connection<br/>[db.php]"]
  node_metadata["Image Metadata Schema<br/>[schema.sql]"]
  node_config["Runtime Configuration<br/>[constants.php]"]
end

node_user(("User"))
node_claude{{"Claude API"}}
node_mysql[("MySQL Database")]

node_user -->|"enters password"| node_login
node_login -->|"checks credentials"| node_session_auth
node_user -->|"selects or captures"| node_upload_ui
node_upload_ui -->|"posts image"| node_analysis
node_analysis -->|"checks session"| node_session_auth
node_analysis -->|"prepares image"| node_image_prep
node_image_prep -->|"requests tagging"| node_claude
node_analysis -->|"stores image"| node_image_files
node_analysis -->|"saves metadata"| node_db_connection
node_gallery -->|"requires login"| node_session_auth
node_gallery -->|"reads image records"| node_db_connection
node_user -->|"browses catalog"| node_gallery
node_user -->|"manages service"| node_admin
node_admin -->|"requires admin"| node_session_auth
node_admin -->|"reads and updates"| node_db_connection
node_upload_ui -->|"fetches balance"| node_coin_api
node_coin_api -->|"gets balance"| node_wallet
node_analysis -->|"deducts coin"| node_wallet
node_admin -->|"sets balance"| node_wallet
node_wallet -->|"queries wallet"| node_db_connection
node_db_connection -->|"loads settings"| node_config
node_db_connection -->|"connects"| node_mysql
node_metadata -->|"defines tables"| node_mysql
node_user -->|"ends session"| node_logout
node_logout -->|"destroys session"| node_session_auth

click node_login "https://github.com/vanixus/ai-product-photo-tagger/blob/main/login.php"
click node_session_auth "https://github.com/vanixus/ai-product-photo-tagger/blob/main/includes/auth.php"
click node_logout "https://github.com/vanixus/ai-product-photo-tagger/blob/main/logout.php"
click node_upload_ui "https://github.com/vanixus/ai-product-photo-tagger/blob/main/index.php"
click node_analysis "https://github.com/vanixus/ai-product-photo-tagger/blob/main/api/analyze.php"
click node_image_prep "https://github.com/vanixus/ai-product-photo-tagger/blob/main/api/analyze.php"
click node_image_files "https://github.com/vanixus/ai-product-photo-tagger/tree/main/uploads"
click node_gallery "https://github.com/vanixus/ai-product-photo-tagger/blob/main/gallery.php"
click node_admin "https://github.com/vanixus/ai-product-photo-tagger/blob/main/admin.php"
click node_coin_api "https://github.com/vanixus/ai-product-photo-tagger/blob/main/api/coins.php"
click node_wallet "https://github.com/vanixus/ai-product-photo-tagger/blob/main/includes/auth.php"
click node_db_connection "https://github.com/vanixus/ai-product-photo-tagger/blob/main/config/db.php"
click node_metadata "https://github.com/vanixus/ai-product-photo-tagger/blob/main/schema.sql"
click node_config "https://github.com/vanixus/ai-product-photo-tagger/blob/main/config/constants.php"

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_login,node_session_auth,node_logout,node_user toneBlue
class node_upload_ui,node_analysis,node_image_prep,node_mysql toneAmber
class node_gallery,node_admin,node_coin_api,node_wallet,node_claude toneMint
class node_image_files,node_db_connection,node_metadata,node_config toneRose
```

## Components

### Access and Sessions

- [Password Login](https://github.com/vanixus/ai-product-photo-tagger/blob/main/login.php): `login.php`
- [Session Authorization](https://github.com/vanixus/ai-product-photo-tagger/blob/main/includes/auth.php): `includes/auth.php`
- [Logout](https://github.com/vanixus/ai-product-photo-tagger/blob/main/logout.php): `logout.php`

### Image Tagging

- [Upload and Camera UI](https://github.com/vanixus/ai-product-photo-tagger/blob/main/index.php): `index.php`
- [Image Analysis Endpoint](https://github.com/vanixus/ai-product-photo-tagger/blob/main/api/analyze.php): `api/analyze.php`
- [Image Preparation](https://github.com/vanixus/ai-product-photo-tagger/blob/main/api/analyze.php): `api/analyze.php`

### Catalog and Management

- [Image Gallery](https://github.com/vanixus/ai-product-photo-tagger/blob/main/gallery.php): `gallery.php`
- [Admin Management](https://github.com/vanixus/ai-product-photo-tagger/blob/main/admin.php): `admin.php`
- [Coin Balance API](https://github.com/vanixus/ai-product-photo-tagger/blob/main/api/coins.php): `api/coins.php`
- [Wallet Operations](https://github.com/vanixus/ai-product-photo-tagger/blob/main/includes/auth.php): `includes/auth.php`

### Runtime Infrastructure

- [Uploaded Images](https://github.com/vanixus/ai-product-photo-tagger/tree/main/uploads): `uploads`
- [PDO Connection](https://github.com/vanixus/ai-product-photo-tagger/blob/main/config/db.php): `config/db.php`
- [Image Metadata Schema](https://github.com/vanixus/ai-product-photo-tagger/blob/main/schema.sql): `schema.sql`
- [Runtime Configuration](https://github.com/vanixus/ai-product-photo-tagger/blob/main/config/constants.php): `config/constants.php`

### Other components

- **User**
- **Claude API**
- **MySQL Database**

## Connections

- User → Password Login: enters password (evidence: `login.php`)
- Password Login → Session Authorization: checks credentials (evidence: `login.php`)
- User → Upload and Camera UI: selects or captures (evidence: `index.php`)
- Upload and Camera UI → Image Analysis Endpoint: posts image (evidence: `index.php`)
- Image Analysis Endpoint → Session Authorization: checks session (evidence: `api/analyze.php`)
- Image Analysis Endpoint → Image Preparation: prepares image (evidence: `api/analyze.php`)
- Image Preparation → Claude API: requests tagging (evidence: `api/analyze.php`)
- Image Analysis Endpoint → Uploaded Images: stores image (evidence: `README.md`)
- Image Analysis Endpoint → PDO Connection: saves metadata (evidence: `README.md`)
- Image Gallery → Session Authorization: requires login (evidence: `gallery.php`)
- Image Gallery → PDO Connection: reads image records (evidence: `gallery.php`)
- User → Image Gallery: browses catalog (evidence: `README.md`)
- User → Admin Management: manages service (evidence: `README.md`)
- Admin Management → Session Authorization: requires admin (evidence: `admin.php`)
- Admin Management → PDO Connection: reads and updates (evidence: `admin.php`)
- Upload and Camera UI → Coin Balance API: fetches balance (evidence: `index.php`)
- Coin Balance API → Wallet Operations: gets balance (evidence: `api/coins.php`)
- Image Analysis Endpoint → Wallet Operations: deducts coin (evidence: `api/analyze.php`)
- Admin Management → Wallet Operations: sets balance (evidence: `admin.php`)
- Wallet Operations → PDO Connection: queries wallet (evidence: `includes/auth.php`)
- PDO Connection → Runtime Configuration: loads settings (evidence: `config/db.php`)
- PDO Connection → MySQL Database: connects (evidence: `config/db.php`)
- Image Metadata Schema → MySQL Database: defines tables (evidence: `README.md`)
- User → Logout: ends session (evidence: `logout.php`)
- Logout → Session Authorization: destroys session (evidence: `logout.php`)
