# karlosbubi/dia architecture

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

- Interactive diagram: https://gitdiagram.com/karlosbubi/dia
- Repository: https://github.com/karlosbubi/dia

## Overview

##### Project Type Analysis
This is a multi-language coding challenge solution repository with implementations in C#, Go, Rust, and C++. The project is organized by year and programming language, with each solution being independent but following a similar pattern.

##### Main Components

A. Core Structure Layer:
- Year-based organization (2015-2024)
- Language-specific implementations
- Shared input files repository

B. Language-Specific Implementation Layer:
- C# Solutions Structure
- Go Solutions Structure
- Rust Solutions Structure
- C++ Solutions Structure

C. Utility Components:
- Input handling system
- Shared utilities (particularly in C#)

**[Top Level Organization]**

- [Years Container]

- [2015-2024 Solutions]

- [Language Implementations]

- [C# Implementation]
- [Go Implementation]
- [Rust Implementation]
- [C++ Implementation]

- [Shared Resources]

- [Input Files]
- [Utilities]

##### Component Relationship Details

- Input file usage (from Inputs directory to each solution)
- Utility dependencies (especially for C# solutions)
- Build system relationships (like justfile connections)

##### Implementation Details

For each language section, show:
**[Language Section]**

- [Build System]
- Solution/Project files
- Package management

- [Source Structure]
- Daily solutions
- Utilities

- [Resources]
- Input files
- Templates

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Project["Advent of Code Solutions"]
        direction TB
        
        subgraph YearOrg["Year-based Organization"]
            Y2015["2015"]:::year
            Y2020["2020"]:::year
            Y2022["2022"]:::year
            Y2023["2023"]:::year
            Y2024["2024"]:::year
        end

        subgraph LangImpl["Language Implementations"]
            direction TB
            
            subgraph CSharp["C# Solutions"]
                direction TB
                CSUtils["Utils"]:::csharp
                CSBuild["Build System"]:::csharp
                CSTemp["Templates"]:::csharp
                CSInput["Input Handler"]:::csharp
            end

            subgraph Go["Go Solutions"]
                direction TB
                GoBuild["Build System"]:::go
                GoTemp["Templates"]:::go
                GoSrc["Source Files"]:::go
            end

            subgraph Rust["Rust Solutions"]
                direction TB
                RustBuild["Build System"]:::rust
                RustTemp["Templates"]:::rust
                RustSrc["Source Files"]:::rust
            end

            subgraph Cpp["C++ Solutions"]
                direction TB
                CppBuild["Build System"]:::cpp
                CppTemp["Templates"]:::cpp
                CppSrc["Source Files"]:::cpp
            end
        end

        subgraph Shared["Shared Resources"]
            direction TB
            Inputs["Input Files"]:::shared
            BuildConfig["Build Configuration"]:::shared
        end
    end

    %% Relationships
    Inputs --> CSharp
    Inputs --> Go
    Inputs --> Rust
    Inputs --> Cpp
    CSUtils --> CSInput
    BuildConfig --> RustBuild
    BuildConfig --> CppBuild
    BuildConfig --> CSBuild
    BuildConfig --> GoBuild

    %% Click Events
    click Y2015 "https://github.com/karlosbubi/dia/tree/master/2015"
    click Y2020 "https://github.com/karlosbubi/dia/tree/master/2020"
    click Y2022 "https://github.com/karlosbubi/dia/tree/master/2022"
    click Y2023 "https://github.com/karlosbubi/dia/tree/master/2023"
    click Y2024 "https://github.com/karlosbubi/dia/tree/master/2024"
    click Inputs "https://github.com/karlosbubi/dia/tree/master/Inputs"
    click CSUtils "https://github.com/karlosbubi/dia/tree/master/2024/C-Sharp/Utils"
    click CSInput "https://github.com/karlosbubi/dia/blob/master/2024/C-Sharp/Utils/LoadInput.cs"
    click CppTemp "https://github.com/karlosbubi/dia/tree/master/2023/Cpp/template"
    click RustBuild "https://github.com/karlosbubi/dia/blob/master/2020/Rust/Cargo.toml"
    click CppBuild "https://github.com/karlosbubi/dia/blob/master/2023/Cpp/day1/CMakeLists.txt"
    click BuildConfig "https://github.com/karlosbubi/dia/tree/master/justfile"

    %% Styling
    classDef year fill:#f0f0f0,stroke:#333
    classDef csharp fill:#68217a,color:white
    classDef go fill:#00add8,color:white
    classDef rust fill:#f74c00,color:white
    classDef cpp fill:#659ad2,color:white
    classDef shared fill:#2ecc71,color:white

    %% Legend
    subgraph Legend
        direction TB
        L1["C# Component"]:::csharp
        L2["Go Component"]:::go
        L3["Rust Component"]:::rust
        L4["C++ Component"]:::cpp
        L5["Shared Resource"]:::shared
        L6["Year Container"]:::year
    end
```
