# bitcoin-model/bitcoin_model architecture

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

- Interactive diagram: https://gitdiagram.com/bitcoin-model/bitcoin_model
- Repository: https://github.com/bitcoin-model/bitcoin_model

## Overview

##### Main Components

A. User Interface Layer
- Excel Workbook Interface
- Input Forms/Sheets
- Visualization Components (Charts)

B. Model Components
- Macro Forecast Engine (21-year projections)
- Strategy Simulation Modules:
- Individual Model
- Corporate Model
- Institution Model
- Nation State Model
- United States Model

C. Calculation Engine
- VBA Modules (indicated by .xlsm extension)
- Formula Processing
- Scenario Generator

**[User Interface Layer]**
- ↕
**[Model Components]**
- ↕
**[Calculation Engine]**

##### Component Relationships

Following flows:
**User Input → Strategy Models → Calculation Engine → Results Display**

##### Key Elements to Highlight

- Input parameters section
- Five strategy models (Normie, BTC 10%, BTC Maxi, Double Maxi, Triple Maxi)
- 21-year forecasting engine
- Scenario comparison visualization
- Automatic update mechanism
- Assumption adjustment capability

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph UI["User Interface Layer"]
        WB["Excel Workbook Interface"]
        IF["Input Forms/Sheets"]
        VC["Visualization Components"]
    end

    subgraph MC["Model Components"]
        MFE["Macro Forecast Engine<br/>(21-year projections)"]
        
        subgraph SM["Strategy Simulation Modules"]
            IM["Individual Model"]
            CM["Corporate Model"]
            ITM["Institution Model"]
            NSM["Nation State Model"]
            USM["United States Model"]
        end
    end

    subgraph CE["Calculation Engine"]
        VBA["VBA Modules"]
        FP["Formula Processing"]
        SG["Scenario Generator"]
    end

    %% Relationships
    WB --> IF
    IF --> MFE
    MFE --> SM
    SM --> VBA
    VBA --> FP
    FP --> SG
    SG --> VC
    VC --> WB

    %% Click events
    click WB "https://github.com/bitcoin-model/bitcoin_model/blob/main/Bitcoin24 v1.0.xlsm"

    %% Styles
    classDef ui fill:#a8d1ff,stroke:#333,stroke-width:2px
    classDef model fill:#ffd7a8,stroke:#333,stroke-width:2px
    classDef calc fill:#b7ffc2,stroke:#333,stroke-width:2px
    classDef strategy fill:#ffcba8,stroke:#333,stroke-width:2px

    class WB,IF,VC ui
    class MFE,SM model
    class IM,CM,ITM,NSM,USM strategy
    class VBA,FP,SG calc

    %% Legend
    subgraph Legend
        UI_L["User Interface"]:::ui
        MODEL_L["Model Component"]:::model
        CALC_L["Calculation"]:::calc
        STRAT_L["Strategy"]:::strategy
    end
```
