# breezeapps/yapuka architecture

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

- Interactive diagram: https://gitdiagram.com/breezeapps/yapuka
- Repository: https://github.com/breezeapps/yapuka

## Overview

##### Main Components Identification

The system should be represented with these key components:

a) Frontend Layer:
- Main Window (window/main)
- Configuration Window (window/config)
- Plugin Window (window/plugin)
- Print Preview Interface (printer/)

b) Backend Layer:
- Main Process (main.js)
- Database Management (utils/database.js)
- Plugin System (plugins/)
- Printer Service (printer/)

c) Data Layer:
- SQLite Database (utils/Yapuka_Data)
- Internationalization Files (utils/locales)

**┌─ Electron Application ─────────────────────┐**
- ┌─ Frontend (Renderer Process) ─────────┐  │

- Main Window   Config Window  Plugins │  │

- ┘  │
- ┌─ Backend (Main Process) ──────────────┐  │

- Task Management    Plugin System     │  │
- Print Service     I18n Service       │  │

- ┘  │
- ┌─ Data Layer ────────────────────────────┐│

- SQLite Database    Localization Files  ││

- ┘│
- ┘

##### Component Relationships

- IPC communication between renderer and main processes
- Data flow between database and application layers
- Plugin system integration points
- Print service workflow

##### Technical Details

- Electron IPC communication paths
- SQLite database connections
- Plugin loading mechanism
- Print template system
- I18n implementation

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Electron["Electron Application"]
        subgraph FrontEnd["Frontend Layer"]
            MainWin["Main Window"]
            ConfigWin["Configuration Window"]
            PluginWin["Plugin Window"]
            PrintPreview["Print Preview"]
        end

        subgraph BackEnd["Backend Layer"]
            MainProcess["Main Process"]
            DBManagement["Database Management"]
            PluginSystem["Plugin System"]
            PrinterService["Printer Service"]
            I18nService["I18n Service"]
            ThemeService["Theme Service"]
        end

        subgraph DataLayer["Data Layer"]
            DB[(SQLite Database)]
            I18nFiles["Localization Files"]
            Templates["Print Templates"]
            PluginFiles["Plugin Files"]
        end
    end

    %% Relationships
    MainProcess --> MainWin
    MainProcess --> ConfigWin
    MainProcess --> PluginWin
    MainProcess --> PrintPreview
    
    DBManagement --> DB
    I18nService --> I18nFiles
    PrinterService --> Templates
    PluginSystem --> PluginFiles
    
    MainWin --> MainProcess
    ConfigWin --> MainProcess
    PluginWin --> MainProcess
    PrintPreview --> PrinterService

    %% Styling
    classDef frontend fill:#3498db,stroke:#2980b9,color:white
    classDef backend fill:#2ecc71,stroke:#27ae60,color:white
    classDef data fill:#f1c40f,stroke:#f39c12,color:black
    classDef plugin fill:#9b59b6,stroke:#8e44ad,color:white
    classDef print fill:#e67e22,stroke:#d35400,color:white

    class MainWin,ConfigWin,PluginWin,PrintPreview frontend
    class MainProcess,DBManagement,I18nService,ThemeService backend
    class DB,I18nFiles,Templates data
    class PluginSystem,PluginFiles plugin
    class PrinterService print

    %% Click Events
    click MainWin "https://github.com/BreezeApps/Yapuka/blob/master/window/main/index.html"
    click ConfigWin "https://github.com/BreezeApps/Yapuka/blob/master/window/config/config.html"
    click PluginWin "https://github.com/BreezeApps/Yapuka/blob/master/window/plugin/pluginWindow.html"
    click PrintPreview "https://github.com/BreezeApps/Yapuka/blob/master/printer/printPreview.js"
    click MainProcess "https://github.com/BreezeApps/Yapuka/blob/master/main.js"
    click DBManagement "https://github.com/BreezeApps/Yapuka/blob/master/utils/database.js"
    click PluginSystem "https://github.com/BreezeApps/Yapuka/tree/master/plugins"
    click PrinterService "https://github.com/BreezeApps/Yapuka/blob/master/printer/printPage.js"
    click DB "https://github.com/BreezeApps/Yapuka/tree/master/utils/Yapuka_Data"
    click I18nService "https://github.com/BreezeApps/Yapuka/blob/master/utils/i18n.js"
    click Templates "https://github.com/BreezeApps/Yapuka/tree/master/print_template"
    click ThemeService "https://github.com/BreezeApps/Yapuka/blob/master/utils/theme.js"

    %% Legend
    subgraph Legend
        Frontend["Frontend Component"]:::frontend
        Backend["Backend Service"]:::backend
        Data["Data Storage"]:::data
        Plugin["Plugin Component"]:::plugin
        Print["Print Service"]:::print
    end
```
