# biliticket/bili_ticket_rush architecture

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

- Interactive diagram: https://gitdiagram.com/biliticket/bili_ticket_rush
- Repository: https://github.com/biliticket/bili_ticket_rush

## Overview

##### Project type and purpose
- From the root Cargo.toml plus three sub-crates (“backend”, “common”, “frontend”) and the README (“bili_ticket_gui: A GUI based rust for Bilibili mall ticket”), we see this is a desktop GUI application with a split between a GUI client (frontend) and a local API server (backend), both sharing core logic in a common library. Its purpose is to let users log in, monitor and grab Bilibili mall tickets, show order lists, manage tasks, and push notifications.

##### File structure
- Top-level:
- .github/ — CI workflows
- Cargo.toml — workspace definition
- backend/ — local API server crate
- common/ — shared domain logic crate
- frontend/ — GUI application crate
- “common” contains modules for HTTP utilities, cookie management, captcha, login flows, push notifications, record logging, order‐listing, task manager, ticket operations.
- “backend” exposes REST-style endpoints (api.rs) that invoke common’s show_orderlist and taskmanager.
- “frontend” contains GUI code (app.rs, main.rs) with UI components (tabs, windows for login, ticket grabbing, order list, settings, etc.), likely using a Rust GUI framework.

##### README for additional insights
- README is minimal but confirms: a Rust-based GUI for Bilibili mall ticket grabbing. No database present—state/logs likely written to file via common::record_log.

a. Main components
- User’s Desktop (User interacts via GUI)
- Frontend GUI application (Rust executable)
- Backend API server (Rust executable spawning local HTTP endpoints)
- Common library (Rust crate with core logic)
- External services:
– Bilibili Mall HTTP APIs (login, fetch tickets, captcha)
– Optional push notification endpoints (e.g. via common::push)
– Selenium (for automated login flows, invoked in login_selenium.rs)
b. Relationships & data flow
1. User clicks buttons in the GUI → frontend issues HTTP calls (or direct function calls) to backend API.
2. Backend handlers (api.rs) call into common:: modules (login, show_orderlist, taskmanager).
3. common::http_utils communicates over the network with Bilibili Mall endpoints (login, fetch/snap ticket data).
4. Responses bubble back: common → backend → frontend → GUI/User.
5. common::push may send out notifications via external push services.
6. common::record_log logs events to local storage.
7. Optional: frontend may launch Selenium-based browser sessions for complex logins (login_selenium.rs).
c. Architectural patterns & design principles
– Modular crates: clear separation of concerns (UI vs API vs domain logic).
– Client-Server pattern (within the same machine) between frontend and backend.
– Layered approach: UI layer → API layer → domain & infra layer → external services.
– Reuse via a shared library (common).
d. Key technologies/frameworks
– Rust/cargo workspace
– HTTP server library in backend (e.g., warp, actix-web—inspect Cargo.toml)
– Rust GUI toolkit in frontend (possibly iced or egui)
– Selenium binding for Rust (login_selenium.rs)
– External HTTP calls (reqwest or hyper) in common::http_utils

