# zenginby/kromis architecture

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

- Interactive diagram: https://gitdiagram.com/zenginby/kromis
- Repository: https://github.com/zenginby/kromis

## Overview

Kromis Studio is a browser-based creative studio: users describe an image or video, refine a prompt and model settings, submit generation, then manage results in a gallery with folders, palettes, and overlays. The web-first product also includes accounts, credits, subscriptions, and provider-key settings. The graph separates the documented studio capabilities from account/billing and the internal queue, worker, and persistence layers. Some subsystems are represented from README claims and indexed file references; unsampled implementations are not assumed to have unverified call links.

Main entry points: [`static/core.js`](https://github.com/zenginby/kromis/blob/main/static/core.js) (Studio interface), [`app.py`](https://github.com/zenginby/kromis/blob/main/app.py) (Web application), [`routers/uretim.py`](https://github.com/zenginby/kromis/blob/main/routers/uretim.py) (Generation routes), [`providers.py`](https://github.com/zenginby/kromis/blob/main/providers.py) (Provider dispatch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_studio["Creative studio"]
  node_web["Studio interface<br/>[core.js]"]
  node_prompt["Prompt director<br/>[chat.js]"]
  node_chat_api["Chat routes<br/>[sohbet.py]"]
  node_palette["Palette tools<br/>[paletler.py]"]
  node_palette_logic["Palette logic<br/>[palet.py]"]
  node_gallery["Gallery and folders<br/>[galeri.py]"]
  node_overlay["Brand overlays<br/>[composite.py]"]
  node_settings["Provider settings<br/>[ayarlar.py]"]
end

subgraph group_generation["Generation"]
  node_generation_api["Generation routes<br/>[uretim.py]"]
  node_catalog["Model catalog<br/>[catalog.py]"]
  node_providers["Provider dispatch<br/>[providers.py]"]
  node_image_clients["Image providers<br/>[azure_client.py]"]
  node_video_clients["Video providers<br/>[veo_client.py]"]
  node_jobs_api["Job routes<br/>[isler.py]"]
end

subgraph group_accounts["Accounts and billing"]
  node_auth["Identity gate<br/>[kimlik.py]"]
  node_account_api["Account routes<br/>[hesap.py]"]
  node_credits["Credit ledger<br/>[defter.py]"]
  node_payment["Payment processing<br/>[odeme.py]"]
  node_polar["Polar payments<br/>[polar.py]"]
end

subgraph group_runtime["Runtime and data"]
  node_queue["Job queue<br/>[kuyruk.py]"]
  node_worker["Generation worker<br/>[isci.py]"]
  node_app["Web application<br/>[app.py]"]
  node_db[("PostgreSQL session<br/>[db.py]")]
  node_schema[("Data schema<br/>[tablolar.py]")]
  node_media_store[("Media storage<br/>[nesne_depo.py]")]
end

node_user(("Studio user"))

node_user -->|"uses"| node_web
node_web -->|"directs prompt"| node_prompt
node_web -.->|"requests chat"| node_chat_api
node_web -->|"submits generation"| node_generation_api
node_web -->|"edits palette"| node_palette
node_palette -.->|"uses"| node_palette_logic
node_web -->|"manages results"| node_gallery
node_web -->|"overlays branding"| node_overlay
node_web -->|"sets credentials"| node_settings
node_app -->|"registers route"| node_generation_api
node_app -->|"registers route"| node_chat_api
node_app -->|"registers route"| node_gallery
node_app -->|"registers route"| node_palette
node_app -->|"registers route"| node_settings
node_app -->|"registers route"| node_jobs_api
node_app -->|"registers route"| node_account_api
node_generation_api -.->|"selects model"| node_catalog
node_generation_api -->|"enqueues job"| node_queue
node_generation_api -.->|"dispatches generation"| node_providers
node_providers -->|"calls image APIs"| node_image_clients
node_providers -->|"calls video APIs"| node_video_clients
node_jobs_api -->|"reads job state"| node_queue
node_worker -.->|"claims jobs"| node_queue
node_worker -.->|"runs generation"| node_providers
node_worker -.->|"stores results"| node_media_store
node_account_api -->|"requires identity"| node_auth
node_generation_api -.->|"requires identity"| node_auth
node_account_api -->|"reads account credits"| node_credits
node_payment -->|"uses payment provider"| node_polar
node_payment -->|"applies paid credits"| node_credits
node_db -.->|"maps tables"| node_schema
node_queue -.->|"persists jobs"| node_db
node_credits -.->|"persists ledger"| node_db

click node_web "https://github.com/zenginby/kromis/blob/main/static/core.js"
click node_prompt "https://github.com/zenginby/kromis/blob/main/static/chat.js"
click node_chat_api "https://github.com/zenginby/kromis/blob/main/routers/sohbet.py"
click node_palette "https://github.com/zenginby/kromis/blob/main/routers/paletler.py"
click node_palette_logic "https://github.com/zenginby/kromis/blob/main/services/palet.py"
click node_gallery "https://github.com/zenginby/kromis/blob/main/routers/galeri.py"
click node_overlay "https://github.com/zenginby/kromis/blob/main/composite.py"
click node_settings "https://github.com/zenginby/kromis/blob/main/routers/ayarlar.py"
click node_generation_api "https://github.com/zenginby/kromis/blob/main/routers/uretim.py"
click node_catalog "https://github.com/zenginby/kromis/blob/main/catalog.py"
click node_providers "https://github.com/zenginby/kromis/blob/main/providers.py"
click node_image_clients "https://github.com/zenginby/kromis/blob/main/azure_client.py"
click node_video_clients "https://github.com/zenginby/kromis/blob/main/veo_client.py"
click node_jobs_api "https://github.com/zenginby/kromis/blob/main/routers/isler.py"
click node_queue "https://github.com/zenginby/kromis/blob/main/services/kuyruk.py"
click node_worker "https://github.com/zenginby/kromis/blob/main/services/isci.py"
click node_auth "https://github.com/zenginby/kromis/blob/main/services/kimlik.py"
click node_account_api "https://github.com/zenginby/kromis/blob/main/routers/hesap.py"
click node_credits "https://github.com/zenginby/kromis/blob/main/services/defter.py"
click node_payment "https://github.com/zenginby/kromis/blob/main/services/odeme.py"
click node_polar "https://github.com/zenginby/kromis/blob/main/services/polar.py"
click node_app "https://github.com/zenginby/kromis/blob/main/app.py"
click node_db "https://github.com/zenginby/kromis/blob/main/services/db.py"
click node_schema "https://github.com/zenginby/kromis/blob/main/services/tablolar.py"
click node_media_store "https://github.com/zenginby/kromis/blob/main/services/nesne_depo.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_web,node_prompt,node_chat_api,node_palette,node_palette_logic,node_gallery,node_overlay,node_settings,node_user toneBlue
class node_generation_api,node_catalog,node_providers,node_image_clients,node_video_clients,node_jobs_api toneAmber
class node_auth,node_account_api,node_credits,node_payment,node_polar toneMint
class node_queue,node_worker,node_app,node_db,node_schema,node_media_store toneRose
```

## Components

### Creative studio

- [Studio interface](https://github.com/zenginby/kromis/blob/main/static/core.js): `static/core.js`
- [Prompt director](https://github.com/zenginby/kromis/blob/main/static/chat.js): `static/chat.js`
- [Chat routes](https://github.com/zenginby/kromis/blob/main/routers/sohbet.py): `routers/sohbet.py`
- [Palette tools](https://github.com/zenginby/kromis/blob/main/routers/paletler.py): `routers/paletler.py`
- [Palette logic](https://github.com/zenginby/kromis/blob/main/services/palet.py): `services/palet.py`
- [Gallery and folders](https://github.com/zenginby/kromis/blob/main/routers/galeri.py): `routers/galeri.py`
- [Brand overlays](https://github.com/zenginby/kromis/blob/main/composite.py): `composite.py`
- [Provider settings](https://github.com/zenginby/kromis/blob/main/routers/ayarlar.py): `routers/ayarlar.py`

### Generation

- [Generation routes](https://github.com/zenginby/kromis/blob/main/routers/uretim.py): `routers/uretim.py`
- [Model catalog](https://github.com/zenginby/kromis/blob/main/catalog.py): `catalog.py`
- [Provider dispatch](https://github.com/zenginby/kromis/blob/main/providers.py): `providers.py`
- [Image providers](https://github.com/zenginby/kromis/blob/main/azure_client.py): `azure_client.py`
- [Video providers](https://github.com/zenginby/kromis/blob/main/veo_client.py): `veo_client.py`
- [Job routes](https://github.com/zenginby/kromis/blob/main/routers/isler.py): `routers/isler.py`

### Accounts and billing

- [Identity gate](https://github.com/zenginby/kromis/blob/main/services/kimlik.py): `services/kimlik.py`
- [Account routes](https://github.com/zenginby/kromis/blob/main/routers/hesap.py): `routers/hesap.py`
- [Credit ledger](https://github.com/zenginby/kromis/blob/main/services/defter.py): `services/defter.py`
- [Payment processing](https://github.com/zenginby/kromis/blob/main/services/odeme.py): `services/odeme.py`
- [Polar payments](https://github.com/zenginby/kromis/blob/main/services/polar.py): `services/polar.py`

### Runtime and data

- [Job queue](https://github.com/zenginby/kromis/blob/main/services/kuyruk.py): `services/kuyruk.py`
- [Generation worker](https://github.com/zenginby/kromis/blob/main/services/isci.py): `services/isci.py`
- [Web application](https://github.com/zenginby/kromis/blob/main/app.py): `app.py`
- [PostgreSQL session](https://github.com/zenginby/kromis/blob/main/services/db.py): `services/db.py`
- [Data schema](https://github.com/zenginby/kromis/blob/main/services/tablolar.py): `services/tablolar.py`
- [Media storage](https://github.com/zenginby/kromis/blob/main/services/nesne_depo.py): `services/nesne_depo.py`

### Other components

- **Studio user**

## Connections

- Studio user → Studio interface: uses (evidence: `README.md`)
- Studio interface → Prompt director: directs prompt (evidence: `README.md`)
- Studio interface → Chat routes: requests chat
- Studio interface → Generation routes: submits generation (evidence: `README.md`)
- Studio interface → Palette tools: edits palette (evidence: `README.md`)
- Palette tools → Palette logic: uses
- Studio interface → Gallery and folders: manages results (evidence: `README.md`)
- Studio interface → Brand overlays: overlays branding (evidence: `README.md`)
- Studio interface → Provider settings: sets credentials (evidence: `README.md`)
- Web application → Generation routes: registers route (evidence: `app.py`)
- Web application → Chat routes: registers route (evidence: `app.py`)
- Web application → Gallery and folders: registers route (evidence: `app.py`)
- Web application → Palette tools: registers route (evidence: `app.py`)
- Web application → Provider settings: registers route (evidence: `app.py`)
- Web application → Job routes: registers route (evidence: `app.py`)
- Web application → Account routes: registers route (evidence: `app.py`)
- Generation routes → Model catalog: selects model (evidence: `routers/uretim.py`)
- Generation routes → Job queue: enqueues job (evidence: `routers/uretim.py`)
- Generation routes → Provider dispatch: dispatches generation
- Provider dispatch → Image providers: calls image APIs (evidence: `providers.py`)
- Provider dispatch → Video providers: calls video APIs (evidence: `providers.py`)
- Job routes → Job queue: reads job state (evidence: `routers/isler.py`)
- Generation worker → Job queue: claims jobs (evidence: `services/isci.py`)
- Generation worker → Provider dispatch: runs generation (evidence: `services/isci.py`)
- Generation worker → Media storage: stores results (evidence: `services/isci.py`)
- Account routes → Identity gate: requires identity (evidence: `routers/hesap.py`)
- Generation routes → Identity gate: requires identity (evidence: `routers/uretim.py`)
- Account routes → Credit ledger: reads account credits (evidence: `routers/hesap.py`)
- Payment processing → Polar payments: uses payment provider (evidence: `services/odeme.py`)
- Payment processing → Credit ledger: applies paid credits (evidence: `services/odeme.py`)
- PostgreSQL session → Data schema: maps tables
- Job queue → PostgreSQL session: persists jobs
- Credit ledger → PostgreSQL session: persists ledger
