# minsomai/vue-flowchart-builder architecture

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

- Interactive diagram: https://gitdiagram.com/minsomai/vue-flowchart-builder
- Repository: https://github.com/minsomai/vue-flowchart-builder

## Overview

##### Main Components Identification

The system should be represented with these key architectural components:

a) Core Components Layer:
- FlowGroup (Composite)
- FlowSibling (Connector)
- FlowSingle (Leaf)

b) Symbol Components Layer:
- Start
- Stop
- Process
- Decision
- Data
- IO

c) Composables (Logic Layer):
- Flowchart Builder
- Edge Builder
- Symbol Handler
- Flow Handlers

##### Specific Elements

- Blue: Vue Components
- Green: Composables
- Yellow: Symbol Components
- Gray: Helper Functions/Constants

- Rectangles: Components
- Hexagons: Composables
- Diamonds: Decision Points
- Circles: Entry/Exit Points

##### Flow Representation

Following relationships:

##### Key Architectural Patterns to Highlight

- Composite Pattern Implementation
- Recursive Edge Building
- Component Hierarchy
- State Management Flow

##### Implementation Details

- How the flowchart builder manages component relationships
- The recursive nature of the edge building system
- Symbol type management and relationships
- Component communication patterns

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Application
        App["Vue Application"]:::vue
        click App "https://github.com/MinSomai/vue-flowchart-builder/blob/master/src/App.vue"
        Vite["Vite Build Tool"]:::build
    end

    subgraph "Core Components"
        FlowGroup["FlowGroup (Composite)"]:::component
        click FlowGroup "https://github.com/MinSomai/vue-flowchart-builder/blob/master/src/components/FlowGroup.vue"
        FlowSibling["FlowSibling (Connector)"]:::component
        click FlowSibling "https://github.com/MinSomai/vue-flowchart-builder/blob/master/src/components/FlowSibling.vue"
        FlowSingle["FlowSingle (Leaf)"]:::component
        click FlowSingle "https://github.com/MinSomai/vue-flowchart-builder/blob/master/src/components/FlowSingle.vue"
    end

    subgraph "Symbol Components"
        Start["Start Symbol"]:::symbol
        click Start "https://github.com/MinSomai/vue-flowchart-builder/blob/master/src/components/symbols/Start.vue"
        Stop["Stop Symbol"]:::symbol
        click Stop "https://github.com/MinSomai/vue-flowchart-builder/blob/master/src/components/symbols/Stop.vue"
        Process["Process Symbol"]:::symbol
        click Process "https://github.com/MinSomai/vue-flowchart-builder/blob/master/src/components/symbols/Process.vue"
        Decision["Decision Symbol"]:::symbol
        click Decision "https://github.com/MinSomai/vue-flowchart-builder/blob/master/src/components/symbols/Decision.vue"
        Data["Data Symbol"]:::symbol
        click Data "https://github.com/MinSomai/vue-flowchart-builder/blob/master/src/components/symbols/Data.vue"
        IO["I/O Symbol"]:::symbol
        click IO "https://github.com/MinSomai/vue-flowchart-builder/blob/master/src/components/symbols/IO.vue"
    end

    subgraph "Logic Layer"
        FlowBuilder["Flowchart Builder"]:::composable
        click FlowBuilder "https://github.com/MinSomai/vue-flowchart-builder/blob/master/src/composables/useFlowchartBuilder.js"
        EdgeBuilder["Edge Builder"]:::composable
        click EdgeBuilder "https://github.com/MinSomai/vue-flowchart-builder/blob/master/src/composables/useRecursiveEdgeBuilder.js"
        SymbolHandler["Symbol Handler"]:::composable
        click SymbolHandler "https://github.com/MinSomai/vue-flowchart-builder/blob/master/src/composables/useSymbol.js"
        GroupHandler["Group Handler"]:::composable
        click GroupHandler "https://github.com/MinSomai/vue-flowchart-builder/blob/master/src/composables/useFlowGroup.js"
        SingleHandler["Single Handler"]:::composable
        click SingleHandler "https://github.com/MinSomai/vue-flowchart-builder/blob/master/src/composables/useFlowSingle.js"
        FlowHelper["Flowchart Helper"]:::composable
        click FlowHelper "https://github.com/MinSomai/vue-flowchart-builder/blob/master/src/composables/useRecursiveFlowchartHelper.js"
        SymbolTypes["Symbol Types"]:::helper
        click SymbolTypes "https://github.com/MinSomai/vue-flowchart-builder/blob/master/src/helpers/const/SymbolTypes.js"
    end

    %% Relationships
    App --> FlowGroup
    FlowGroup --> FlowSingle
    FlowGroup --> FlowSibling
    FlowSingle --> Start & Stop & Process & Decision & Data & IO

    FlowBuilder --> EdgeBuilder
    FlowBuilder --> SymbolHandler
    FlowBuilder --> GroupHandler
    FlowBuilder --> SingleHandler
    FlowBuilder --> FlowHelper

    SymbolHandler --> SymbolTypes
    GroupHandler --> FlowGroup
    SingleHandler --> FlowSingle
    EdgeBuilder --> FlowSibling

    %% Styles
    classDef vue fill:#41B883,stroke:#35495E,color:white
    classDef build fill:#646CFF,stroke:#535BF2,color:white
    classDef component fill:#3498DB,stroke:#2980B9,color:white
    classDef symbol fill:#F1C40F,stroke:#F39C12,color:black
    classDef composable fill:#2ECC71,stroke:#27AE60,color:white
    classDef helper fill:#95A5A6,stroke:#7F8C8D,color:white

    %% Legend
    subgraph Legend
        L1["Vue Component"]:::vue
        L2["Build Tool"]:::build
        L3["Core Component"]:::component
        L4["Symbol Component"]:::symbol
        L5["Composable"]:::composable
        L6["Helper"]:::helper
    end
```
