# skynet2403/maze-maker-y-solver architecture

> Architecture diagram of the GitHub repository skynet2403/maze-maker-y-solver, 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/skynet2403/maze-maker-y-solver
- Repository: https://github.com/skynet2403/maze-maker-y-solver

## Overview

##### Project type and purpose
- This is a desktop Java application (built and packaged via NetBeans) that reads or generates a maze and then solves it using a stack-based algorithm.
- The README confirms: “este es un programa que resuelve un laberinto por medio de pilas.”

##### File structure
- Top-level:
- `.gitignore`
- `README.md` & `documento_Laberinto.pdf` (docs)
- `Ejecutable jar/` (standalone jar + instructions)
- `Laberinto/` (the NetBeans project)
- Inside `Laberinto/`:
- `nbproject/` (IDE metadata)
- `build.xml`, `manifest.mf` (Ant build config, JAR manifest)
- `src/Frame_mostrado/Frame_usar.java` (GUI)
- `src/Resolucion/SolucionarLaberinto.java` (solver engine)
- `src/laberinto/Laberinto.java` (data model for maze representation)
- Dist folder holds the packaged `Laberinto.jar`.

##### README insights
- No additional architecture notes, but key idea: separation of UI, solver logic, and maze model.

##### Elements
- User → UI (start)
- UI → Solver Engine (solve request)
- Solver Engine → Maze Model (read structure)
- Solver Engine → Stack (push/pop operations)
- Solver Engine → UI (return solution)
- Build scripts → Compilation → JAR

## Diagram (Mermaid)

```mermaid
flowchart TD
    Actor["User"]:::external
    subgraph "Presentation Layer"
        UI["Frame_usar\n(Swing UI)"]:::frontend
    end
    subgraph "Core Logic Layer"
        Solver["SolucionarLaberinto\n(Solver Engine)"]:::logic
        Stack["Stack\n(Data Structure)"]:::ds
    end
    subgraph "Data Layer"
        Model["Laberinto\n(Maze Model)"]:::model
    end
    subgraph "Build & Packaging"
        Ant["build.xml\n(Ant Script)"]:::build
        NB["nbproject/\n(NetBeans Metadata)"]:::build
        Manifest["manifest.mf"]:::build
        DistJar["dist/Laberinto.jar"]:::build
        ExeDist["Ejecutable jar/Laberinto.jar"]:::build
    end

    Actor -->|"launch()"| ExeDist
    ExeDist -->|"runs JAR"| UI
    UI -->|"solve() request"| Solver
    Solver -->|"loadMaze()"| Model
    Solver -->|"push()/pop()"| Stack
    Solver -->|"solution path"| UI

    NB -->|"metadata used by"| Ant
    Ant -->|"compile & package"| DistJar
    Manifest -->|"included in"| DistJar
    DistJar -->|"distributed as"| ExeDist

    click UI "https://github.com/skynet2403/maze-maker-y-solver/blob/login-javantastic/Laberinto/src/Frame_mostrado/Frame_usar.java"
    click Solver "https://github.com/skynet2403/maze-maker-y-solver/blob/login-javantastic/Laberinto/src/Resolucion/SolucionarLaberinto.java"
    click Model "https://github.com/skynet2403/maze-maker-y-solver/blob/login-javantastic/Laberinto/src/laberinto/Laberinto.java"
    click Ant "https://github.com/skynet2403/maze-maker-y-solver/blob/login-javantastic/Laberinto/build.xml"
    click NB "https://github.com/skynet2403/maze-maker-y-solver/tree/login-javantastic/Laberinto/nbproject/"
    click Manifest "https://github.com/skynet2403/maze-maker-y-solver/blob/login-javantastic/Laberinto/manifest.mf"
    click DistJar "https://github.com/skynet2403/maze-maker-y-solver/blob/login-javantastic/Laberinto/dist/Laberinto.jar"
    click ExeDist "https://github.com/skynet2403/maze-maker-y-solver/blob/login-javantastic/Ejecutable jar/Laberinto.jar"

    classDef frontend fill:#D6EAF8,stroke:#21618C,color:#1B4F72;
    classDef logic fill:#AED6F1,stroke:#1A5276,color:#154360;
    classDef model fill:#ABEBC6,stroke:#1D8348,color:#145A32;
    classDef ds fill:#D5F5E3,stroke:#117A65,color:#0B5345;
    classDef build fill:#F9E79F,stroke:#B9770E,color:#7E5109;
    classDef external fill:#F5B7B1,stroke:#B03A2E,color:#641E16;
```
