# andyfratello/pro2 architecture

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

- Interactive diagram: https://gitdiagram.com/andyfratello/pro2
- Repository: https://github.com/andyfratello/pro2

## Overview

##### Main Components
- Think of each top-level directory as a major module or category:
- “Apuntadors 1” and “Apuntadors 2”: Exercises focusing on pointers.
- “Exàmens”: Contains exam solution PDFs.
- “List & BinTree”: Contains exercises (including .tar archives and one .cc file) on lists and binary trees.
- “Map & Set”: Exercises concerning map and set data structures.
- “Pràctica”: Contains a practice/project assignment (with both a PDF description and program archives).
- “Sessio1”, “Sessio2”, “Sessio3”: Likely collections of session exercises or labs.
- “Stack and queue”: Exercises related to stacks and queues.
- A component for the README that explains the purpose (“Programació-2”) and serves as an entry point for understanding how the repository is structured.

##### Architectural Patterns
- Use a hierarchical breakdown: a top-level node for “Programació-2 Exercise Repository” that branches out into modules such as “Pointers”, “Lists & Trees”, “Maps & Sets”, “Stacks & Queues”, “Sessions”, etc.
- Such modular separation respects separation of concerns—a common design principle.

##### Technologies and Artifacts
- Optionally, note that the project is used for educational purposes, so the “client” is effectively the instructor/student workflow.

##### Instructing the Principal Software Engineer
- Pointers (combining Apuntadors 1 and Apuntadors 2)
- Exams (Exàmens)
- Lists & Binary Trees (List & BinTree)
- Maps & Sets (Map & Set)
- Practice Project (Pràctica)
- Sessions (Sessio1, Sessio2, Sessio3)
- Stacks & Queues (Stack and queue)
- Use clear labeling for each node.
- Another for modules containing archives (.tar files),
- And another for documentation or exam files (.pdf).
- Optionally, include a “Documentation/README” node linking to all other components to indicate the foundational overview provided in the README.

## Diagram (Mermaid)

```mermaid
flowchart TD
    central["Programació-2 Exercises Repository"]:::centralStyle

    subgraph "Pointers (Apuntadors)"
        A1["Apuntadors 1"]:::moduleSource
        A2["Apuntadors 2"]:::moduleSource
        A1 -->|"next"| A2
    end

    Exams["Exams (Exàmens)"]:::docs
    Lists["Lists & Binary Trees"]:::moduleSource
    Maps["Maps & Sets"]:::moduleSource
    Practice["Practice Project (Pràctica)"]:::docs

    subgraph "Sessions"
        S1["Sessio1"]:::moduleSource
        S2["Sessio2"]:::moduleSource
        S3["Sessio3"]:::moduleSource
        S1 -->|"next"| S2
        S2 -->|"next"| S3
    end

    Stacks["Stacks & Queues"]:::moduleSource
    Readme["Documentation/README"]:::docs

    %% Connections from central repository node to each module
    central --> A1
    central --> Exams
    central --> Lists
    central --> Maps
    central --> Practice
    central --> S1
    central --> Stacks
    central --> Readme

    %% Learning progression arrows
    A1 -->|"leadsTo"| Lists
    Lists -->|"leadsTo"| Maps
    Maps -->|"leadsTo"| Stacks

    %% Click Events
    click A1 "https://github.com/andyfratello/pro2/tree/main/Apuntadors 1/"
    click A2 "https://github.com/andyfratello/pro2/tree/main/Apuntadors 2/"
    click Exams "https://github.com/andyfratello/pro2/tree/main/Exàmens/"
    click Lists "https://github.com/andyfratello/pro2/tree/main/List & BinTree/"
    click Maps "https://github.com/andyfratello/pro2/tree/main/Map & Set/"
    click Practice "https://github.com/andyfratello/pro2/tree/main/Pràctica/"
    click S1 "https://github.com/andyfratello/pro2/tree/main/Sessio1/"
    click S2 "https://github.com/andyfratello/pro2/tree/main/Sessio2/"
    click S3 "https://github.com/andyfratello/pro2/tree/main/Sessio3/"
    click Stacks "https://github.com/andyfratello/pro2/tree/main/Stack and queue/"
    click Readme "https://github.com/andyfratello/pro2/blob/main/README.md"

    %% Styles
    classDef moduleSource fill:#AED6F1,stroke:#1B4F72,stroke-width:2px;
    classDef docs fill:#F9E79F,stroke:#B7950B,stroke-width:2px;
    classDef centralStyle fill:#D5F5E3,stroke:#1D8348,stroke-width:2px;
```
