# marcoaaguiar/poe2-tree architecture

> Architecture diagram of the GitHub repository marcoaaguiar/poe2-tree, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/marcoaaguiar/poe2-tree
- Repository: https://github.com/marcoaaguiar/poe2-tree

## Overview

##### Main Components Identification

The system can be broken down into these main components:

a) Frontend Application (SvelteKit-based)
- UI Components Layer
- Data Management Layer
- Static Assets

b) Data Processing
- Tree Scanner Component
- Data Storage

**[Frontend Application]**

- [UI Layer]
- Header Component
- Tree Node Components
- Node List Items
- Save/Load System

- [Data Layer]
- JSON Data Files
- nodes.json
- nodes_desc.json
- skills.json
- keywords.json
- State Management

- [Static Assets]
- Ascendancies
- Skills

**[Tree Scanner]**

- [Python-based Data Processor]

##### Component Relationships

- Tree Scanner → Data Layer (data generation flow)
- Data Layer → UI Layer (data consumption flow)
- UI Layer → User Interface (rendering flow)
- Save/Load System ↔ Local Storage (persistence)

##### Important Implementation Details to Highlight

- SvelteKit Framework usage
- Component-based architecture
- JSON-based data structure
- Python-based data processing
- Static file serving

##### Specific Elements

a) Frontend Components:
- Tree node visualization system
- Node tooltips
- Save/load functionality
- Header navigation

b) Data Management:
- JSON data files structure
- Data flow between components
- State management system

c) Build/Deploy Pipeline:
- GitHub workflows
- Static asset handling

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Frontend
        UI[UI Layer]
        DL[Data Layer]
        SA[Static Assets]
        
        subgraph UIComponents
            direction TB
            HC["Header Component"]
            TN["Tree Node Component"]
            NL["Node List Items"]
            SL["Save/Load System"]
            TT["Tree Node Tooltip"]
        end
        
        subgraph DataComponents
            direction TB
            JF["JSON Files"]
            SM["State Management"]
            
            subgraph JSONData
                direction TB
                NJ["nodes.json"]
                ND["nodes_desc.json"]
                SJ["skills.json"]
                KJ["keywords.json"]
            end
        end
        
        subgraph StaticAssets
            direction TB
            AS["Ascendancies"]
            SK["Skills"]
        end
    end
    
    subgraph Processing
        TS["Tree Scanner"]
        TSO["Scanner Output"]
    end
    
    subgraph MainApp
        ML["Main Layout"]
        MP["Main Page"]
    end
    
    %% Relationships
    UI --> UIComponents
    DL --> DataComponents
    SA --> StaticAssets
    
    TS --> TSO
    TSO --> JF
    
    DataComponents --> UIComponents
    UIComponents --> MainApp
    SL <--> LS[("Local Storage")]
    
    %% Click Events
    click HC "https://github.com/marcoaaguiar/poe2-tree/blob/main/src/lib/components/ui/header/header.svelte"
    click TN "https://github.com/marcoaaguiar/poe2-tree/blob/main/src/lib/components/ui/tree-node/tree-node.svelte"
    click NL "https://github.com/marcoaaguiar/poe2-tree/tree/main/src/lib/components/ui/node-list-item/"
    click SL "https://github.com/marcoaaguiar/poe2-tree/tree/main/src/lib/components/save-and-load/"
    click TT "https://github.com/marcoaaguiar/poe2-tree/blob/main/src/lib/components/ui/tree-node-tooltip/tree-node-tooltip.svelte"
    click NJ "https://github.com/marcoaaguiar/poe2-tree/blob/main/src/lib/data/nodes.json"
    click ND "https://github.com/marcoaaguiar/poe2-tree/blob/main/src/lib/data/nodes_desc.json"
    click SJ "https://github.com/marcoaaguiar/poe2-tree/blob/main/src/lib/data/skills.json"
    click KJ "https://github.com/marcoaaguiar/poe2-tree/blob/main/src/lib/data/keywords.json"
    click AS "https://github.com/marcoaaguiar/poe2-tree/tree/main/static/ascendancies/"
    click SK "https://github.com/marcoaaguiar/poe2-tree/tree/main/static/skills/"
    click TS "https://github.com/marcoaaguiar/poe2-tree/blob/main/tree-scanner/main.py"
    click TSO "https://github.com/marcoaaguiar/poe2-tree/blob/main/tree-scanner/output/nodes.json"
    click ML "https://github.com/marcoaaguiar/poe2-tree/blob/main/src/routes/+layout.svelte"
    click MP "https://github.com/marcoaaguiar/poe2-tree/blob/main/src/routes/+page.svelte"
    
    %% Styling
    classDef frontend fill:#3498db,stroke:#2980b9,color:white
    classDef data fill:#2ecc71,stroke:#27ae60,color:white
    classDef processing fill:#e67e22,stroke:#d35400,color:white
    classDef ui fill:#9b59b6,stroke:#8e44ad,color:white
    classDef storage fill:#95a5a6,stroke:#7f8c8d,color:white
    
    class UI,UIComponents,HC,TN,NL,SL,TT frontend
    class DL,DataComponents,JF,SM,JSONData,NJ,ND,SJ,KJ data
    class TS,TSO processing
    class ML,MP ui
    class LS storage
    class SA,StaticAssets,AS,SK frontend
```
