# frozsgy/ceng334-hw architecture

> Architecture diagram of the GitHub repository frozsgy/ceng334-hw, 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/ceng334-hw
- Repository: https://github.com/frozsgy/ceng334-hw

## Overview

##### Project Type and Purpose
- This is an academic “monorepo” for an Operating Systems course (CENG334), containing three independent homework assignments.
- Each assignment is a small C/C++ system demonstrating OS concepts:
- Homework 1: An auction server/client implementation using IPC.
- Homework 2: A multithreaded elevator controller using monitors.
- Homework 3 (not yet in file tree): A simple shell over an ext2 image.

##### File‐Structure Analysis
- Top level: “Homework 1”, “Homework 2”, plus LICENSE and README.md.
- Each homework folder has:
- PDF problem statement
- “submission” subfolder with C/C++ source, headers, a makefile
- (HW1) logging, messaging, bidder/server modules
- (HW2) controller, elevator, person, monitor modules

##### README Insights
- Confirms each homework’s OS concept: IPC for HW1, threads+monitors for HW2, ext2 shell for HW3.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Monorepo: CENG334"
        direction TB

        subgraph "Homework 1: IPC Auction System"
            direction TB
            AS["AuctionServer"]:::process
            BD["Bidder"]:::process
            LOG["Logging Module"]:::module
            MSG["Message Definitions"]:::module
            UTIL["Utility & Shared Methods"]:::module

            AS -->|"<-- IPC Message Queue -->"| BD
            AS -->|"logs to"| LOG
            BD -->|"logs to"| LOG
            AS -->|"uses"| MSG
            BD -->|"uses"| MSG
            AS -->|"imports"| UTIL
            BD -->|"imports"| UTIL
        end

        subgraph "Homework 2: Multithreaded Elevator System"
            direction TB
            PROC["Process"]:::processContainer
            subgraph PROC
                direction TB
                CTRL["Controller Thread"]:::thread
                ELV["Elevator Thread"]:::thread
                PER["Person Threads"]:::thread
                MON["Monitor (Sync)"]:::module

                CTRL -->|"issues commands"| ELV
                CTRL -->|"requests lock"| MON
                ELV -->|"requests lock"| MON
                PER -->|"requests service via"| MON
            end
        end
    end

    %% Click Events for Homework 1
    click AS "https://github.com/frozsgy/ceng334-hw/blob/main/Homework 1/submission/server.cpp"
    click BD "https://github.com/frozsgy/ceng334-hw/blob/main/Homework 1/submission/bidder.cpp"
    click LOG "https://github.com/frozsgy/ceng334-hw/blob/main/Homework 1/submission/logging.c"
    click LOG "https://github.com/frozsgy/ceng334-hw/blob/main/Homework 1/submission/logging.h"
    click MSG "https://github.com/frozsgy/ceng334-hw/blob/main/Homework 1/submission/message.h"
    click UTIL "https://github.com/frozsgy/ceng334-hw/blob/main/Homework 1/submission/methods.cpp"
    click UTIL "https://github.com/frozsgy/ceng334-hw/blob/main/Homework 1/submission/methods.hpp"
    click UTIL "https://github.com/frozsgy/ceng334-hw/blob/main/Homework 1/submission/utils.cpp"
    click UTIL "https://github.com/frozsgy/ceng334-hw/blob/main/Homework 1/submission/utils.hpp"

    %% Click Events for Homework 2
    click CTRL "https://github.com/frozsgy/ceng334-hw/blob/main/Homework 2/submission/controller.cpp"
    click CTRL "https://github.com/frozsgy/ceng334-hw/blob/main/Homework 2/submission/controller.hpp"
    click ELV "https://github.com/frozsgy/ceng334-hw/blob/main/Homework 2/submission/elevator.cpp"
    click ELV "https://github.com/frozsgy/ceng334-hw/blob/main/Homework 2/submission/elevator.hpp"
    click PER "https://github.com/frozsgy/ceng334-hw/blob/main/Homework 2/submission/person.cpp"
    click PER "https://github.com/frozsgy/ceng334-hw/blob/main/Homework 2/submission/person.hpp"
    click MON "https://github.com/frozsgy/ceng334-hw/blob/main/Homework 2/submission/monitor.h"
    click PROC "https://github.com/frozsgy/ceng334-hw/blob/main/Homework 2/submission/main.cpp"

    classDef process fill:#f9f,stroke:#333,stroke-width:1px
    classDef module fill:#ff9,stroke:#333,stroke-width:1px
    classDef thread fill:#9f9,stroke:#333,stroke-width:1px
    classDef processContainer fill:#9ff,stroke:#333,stroke-width:1px
```
