# petrk39/sd-exif-editor-v2 architecture

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

- Interactive diagram: https://gitdiagram.com/petrk39/sd-exif-editor-v2
- Repository: https://github.com/petrk39/sd-exif-editor-v2

## Overview

##### Main Components

A. Presentation Layer (UI)
- Main View (MainView.xaml)
- Custom Controls (Controls folder)
- Tabs (Edit, Settings, View)
- Themes System

B. Application Layer (ViewModels)
- Main ViewModel
- Edit ViewModel
- Settings ViewModel
- View ViewModel
- CivitItem ViewModel

C. Services Layer
- Metadata Parser Service
- Civit Service (External API Integration)
- Settings Service
- Message Service
- Args Parser Service

D. Models Layer
- Image Model
- SDMetadata Model
- CivitItem Model

- ┌─────────────────────────────┐
- Presentation Layer      │
- ┤
- Application Layer        │
- ┤
- Services Layer         │
- ┤
- Models Layer          │
- ┘

##### Key Relationships

- MVVM Pattern Implementation:
- Views → ViewModels (via DataBinding)
- ViewModels → Models
- ViewModels → Services

- Service Dependencies:
- MetadataParserService ↔ Image/SDMetadata Models
- CivitService ↔ External API
- SettingsService ↔ Application Configuration

##### Detailed Component Breakdown

**┌─ UI Layer ─────────────────────┐**
- MainView                     │
- Tab Controls                 │
- EditTabControl            │
- ViewTabControl            │
- SettingsTabControl        │
- Custom Controls             │
- ┬───────────────┘
- ↓
**┌─ ViewModels ──────────────────┐**
- MainViewModel               │
- EditViewModel               │
- ViewViewModel               │
- SettingsViewModel          │
- CivitItemViewModel         │
- ┬───────────────┘
- ↓
**┌─ Services ────────────────────┐**
- MetadataParserService      │
- CivitService               │
- SettingsService            │
- MessageService             │
- ArgsParserService          │
- ┬───────────────┘
- ↓
**┌─ Models ──────────────────────┐**
- Image                      │
- SDMetadata                 │
- CivitItem                  │
- ┘

##### Additional Elements

- Input/Output flows for file operations
- Error handling paths
- Configuration management flows
- Theme switching mechanism
- Command-line argument processing flow

##### Implementation Details

- Interface implementations (IMetadataParserService, ICivitService, etc.)
- Async operations (especially for API calls)
- Dependency injection points
- Factory patterns (CivitItemViewModelFactory)

