# dov4k1n/seminars-evm architecture

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

- Interactive diagram: https://gitdiagram.com/dov4k1n/seminars-evm
- Repository: https://github.com/dov4k1n/seminars-evm

## Overview

##### Main components
- Academic/Project Groups – treat each top-level folder (e.g., “1-semester”, “2-semester”, “3-semester”, “4-semester”, “caos”, “tba”) as a major subsystem.
- Within each semester folder, there are many projects grouped by topics (for example, in “1-semester” you see projects like “01-hello-world-and-calculator”, “02-conditionals-and-cycles”, etc.). Consider representing each project as a node within its semester group.
- Auxiliary components – elements such as build configurations (Makefiles, CMake files) or tool integrations (like the use of external libraries in some projects such as nlohmann/json) can be noted within the appropriate group.

##### Out Relationships and Interactions
- Since most of these projects appear to be self-contained and are not part of a single running application, the “data flow” is minimal at a system runtime level. Instead, view this as a portfolio or learning repository.
- A container (or repository) at the highest level that holds multiple independent subsystems (themselves each a collection of standalone C/C++ projects or experiments).

##### Architectural Patterns and Design Principles
- Projects with a specific design (such as the “1-theater_cpp” in the “tba” folder) would benefit from showing class dependencies, if necessary.

## Diagram (Mermaid)

