# qsoo/gnm architecture

> Architecture diagram of the GitHub repository qsoo/gnm, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/qsoo/gnm
- Repository: https://github.com/qsoo/gnm

## Overview

##### Project Type and Purpose
- This is a full-stack interactive web application (“GNM”) that lets users explore virtual art galleries, upload photos, and have them transformed into famous artists’ styles (Monet, Klimt, Chun Kyung-ja) via AI style‐transfer models.
- Frontend: Vue.js SPA (Quasar)
- Backend: Django + Django REST Framework
- AI: PyTorch‐based style-transfer modules
- Database: relational (e.g. PostgreSQL or SQLite)
- Storage: local or cloud media storage for uploaded/processed images

##### Main Components
a. User Browser (Client)
- Vue.js SPA served from `frontend/dist` or directly via CDN/Nginx
- Routes, components, API clients under `frontend/src`
b. API Server
- Django project under `backend/pjt` (settings for local/production)
- Two main apps:
– `galleries` (gallery metadata, navigation)
– `articles` (guestbook entries + transformed image references)
- Authentication/session management (DRF, Django sessions)
- File‐upload endpoints (`/api/upload`)
- Swagger/OpenAPI docs served via `drf-yasg`
c. AI Style-Transfer Service
- PyTorch code modules under `Models/<artist>/…/style_transfer` (function.py, net.py, pretrained `.tar` and `.pth`)
- Could be deployed as a separate microservice or imported as a package
- Exposed via a local Python API or REST endpoint that the Django server invokes
d. Data Stores
- Relational Database (stores user, guestbook, gallery metadata)
- Media Storage (disk or S3 bucket for original & styled images)
- Static Assets (served via Django staticfiles or external CDN)

##### Component Interactions & Data Flow
1. User → Browser: clicks on galleries or uploads image
2. SPA → API Server:
– GET `/api/galleries/` → list of galleries & metadata
– POST `/api/upload/` → user image + selected style
3. API Server → Database: save metadata (guestbook post, image record)
4. API Server → AI Service: send image + style tag → receive stylized image buffer
5. API Server → Media Storage: write stylized image file, update DB record
6. API Server → SPA: return URL for styled image + any metadata
7. SPA → Browser: displays new image in “Special Exhibition” or guestbook

