# rangasaideekshithg-crypto/red-bus-chrome-extension architecture

> Architecture diagram of the GitHub repository rangasaideekshithg-crypto/red-bus-chrome-extension, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rangasaideekshithg-crypto/red-bus-chrome-extension
- Repository: https://github.com/rangasaideekshithg-crypto/red-bus-chrome-extension

## Overview

RedBus Smart Assistant is a Chrome extension for inspecting live RedBus listings and helping users compare buses, get recommendations, track fares, and ask travel questions. The documented route workflow uses a side-panel route picker, but live results come only from the selected RedBus route page; the supplied CSV is sample picker data, not inventory. The README also documents an OpenRouter-backed assistant, fare alerts, and optional voice controls. The provided tree contains no implementation source, so subsystem paths and several internal connections cannot be verified.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_extension["Extension experience"]
  node_sidepanel["Side panel"]
  node_routepicker["Route picker"]
  node_voice["Voice controls"]
end

subgraph group_travel["Travel features"]
  node_extractor["Listing extraction"]
  node_comparison["Bus comparison"]
  node_recommendations["Recommendations"]
  node_samplecsv["Sample route data"]
  node_faretracking["Fare history and alerts"]
  node_assistant["Travel assistant"]
end

subgraph group_backend["Backend and storage"]
  node_backend["Backend"]
  node_sqlite[("SQLite")]
end

node_user(("Traveler"))
node_redbuspage["RedBus route page"]
node_mysql[("MySQL")]
node_openrouter["OpenRouter"]

node_user -->|"uses"| node_sidepanel
node_sidepanel -->|"offers"| node_routepicker
node_routepicker -->|"lists routes"| node_samplecsv
node_redbuspage -->|"provides listings"| node_extractor
node_extractor -.->|"supplies results"| node_comparison
node_extractor -.->|"supplies results"| node_recommendations
node_user -.->|"asks questions"| node_assistant
node_assistant -.->|"uses"| node_openrouter
node_user -.->|"uses"| node_faretracking
node_user -.->|"uses"| node_voice
node_backend -->|"uses by default"| node_sqlite
node_backend -->|"configurable for"| node_mysql

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_sidepanel,node_routepicker,node_voice toneBlue
class node_extractor,node_comparison,node_recommendations,node_samplecsv,node_faretracking,node_assistant,node_mysql toneAmber
class node_backend,node_sqlite,node_redbuspage,node_openrouter toneMint
class node_user toneIndigo
```

## Components

### Extension experience

- **Side panel**
- **Route picker**
- **Voice controls**

### Travel features

- **Listing extraction**
- **Bus comparison**
- **Recommendations**
- **Sample route data**
- **Fare history and alerts**
- **Travel assistant**

### Backend and storage

- **Backend**
- **SQLite**

### Other components

- **Traveler**
- **RedBus route page**
- **MySQL**
- **OpenRouter**

## Connections

- Traveler → Side panel: uses (evidence: `README.md`)
- Side panel → Route picker: offers (evidence: `README.md`)
- Route picker → Sample route data: lists routes (evidence: `README.md`)
- RedBus route page → Listing extraction: provides listings (evidence: `README.md`)
- Listing extraction → Bus comparison: supplies results
- Listing extraction → Recommendations: supplies results
- Traveler → Travel assistant: asks questions
- Travel assistant → OpenRouter: uses
- Traveler → Fare history and alerts: uses
- Traveler → Voice controls: uses
- Backend → SQLite: uses by default (evidence: `README.md`)
- Backend → MySQL: configurable for (evidence: `README.md`)