```mermaid
flowchart TD
    Root["Seminars and Experimental Projects Repository"]:::repo

    subgraph "1-semester"
        s1_dir("1-semester"):::folder
        a1("01-hello-world-and-calculator"):::project
        a2("02-conditionals-and-cycles"):::project
    end

    subgraph "2-semester"
        s2_dir("2-semester"):::folder
        b1("01-makefile"):::project
        b2("02-newtons-method"):::project
        b3("03-simpsons-rule"):::project
        b1_m("Makefile"):::build
    end

    subgraph "3-semester"
        s3_dir("3-semester"):::folder
        c1("01-calculator"):::project
        c2("04-classes"):::project
        c3("05-linked-lists"):::project
        c4("06-trees"):::project
    end

    subgraph "4-semester"
        s4_dir("4-semester"):::folder
        subgraph "2024 Projects"
            d1("00-client-server-task"):::project
            d1_cmake("CMakeLists.txt"):::build
            d1_ci(".ci"):::ci
            d1_github(".github"):::ci
            d1_httplib("FindHttplib.cmake"):::build
            d1_json("FindNlohmannJson.cmake"):::build
        end
        subgraph "Meta-Programming"
            d2("02-meta-programming"):::project
        end
    end

    subgraph "caos"
        caos_dir("caos"):::folder
        e1("command-line"):::project
        e2("sum.S"):::assembly
    end

    subgraph "tba"
        tba_dir("tba"):::folder
        f1("0-css-test"):::web
        f2("0-js-test"):::web
        f3("1-theater_cpp"):::project
        f4("2-operator_overload"):::project
        f5("3-inheritance"):::project
        f6("4-virtual_funs"):::project
        f7("5-templates"):::project
        f8("contest"):::project
        f3_cmake("CMakeLists.txt"):::build
    end

    %% Repository Structure
    Root -->|"contains"| s1_dir
    Root -->|"contains"| s2_dir
    Root -->|"contains"| s3_dir
    Root -->|"contains"| s4_dir
    Root -->|"contains"| caos_dir
    Root -->|"contains"| tba_dir

    %% 1-semester connections
    s1_dir -->|"project"| a1
    s1_dir -->|"project"| a2

    %% 2-semester connections
    s2_dir -->|"project"| b1
    s2_dir -->|"project"| b2
    s2_dir -->|"project"| b3
    b1 -->|"build"| b1_m

    %% 3-semester connections
    s3_dir -->|"project"| c1
    s3_dir -->|"project"| c2
    s3_dir -->|"project"| c3
    s3_dir -->|"project"| c4

    %% 4-semester connections (2024 Projects and Meta-Programming)
    s4_dir -->|"project"| d1
    s4_dir -->|"project"| d2
    d1 -->|"build"| d1_cmake
    d1 -->|"CI/CD"| d1_ci
    d1 -->|"CI/CD"| d1_github
    d1 -->|"dep"| d1_httplib
    d1 -->|"dep"| d1_json
    d1_cmake -->|"triggers"| d1_ci
    d1_cmake -->|"triggers"| d1_github

    %% caos connections
    caos_dir -->|"project"| e1
    caos_dir -->|"assembly"| e2

    %% tba connections
    tba_dir -->|"project"| f1
    tba_dir -->|"project"| f2
    tba_dir -->|"project"| f3
    tba_dir -->|"project"| f4
    tba_dir -->|"project"| f5
    tba_dir -->|"project"| f6
    tba_dir -->|"project"| f7
    tba_dir -->|"project"| f8
    f3 -->|"build"| f3_cmake

    %% Click Events
    click s1_dir "https://github.com/dov4k1n/seminars-evm/tree/main/1-semester"
    click a1 "https://github.com/dov4k1n/seminars-evm/tree/main/1-semester/01-hello-world-and-calculator"
    click a2 "https://github.com/dov4k1n/seminars-evm/tree/main/1-semester/02-conditionals-and-cycles"

    click s2_dir "https://github.com/dov4k1n/seminars-evm/tree/main/2-semester"
    click b1 "https://github.com/dov4k1n/seminars-evm/tree/main/2-semester/01-makefile"
    click b1_m "https://github.com/dov4k1n/seminars-evm/tree/main/2-semester/01-makefile/Makefile"
    click b2 "https://github.com/dov4k1n/seminars-evm/tree/main/2-semester/02-newtons-method"
    click b3 "https://github.com/dov4k1n/seminars-evm/tree/main/2-semester/03-simpsons-rule"

    click s3_dir "https://github.com/dov4k1n/seminars-evm/tree/main/3-semester"
    click c1 "https://github.com/dov4k1n/seminars-evm/tree/main/3-semester/01-calculator"
    click c2 "https://github.com/dov4k1n/seminars-evm/tree/main/3-semester/04-classes"
    click c3 "https://github.com/dov4k1n/seminars-evm/tree/main/3-semester/05-linked-lists"
    click c4 "https://github.com/dov4k1n/seminars-evm/tree/main/3-semester/06-trees"

    click s4_dir "https://github.com/dov4k1n/seminars-evm/tree/main/4-semester"
    click d1 "https://github.com/dov4k1n/seminars-evm/tree/main/4-semester/2024/00-client-server-task"
    click d1_cmake "https://github.com/dov4k1n/seminars-evm/blob/main/4-semester/2024/00-client-server-task/CMakeLists.txt"
    click d1_ci "https://github.com/dov4k1n/seminars-evm/blob/main/4-semester/2024/00-client-server-task/.ci"
    click d1_github "https://github.com/dov4k1n/seminars-evm/blob/main/4-semester/2024/00-client-server-task/.github"
    click d1_httplib "https://github.com/dov4k1n/seminars-evm/blob/main/4-semester/2024/00-client-server-task/FindHttplib.cmake"
    click d1_json "https://github.com/dov4k1n/seminars-evm/blob/main/4-semester/2024/00-client-server-task/FindNlohmannJson.cmake"
    click d2 "https://github.com/dov4k1n/seminars-evm/tree/main/4-semester/02-meta-programming"

    click caos_dir "https://github.com/dov4k1n/seminars-evm/tree/main/caos"
    click e1 "https://github.com/dov4k1n/seminars-evm/tree/main/caos/command-line"
    click e2 "https://github.com/dov4k1n/seminars-evm/blob/main/caos/sum.S"

    click tba_dir "https://github.com/dov4k1n/seminars-evm/tree/main/tba"
    click f1 "https://github.com/dov4k1n/seminars-evm/tree/main/tba/0-css-test"
    click f2 "https://github.com/dov4k1n/seminars-evm/tree/main/tba/0-js-test"
    click f3 "https://github.com/dov4k1n/seminars-evm/tree/main/tba/1-theater_cpp"
    click f3_cmake "https://github.com/dov4k1n/seminars-evm/blob/main/tba/1-theater_cpp/CMakeLists.txt"
    click f4 "https://github.com/dov4k1n/seminars-evm/tree/main/tba/2-operator_overload"
    click f5 "https://github.com/dov4k1n/seminars-evm/tree/main/tba/3-inheritance"
    click f6 "https://github.com/dov4k1n/seminars-evm/tree/main/tba/4-virtual_funs"
    click f7 "https://github.com/dov4k1n/seminars-evm/tree/main/tba/5-templates"
    click f8 "https://github.com/dov4k1n/seminars-evm/tree/main/tba/contest"

    %% Styles
    classDef repo fill:#f9f,stroke:#333,stroke-width:2px;
    classDef folder fill:#ccf,stroke:#333,stroke-width:2px;
    classDef project fill:#cfc,stroke:#333,stroke-width:2px;
    classDef build fill:#fcf,stroke:#333,stroke-width:2px;
    classDef ci fill:#cff,stroke:#333,stroke-width:2px;
    classDef assembly fill:#ff9,stroke:#333,stroke-width:2px;
    classDef web fill:#9cf,stroke:#333,stroke-width:2px;
```
