# skleni/genesis architecture

> Architecture diagram of the GitHub repository skleni/genesis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-31). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/skleni/genesis
- Repository: https://github.com/skleni/genesis

## Overview

##### Main Components Identification
The system can be broken down into these major components:

a) Core Components:
- Genesis Core (base library)
- Generation Engine
- Processing Pipeline
- UI Layer

b) Supporting Components:
- Data Handlers
- Algorithms
- Previews
- Processors

##### Component Relationships

a) Data Flow:
- UI → MapGenerator → Processors → Core
- Preview Generator ← MapGenerator (for real-time updates)
- Settings → MapGenerator (for configuration)

b) Dependencies:
- How processors depend on core components
- Data structure usage across layers
- Template usage in CWC processor

##### Technical Details

Specific technical implementations:
- MVVM pattern in UI layer
- A* pathfinding algorithm usage
- Perlin noise for terrain generation
- Resource generation system

a) Generation:
- Terrain processing
- Object placement
- Road network generation
- Resource distribution

b) Data Management:
- Data structures
- Script handling
- Template management

c) Preview System:
- Real-time preview generation
- UI update mechanism

##### Important Notes

Emphasize:
- Modular architecture allowing for easy extension
- Clear separation between game-specific (CWC) and generic components
- Pipeline-based processing system
- Template-driven generation system

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles and classes
    classDef ui fill:#FFA500,stroke:#000
    classDef core fill:#4169E1,stroke:#000
    classDef processor fill:#90EE90,stroke:#000
    classDef data fill:#9370DB,stroke:#000
    classDef template fill:#808080,stroke:#000
    classDef preview fill:#20B2AA,stroke:#000

    %% Legend
    subgraph Legend
        UI[UI Components]:::ui
        CORE[Core Components]:::core
        PROC[Processors]:::processor
        DATA[Data Handlers]:::data
        TEMP[Templates]:::template
        PREV[Preview System]:::preview
    end

    %% UI Layer
    subgraph UI_Layer
        MainWindow["Main Window"]:::ui
        ViewModel["ViewModels"]:::ui
        PreviewUI["Preview Interface"]:::ui
    end

    %% Core Layer
    subgraph Core_Layer
        GenCore["Genesis Core"]:::core
        MathUtils["Math Utilities"]:::core
        RoadSystem["Road System"]:::core
        Settings["Settings Manager"]:::core
        Algorithms["Algorithms"]:::core
    end

    %% Processing Layer
    subgraph Processing_Layer
        MapGen["Map Generator"]:::processor
        TerrainGen["Terrain Generator"]:::processor
        RoadGen["Road Generator"]:::processor
        ObjGen["Object Generator"]:::processor
        ResourceGen["Resource Generator"]:::processor
    end

    %% Data Layer
    subgraph Data_Layer
        MapData["Map Structures"]:::data
        ObjDefs["Object Definitions"]:::data
        Scripts["Script System"]:::data
    end

    %% Template System
    subgraph Template_System
        VillageTemp["Village Templates"]:::template
        FlagTemp["Flag Templates"]:::template
        FuelTemp["Fuel Depot Templates"]:::template
    end

    %% Preview System
    PreviewGen["Preview Generator"]:::preview

    %% Relationships
    MainWindow --> ViewModel
    ViewModel --> MapGen
    MapGen --> PreviewGen
    PreviewGen --> PreviewUI
    MapGen --> TerrainGen
    MapGen --> RoadGen
    MapGen --> ObjGen
    MapGen --> ResourceGen
    
    TerrainGen --> GenCore
    RoadGen --> RoadSystem
    ObjGen --> MapData
    ResourceGen --> Scripts

    GenCore --> MathUtils
    RoadSystem --> Algorithms
    
    TerrainGen --> MapData
    RoadGen --> MapData
    ObjGen --> ObjDefs
    
    ResourceGen --> VillageTemp
    ResourceGen --> FlagTemp
    ResourceGen --> FuelTemp

    %% Click events
    click GenCore "https://github.com/Skleni/genesis/tree/master/Genesis/Core"
    click MathUtils "https://github.com/Skleni/genesis/tree/master/Genesis/Math"
    click RoadSystem "https://github.com/Skleni/genesis/tree/master/Genesis/Roads"
    click Settings "https://github.com/Skleni/genesis/tree/master/Genesis/Settings"
    click MapGen "https://github.com/Skleni/genesis/blob/master/Genesis.MapGenerator/MapGenerator.cs"
    click PreviewGen "https://github.com/Skleni/genesis/blob/master/Genesis.Previews/PreviewGenerator.cs"
    click TerrainGen "https://github.com/Skleni/genesis/blob/master/Genesis.Processors/TerrainGenerator.cs"
    click RoadGen "https://github.com/Skleni/genesis/blob/master/Genesis.Processors/RoadGenerator.cs"
    click ObjGen "https://github.com/Skleni/genesis/blob/master/Genesis.Processors/StartingPositionGenerator.cs"
    click MainWindow "https://github.com/Skleni/genesis/blob/master/Genesis.UI/MainWindow.xaml"
    click PreviewUI "https://github.com/Skleni/genesis/blob/master/Genesis.UI/Preview.xaml"
    click ViewModel "https://github.com/Skleni/genesis/tree/master/Genesis.UI/ViewModel"
    click MapData "https://github.com/Skleni/genesis/tree/master/CkMp.Data/Map"
    click ObjDefs "https://github.com/Skleni/genesis/tree/master/CkMp.Data/Objects"
    click Scripts "https://github.com/Skleni/genesis/tree/master/CkMp.Data/Scripts"
    click Algorithms "https://github.com/Skleni/genesis/blob/master/Genesis.Algorithms"
    click ResourceGen "https://github.com/Skleni/genesis/blob/master/Genesis.Processors.CWC/ResourceGenerator.cs"
    click VillageTemp "https://github.com/Skleni/genesis/tree/master/Genesis.Processors.CWC/Templates/Village"
    click FlagTemp "https://github.com/Skleni/genesis/tree/master/Genesis.Processors.CWC/Templates/LargeFlag"
    click FuelTemp "https://github.com/Skleni/genesis/tree/master/Genesis.Processors.CWC/Templates/LargeFuelDepot"
```