##### Architectural Patterns & Design Principles
- Layered architecture:
- Presentation (Vue.js components)
- Application/API layer (Django views/serializers)
- Domain logic (Django models + services)
- AI Service (style-transfer module)
- Persistence (DB + Media storage)
- Component‐based frontend (reusable Vue components per gallery/feature)
- Separation of concerns: style-transfer code isolated in its own module or service
- Config‐driven environments (Django `settings/base.py`, `local.py`, `production.py`)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% User Browser Layer
    subgraph "User Browser (Vue.js SPA)" 
        direction TB
        MapPage["MapPage.vue"]:::frontend
        GuestBook["GuestBook.vue"]:::frontend
        SpecialGallery["SpecialGallery.vue"]:::frontend
        PhotoUpload["PhotoUpload.vue"]:::frontend
        IconMapComp["IconMap.vue"]:::frontend
        BookComp["Book.vue"]:::frontend
        OutputComp["Output.vue"]:::frontend
        Router["router/index.js"]:::frontend
        APIClient["fileUpload.js"]:::frontend
    end

    %% API Server Layer
    subgraph "API Server (Django + DRF)" 
        direction TB
        DjangoREST["Django REST API"]:::api
        subgraph "Apps"
            direction TB
            ArticlesApp["articles (views.py, serializers.py, urls.py, models.py)"]:::api
            GalleriesApp["galleries (views.py, serializers.py, urls.py, models.py)"]:::api
        end
        EnvConfig["settings (base.py, local.py, production.py)"]:::api
        SwaggerAssets["drf-yasg staticfiles"]:::api
    end

    %% AI Service Layer
    subgraph "AI Style-Transfer Service (PyTorch)" 
        direction TB
        MonetFunc["claude_monet/function.py"]:::ai
        MonetNet["claude_monet/net.py"]:::ai
        KlimtFunc["gustav_klimt/function.py"]:::ai
        KlimtNet["gustav_klimt/net.py"]:::ai
        ChunFunc["chun_kyung_ja/function.py"]:::ai
        ChunNet["chun_kyung_ja/net.py"]:::ai
    end

    %% Data Stores Layer
    subgraph "Data Stores & Static" 
        direction TB
        RelationalDB["Relational Database"]:::data
        MediaStorage["Media Storage"]:::data
        StaticAssets["Static Assets"]:::data
    end

    %% Connections User->API
    MapPage -->|"/api/galleries/ GET"| DjangoREST
    GuestBook -->|"/api/articles/ GET/POST"| DjangoREST
    PhotoUpload -->|"/api/upload POST"| DjangoREST
    APIClient -->|calls POST /upload| DjangoREST
    Router -->|routes SPA requests| MapPage

    %% API->AI
    DjangoREST -->|"RPC/Local call: transform(image,style)"| MonetFunc
    DjangoREST -->|"RPC/Local call: transform(image,style)"| KlimtFunc
    DjangoREST -->|"RPC/Local call: transform(image,style)"| ChunFunc

    %% API->Data Stores
    DjangoREST -->|"SQL"| RelationalDB
    DjangoREST -->|"write file"| MediaStorage
    DjangoREST -->|"serve static"| StaticAssets
    DjangoREST -->|"serve docs"| SwaggerAssets

    %% Return flows
    RelationalDB -->|"metadata"| DjangoREST
    MediaStorage -->|"image URL"| DjangoREST
    DjangoREST -->|"JSON response"| PhotoUpload

    %% Click events User Browser
    click MapPage "https://github.com/qsoo/gnm/blob/master/frontend/src/views/MapPage.vue"
    click GuestBook "https://github.com/qsoo/gnm/blob/master/frontend/src/views/GuestBook.vue"
    click SpecialGallery "https://github.com/qsoo/gnm/blob/master/frontend/src/views/SpecialGallery.vue"
    click PhotoUpload "https://github.com/qsoo/gnm/blob/master/frontend/src/views/PhotoUpload.vue"
    click IconMapComp "https://github.com/qsoo/gnm/blob/master/frontend/src/components/IconMap/IconMap.vue"
    click BookComp "https://github.com/qsoo/gnm/blob/master/frontend/src/components/GuestBook/Book.vue"
    click OutputComp "https://github.com/qsoo/gnm/blob/master/frontend/src/components/SpecialGallery/Output.vue"
    click Router "https://github.com/qsoo/gnm/blob/master/frontend/src/router/index.js"
    click APIClient "https://github.com/qsoo/gnm/blob/master/frontend/src/api/fileUpload.js"

    %% Click events API Server
    click EnvConfig "https://github.com/qsoo/gnm/blob/master/backend/pjt/settings/base.py"
    click SwaggerAssets "https://github.com/qsoo/gnm/tree/master/backend/pjt/staticfiles/drf-yasg"
    click ArticlesApp "https://github.com/qsoo/gnm/blob/master/backend/articles/views.py"
    click ArticlesApp "https://github.com/qsoo/gnm/blob/master/backend/articles/serializers.py"
    click ArticlesApp "https://github.com/qsoo/gnm/blob/master/backend/articles/urls.py"
    click ArticlesApp "https://github.com/qsoo/gnm/blob/master/backend/articles/models.py"
    click GalleriesApp "https://github.com/qsoo/gnm/blob/master/backend/galleries/views.py"
    click GalleriesApp "https://github.com/qsoo/gnm/blob/master/backend/galleries/serializers.py"
    click GalleriesApp "https://github.com/qsoo/gnm/blob/master/backend/galleries/urls.py"
    click GalleriesApp "https://github.com/qsoo/gnm/blob/master/backend/galleries/models.py"
    click DjangoREST "https://github.com/qsoo/gnm/blob/master/backend/pjt/urls.py"

    %% Click events AI Service
    click MonetFunc "https://github.com/qsoo/gnm/blob/master/Models/claude_monet/monet/style_transfer/function.py"
    click MonetNet "https://github.com/qsoo/gnm/blob/master/Models/claude_monet/monet/style_transfer/net.py"
    click KlimtFunc "https://github.com/qsoo/gnm/blob/master/Models/gustav_klimt/klimt/style_transfer/function.py"
    click KlimtNet "https://github.com/qsoo/gnm/blob/master/Models/gustav_klimt/klimt/style_transfer/net.py"
    click ChunFunc "https://github.com/qsoo/gnm/blob/master/Models/chun_kyung_ja/chun/style_transfer/function.py"
    click ChunNet "https://github.com/qsoo/gnm/blob/master/Models/chun_kyung_ja/chun/style_transfer/net.py"

    %% Styles
    classDef frontend fill:#AED6F1,stroke:#2980B9,color:#000
    classDef api fill:#ABEBC6,stroke:#27AE60,color:#000
    classDef ai fill:#F5B041,stroke:#D35400,color:#000
    classDef data fill:#D5DBDB,stroke:#7F8C8D,color:#000
```
