# hienhm2212/it-tools architecture

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

- Interactive diagram: https://gitdiagram.com/hienhm2212/it-tools
- Repository: https://github.com/hienhm2212/it-tools

## Overview

##### Main Components

Frontend Architecture:
- Vue.js Application Core
- Router Layer (src/router.ts)
- Store Layer (src/stores)
- i18n Module (src/modules/i18n)
- Command Palette Module (src/modules/command-palette)
- Tracker Module (src/modules/tracker)

Tools Organization:
- Tools Registry (src/tools/index.ts)
- Individual Tool Components (grouped by categories)
- Shared Tool Services

UI Component Library:
- Custom UI Components (src/ui)
- Third-party Integration (Naive UI)

##### Key Relationships to Highlight

Data Flow:
**User Interface → Tool Components → Tool Services → Utility Functions**
**↑                     ↓**
**Store Layer  ←→  Core Services**

##### Architectural Patterns

Component Architecture:
**Layout Components**
- ↓
**Page Components**
- ↓
**Tool Components**
- ↓
**UI Components**

##### Specific Implementation Details

- Client Browser                                         |

- ↓

- Vue.js Application Core                                    |

- Router     |  |    Stores     |  |     i18n     |  |    Command Palette     |  |

- ↓

- Tools Registry                                          |

- Conversion    |  |  Generators   |  |  Formatters   |  |       Validators       |  |
- Tools         |  |  Tools        |  |  Tools        |  |       Tools           |  |

- ↓

- Shared Infrastructure                                      |

- UI Library   |  |   Services    |  |   Utilities   |  |     Composables        |  |

##### Additional Elements

Annotations for:
- Docker deployment options
- Internationalization flow
- Tool registration process
- Component communication patterns

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        Browser[Browser]
    end

    subgraph VueCore[Vue.js Application Core]
        App["Application Entry"]:::core
        Router["Router Layer"]:::core
        Store["Store Layer"]:::core
        I18n["i18n Module"]:::core
        CommandPalette["Command Palette"]:::core
        Tracker["Tracker Module"]:::core
    end

    subgraph ToolsLayer[Tools Organization]
        ToolsRegistry["Tools Registry"]:::tools
        ConversionTools["Conversion Tools"]:::tools
        GeneratorTools["Generator Tools"]:::tools
        FormatterTools["Formatter Tools"]:::tools
        ValidatorTools["Validator Tools"]:::tools
    end

    subgraph Infrastructure[Shared Infrastructure]
        UILib["UI Component Library"]:::ui
        NaiveUI["Naive UI Integration"]:::external
        Services["Shared Services"]:::service
        Utils["Utilities"]:::service
        Composables["Composables"]:::service
    end

    subgraph Pages[Pages and Layouts]
        Layouts["Layout Components"]:::ui
        CorePages["Core Pages"]:::ui
        CommonComponents["Common Components"]:::ui
    end

    %% Relationships
    Browser --> App
    App --> Router
    App --> Store
    App --> I18n
    App --> CommandPalette
    App --> Tracker

    Router --> CorePages
    CorePages --> ToolsRegistry
    ToolsRegistry --> ConversionTools
    ToolsRegistry --> GeneratorTools
    ToolsRegistry --> FormatterTools
    ToolsRegistry --> ValidatorTools

    ConversionTools --> UILib
    GeneratorTools --> UILib
    FormatterTools --> UILib
    ValidatorTools --> UILib

    UILib --> NaiveUI
    UILib --> Services
    UILib --> Utils
    UILib --> Composables

    CorePages --> Layouts
    CorePages --> CommonComponents

    %% Click Events
    click Router "https://github.com/hienhm2212/it-tools/blob/main/src/router.ts"
    click Store "https://github.com/hienhm2212/it-tools/tree/main/src/stores/"
    click I18n "https://github.com/hienhm2212/it-tools/tree/main/src/modules/i18n/"
    click CommandPalette "https://github.com/hienhm2212/it-tools/tree/main/src/modules/command-palette/"
    click Tracker "https://github.com/hienhm2212/it-tools/tree/main/src/modules/tracker/"
    click ToolsRegistry "https://github.com/hienhm2212/it-tools/blob/main/src/tools/index.ts"
    click ConversionTools "https://github.com/hienhm2212/it-tools/tree/main/src/tools/"
    click GeneratorTools "https://github.com/hienhm2212/it-tools/tree/main/src/tools/"
    click FormatterTools "https://github.com/hienhm2212/it-tools/tree/main/src/tools/"
    click ValidatorTools "https://github.com/hienhm2212/it-tools/tree/main/src/tools/"
    click UILib "https://github.com/hienhm2212/it-tools/tree/main/src/ui/"
    click NaiveUI "https://github.com/hienhm2212/it-tools/blob/main/src/plugins/naive.plugin.ts"
    click Composables "https://github.com/hienhm2212/it-tools/tree/main/src/composable/"
    click Utils "https://github.com/hienhm2212/it-tools/tree/main/src/utils/"
    click Layouts "https://github.com/hienhm2212/it-tools/tree/main/src/layouts/"
    click CorePages "https://github.com/hienhm2212/it-tools/tree/main/src/pages/"
    click App "https://github.com/hienhm2212/it-tools/blob/main/src/App.vue"
    click CommonComponents "https://github.com/hienhm2212/it-tools/tree/main/src/components/"

    %% Styles
    classDef core fill:#2196F3,stroke:#1565C0,color:white
    classDef tools fill:#4CAF50,stroke:#2E7D32,color:white
    classDef ui fill:#9C27B0,stroke:#6A1B9A,color:white
    classDef service fill:#FF9800,stroke:#EF6C00,color:white
    classDef external fill:#9E9E9E,stroke:#616161,color:white

    %% Legend
    subgraph Legend
        CoreComp["Core Components"]:::core
        ToolComp["Tool Components"]:::tools
        UIComp["UI Components"]:::ui
        ServiceComp["Services & Utilities"]:::service
        ExtComp["External Integrations"]:::external
    end
```
