# dennis1088/diceware-web architecture

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

- Interactive diagram: https://gitdiagram.com/dennis1088/diceware-web
- Repository: https://github.com/dennis1088/diceware-web

## Overview

##### Main Components

a. Web Application Layer:
- Sinatra Web Server (indicated by app.rb and config.ru)
- Views Engine (ERB templating, shown by views/index.erb)
- Static Asset Handler (public directory)

b. Core Logic Layer:
- Diceware Gem (external dependency)
- Application Logic (app.rb)

c. Client-Side Layer:
- JavaScript Components (public/js)
- CSS Styling (public/css)

**[Client Browser] → [Web Application Layer] → [Core Logic Layer]**

##### Detailed Component Breakdown

Client Layer (Blue):
**┌─────────────────────┐**
- Client Browser   │
- ┤
- HTML/ERB Views    │
- CSS (main.css)    │
- JavaScript        │
- (main.js,         │
- plugins.js)      │
- ┘

Web Application Layer (Green):
**┌─────────────────────┐**
- Sinatra Server    │
- ┤
- Routes (app.rb)   │
- View Engine (ERB) │
- Static Assets     │
- ┘

Core Logic Layer (Yellow):
**┌─────────────────────┐**
- Diceware Service   │
- ┤
- Passphrase        │
- Generation        │
- Word List Access  │
- ┘

##### Flow Indicators

- HTTP requests from client to server
- Data flow between components
- Dependencies between layers

##### Technical Details to Highlight

- Rack-based architecture (config.ru)
- Static file serving configuration
- Test suite integration (test directory)
- Asset organization (public directory structure)

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        Browser["Web Browser"]:::client
        CSS["CSS Styling"]:::client
        JS["JavaScript Components"]:::client
        Browser --> CSS
        Browser --> JS
    end

    subgraph "Web Application Layer"
        SinatraServer["Sinatra Web Server"]:::server
        RackConfig["Rack Configuration"]:::server
        ViewEngine["Views Engine"]:::server
        StaticAssets["Static Asset Handler"]:::server
        
        SinatraServer --> ViewEngine
        SinatraServer --> StaticAssets
        RackConfig --> SinatraServer
    end

    subgraph "Core Logic Layer"
        AppLogic["Application Logic"]:::core
        DicewareGem["Diceware Gem"]:::external
        TestSuite["Test Suite"]:::testing
        TestHelper["Test Helper"]:::testing
        
        AppLogic --> DicewareGem
        TestSuite --> TestHelper
        TestSuite --> AppLogic
    end

    Browser --> SinatraServer
    SinatraServer --> AppLogic
    StaticAssets --> CSS
    StaticAssets --> JS

    classDef client fill:#a8d1f0,stroke:#333,stroke-width:2px
    classDef server fill:#90EE90,stroke:#333,stroke-width:2px
    classDef core fill:#FFE5B4,stroke:#333,stroke-width:2px
    classDef external fill:#D3D3D3,stroke:#333,stroke-width:2px
    classDef testing fill:#FFA07A,stroke:#333,stroke-width:2px

    click SinatraServer "https://github.com/dennis1088/diceware-web/blob/master/app.rb"
    click RackConfig "https://github.com/dennis1088/diceware-web/blob/master/config.ru"
    click ViewEngine "https://github.com/dennis1088/diceware-web/blob/master/views/index.erb"
    click StaticAssets "https://github.com/dennis1088/diceware-web/tree/master/public/"
    click AppLogic "https://github.com/dennis1088/diceware-web/blob/master/app.rb"
    click TestSuite "https://github.com/dennis1088/diceware-web/blob/master/test/diceware_test.rb"
    click JS "https://github.com/dennis1088/diceware-web/blob/master/public/js/main.js"
    click CSS "https://github.com/dennis1088/diceware-web/blob/master/public/css/main.css"
    click TestHelper "https://github.com/dennis1088/diceware-web/blob/master/test/test_helper.rb"

    subgraph Legend
        Client_["Client Component"]:::client
        Server_["Server Component"]:::server
        Core_["Core Logic"]:::core
        External_["External Dependency"]:::external
        Testing_["Testing Component"]:::testing
    end
```
