# awgeezrick/books_i_have_read architecture

> Architecture diagram of the GitHub repository awgeezrick/books_i_have_read, 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/awgeezrick/books_i_have_read
- Repository: https://github.com/awgeezrick/books_i_have_read

## Overview

##### High-Level Architecture Components

a. Data Layer:

##### Jupyter Notebook Branch
- Connection to HTML export capability

##### Web Interface Branch
- Three connected components: HTML, CSS, and JavaScript

##### Component Relationships

- Data flow from JSON storage to both presentation layers
- Conversion path from Notebook to HTML
- Integration between web components (HTML, CSS, JS)

##### Yearly Implementation

- How each year (2019-2024) implements the same pattern

##### Technical Details

For each component, add annotations showing:
- File types (.json, .ipynb, .html, .css, .js)
- Data flow direction
- Export/conversion processes

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Legend
        L1[Web Component]:::web
        L2[Notebook Component]:::notebook
        L3[(Data Store)]:::data
        L4[".ipynb → .html"]:::conversion
    end

    subgraph YearlyImplementation["Yearly Implementation (2019-2024)"]
        DataStore[(JSON Data Store)]:::data
        click DataStore "https://github.com/awgeezrick/books_i_have_read/blob/main/2024/notebook_version/book_data.json"

        subgraph NotebookBranch["Notebook Format"]
            JupyterNotebook[Jupyter Notebook]:::notebook
            click JupyterNotebook "https://github.com/awgeezrick/books_i_have_read/blob/main/2024/notebook_version/books_i_have_read_2024.ipynb"
            NotebookHTML[Exported HTML]:::notebook
            click NotebookHTML "https://github.com/awgeezrick/books_i_have_read/blob/main/2024/notebook_version/books_i_have_read_2024.html"
            Conversion[".ipynb → .html"]:::conversion
        end

        subgraph WebBranch["Web Format"]
            HTML[HTML Interface]:::web
            click HTML "https://github.com/awgeezrick/books_i_have_read/blob/main/2024/web_page_version/index.html"
            CSS[CSS Styling]:::web
            click CSS "https://github.com/awgeezrick/books_i_have_read/blob/main/2024/web_page_version/style.css"
            JavaScript[JavaScript Logic]:::web
            click JavaScript "https://github.com/awgeezrick/books_i_have_read/blob/main/2024/web_page_version/script.js"
        end

        %% Relationships
        DataStore --> JupyterNotebook
        DataStore --> HTML
        JupyterNotebook --> Conversion
        Conversion --> NotebookHTML
        HTML --- CSS
        HTML --- JavaScript
        JavaScript --- CSS
    end

    %% Style Definitions
    classDef web fill:#90EE90,stroke:#333,stroke-width:2px
    classDef notebook fill:#DDA0DD,stroke:#333,stroke-width:2px
    classDef data fill:#ADD8E6,stroke:#333,stroke-width:2px
    classDef conversion fill:#FFE4B5,stroke:#333,stroke-width:2px

    %% Year Directory Click Events
    click YearlyImplementation "https://github.com/awgeezrick/books_i_have_read/tree/main/2024/"
```
