# bfiliks/intertextuality-network-aa-lit architecture

> Architecture diagram of the GitHub repository bfiliks/intertextuality-network-aa-lit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bfiliks/intertextuality-network-aa-lit
- Repository: https://github.com/bfiliks/intertextuality-network-aa-lit

## Overview

##### Project type and purpose
- This is a **static visualization pipeline** / **static site** project.
- Purpose: take a curated CSV of intertextual connections, run a Python script to generate an interactive Plotly network graph (`interactive.html`), and bundle it with static assets (PDF poster, slide deck, images, index.html) for local viewing or web deployment.

##### File structure
- Top-level files:
- `edges.csv` → data source of book‐to‐book connections
- `build_network.py` → Python script that reads `edges.csv` and outputs the visualization
- `index.html` → landing page or redirector
- `LICENSE`, `README.md` → documentation
- `assets/` directory: static outputs and supporting materials:
- `interactive.html` (generated Plotly graph)
- PDF, PPTX, SVG, PNG poster and QR code
- No “backend” server or database—everything is file‐based.

##### README for additional insights
- The script regenerates `assets/interactive.html` from `edges.csv`.
- Uses Plotly (client‐side JavaScript) for interactivity and theme filters.
- Deployment targets: GitHub Pages, Netlify, Vercel, or Hugging Face Spaces as a static site.

a. Main components:
1. Data Source
- `edges.csv` (CSV file)
2. Processing Engine
- `build_network.py` (Python script + libraries: pandas, plotly)
3. Generated Artifacts
- `assets/interactive.html` (HTML + JS)
- `assets/*.png/.svg/.pdf/.pptx` (static assets)
- `index.html`
4. Hosting Layer
- GitHub Pages / Netlify / Vercel / Static file server
5. Client
- Web Browser rendering HTML/JS
b. Relationships & data flow:
- Static assets and `index.html` are served alongside `interactive.html`
- Hosting layer serves static files to the browser
- Browser fetches `interactive.html`, loads Plotly JS, reads embedded JSON graph data, renders interactive network
c. Architectural patterns & design principles:
- **Batch pipeline**: regenerate on demand via CLI (no live server)
- **Static site architecture**: pre-render assets, serve over CDN or GitHub Pages
- **Separation of concerns**: data (CSV) vs. processing (Python) vs. presentation (HTML/JS)
d. Key technologies:
- Python (pandas, plotly)
- CSV file as data store
- Plotly.js for client-side graph rendering
- GitHub Pages / Netlify static hosting
- Standard web stack: HTML/CSS/JS

##### Final advice
- Be exhaustive in capturing all static files your pipeline depends on (e.g., index.html, poster assets).
- Don’t overcomplicate: break the project into **Data**, **Build**, **Output**, **Hosting**, **Client**.
- Keep it clean: separate offline build steps from online serving steps visually.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Repository Files
    subgraph "Repository Files"
        subgraph "Data"
            edges["edges.csv"]:::data
        end
        subgraph "Processing"
            build["build_network.py"]:::processing
        end
        subgraph "Documentation"
            readme["README.md"]:::infra
            license["LICENSE"]:::infra
        end
    end

    %% Generated Artifacts
    subgraph "Generated Artifacts"
        subgraph assets
            interactive["interactive.html"]:::presentation
            poster["book_level_poster.pdf"]:::presentation
            presentationFile["book_level_presentation.pptx"]:::presentation
        end
        index["index.html"]:::presentation
    end

    %% Hosting Layer
    hosting["Static Hosting (GitHub Pages / Netlify / Vercel)"]:::infra

    %% Client
    browser["Web Browser"]:::client

    %% Data Flow
    edges -->|"reads CSV"| build
    build -->|"generates interactive.html"| interactive
    build -->|"generates static assets"| poster
    build -->|"generates static assets"| presentationFile
    build -->|"outputs landing page"| index

    interactive & poster & presentationFile & index -->|"served as static files"| hosting
    hosting -->|"HTTP GET"| browser
    browser -->|"loads HTML/JS"| interactive

    %% Click Events
    click edges "https://github.com/bfiliks/intertextuality-network-aa-lit/blob/main/edges.csv"
    click build "https://github.com/bfiliks/intertextuality-network-aa-lit/blob/main/build_network.py"
    click interactive "https://github.com/bfiliks/intertextuality-network-aa-lit/blob/main/assets/interactive.html"
    click poster "https://github.com/bfiliks/intertextuality-network-aa-lit/blob/main/assets/book_level_poster.pdf"
    click presentationFile "https://github.com/bfiliks/intertextuality-network-aa-lit/blob/main/assets/book_level_presentation.pptx"
    click index "https://github.com/bfiliks/intertextuality-network-aa-lit/blob/main/index.html"
    click readme "https://github.com/bfiliks/intertextuality-network-aa-lit/blob/main/README.md"
    click license "https://github.com/bfiliks/intertextuality-network-aa-lit/tree/main/LICENSE"
    click assets "https://github.com/bfiliks/intertextuality-network-aa-lit/tree/main/assets/"

    %% Styles
    classDef data fill:#b6e7a7,stroke:#333
    classDef processing fill:#a0c4ff,stroke:#333
    classDef presentation fill:#ffd6a5,stroke:#333
    classDef infra fill:#d3d3d3,stroke:#333
    classDef client fill:#cdb4db,stroke:#333
```
