# biegehydra/easycsv-dotnet architecture

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

- Interactive diagram: https://gitdiagram.com/biegehydra/easycsv-dotnet
- Repository: https://github.com/biegehydra/easycsv-dotnet

## Overview

##### Main Components

a) Core Components:
- EasyCsv.Core (Core functionality)
- EasyCsv.Components (Blazor UI components)
- EasyCsv.Processing (CSV processing strategies)
- EasyCsv.FileExtensions (File handling extensions)

b) Integration Points:
- Browser File Integration
- Stream/String Input/Output
- Object Mapping Interface
- External File Systems

**┌─ Client Layer ─────────────────────────┐**
- Blazor Components                      │
- CsvFileInput                       │
- CsvProcessingStepper               │
- HeaderMatching Components          │
- Processing Layer ────────────────────┤
- Strategy Runner                    │
- Processing Strategies             │
- Operation Progress Context        │
- Core Layer ───────────────────────────┤
- CSV Operations                     │
- CRUD Operations                    │
- Configuration                      │
- Data Access Layer ──────────────────┘
- File System Integration           │
- Stream/String Handling            │

##### Key Relationships to Highlight

a) Data Flow:
- Bidirectional relationships between components and core

b) Component Integration:
- How Blazor components interact with processing strategies
- Factory pattern usage
- Demonstrate mutation scope flow

##### Important Elements

a) Interface Boundaries:
- IEasyCsv
- IEasyCsvOperations
- IEasyMutations

b) Processing Pipeline:
- CSV Parsing
- Mutation Scope
- Strategy Execution
- Result Generation

##### Implementation Details

- The factory pattern for CSV creation
- The mutation scope pattern for operations
- The strategy pattern for processing
- Component composition in Blazor

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client["Client Layer"]
        FileInput["CsvFileInput"]:::ui
        ProcessingStepper["CsvProcessingStepper"]:::ui
        HeaderMatching["HeaderMatching Components"]:::ui
    end

    subgraph Processing["Processing Layer"]
        StrategyRunner["Strategy Runner"]:::processing
        ProcessingStrategies["Processing Strategies"]:::processing
        OperationProgress["Operation Progress Context"]:::processing
    end

    subgraph Core["Core Layer"]
        CsvOps["CSV Operations"]:::core
        CrudOps["CRUD Operations"]:::core
        Config["Configuration"]:::core
        Factory["CSV Factory"]:::core
        MutationScope["Mutation Scope"]:::core
        CsvContext["CSV Context"]:::core
    end

    subgraph DataAccess["Data Access Layer"]
        FileSystem["File System Integration"]:::data
        StreamHandling["Stream/String Handling"]:::data
        FileFactory["File Factory"]:::data
    end

    %% Relationships
    FileInput --> ProcessingStepper
    ProcessingStepper --> StrategyRunner
    HeaderMatching --> ProcessingStrategies

    StrategyRunner --> ProcessingStrategies
    ProcessingStrategies --> OperationProgress
    OperationProgress --> CsvOps

    CsvOps --> CrudOps
    CsvOps --> Config
    Factory --> MutationScope
    MutationScope --> CsvContext

    CrudOps --> FileSystem
    CrudOps --> StreamHandling
    FileSystem --> FileFactory

    %% Click Events
    click FileInput "https://github.com/biegehydra/EasyCsv-Dotnet/blob/master/src/EasyCsv.Components/CsvFileInput.razor"
    click ProcessingStepper "https://github.com/biegehydra/EasyCsv-Dotnet/blob/master/src/EasyCsv.Components/Processing/CsvProcessingStepper.razor"
    click HeaderMatching "https://github.com/biegehydra/EasyCsv-Dotnet/blob/master/src/EasyCsv.Components/HeaderMatching/CsvTableHeaderMatcher.razor"
    click StrategyRunner "https://github.com/biegehydra/EasyCsv-Dotnet/blob/master/src/EasyCsv.Processing/StrategyRunner.cs"
    click ProcessingStrategies "https://github.com/biegehydra/EasyCsv-Dotnet/tree/master/src/EasyCsv.Processing/Strategies/"
    click OperationProgress "https://github.com/biegehydra/EasyCsv-Dotnet/blob/master/src/EasyCsv.Processing/OperationProgressContext.cs"
    click CsvOps "https://github.com/biegehydra/EasyCsv-Dotnet/blob/master/src/EasyCsv.Core/Services/EasyCsvOperations.cs"
    click CrudOps "https://github.com/biegehydra/EasyCsv-Dotnet/blob/master/src/EasyCsv.Core/Services/EasyCsvCrud.cs"
    click Config "https://github.com/biegehydra/EasyCsv-Dotnet/blob/master/src/EasyCsv.Core/Configuration/EasyCsvConfiguration.cs"
    click Factory "https://github.com/biegehydra/EasyCsv-Dotnet/blob/master/src/EasyCsv.Core/Factories/EasyCsvFactory.cs"
    click MutationScope "https://github.com/biegehydra/EasyCsv-Dotnet/blob/master/src/EasyCsv.Core/Types/MutationScope.cs"
    click CsvContext "https://github.com/biegehydra/EasyCsv-Dotnet/blob/master/src/EasyCsv.Core/Configuration/CsvContextProfile.cs"
    click FileFactory "https://github.com/biegehydra/EasyCsv-Dotnet/blob/master/src/EasyCsv.FileExtensions/EasyCsvFileFactory.cs"
    click StreamHandling "https://github.com/biegehydra/EasyCsv-Dotnet/blob/master/src/EasyCsv.Core/Services/EasyCsvReadWrite.cs"

    %% Styles
    classDef ui fill:#FFE873,stroke:#333,stroke-width:2px
    classDef processing fill:#87CEEB,stroke:#333,stroke-width:2px
    classDef core fill:#90EE90,stroke:#333,stroke-width:2px
    classDef data fill:#D3D3D3,stroke:#333,stroke-width:2px

    %% Legend
    subgraph Legend
        UI["UI Components"]:::ui
        Process["Processing Components"]:::processing
        CoreComp["Core Components"]:::core
        DataComp["Data Components"]:::data
    end
```
