# iyy0v/usthb-projects architecture

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

- Interactive diagram: https://gitdiagram.com/iyy0v/usthb-projects
- Repository: https://github.com/iyy0v/usthb-projects

## Overview

##### Project type and purpose
- At the highest level, this repo is a “portfolio” monorepo of independent university projects spanning multiple years (L1, L2, L3, M1, M2).
- It is *not* one single runtime system but rather a categorized collection of small standalone systems: algorithm exercises (C), object-oriented Java apps, web mini-sites (HTML/PHP/JS), SQL scripts, compilers (Flex/Bison/C), OS/assembly experiments, a multi-tier distributed application, etc.

##### File structure
- Top-level folders:
- L1, L2, L3, M1, M2 (year-level groupings).
- README.md (overview).
- Under each year you find one or more *projects*, each in its own subfolder (e.g., L2/A3marDarek, M1/PCL_Compiler, M2/DistributedApp, M3/TabGen).
- Each project folder contains exactly the source, binaries, scripts and documentation needed for that standalone assignment.
- There are no cross-module dependencies—each project compiles/runs independently.

##### README for additional insights
- The README enumerates each project, its abbreviation, its tech stack, and the learning goal.
- Technology summary by year:
- L1/L2: C algorithmics + Assembly + Java console apps
- L3: Python/NLP, mini-compiler, PHP web, shell-clones
- M1: Web (HTML/CSS/JS/XML), sorting benchmarks (C), OS scripts, SQL (Oracle), JUnit tests, compiler with Flex/Bison
- M2: Distributed N-tier (EJB3, sockets, RMI, MySQL), Data Warehousing (SQL), Java design patterns

##### Diagramming conventions
- Use **clear labels** on every node (“L1 – Algo Scripts”, “M2 – DistributedApp: EJB Server”).
- Rectangles for folders/modules

##### Detail without overthinking
- *Level 2* (optional deeper dive): pick 1–2 key projects (e.g., PCL_Compiler, DistributedApp) and expand their internal architecture
- *all* essential components (source code, build scripts, docs, binaries) at whichever level you present

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Portfolio Root
    Root["USTHB Projects"]:::root
    click Root "https://github.com/iyy0v/usthb-projects/blob/main/README.md"

    %% Year Clusters
    subgraph "L1" 
        direction TB
        L1_Algo["L1 – Algo Scripts (C)"]:::project
        L1_Math["L1 – Mathematical Programming Reports"]:::project
    end
    click L1_Algo "https://github.com/iyy0v/usthb-projects/tree/main/L1/Algo Scripts"
    click L1_Math "https://github.com/iyy0v/usthb-projects/tree/main/L1/MathProg"

    subgraph "L2"
        direction TB
        L2_POJ["L2 – POO Application (A3marDarek)"]:::project
        L2_Exp["L2 – Expression Evaluator (C)"]:::project
        L2_PGCD["L2 – PGCD Assembly Experiments"]:::project
    end
    click L2_POJ "https://github.com/iyy0v/usthb-projects/tree/main/L2/A3marDarek"
    click L2_Exp "https://github.com/iyy0v/usthb-projects/tree/main/L2/ExpEval"
    click L2_PGCD "https://github.com/iyy0v/usthb-projects/tree/main/L2/PGCD x86"

    subgraph "L3"
        direction TB
        L3_Tab["L3 – Web Mini-Site TabGen"]:::project
    end
    click L3_Tab "https://github.com/iyy0v/usthb-projects/tree/main/L3/TabGen"

    subgraph "M1"
        direction TB
        M1_JUnit["M1 – JUnit Test Suites"]:::project
        M1_LS["M1 – LiveScore Web App"]:::project
        M1_PCL["M1 – PCL_Compiler (Flex/Bison/C)"]:::project
        M1_SYS["M1 – System Scripts (C)"]:::project
        M1_SQL["M1 – SQL Scripts & Reports"]:::project
        M1_Sort["M1 – Sorting Benchmark Tool"]:::project
        M1_PP["M1 – Project Planning Files"]:::project
    end
    click M1_JUnit "https://github.com/iyy0v/usthb-projects/tree/main/M1/JUnit"
    click M1_LS "https://github.com/iyy0v/usthb-projects/tree/main/M1/LiveScore"
    click M1_PCL "https://github.com/iyy0v/usthb-projects/tree/main/M1/PCL_Compiler"
    click M1_SYS "https://github.com/iyy0v/usthb-projects/tree/main/M1/SYS Scripts"
    click M1_SQL "https://github.com/iyy0v/usthb-projects/tree/main/M1/SQL3"
    click M1_Sort "https://github.com/iyy0v/usthb-projects/tree/main/M1/SortCmp"
    click M1_PP "https://github.com/iyy0v/usthb-projects/tree/main/M1/ProjectPlans"

    subgraph "M2"
        direction TB
        M2_DA["M2 – Data Warehousing / Analysis"]:::project
        M2_DP["M2 – Java Design Patterns"]:::project
        subgraph "M2 – DistributedApp"
            direction TB
            DA_Client["Client & Server Code"]:::component
            DA_EJB["Persistence/EJB Module"]:::component
            DA_Classes["Build Output & Classes"]:::component
            DA_Doc["Project Documentation"]:::document
        end
    end
    click M2_DA "https://github.com/iyy0v/usthb-projects/tree/main/M2/DataAnalysis"
    click M2_DP "https://github.com/iyy0v/usthb-projects/tree/main/M2/DesignPatterns"
    click DA_Client "https://github.com/iyy0v/usthb-projects/tree/main/M2/DistributedApp/Servers"
    click DA_EJB "https://github.com/iyy0v/usthb-projects/tree/main/M2/DistributedApp/DB/ejbModule"
    click DA_Classes "https://github.com/iyy0v/usthb-projects/tree/main/M2/DistributedApp/DB/build/classes"
    click DA_Doc "https://github.com/iyy0v/usthb-projects/blob/main/M2/DistributedApp/ProjectCAGL.pdf"

    %% Hierarchy Links
    Root -->|"contains"| L1_Algo
    Root --> L1_Math
    Root --> L2_POJ
    Root --> L2_Exp
    Root --> L2_PGCD
    Root --> L3_Tab
    Root --> M1_JUnit
    Root --> M1_LS
    Root --> M1_PCL
    Root --> M1_SYS
    Root --> M1_SQL
    Root --> M1_Sort
    Root --> M1_PP
    Root --> M2_DA
    Root --> M2_DP
    Root --> DA_Client

    DA_Client -->|"uses EJBs"| DA_EJB
    DA_EJB -->|"deploys classes to"| DA_Classes
    DA_Client -->|"refers docs"| DA_Doc

    %% Styles
    classDef root fill:#1f77b4,stroke:#333,stroke-width:2px,color:#fff;
    classDef project fill:#2ca02c,stroke:#333,stroke-width:1px;
    classDef component fill:#ff7f0e,stroke:#333,stroke-width:1px,stroke-dasharray: 5 5;
    classDef document fill:#d62728,stroke:#333,stroke-width:1px,stroke-dasharray: 2 2;
```
