# wvvtop/svoy-3d architecture

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

- Interactive diagram: https://gitdiagram.com/wvvtop/svoy-3d
- Repository: https://github.com/wvvtop/svoy-3d

## Overview

Svoy-3d is an API for user accounts and 3D-related orders, including order-photo handling and a separate admin API. The user workflow covers authentication, order creation and management, and image upload, processing, storage, and retrieval; administrators have a separate order-reading surface. The graph includes shared persistence, image/storage services, and application error handling. Several route and admin-service implementations were not sampled, so their unverified runtime links are omitted rather than inferred.

Main entry points: [`app/servers/user/services/order_image`](https://github.com/wvvtop/svoy-3d/tree/main/app/servers/user/services/order_image) (Order-image services), [`app/servers/user/main.py`](https://github.com/wvvtop/svoy-3d/blob/main/app/servers/user/main.py) (User API app), [`app/servers/admin/main.py`](https://github.com/wvvtop/svoy-3d/blob/main/app/servers/admin/main.py) (Admin API app), [`app/servers/user/routers`](https://github.com/wvvtop/svoy-3d/tree/main/app/servers/user/routers) (User routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_user_api["User API"]
  node_user_app["User API app<br/>[main.py]"]
  node_user_routes["User routes"]
  node_user_auth["User authentication route<br/>[auth.py]"]
  node_order_routes["Order routes"]
  node_image_routes["Order-image routes"]
end

subgraph group_admin_api["Admin API"]
  node_admin_app["Admin API app<br/>[main.py]"]
  node_admin_routes["Admin routes"]
  node_admin_order_read["Admin order reading<br/>[read.py]"]
end

subgraph group_domain["Orders and Images"]
  node_order_service["Order services"]
  node_image_service["Order-image services"]
end

subgraph group_shared["Shared Services"]
  node_auth_service["Authentication service<br/>[auth.py]"]
  node_image_processing["Image processing<br/>[image_processor.py]"]
  node_image_validation["Image validation<br/>[image_validator.py]"]
  node_image_upload["Image upload helper<br/>[image_upload.py]"]
  node_storage_service["Object storage service<br/>[storage.py]"]
  node_storage_client["Storage client setup<br/>[client.py]"]
  node_exception_handler["Application error handler"]
end

subgraph group_persistence["Persistence"]
  node_user_repository["User repository<br/>[user.py]"]
  node_order_repository["Order repositories"]
  node_database_setup["Database setup<br/>[database.py]"]
  node_db_models[("User and order models<br/>[order.py]")]
  node_photo_model[("Order-photo model<br/>[order_photo.py]")]
end

node_user(("User"))
node_admin(("Administrator"))
node_postgres[("PostgreSQL")]
node_minio[("MinIO")]

node_user -->|"uses API"| node_user_app
node_user_app -->|"mounts routes"| node_user_routes
node_user_routes -->|"includes"| node_user_auth
node_user_routes -->|"includes"| node_order_routes
node_user_routes -->|"includes"| node_image_routes
node_user_auth -->|"calls"| node_auth_service
node_auth_service -->|"queries users"| node_user_repository
node_user_repository -->|"uses user model"| node_db_models
node_order_routes -.->|"dispatches order actions"| node_order_service
node_image_routes -.->|"dispatches image actions"| node_image_service
node_order_service -->|"creates order"| node_order_repository
node_order_service -->|"uses order model"| node_db_models
node_order_service -->|"uploads order image"| node_image_service
node_order_repository -->|"queries orders"| node_db_models
node_image_service -->|"loads order"| node_order_repository
node_image_service -->|"validates image"| node_image_validation
node_image_service -->|"processes image"| node_image_processing
node_image_service -->|"uploads image data"| node_image_upload
node_image_service -->|"stores image"| node_storage_service
node_user_app -->|"creates clients"| node_storage_client
node_user_app -->|"initializes buckets"| node_storage_service
node_storage_service -->|"reads and writes objects"| node_minio
node_user_app -->|"creates database"| node_database_setup
node_database_setup -->|"opens connection"| node_postgres
node_user_app -->|"registers handler"| node_exception_handler
node_admin -->|"uses API"| node_admin_app
node_admin_app -->|"mounts routes"| node_admin_routes
node_admin_routes -->|"includes order route"| node_admin_order_read
node_admin_app -->|"creates database"| node_database_setup
node_admin_app -->|"creates clients"| node_storage_client
node_admin_app -->|"initializes buckets"| node_storage_service

click node_user_app "https://github.com/wvvtop/svoy-3d/blob/main/app/servers/user/main.py"
click node_user_routes "https://github.com/wvvtop/svoy-3d/tree/main/app/servers/user/routers"
click node_user_auth "https://github.com/wvvtop/svoy-3d/blob/main/app/servers/user/routers/auth.py"
click node_order_routes "https://github.com/wvvtop/svoy-3d/tree/main/app/servers/user/routers/orders"
click node_image_routes "https://github.com/wvvtop/svoy-3d/tree/main/app/servers/user/routers/orders_image"
click node_admin_app "https://github.com/wvvtop/svoy-3d/blob/main/app/servers/admin/main.py"
click node_admin_routes "https://github.com/wvvtop/svoy-3d/tree/main/app/servers/admin/routers"
click node_admin_order_read "https://github.com/wvvtop/svoy-3d/blob/main/app/servers/admin/routers/orders/read.py"
click node_auth_service "https://github.com/wvvtop/svoy-3d/blob/main/app/services/auth.py"
click node_user_repository "https://github.com/wvvtop/svoy-3d/blob/main/app/repositories/user.py"
click node_order_service "https://github.com/wvvtop/svoy-3d/tree/main/app/servers/user/services/order"
click node_order_repository "https://github.com/wvvtop/svoy-3d/tree/main/app/servers/user/repositories/order"
click node_image_service "https://github.com/wvvtop/svoy-3d/tree/main/app/servers/user/services/order_image"
click node_image_processing "https://github.com/wvvtop/svoy-3d/blob/main/app/services/image/image_processor.py"
click node_image_validation "https://github.com/wvvtop/svoy-3d/blob/main/app/services/image/image_validator.py"
click node_image_upload "https://github.com/wvvtop/svoy-3d/blob/main/app/services/image/image_upload.py"
click node_storage_service "https://github.com/wvvtop/svoy-3d/blob/main/app/services/storage.py"
click node_storage_client "https://github.com/wvvtop/svoy-3d/blob/main/app/integrations/storage/client.py"
click node_database_setup "https://github.com/wvvtop/svoy-3d/blob/main/app/database/database.py"
click node_db_models "https://github.com/wvvtop/svoy-3d/blob/main/app/database/models/order.py"
click node_photo_model "https://github.com/wvvtop/svoy-3d/blob/main/app/database/models/order_photo.py"
click node_exception_handler "https://github.com/wvvtop/svoy-3d/blob/main/app/exceptions/app_exception_handler.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_user_app,node_user_routes,node_user_auth,node_order_routes,node_image_routes,node_user toneBlue
class node_admin_app,node_admin_routes,node_admin_order_read,node_postgres,node_minio toneAmber
class node_order_service,node_image_service toneMint
class node_auth_service,node_image_processing,node_image_validation,node_image_upload,node_storage_service,node_storage_client,node_exception_handler toneRose
class node_user_repository,node_order_repository,node_database_setup,node_db_models,node_photo_model,node_admin toneIndigo
```

## Components

### User API

- [User API app](https://github.com/wvvtop/svoy-3d/blob/main/app/servers/user/main.py): `app/servers/user/main.py`
- [User routes](https://github.com/wvvtop/svoy-3d/tree/main/app/servers/user/routers): `app/servers/user/routers`
- [User authentication route](https://github.com/wvvtop/svoy-3d/blob/main/app/servers/user/routers/auth.py): `app/servers/user/routers/auth.py`
- [Order routes](https://github.com/wvvtop/svoy-3d/tree/main/app/servers/user/routers/orders): `app/servers/user/routers/orders`
- [Order-image routes](https://github.com/wvvtop/svoy-3d/tree/main/app/servers/user/routers/orders_image): `app/servers/user/routers/orders_image`

### Admin API

- [Admin API app](https://github.com/wvvtop/svoy-3d/blob/main/app/servers/admin/main.py): `app/servers/admin/main.py`
- [Admin routes](https://github.com/wvvtop/svoy-3d/tree/main/app/servers/admin/routers): `app/servers/admin/routers`
- [Admin order reading](https://github.com/wvvtop/svoy-3d/blob/main/app/servers/admin/routers/orders/read.py): `app/servers/admin/routers/orders/read.py`

### Orders and Images

- [Order services](https://github.com/wvvtop/svoy-3d/tree/main/app/servers/user/services/order): `app/servers/user/services/order`
- [Order-image services](https://github.com/wvvtop/svoy-3d/tree/main/app/servers/user/services/order_image): `app/servers/user/services/order_image`

### Shared Services

- [Authentication service](https://github.com/wvvtop/svoy-3d/blob/main/app/services/auth.py): `app/services/auth.py`
- [Image processing](https://github.com/wvvtop/svoy-3d/blob/main/app/services/image/image_processor.py): `app/services/image/image_processor.py`
- [Image validation](https://github.com/wvvtop/svoy-3d/blob/main/app/services/image/image_validator.py): `app/services/image/image_validator.py`
- [Image upload helper](https://github.com/wvvtop/svoy-3d/blob/main/app/services/image/image_upload.py): `app/services/image/image_upload.py`
- [Object storage service](https://github.com/wvvtop/svoy-3d/blob/main/app/services/storage.py): `app/services/storage.py`
- [Storage client setup](https://github.com/wvvtop/svoy-3d/blob/main/app/integrations/storage/client.py): `app/integrations/storage/client.py`
- [Application error handler](https://github.com/wvvtop/svoy-3d/blob/main/app/exceptions/app_exception_handler.py): `app/exceptions/app_exception_handler.py`

### Persistence

- [User repository](https://github.com/wvvtop/svoy-3d/blob/main/app/repositories/user.py): `app/repositories/user.py`
- [Order repositories](https://github.com/wvvtop/svoy-3d/tree/main/app/servers/user/repositories/order): `app/servers/user/repositories/order`
- [Database setup](https://github.com/wvvtop/svoy-3d/blob/main/app/database/database.py): `app/database/database.py`
- [User and order models](https://github.com/wvvtop/svoy-3d/blob/main/app/database/models/order.py): `app/database/models/order.py`
- [Order-photo model](https://github.com/wvvtop/svoy-3d/blob/main/app/database/models/order_photo.py): `app/database/models/order_photo.py`

### Other components

- **User**
- **Administrator**
- **PostgreSQL**
- **MinIO**

## Connections

- User → User API app: uses API (evidence: `app/servers/user/main.py`)
- User API app → User routes: mounts routes (evidence: `app/servers/user/main.py`)
- User routes → User authentication route: includes (evidence: `app/servers/user/routers/__init__.py`)
- User routes → Order routes: includes (evidence: `app/servers/user/routers/__init__.py`)
- User routes → Order-image routes: includes (evidence: `app/servers/user/routers/__init__.py`)
- User authentication route → Authentication service: calls (evidence: `app/servers/user/routers/auth.py`)
- Authentication service → User repository: queries users (evidence: `app/services/auth.py`)
- User repository → User and order models: uses user model (evidence: `app/repositories/user.py`)
- Order routes → Order services: dispatches order actions
- Order-image routes → Order-image services: dispatches image actions
- Order services → Order repositories: creates order (evidence: `app/servers/user/services/order/create_order.py`)
- Order services → User and order models: uses order model (evidence: `app/servers/user/services/order/create_order.py`)
- Order services → Order-image services: uploads order image (evidence: `app/servers/user/services/order/create_order.py`)
- Order repositories → User and order models: queries orders (evidence: `app/servers/user/repositories/order/get_order.py`)
- Order-image services → Order repositories: loads order (evidence: `app/servers/user/services/order_image/upload.py`)
- Order-image services → Image validation: validates image (evidence: `app/servers/user/services/order_image/upload.py`)
- Order-image services → Image processing: processes image (evidence: `app/servers/user/services/order_image/upload.py`)
- Order-image services → Image upload helper: uploads image data (evidence: `app/servers/user/services/order_image/upload.py`)
- Order-image services → Object storage service: stores image (evidence: `app/servers/user/services/order_image/upload.py`)
- User API app → Storage client setup: creates clients (evidence: `app/servers/user/main.py`)
- User API app → Object storage service: initializes buckets (evidence: `app/servers/user/main.py`)
- Object storage service → MinIO: reads and writes objects (evidence: `app/services/storage.py`)
- User API app → Database setup: creates database (evidence: `app/servers/user/main.py`)
- Database setup → PostgreSQL: opens connection (evidence: `app/database/database.py`)
- User API app → Application error handler: registers handler (evidence: `app/servers/user/main.py`)
- Administrator → Admin API app: uses API (evidence: `app/servers/admin/main.py`)
- Admin API app → Admin routes: mounts routes (evidence: `app/servers/admin/main.py`)
- Admin routes → Admin order reading: includes order route (evidence: `app/servers/admin/routers/__init__.py`)
- Admin API app → Database setup: creates database (evidence: `app/servers/admin/main.py`)
- Admin API app → Storage client setup: creates clients (evidence: `app/servers/admin/main.py`)
- Admin API app → Object storage service: initializes buckets (evidence: `app/servers/admin/main.py`)
