# jaimeperezrisco/figuras architecture

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

- Interactive diagram: https://gitdiagram.com/jaimeperezrisco/figuras
- Repository: https://github.com/jaimeperezrisco/figuras

## Overview

##### Project Type and Purpose
- The project is focused on object-oriented concepts such as inheritance (with base classes like Figura, and more specialized subtypes like Figura2D and Figura3D) and encapsulation.
- The Main.java acts as an entry point for the application.

##### Analyzing the File Structure
- Top-Level Folders:
- .vscode – holds project-specific configuration (IDE settings).
- bin – destination for compiled classes (runtime binaries).
- src – source folder containing your Java code.

##### Examining the README
- The README emphasizes how to write Java code in VS Code and mentions the default folder structure.

a. Main Components:
- Source Code Module: Represented by the “src/Figuras” package. Here, list the classes:
- Figura (base class)
- Figura2D and Figura3D (possibly abstract/specialized types)
- Circulo, Rectangulo (likely inheriting from Figura2D)
- Esfera, PiramideRectangular (likely inheriting from Figura3D)
- Main class: point of entry to the application
- Build/Output Module: The “bin” folder which holds the compiled bytecode.
- Configuration: The “.vscode” folder indicating the settings that help configure the development environment.

b. Relationships and Interactions:
- That Main.java leverages these classes to run the application.
- Optionally, illustrate the build process from the src folder to the bin folder, highlighting compilation.

c. Architectural Patterns:
- Object-Oriented Inheritance: Emphasize the hierarchy in the “Figuras” package. This pattern is key to the project.
- Standard Separation of Concerns: Distinction between source (logic) and binary output (executable code).
- Although the project is simple, note the design principles of modularity and reusability.

d. Technologies, Frameworks, or Libraries:
- Since it’s a basic Java project, note that it uses plain Java with no additional frameworks.
- Mention Visual Studio Code as the IDE, which is less about runtime architecture but more about project management and configuration (via the .vscode folder).

## Diagram (Mermaid)

```mermaid
flowchart TD
    Config["IDE Configuration (.vscode)"]:::config
    subgraph "Source Code Module (src/Figuras)"
        Figura["Figura (Base Class)"]:::source
        Figura2D["Figura2D (2D Base)"]:::source
        Figura3D["Figura3D (3D Base)"]:::source
        Circulo["Circulo (2D)"]:::source
        Rectangulo["Rectangulo (2D)"]:::source
        Esfera["Esfera (3D)"]:::source
        PiramideRectangular["PiramideRectangular (3D)"]:::source
        MainClass["Main Class (Entry Point)"]:::entry
    end
    BuildOutput["Compiled Output (bin/Figuras)"]:::build

    %% Inheritance relationships
    Figura2D -->|"inherits"| Figura
    Figura3D -->|"inherits"| Figura
    Circulo -->|"inherits"| Figura2D
    Rectangulo -->|"inherits"| Figura2D
    Esfera -->|"inherits"| Figura3D
    PiramideRectangular -->|"inherits"| Figura3D

    %% Main class uses relationships
    MainClass -->|"uses"| Circulo
    MainClass -->|"uses"| Rectangulo
    MainClass -->|"uses"| Esfera
    MainClass -->|"uses"| PiramideRectangular

    %% Build process from source to output
    MainClass ---|"compiles-to"| BuildOutput

    %% Styles
    classDef config fill:#FFCCCC,stroke:#990000,stroke-width:2px;
    classDef build fill:#ADD8E6,stroke:#00008B,stroke-width:2px;
    classDef source fill:#C1E1C1,stroke:#228B22,stroke-width:2px;
    classDef entry fill:#FFFF99,stroke:#FF8C00,stroke-width:2px;

    %% Click Events
    click Config "https://github.com/jaimeperezrisco/figuras/blob/main/.vscode"
    click MainClass "https://github.com/jaimeperezrisco/figuras/blob/main/src/Figuras/Main.java"
    click Figura "https://github.com/jaimeperezrisco/figuras/blob/main/src/Figuras/Figura.java"
    click Figura2D "https://github.com/jaimeperezrisco/figuras/blob/main/src/Figuras/Figura2D.java"
    click Figura3D "https://github.com/jaimeperezrisco/figuras/blob/main/src/Figuras/Figura3D.java"
    click Circulo "https://github.com/jaimeperezrisco/figuras/blob/main/src/Figuras/Circulo.java"
    click Rectangulo "https://github.com/jaimeperezrisco/figuras/blob/main/src/Figuras/Rectangulo.java"
    click Esfera "https://github.com/jaimeperezrisco/figuras/blob/main/src/Figuras/Esfera.java"
    click PiramideRectangular "https://github.com/jaimeperezrisco/figuras/blob/main/src/Figuras/PiramideRectangular.java"
    click BuildOutput "https://github.com/jaimeperezrisco/figuras/tree/main/bin/Figuras"
```