##### Callouts for essential details
- Don’t forget:
- The shared common crate is at the heart—everything funnels logic through it.
- GUI windows (login, grab_ticket, show_orderlist) correspond to specific API endpoints and common logic modules.
- Selenium integration is a special path—show it explicitly if login automation is critical.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% User
    User["User/Desktop"]:::external

    subgraph "Local Deployment"
        direction TB

        subgraph "Frontend (GUI Application)"
            direction TB
            FrontMain["frontend/src/main.rs"]:::frontend
            FrontApp["frontend/src/app.rs"]:::frontend
            FrontUI["UI Components (src/ui/)"]:::frontend
            FrontTabs["Tabs (src/ui/tabs/)"]:::frontend
            FrontWindows["Windows & Dialogs (src/windows/)"]:::frontend
        end

        subgraph "Backend (Local API Server)"
            direction TB
            BackendLib["backend/src/lib.rs"]:::backend
            API["backend/src/api.rs"]:::backend
            ShowOrderBE["backend/src/show_orderlist.rs"]:::backend
            TaskManagerBE["backend/src/taskmanager.rs"]:::backend
        end

        subgraph "Common Library (Shared Logic)"
            direction TB
            CommonLib["common/src/lib.rs"]:::common
            Account["common/src/account.rs"]:::common
            Login["common/src/login.rs"]:::common
            CookieMgr["common/src/cookie_manager.rs"]:::common
            Captcha["common/src/captcha.rs"]:::common
            HTTPUtils["common/src/http_utils.rs"]:::common
            ShowOrderCL["common/src/show_orderlist.rs"]:::common
            TaskManagerCL["common/src/taskmanager.rs"]:::common
            Ticket["common/src/ticket.rs"]:::common
            Push["common/src/push.rs"]:::common
            RecordLog["common/src/record_log.rs"]:::common
            Utility["common/src/utility.rs"]:::common
            Utils["common/src/utils.rs"]:::common
        end
    end

    %% External services
    BiliAPI["Bilibili Mall HTTP API"]:::external
    PushService["Push Notification Service"]:::external
    Selenium["Selenium (login_selenium.rs)"]:::selenium

    %% Connections
    User -->|"interact via GUI"| FrontMain
    FrontMain -->|"invokes"| FrontApp
    FrontApp -->|"renders UI"| FrontUI
    FrontApp -->|"loads Tabs"| FrontTabs
    FrontApp -->|"opens Windows"| FrontWindows

    FrontWindows -->|"calls HTTP/JSON"| API
    API -->|"calls functions"| CommonLib
    API -->|"show orderlist"| ShowOrderCL
    API -->|"manage tasks"| TaskManagerCL

    CommonLib --> Account
    CommonLib --> Login
    CommonLib --> CookieMgr
    CommonLib --> Captcha
    CommonLib --> HTTPUtils
    CommonLib --> Ticket
    CommonLib --> Utility
    CommonLib --> Utils

    Login --> Selenium
    HTTPUtils --> BiliAPI
    ShowOrderCL --> BiliAPI
    TaskManagerCL --> BiliAPI

    CommonLib --> RecordLog
    Push --> PushService
    CommonLib --> Push

    %% Click Events Frontend
    click FrontMain "https://github.com/biliticket/bili_ticket_rush/blob/main/frontend/src/main.rs"
    click FrontApp "https://github.com/biliticket/bili_ticket_rush/blob/main/frontend/src/app.rs"
    click FrontUI "https://github.com/biliticket/bili_ticket_rush/tree/main/frontend/src/ui/"
    click FrontTabs "https://github.com/biliticket/bili_ticket_rush/tree/main/frontend/src/ui/tabs/"
    click FrontWindows "https://github.com/biliticket/bili_ticket_rush/tree/main/frontend/src/windows/"

    %% Click Events Backend
    click BackendLib "https://github.com/biliticket/bili_ticket_rush/blob/main/backend/src/lib.rs"
    click API "https://github.com/biliticket/bili_ticket_rush/blob/main/backend/src/api.rs"
    click ShowOrderBE "https://github.com/biliticket/bili_ticket_rush/blob/main/backend/src/show_orderlist.rs"
    click TaskManagerBE "https://github.com/biliticket/bili_ticket_rush/blob/main/backend/src/taskmanager.rs"

    %% Click Events Common
    click CommonLib "https://github.com/biliticket/bili_ticket_rush/blob/main/common/src/lib.rs"
    click Account "https://github.com/biliticket/bili_ticket_rush/blob/main/common/src/account.rs"
    click Login "https://github.com/biliticket/bili_ticket_rush/blob/main/common/src/login.rs"
    click CookieMgr "https://github.com/biliticket/bili_ticket_rush/blob/main/common/src/cookie_manager.rs"
    click Captcha "https://github.com/biliticket/bili_ticket_rush/blob/main/common/src/captcha.rs"
    click HTTPUtils "https://github.com/biliticket/bili_ticket_rush/blob/main/common/src/http_utils.rs"
    click ShowOrderCL "https://github.com/biliticket/bili_ticket_rush/blob/main/common/src/show_orderlist.rs"
    click TaskManagerCL "https://github.com/biliticket/bili_ticket_rush/blob/main/common/src/taskmanager.rs"
    click Ticket "https://github.com/biliticket/bili_ticket_rush/blob/main/common/src/ticket.rs"
    click Push "https://github.com/biliticket/bili_ticket_rush/blob/main/common/src/push.rs"
    click RecordLog "https://github.com/biliticket/bili_ticket_rush/blob/main/common/src/record_log.rs"
    click Utility "https://github.com/biliticket/bili_ticket_rush/blob/main/common/src/utility.rs"
    click Utils "https://github.com/biliticket/bili_ticket_rush/blob/main/common/src/utils.rs"

    %% Classes
    classDef frontend fill:#D6EAF8,stroke:#2980B9,color:#154360
    classDef backend fill:#D5F5E3,stroke:#27AE60,color:#145A32
    classDef common fill:#E8DAEF,stroke:#8E44AD,color:#512E5F
    classDef external fill:#F2F3F4,stroke:#7F8C8D,color:#2C3E50
    classDef selenium fill:#FADBD8,stroke:#C0392B,color:#78281F
```
