# mini-bomba/dearrowbrowser architecture

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

- Interactive diagram: https://gitdiagram.com/mini-bomba/dearrowbrowser
- Repository: https://github.com/mini-bomba/dearrowbrowser

## Overview

##### Main Components Identification

a. Core Components:
- dearrow-parser: Data parsing layer
- dearrow-browser-server: Backend server
- dearrow-browser-api: API definitions layer
- dearrow-browser-frontend: Frontend application

**[External Data Sources] → [Backend Layer] → [Frontend Layer]**

##### Specific Implementation Details

- Rounded rectangles for modules
- Hexagons for external services/data

- Blue: Frontend components
- Green: Backend services
- Yellow: Data storage
- Gray: External services
- Purple: API/Interface layers

##### Component Relationships

Key interactions:
**[CSV Files] → [dearrow-parser] → [dearrow-browser-server]**
- ↓
- [dearrow-browser-api]
- ↓
- [dearrow-browser-frontend]

##### Detailed Subcomponents

Frontend (dearrow-browser-frontend):
- Components system
- Pages routing
- Thumbnail processing
- Worker architecture
- State management

Backend (dearrow-browser-server):
- API endpoints
- Middleware stack
- SponsorBlock emulation
- Database management

##### External Integrations
- Connection to original DeArrow service
- SponsorBlockServer emulation endpoints
- InnerTube integration

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles and classes
    classDef external fill:#gray,stroke:#333
    classDef frontend fill:#blue,stroke:#333
    classDef backend fill:#green,stroke:#333
    classDef data fill:#yellow,stroke:#333
    classDef api fill:#purple,stroke:#333

    %% External Data Sources
    CSV[("DeArrow Database\n(.csv files)")]:::data
    SB["SponsorBlock\nService"]:::external
    IT["InnerTube\nService"]:::external

    %% Backend Layer
    subgraph Backend
        Parser["Parser Module"]:::backend
        Server["Server Core"]:::backend
        API["API Definitions"]:::api
        
        subgraph ServerComponents
            Routes["Routes"]:::backend
            Middleware["Middleware"]:::backend
            State["State Management"]:::backend
            ITIntegration["InnerTube\nIntegration"]:::backend
            SBEmulation["SponsorBlock\nEmulation"]:::backend
        end
    end

    %% Frontend Layer
    subgraph Frontend
        FrontCore["Frontend Core"]:::frontend
        
        subgraph FrontendComponents
            Components["Components"]:::frontend
            Pages["Pages"]:::frontend
            Thumbnails["Thumbnail\nProcessing"]:::frontend
            Workers["Worker\nArchitecture"]:::frontend
            FrontState["State\nManagement"]:::frontend
            FrontIT["InnerTube\nIntegration"]:::frontend
            FrontSB["SponsorBlock\nIntegration"]:::frontend
        end
    end

    %% Relationships
    CSV --> Parser
    Parser --> Server
    Server --> API
    API --> FrontCore
    
    Server --> Routes
    Server --> Middleware
    Server --> State
    Server --> ITIntegration
    Server --> SBEmulation
    
    ITIntegration --> IT
    SBEmulation --> SB
    
    FrontCore --> Components
    FrontCore --> Pages
    FrontCore --> Thumbnails
    FrontCore --> Workers
    FrontCore --> FrontState
    FrontCore --> FrontIT
    FrontCore --> FrontSB
    
    FrontIT --> IT
    FrontSB --> SB

    %% Click events
    click Parser "https://github.com/mini-bomba/DeArrowBrowser/blob/master/dearrow-parser/src/lib.rs"
    click API "https://github.com/mini-bomba/DeArrowBrowser/blob/master/dearrow-browser-api/src/api.rs"
    click Server "https://github.com/mini-bomba/DeArrowBrowser/blob/master/dearrow-browser-server/src/main.rs"
    click Routes "https://github.com/mini-bomba/DeArrowBrowser/blob/master/dearrow-browser-server/src/routes.rs"
    click Middleware "https://github.com/mini-bomba/DeArrowBrowser/tree/master/dearrow-browser-server/src/middleware/"
    click State "https://github.com/mini-bomba/DeArrowBrowser/blob/master/dearrow-browser-server/src/state.rs"
    click ITIntegration "https://github.com/mini-bomba/DeArrowBrowser/blob/master/dearrow-browser-server/src/innertube.rs"
    click SBEmulation "https://github.com/mini-bomba/DeArrowBrowser/blob/master/dearrow-browser-server/src/sbserver_emulation.rs"
    click FrontCore "https://github.com/mini-bomba/DeArrowBrowser/blob/master/dearrow-browser-frontend/src/main.rs"
    click Components "https://github.com/mini-bomba/DeArrowBrowser/tree/master/dearrow-browser-frontend/src/components/"
    click Pages "https://github.com/mini-bomba/DeArrowBrowser/tree/master/dearrow-browser-frontend/src/pages/"
    click Thumbnails "https://github.com/mini-bomba/DeArrowBrowser/tree/master/dearrow-browser-frontend/src/thumbnails/"
    click Workers "https://github.com/mini-bomba/DeArrowBrowser/blob/master/dearrow-browser-frontend/src/thumbnails/worker.rs"
    click FrontState "https://github.com/mini-bomba/DeArrowBrowser/blob/master/dearrow-browser-frontend/src/contexts.rs"
    click FrontIT "https://github.com/mini-bomba/DeArrowBrowser/blob/master/dearrow-browser-frontend/src/innertube.rs"
    click FrontSB "https://github.com/mini-bomba/DeArrowBrowser/blob/master/dearrow-browser-frontend/src/sbserver.rs"
```
