# astridaaa/objektinis2 architecture

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

- Interactive diagram: https://gitdiagram.com/astridaaa/objektinis2
- Repository: https://github.com/astridaaa/objektinis2

## Overview

##### Project type and purpose
- This is a C++ command-line benchmarking tool (open-source CLI application) for comparing STL container performance (vector, deque, list) under three “student grouping and sorting” strategies.
- It reads input files containing student records, applies one of three partitioning/sorting strategies, measures execution times, and outputs results, comparing container types and compiler flags.

##### File structure
- Top-level:
- makefile, main.cpp/.h, functions.h
- Strategic implementations under “Strategijos/” (three .cpp files + functions.cpp + strategija.h + makefile)
- Code separation:
- main.cpp: CLI driver, argument parsing, orchestration
- functions.cpp/.h: I/O and utility templates (nuskaitymasFile, sorting functions)
- Strategijos/*.cpp & strategija.h: three strategy implementations (studentuIsskirstymas1/2/3 + rikiavimas)
- Build & run: two makefiles (root and Strategijos/) define targets for each strategy and the combined run_main.

##### README for additional insights
- Describes the four key functions: templated file reader, three grouping strategies, three sorting variants.
- Shows performance tables, compiler flags, and recommended strategy/container combinations.

##### Crucial architectural elements
- Strategy interface (to illustrate plugin-style extensibility)
- Templated file reader decoupled from container type
- Measurement wrapper around every major stage
- Build targets in Makefiles mapping strategies to runX targets

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Data Sources
    InputFiles(("Input Files")):::data
    FileIO["File I/O Module"]:::module
    InputFiles -->|reads| FileIO

    %% CLI Layer
    CLIRunner["CLI Runner"]:::module
    FileIO -->|template reader<br/>vector<Student>| DataModel

    %% Data Model
    DataModel["Data Model<br/>(Student struct + containers)"]:::data

    %% Strategy Interface
    StrategyInterface["Strategy Interface"]:::module
    DataModel --> StrategyInterface

    %% Strategy Modules
    subgraph "Strategy Modules"
        Strategy1["Strategy1"]:::module
        Strategy2["Strategy2"]:::module
        Strategy3["Strategy3"]:::module
    end
    StrategyInterface -->|implements| Strategy1
    StrategyInterface -->|implements| Strategy2
    StrategyInterface -->|implements| Strategy3

    %% Sorting Module
    Sorting["Sorting Module"]:::module
    Strategy1 -->|calls std::partition/<br/>sorting| Sorting
    Strategy2 -->|calls std::partition/<br/>sorting| Sorting
    Strategy3 -->|calls std::partition/<br/>sorting| Sorting

    %% Timer & Output
    Timer["Timer/Measurement Module"]:::module
    Output["Output Module"]:::module
    CLIRunner -->|selects strategy| StrategyInterface
    Sorting -->|operation durations| Timer
    Timer -->|timings + metadata| Output
    CLIRunner -->|parameters/flags| Timer
    CLIRunner -->|parameters/flags| Output

    %% Build System
    subgraph "Build System"
        BuildRoot["Root Makefile"]:::build
        BuildStrat["Strategies Makefile"]:::build
    end

    %% Click Events
    click CLIRunner "https://github.com/astridaaa/objektinis2/blob/v1.1/main.cpp"
    click FileIO "https://github.com/astridaaa/objektinis2/blob/v1.1/functions.h"
    click FileIO "https://github.com/astridaaa/objektinis2/blob/v1.1/Strategijos/functions.cpp"
    click DataModel "https://github.com/astridaaa/objektinis2/blob/v1.1/main.h"
    click StrategyInterface "https://github.com/astridaaa/objektinis2/blob/v1.1/Strategijos/strategija.h"
    click Strategy1 "https://github.com/astridaaa/objektinis2/blob/v1.1/Strategijos/Strategija1.cpp"
    click Strategy2 "https://github.com/astridaaa/objektinis2/blob/v1.1/Strategijos/Strategija2.cpp"
    click Strategy3 "https://github.com/astridaaa/objektinis2/blob/v1.1/Strategijos/Strategija3.cpp"
    click Sorting "https://github.com/astridaaa/objektinis2/blob/v1.1/Strategijos/functions.cpp"
    click Timer "https://github.com/astridaaa/objektinis2/blob/v1.1/main.cpp"
    click BuildRoot "https://github.com/astridaaa/objektinis2/tree/v1.1/makefile"
    click BuildStrat "https://github.com/astridaaa/objektinis2/tree/v1.1/Strategijos/makefile"

    %% Styles
    classDef module fill:#ADD8E6,stroke:#000,stroke-width:1px;
    classDef data fill:#90EE90,stroke:#000,stroke-width:1px;
    classDef build fill:#FFDEAD,stroke:#000,stroke-width:1px;
```
