# frozsgy/metu architecture

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

- Interactive diagram: https://gitdiagram.com/frozsgy/metu
- Repository: https://github.com/frozsgy/metu

## Overview

##### Project type and purpose
- This is a monolithic “knowledge‐base” or “portfolio” repository rather than a deployable application. It collects every homework, lab, exam, and assignment from multiple courses (CENG111, CENG140, … , CENG499) in METU’s Computer Engineering Programme.
- Purpose: archival, demonstration of coding evolution, and reference. There is no cross‐module code execution or a unified run/build process.

##### File structure
- Top-level: a flat set of directories named by course code (CENG111, CENG140, …).
- Under each course: subdirectories per assignment or lab (e.g., THE1, THE2, lab1, HW1, Project 1, etc). Files are PDFs, source code (C, C++, Python, Java, assembly, Haskell, Verilog), testers, sample I/O.
- No monolithic build scripts, no single CI/CD pipeline; each subfolder often has its own test harness or README.
- A root README.md and LICENSE.

##### README for additional insights
- Explains purpose: collection of homeworks across courses.
- Highlights that some subrepos (CENG334, CENG336, CENG435, CENG477, CENG453) live elsewhere for “good examples.”

##### Elements
- Clear labels: “CENG111,” “CENG140,” … , “CENG499,” “README.md,” “LICENSE.”

##### Detailed capture of essential elements
- Avoid overcomplicating: the core architecture is a directory/module hierarchy with no runtime integration.
- The goal is to show clearly how the repository is organized and how a reader navigates from the top‐level to each assignment.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Root
    README["README.md"]:::root
    LICENSE["LICENSE"]:::root

    %% Course Modules
    subgraph "CENG111" 
        C111_THE2["THE2"]:::assignment
        subgraph "THE2"
            C111_THE2_CODE["the2.py"]:::code
            C111_THE2_TESTS["official_tests.zip"]:::tests
            C111_THE2_DOC["the2_description.pdf"]:::doc
        end
    end
    subgraph "CENG140"
        C140_THE1["THE1"]:::assignment
        subgraph "THE1"
            C140_THE1_CODE1["the1_iterative.c"]:::code
            C140_THE1_CODE2["the1_recursive.c"]:::code
            C140_THE1_CODE3["the1_part2.c"]:::code
            C140_THE1_GRADER["grader.zip"]:::tests
            subgraph "Tester"
                C140_THE1_TESTER_SCRIPT["tester.py"]:::code
                C140_THE1_TESTS["tests/"]:::tests
            end
        end
    end
    subgraph "CENG350"
        subgraph "SDD-UML-Diagrams"
            C350_SDD_COMP["Group62-Component-Diagram.mdj"]:::doc
        end
        subgraph "SRS-UML-Diagrams"
            C350_SRS_USE["Group62-Use-Case-Diagram.mdj"]:::doc
        end
    end
    subgraph "CENG334" 
        C334_README["README.md"]:::external
        subgraph "Homework 1"
            C334_HW1_SUB["submission/"]:::code
        end
    end
    subgraph "CENG336"
        C336_README["README.md"]:::external
    end
    subgraph "CENG435"
        C435_README["README.md"]:::external
    end
    subgraph "CENG477"
        C477_README["README.md"]:::external
    end
    subgraph "CENG453"
        C453_README["README.md"]:::external
    end

    %% Root to courses
    README -->|"navigates to"| CENG111["CENG111"] 
    README -->|"navigates to"| CENG140["CENG140"]
    README -->|"navigates to"| CENG350["CENG350"]
    README -->|"navigates to"| CENG334["CENG334"]
    README -->|"navigates to"| CENG336["CENG336"]
    README -->|"navigates to"| CENG435["CENG435"]
    README -->|"navigates to"| CENG477["CENG477"]
    README -->|"navigates to"| CENG453["CENG453"]

    %% Click Events
    click README "https://github.com/frozsgy/metu/blob/master/./README.md"
    click LICENSE "https://github.com/frozsgy/metu/tree/master/./LICENSE"
    click CENG111 "https://github.com/frozsgy/metu/tree/master/CENG111/"
    click C111_THE2_CODE "https://github.com/frozsgy/metu/blob/master/CENG111/THE2/the2.py"
    click C111_THE2_TESTS "https://github.com/frozsgy/metu/blob/master/CENG111/THE2/official_tests.zip"
    click C111_THE2_DOC "https://github.com/frozsgy/metu/blob/master/CENG111/THE2/the2_description.pdf"
    click CENG140 "https://github.com/frozsgy/metu/tree/master/CENG140/"
    click C140_THE1_CODE1 "https://github.com/frozsgy/metu/blob/master/CENG140/THE1/the1_iterative.c"
    click C140_THE1_CODE2 "https://github.com/frozsgy/metu/blob/master/CENG140/THE1/the1_recursive.c"
    click C140_THE1_CODE3 "https://github.com/frozsgy/metu/blob/master/CENG140/THE1/the1_part2.c"
    click C140_THE1_GRADER "https://github.com/frozsgy/metu/blob/master/CENG140/THE1/grader.zip"
    click C140_THE1_TESTER_SCRIPT "https://github.com/frozsgy/metu/blob/master/CENG140/THE1/Tester/tester.py"
    click C140_THE1_TESTS "https://github.com/frozsgy/metu/tree/master/CENG140/THE1/Tester/tests/"
    click CENG350 "https://github.com/frozsgy/metu/tree/master/CENG350/"
    click C350_SDD_COMP "https://github.com/frozsgy/metu/blob/master/CENG350/SDD-UML-Diagrams/Group62-Component-Diagram.mdj"
    click C350_SRS_USE "https://github.com/frozsgy/metu/blob/master/CENG350/SRS-UML-Diagrams/Group62-Use-Case-Diagram.mdj"
    click CENG334 "https://github.com/frozsgy/metu/tree/master/CENG334/"
    click C334_README "https://github.com/frozsgy/metu/blob/master/CENG334/README.md"
    click C334_HW1_SUB "https://github.com/frozsgy/metu/tree/master/CENG334/Homework 1/submission/"
    click CENG336 "https://github.com/frozsgy/metu/tree/master/CENG336/"
    click C336_README "https://github.com/frozsgy/metu/blob/master/CENG336/README.md"
    click CENG435 "https://github.com/frozsgy/metu/tree/master/CENG435/"
    click C435_README "https://github.com/frozsgy/metu/blob/master/CENG435/README.md"
    click CENG477 "https://github.com/frozsgy/metu/tree/master/CENG477/"
    click C477_README "https://github.com/frozsgy/metu/blob/master/CENG477/README.md"
    click CENG453 "https://github.com/frozsgy/metu/tree/master/CENG453/"
    click C453_README "https://github.com/frozsgy/metu/blob/master/CENG453/README.md"

    %% Styles
    classDef root fill:#f9f,stroke:#333,stroke-width:2px;
    classDef course fill:#bbf,stroke:#333,stroke-width:1px;
    classDef assignment fill:#ddf,stroke:#333,stroke-width:1px;
    classDef code fill:#afa,stroke:#2f2,stroke-width:1px;
    classDef doc fill:#fbb,stroke:#d22,stroke-width:1px;
    classDef tests fill:#ffc,stroke:#aa0,stroke-width:1px,stroke-dasharray: 5 5;
    classDef external fill:#ffe,stroke:#f66,stroke-width:2px,stroke-dasharray: 5 5;
    class CENG111,CENG140,CENG350,CENG334,CENG336,CENG435,CENG477,CENG453 course
```
