# bongodev/vanilla-javascript-fall-2024 architecture

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

- Interactive diagram: https://gitdiagram.com/bongodev/vanilla-javascript-fall-2024
- Repository: https://github.com/bongodev/vanilla-javascript-fall-2024

## Overview

##### Main Components Structure

**[Project Structure Layer]**

**[Application Modules Layer]**

**[Common Components Layer]**

##### Component Details

a) Project Structure Layer:
- GitHub Actions workflow component (shown from .github/workflows)
- Documentation component (README.md)

b) Application Modules Layer (organize in chronological order):
**[Counter App] → [Number Comparator] → [Grade Calculator] → [Number Table] →**
**[Number Table 1-10] → [Employee Management] → [E-commerce] → [Render Products]**

Each application module should be represented with:
- Input/Output interfaces
- DOM interaction points
- JavaScript logic components
- Event listeners

c) Common Components Layer:
- HTML Structure (index.html)
- JavaScript Utilities (script.js)
- Asset Management (assets folder)

##### Relationships and Flows

**[Product Display] ⇄ [Shopping Cart]**
- ↓
**[Filter System] → [Price Calculator]**
- ↓
**[Local Storage Integration]**

**[API Layer] → [Promise Handler] → [Async Operations] → [DOM Renderer]**

##### Implementation Details

Technical aspects:
- DOM Manipulation methods
- Event Listener implementations
- Data flow patterns
- State management (especially for e-commerce)
- API integration (for render products)

##### Common patterns and reusable components

Keep the abstraction level focused on the educational aspects while maintaining technical accuracy in showing how each application implements various JavaScript concepts.

Remember to include notes about:
- JavaScript fundamentals (variables, functions, loops)
- DOM manipulation patterns
- Event handling mechanisms
- Data management approaches
- Asynchronous programming patterns (for later modules)

This structure will help developers understand both the educational progression and the technical implementation of each component.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Main Layers
    subgraph ProjectLayer["Project Structure Layer"]
        VJS["Vanilla JavaScript Course"]
        GH["GitHub Actions Workflow"]
        DOC["Documentation"]
    end

    subgraph AppLayer["Application Modules Layer"]
        direction TB
        CA["Counter App"]:::app
        NC["Number Comparator"]:::app
        GC["Grade Calculator"]:::app
        NT["Number Table"]:::app
        NT10["Number Table 1-10"]:::app
        EM["Employee Management"]:::app
        
        subgraph EC["E-commerce Module"]
            PD["Product Display"]:::ecom
            SC["Shopping Cart"]:::ecom
            FS["Filter System"]:::ecom
            PC["Price Calculator"]:::ecom
            LS["Local Storage"]:::ecom
        end
        
        subgraph RP["Render Products Module"]
            API["API Layer"]:::api
            PH["Promise Handler"]:::async
            AO["Async Operations"]:::async
            DR["DOM Renderer"]:::ui
        end
    end

    subgraph CommonLayer["Common Components Layer"]
        HTML["HTML Structure"]:::ui
        JS["JavaScript Utilities"]:::code
        ASSETS["Asset Management"]:::resource
    end

    %% Relationships
    VJS --> GH
    VJS --> DOC
    
    %% Application Flow
    CA --> NC --> GC --> NT --> NT10 --> EM --> EC --> RP
    
    %% E-commerce Relationships
    PD <--> SC
    PD --> FS
    FS --> PC
    FS --> LS
    
    %% Render Products Flow
    API --> PH --> AO --> DR
    
    %% Common Components Relations
    HTML --- JS
    JS --- ASSETS
    
    %% Legend
    subgraph Legend
        L1["🟦 Application Module"]:::app
        L2["🟨 JavaScript Component"]:::code
        L3["🟩 UI Element"]:::ui
        L4["🟪 Resource"]:::resource
        L5["🔄 Async Operation"]:::async
        L6["🌐 API Component"]:::api
        L7["🛒 E-commerce Component"]:::ecom
    end

    %% Styles
    classDef app fill:#4a90e2,stroke:#2e5c8a,color:white
    classDef code fill:#f1c40f,stroke:#b7950b,color:black
    classDef ui fill:#2ecc71,stroke:#27ae60,color:white
    classDef resource fill:#9b59b6,stroke:#8e44ad,color:white
    classDef async fill:#e74c3c,stroke:#c0392b,color:white
    classDef api fill:#3498db,stroke:#2980b9,color:white
    classDef ecom fill:#e67e22,stroke:#d35400,color:white

    %% Click Events
    click GH "https://github.com/bongodev/vanilla-javascript-fall-2024/blob/main//.github/workflows/static.yml"
    click DOC "https://github.com/bongodev/vanilla-javascript-fall-2024/blob/main//README.md"
    click HTML "https://github.com/bongodev/vanilla-javascript-fall-2024/blob/main//index.html"
    click JS "https://github.com/bongodev/vanilla-javascript-fall-2024/blob/main//script.js"
    click ASSETS "https://github.com/bongodev/vanilla-javascript-fall-2024/tree/main//assets"
    click CA "https://github.com/bongodev/vanilla-javascript-fall-2024/tree/main//001-counter-app"
    click NC "https://github.com/bongodev/vanilla-javascript-fall-2024/tree/main//002-number-comparator"
    click GC "https://github.com/bongodev/vanilla-javascript-fall-2024/tree/main//003-grade-calculator"
    click NT "https://github.com/bongodev/vanilla-javascript-fall-2024/tree/main//004-number-table"
    click NT10 "https://github.com/bongodev/vanilla-javascript-fall-2024/tree/main//005-number-table-1-10"
    click EM "https://github.com/bongodev/vanilla-javascript-fall-2024/tree/main//006-employee-table"
    click EC "https://github.com/bongodev/vanilla-javascript-fall-2024/tree/main//007-e-commerce"
    click RP "https://github.com/bongodev/vanilla-javascript-fall-2024/tree/main//008-render-products"
    click PD "https://github.com/bongodev/vanilla-javascript-fall-2024/blob/main//007-e-commerce/*/index.html"
    click API "https://github.com/bongodev/vanilla-javascript-fall-2024/blob/main//008-render-products/*/js/script.js"
    click DR "https://github.com/bongodev/vanilla-javascript-fall-2024/blob/main//008-render-products/*/index.html"
```