Remember to maintain a balance between detail and clarity, focusing on the architectural decisions that make this application unique, such as its EXIF editing capabilities and Civit.ai integration.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles
    classDef ui fill:#3498db,stroke:#2980b9,color:white
    classDef viewmodel fill:#2ecc71,stroke:#27ae60,color:white
    classDef service fill:#f1c40f,stroke:#f39c12,color:black
    classDef model fill:#e67e22,stroke:#d35400,color:white
    classDef external fill:#95a5a6,stroke:#7f8c8d,color:white

    subgraph UI["Presentation Layer"]
        MainView["Main View"]:::ui
        CustomControls["Custom Controls"]:::ui
        
        subgraph Tabs["Tab Controls"]
            EditTab["Edit Tab"]:::ui
            ViewTab["View Tab"]:::ui
            SettingsTab["Settings Tab"]:::ui
        end
        
        ThemeSystem["Themes System"]:::ui
    end

    subgraph ViewModels["Application Layer"]
        MainVM["Main ViewModel"]:::viewmodel
        EditVM["Edit ViewModel"]:::viewmodel
        ViewVM["View ViewModel"]:::viewmodel
        SettingsVM["Settings ViewModel"]:::viewmodel
        CivitItemVM["CivitItem ViewModel"]:::viewmodel
        CivitFactory["CivitItem Factory"]:::viewmodel
    end

    subgraph Services["Services Layer"]
        MetadataService["Metadata Parser Service"]:::service
        CivitService["Civit Service"]:::service
        SettingsService["Settings Service"]:::service
        MessageService["Message Service"]:::service
        ArgsService["Args Parser Service"]:::service
    end

    subgraph Models["Models Layer"]
        ImageModel["Image Model"]:::model
        SDMetadataModel["SDMetadata Model"]:::model
        CivitItemModel["CivitItem Model"]:::model
    end

    ExternalAPI["Civit.ai API"]:::external

    %% Relationships
    MainView --> MainVM
    EditTab --> EditVM
    ViewTab --> ViewVM
    SettingsTab --> SettingsVM

    MainVM --> MessageService
    MainVM --> ArgsService
    
    EditVM --> MetadataService
    EditVM --> MessageService
    
    ViewVM --> MetadataService
    ViewVM --> CivitService
    
    SettingsVM --> SettingsService
    SettingsVM --> ThemeSystem
    
    CivitFactory --> CivitItemVM
    CivitItemVM --> CivitItemModel
    
    MetadataService --> ImageModel
    MetadataService --> SDMetadataModel
    
    CivitService --> ExternalAPI
    CivitService --> CivitItemModel

    %% Click Events
    click MainView "https://github.com/PetrK39/SD-EXIF-Editor-v2/blob/master/SD EXIF Editor v2/Views/MainView.xaml"
    click CustomControls "https://github.com/PetrK39/SD-EXIF-Editor-v2/tree/master/SD EXIF Editor v2/Controls/"
    click EditTab "https://github.com/PetrK39/SD-EXIF-Editor-v2/blob/master/SD EXIF Editor v2/Controls/Tabs/EditTabControl.xaml"
    click ViewTab "https://github.com/PetrK39/SD-EXIF-Editor-v2/blob/master/SD EXIF Editor v2/Controls/Tabs/ViewTabControl.xaml"
    click SettingsTab "https://github.com/PetrK39/SD-EXIF-Editor-v2/blob/master/SD EXIF Editor v2/Controls/Tabs/SettingsTabControl.xaml"
    click ThemeSystem "https://github.com/PetrK39/SD-EXIF-Editor-v2/blob/master/SD EXIF Editor v2/Themes/ThemesController.cs"
    
    click MainVM "https://github.com/PetrK39/SD-EXIF-Editor-v2/blob/master/SD EXIF Editor v2/ViewModels/MainViewModel.cs"
    click EditVM "https://github.com/PetrK39/SD-EXIF-Editor-v2/blob/master/SD EXIF Editor v2/ViewModels/EditViewModel.cs"
    click ViewVM "https://github.com/PetrK39/SD-EXIF-Editor-v2/blob/master/SD EXIF Editor v2/ViewModels/ViewViewModel.cs"
    click SettingsVM "https://github.com/PetrK39/SD-EXIF-Editor-v2/blob/master/SD EXIF Editor v2/ViewModels/SettingsViewModel.cs"
    click CivitItemVM "https://github.com/PetrK39/SD-EXIF-Editor-v2/blob/master/SD EXIF Editor v2/ViewModels/CivitItemViewModel.cs"
    click CivitFactory "https://github.com/PetrK39/SD-EXIF-Editor-v2/blob/master/SD EXIF Editor v2/Factories/CivitItemViewModelFactory.cs"
    
    click MetadataService "https://github.com/PetrK39/SD-EXIF-Editor-v2/blob/master/SD EXIF Editor v2/Services/MetadataParserService.cs"
    click CivitService "https://github.com/PetrK39/SD-EXIF-Editor-v2/blob/master/SD EXIF Editor v2/Services/CivitService.cs"
    click SettingsService "https://github.com/PetrK39/SD-EXIF-Editor-v2/blob/master/SD EXIF Editor v2/Services/SettingsService.cs"
    click MessageService "https://github.com/PetrK39/SD-EXIF-Editor-v2/blob/master/SD EXIF Editor v2/Services/MessageService.cs"
    click ArgsService "https://github.com/PetrK39/SD-EXIF-Editor-v2/blob/master/SD EXIF Editor v2/Services/ArgsParserService.cs"
    
    click ImageModel "https://github.com/PetrK39/SD-EXIF-Editor-v2/blob/master/SD EXIF Editor v2/Models/Image.cs"
    click SDMetadataModel "https://github.com/PetrK39/SD-EXIF-Editor-v2/blob/master/SD EXIF Editor v2/Models/SDMetadata.cs"
    click CivitItemModel "https://github.com/PetrK39/SD-EXIF-Editor-v2/blob/master/SD EXIF Editor v2/Models/CivitItem.cs"
```
