# jurnalanas/vat-simulator architecture

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

- Interactive diagram: https://gitdiagram.com/jurnalanas/vat-simulator
- Repository: https://github.com/jurnalanas/vat-simulator

## Overview

##### Main System Components

a. Client-Side Layer
- Next.js Application (Frontend)
- React Components Structure
- UI Components Library (Shadcn UI)

b. Application Logic Layer
- VAT Calculation Engine
- State Management
- Utility Functions

##### Component Organization

**Frontend Application**
- Core Application (src/app)
- Layout Component
- Main Page Component
- Component Layer
- UI Components (src/components/ui)
- VAT-specific Components (src/components/vat)
- Business Logic Layer
- Utility Functions (src/lib)
- Type Definitions (src/types)

##### Technical Stack Representation

- Next.js 15
- React 19
- TypeScript
- Tailwind CSS
- Shadcn UI

##### Implementation Details

a. Core Application Structure
**src/app**
- layout.tsx (App Shell)
- page.tsx (Main Page)

b. Component Organization
**src/components**
- ui/ (Reusable UI Components)
- vat/ (VAT-specific Components)

c. Business Logic
**src/lib**
- utils.ts (General Utilities)
- vat-utils.ts (VAT Calculations)

##### Additional Elements

Include:
- Version information for major dependencies
- Clear labeling of all components and their relationships
- Annotations for key architectural decisions

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Frontend
        AppLayout["App Layout"]
        MainPage["Main Page"]
        
        subgraph Components
            direction TB
            
            subgraph UIComponents["UI Components"]
                direction TB
                Collapsible["Collapsible"]
                Input["Input Field"]
                Label["Label"]
                Slider["Slider"]
            end
            
            subgraph VATComponents["VAT Components"]
                direction TB
                VATComparison["VAT Comparison"]
                Footer["Footer"]
                MarginControls["Margin Controls"]
                Stage["Stage"]
                Summary["Summary"]
                VATRateSection["VAT Rate Section"]
            end
        end
        
        subgraph BusinessLogic["Business Logic"]
            direction TB
            Utils["General Utils"]
            VATUtils["VAT Calculator"]
            TypeDefs["Type Definitions"]
        end
        
        subgraph Styling["Styling Layer"]
            direction TB
            GlobalCSS["Global CSS"]
            TailwindConfig["Tailwind Config"]
        end
    end
    
    %% Relationships
    AppLayout --> MainPage
    MainPage --> VATComparison
    VATComparison --> VATRateSection
    VATComparison --> MarginControls
    VATComparison --> Stage
    VATComparison --> Summary
    VATComparison --> Footer
    
    VATComponents --> UIComponents
    VATComponents --> BusinessLogic
    
    %% Click events
    click AppLayout "https://github.com/jurnalanas/vat-simulator/blob/main/src/app/layout.tsx"
    click MainPage "https://github.com/jurnalanas/vat-simulator/blob/main/src/app/page.tsx"
    click Collapsible "https://github.com/jurnalanas/vat-simulator/blob/main/src/components/ui/collapsible.tsx"
    click Input "https://github.com/jurnalanas/vat-simulator/blob/main/src/components/ui/input.tsx"
    click Label "https://github.com/jurnalanas/vat-simulator/blob/main/src/components/ui/label.tsx"
    click Slider "https://github.com/jurnalanas/vat-simulator/blob/main/src/components/ui/slider.tsx"
    click VATComparison "https://github.com/jurnalanas/vat-simulator/blob/main/src/components/vat-comparison.tsx"
    click Footer "https://github.com/jurnalanas/vat-simulator/blob/main/src/components/vat/footer.tsx"
    click MarginControls "https://github.com/jurnalanas/vat-simulator/blob/main/src/components/vat/margin-controls.tsx"
    click Stage "https://github.com/jurnalanas/vat-simulator/blob/main/src/components/vat/stage.tsx"
    click Summary "https://github.com/jurnalanas/vat-simulator/blob/main/src/components/vat/summary.tsx"
    click VATRateSection "https://github.com/jurnalanas/vat-simulator/blob/main/src/components/vat/vat-rate-section.tsx"
    click Utils "https://github.com/jurnalanas/vat-simulator/blob/main/src/lib/utils.ts"
    click VATUtils "https://github.com/jurnalanas/vat-simulator/blob/main/src/lib/vat-utils.ts"
    click TypeDefs "https://github.com/jurnalanas/vat-simulator/blob/main/src/types/vat.ts"
    click GlobalCSS "https://github.com/jurnalanas/vat-simulator/blob/main/src/app/globals.css"
    click TailwindConfig "https://github.com/jurnalanas/vat-simulator/blob/main/tailwind.config.ts"
    
    %% Styling
    classDef default fill:#f9f9f9,stroke:#333,stroke-width:2px
    classDef component fill:#e1f5fe,stroke:#0288d1
    classDef logic fill:#f3e5f5,stroke:#7b1fa2
    classDef styling fill:#fff3e0,stroke:#ff9800
    
    class AppLayout,MainPage default
    class Collapsible,Input,Label,Slider,VATComparison,Footer,MarginControls,Stage,Summary,VATRateSection component
    class Utils,VATUtils,TypeDefs logic
    class GlobalCSS,TailwindConfig styling
```
