# mrdionesalvi/sistemi-operativi architecture

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

- Interactive diagram: https://gitdiagram.com/mrdionesalvi/sistemi-operativi
- Repository: https://github.com/mrdionesalvi/sistemi-operativi

## Overview

##### Project type and purpose
- This is a monorepo for an academic operating-systems course containing:
a. “Laboratorio” folder: C-language lab exercises (Lab02–Lab09).
b. “Teoria” folder: LaTeX source for course theory chapters and compiled PDF.
c. README with WakaTime badge, .vscode configs, .gitignore, LICENSE.
- It’s not a classical client-server app but a combined documentation + code-sample project with a build pipeline and dev-tool integrations.

##### File structure
- Top level:
- .gitignore, .vscode/, LICENSE, README.md (repo metadata/config)
- Laboratorio/ (all C exercises grouped by lab)
- Teoria/ (LaTeX source, images, environment styles, final main.pdf)
- Each lab directory: C source, supporting PDFs, test files, subfolders (e.g., server-client).
- Teoria has chapters, enviroment (sty files), images, and final outputs.
- No formal build scripts (Makefile) present, but implicit build steps: gcc for C code, pdflatex for docs.
- External integration: WakaTime badge in README (metrics service).

##### README for additional insights
- It only exposes a WakaTime project badge—implying developer metric tracking.
- No further architecture or tech-stack explanation.

a. Main components
1. Version Control: Git Repo (GitHub/GitLab)
2. Developer Workstation + IDE (with .vscode settings & WakaTime plugin)
3. “Laboratorio” module (C code for Labs)
4. “Teoria” module (LaTeX source → main.pdf)
5. Build Tools:
- GCC toolchain (compile & run C labs)
- pdflatex (build PDF from Teoria)
6. Outputs: Executable binaries (lab tests), main.pdf
7. External Service: WakaTime analytics
b. Relationships & interactions
- Developer pulls/clones repo → edits code or LaTeX → invokes build tools → generates executables or PDF → runs/tests C code.
- IDE usage: reads/writes source, uses .vscode to configure linters, and pushes time metrics to WakaTime.
- Version Control: commit/push changes back to remote.
- README displays WakaTime badge (fetched from WakaTime API).
c. Architectural patterns/principles
- Monorepo structure separating code and documentation.
- Convention-over-configuration: directory naming by lab number.
- Toolchain decoupling: C compile pipeline vs. LaTeX build pipeline run independently.
d. Key technologies/frameworks/libraries
- C language, GCC compiler
- LaTeX, pdflatex, custom .sty environment files
- WakaTime plugin & badge API
- Git, .vscode for IDE configuration

##### Elements
- Clear labels for each component (e.g., “Laboratorio (C Labs)”, “Teoria (LaTeX)”)
- From Git Repo to Developer IDE
- IDE → Build Tools → Outputs
- IDE → WakaTime Service → README Badge

##### Final Recommendations
- Be exhaustive: break down each Lab (e.g., Lab05 server-client submodule) if further detail is needed.
- Paths: source → build → test/report.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Version Control
    GitRepo["Git Repository"]:::vc

    %% Dev Environment
    subgraph "Dev Environment"
        IDE["Developer IDE (.vscode)"]:::external
        WakaTime["WakaTime Service"]:::service
    end

    %% Build Pipelines
    subgraph "Build Pipelines"
        subgraph "Labs Pipeline"
            Laboratorio["Laboratorio Module"]:::code

            subgraph "Labs"
                Lab02["Lab02"]:::code
                Lab03["Lab03"]:::code
                Lab04["Lab04"]:::code

                Lab05["Lab05"]:::code
                Esercizi["Esercizi"]:::code

                Lab06["Lab06"]:::code
                ServerClient["server-client"]:::code

                Lab07["Lab07"]:::code
                WriterReader07["writer_reader"]:::code

                Lab08["Lab08"]:::code
                FatherNChild["father_with_Nchild"]:::code
                FirstStep["first_step"]:::code
                WriterReader08["writer_reader"]:::code

                Lab09["Lab09"]:::code
                Awk09["awk"]:::code
                Concat09["concatenazione_file"]:::code
                Standalone09["standalone scripts"]:::code
            end

            GCC["GCC Toolchain"]:::tools
            LabOutputs["Lab Executables"]:::outputs

            Laboratorio --> GCC --> LabOutputs
        end

        subgraph "Docs Pipeline"
            Teoria["Teoria Module"]:::docs
            PDFBuilder["pdfLaTeX"]:::tools
            DocOutput["main.pdf"]:::outputs

            Teoria --> PDFBuilder --> DocOutput
        end
    end

    %% Relationships
    GitRepo --> IDE
    IDE -->|"edits code/docs"| Laboratorio
    IDE -->|"edits code/docs"| Teoria
    IDE -->|"tracks time"| WakaTime
    WakaTime -->|"badge in README"| GitRepo
    GitRepo --> Laboratorio
    GitRepo --> Teoria

    %% Click Events
    click GitRepo "https://github.com/mrdionesalvi/sistemi-operativi/blob/main//README.md"
    click IDE "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//.vscode/"
    click WakaTime "https://github.com/mrdionesalvi/sistemi-operativi/blob/main//README.md"
    click Laboratorio "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Laboratorio/"
    click Lab02 "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Laboratorio/Lab02/"
    click Lab03 "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Laboratorio/Lab03/"
    click Lab04 "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Laboratorio/Lab04/"
    click Lab05 "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Laboratorio/Lab05/"
    click Esercizi "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Laboratorio/Lab05/Esercizi/"
    click Lab06 "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Laboratorio/Lab06/"
    click ServerClient "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Laboratorio/Lab06/server-client/"
    click Lab07 "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Laboratorio/Lab07/"
    click WriterReader07 "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Laboratorio/Lab07/writer_reader/"
    click Lab08 "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Laboratorio/Lab08/"
    click FatherNChild "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Laboratorio/Lab08/father_with_Nchild/"
    click FirstStep "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Laboratorio/Lab08/first_step/"
    click WriterReader08 "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Laboratorio/Lab08/writer_reader/"
    click Lab09 "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Laboratorio/Lab09/"
    click Awk09 "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Laboratorio/Lab09/awk/"
    click Concat09 "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Laboratorio/Lab09/concatenazione_file/"
    click Standalone09 "https://github.com/mrdionesalvi/sistemi-operativi/blob/main//Laboratorio/Lab09/ipc_cleaner.sh"
    click Teoria "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Teoria/"
    click Teoria "https://github.com/mrdionesalvi/sistemi-operativi/blob/main//Teoria/main.tex"
    click DocOutput "https://github.com/mrdionesalvi/sistemi-operativi/blob/main//Teoria/main.pdf"
    click Teoria "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Teoria/chapters/"
    click Teoria "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Teoria/enviroment/"
    click Teoria "https://github.com/mrdionesalvi/sistemi-operativi/tree/main//Teoria/images/"

    %% Styles
    classDef vc fill:#dddddd,stroke:#333333;
    classDef external fill:#f2f2f2,stroke:#666666;
    classDef service fill:#d1b3ff,stroke:#732d94;
    classDef code fill:#b3ffb3,stroke:#2d862d;
    classDef docs fill:#b3d1ff,stroke:#264d94;
    classDef tools fill:#ffe0b3,stroke:#b38600;
    classDef outputs fill:#ffcccc,stroke:#b30000;
```
