# yangdiansheng/ymusic architecture

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

- Interactive diagram: https://gitdiagram.com/yangdiansheng/ymusic
- Repository: https://github.com/yangdiansheng/ymusic

## Overview

##### Project type and purpose
- This is a multi-module Android client application called “YMusic.”
- It exposes a music streaming UI (Activities, Fragments) that interacts with audio playback, network requests, image loading, sharing, update checks, QR scanning, etc.
- The root project uses Gradle and is composed of one “app” module plus nine feature/support libraries (lib_audio, lib_network, lib_common_ui, lib_imageloader, lib_video, lib_webview, lib_share, lib_update, lib_pullalive, lib_qrcode).

##### File structure
- Top-level modules:
- app/ – the main Android application (UI layer, business-logic glue, RequestCenter, mock API)
- lib_* – independent Android libraries each providing a single concern:
– lib_network: HTTP client, request/response handlers
– lib_audio: background music service, playback controls
– lib_common_ui: shared UI components (base activities, custom views)
– lib_imageloader: image loading/ caching manager
– lib_video: video playback helpers
– lib_webview: embedded WebView utilities
– lib_share: social/share integration
– lib_update: app update checker/downloader
– lib_pullalive: keep-alive/background tasks
– lib_qrcode: QR code scanning utilities
- app/src/main/java/com/yangdiansheng/music:
- api/MockData and RequestCenter: data access entry point
- view/: Activities and Fragments for home, login, discovery, friend, mine
- MApplication: global application subclass
- BaseModel: shared data model base class
- Gradle config files (build.gradle, settings.gradle) wire dependencies between modules.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        App["App Module"]:::coreapp
        HomeActivity["HomeActivity"]:::coreapp
        DiscoryFragment["DiscoryFragment"]:::coreapp
        FriendFragment["FriendFragment"]:::coreapp
        MineFragment["MineFragment"]:::coreapp
        LoginActivity["LoginActivity"]:::coreapp
        TestOneActivity["TestOneActivity"]:::coreapp
        TestTwoActivity["TestTwoActivity"]:::coreapp
    end

    %% Business Logic & Application Layer
    subgraph "Business Logic & Application"
        direction TB
        MApplication["MApplication"]:::coreapp
        BaseModel["BaseModel"]:::coreapp
        UserManager["UserManager"]:::coreapp
    end

    %% Data Layer & Network
    subgraph "Data Layer & Network"
        direction TB
        RequestCenter["RequestCenter"]:::coreapp
        MockData["MockData"]:::coreapp
        lib_network["lib_network\n(OkHttp Client & Callbacks)"]:::support
    end

    %% Media & Utility Libraries
    subgraph "Media & Utility Libraries"
        direction TB
        lib_audio["lib_audio\n(Audio Service & Controls)"]:::support
        lib_common_ui["lib_common_ui\n(Shared UI Components)"]:::support
        lib_imageloader["lib_imageloader\n(ImageLoaderManager)"]:::support
        lib_video["lib_video\n(Video Helpers)"]:::support
        lib_webview["lib_webview\n(WebView Utilities)"]:::support
        lib_share["lib_share\n(Share Integration)"]:::support
        lib_update["lib_update\n(Update Checker)"]:::support
        lib_pullalive["lib_pullalive\n(Keep-Alive Tasks)"]:::support
        lib_qrcode["lib_qrcode\n(QR Code Scanning)"]:::support
    end

    %% External Systems
    Server[(Backend Server)]:::external
    Social[(Social Platforms)]:::external

    %% Dependencies
    App -->|depends on| lib_network
    App -->|depends on| lib_audio
    App -->|depends on| lib_common_ui
    App -->|depends on| lib_imageloader
    App -->|depends on| lib_video
    App -->|depends on| lib_webview
    App -->|depends on| lib_share
    App -->|depends on| lib_update
    App -->|depends on| lib_pullalive
    App -->|depends on| lib_qrcode

    HomeActivity -->|uses| MApplication
    DiscoryFragment -->|uses| MApplication
    FriendFragment -->|uses| MApplication
    MineFragment -->|uses| MApplication
    LoginActivity -->|uses| UserManager
    TestOneActivity -->|uses| MApplication
    TestTwoActivity -->|uses| MApplication

    MApplication -->|initializes| BaseModel
    BaseModel -->|calls| RequestCenter
    UserManager -->|calls| RequestCenter

    RequestCenter -->|fetches mock| MockData
    RequestCenter -->|calls| lib_network
    lib_network -->|HTTP calls| Server

    HomeActivity -->|plays audio| lib_audio
    HomeActivity -->|loads image| lib_imageloader
    HomeActivity -->|plays video| lib_video
    HomeActivity -->|opens web| lib_webview
    HomeActivity -->|shares content| lib_share
    HomeActivity -->|checks update| lib_update
    HomeActivity -->|background keep-alive| lib_pullalive
    HomeActivity -->|scans QR| lib_qrcode

    lib_share -->|external share| Social
    lib_update -->|update server| Server
    lib_pullalive -->|heartbeat| Server
    lib_qrcode -->|scan API| Server

    %% Click Events
    click App "https://github.com/yangdiansheng/ymusic/tree/master/app/"
    click HomeActivity "https://github.com/yangdiansheng/ymusic/blob/master/app/src/main/java/com/yangdiansheng/music/view/home/HomeActivity.java"
    click DiscoryFragment "https://github.com/yangdiansheng/ymusic/blob/master/app/src/main/java/com/yangdiansheng/music/view/discory/DiscoryFragment.java"
    click FriendFragment "https://github.com/yangdiansheng/ymusic/blob/master/app/src/main/java/com/yangdiansheng/music/view/friend/FriendFragment.java"
    click MineFragment "https://github.com/yangdiansheng/ymusic/blob/master/app/src/main/java/com/yangdiansheng/music/view/mine/MineFragment.java"
    click LoginActivity "https://github.com/yangdiansheng/ymusic/blob/master/app/src/main/java/com/yangdiansheng/music/view/login/LoginActivity.java"
    click TestOneActivity "https://github.com/yangdiansheng/ymusic/blob/master/app/src/main/java/com/yangdiansheng/music/test/TestOneActivity.kt"
    click TestTwoActivity "https://github.com/yangdiansheng/ymusic/blob/master/app/src/main/java/com/yangdiansheng/music/test/TestTwoActivity.kt"
    click MApplication "https://github.com/yangdiansheng/ymusic/blob/master/app/src/main/java/com/yangdiansheng/music/MApplication.java"
    click BaseModel "https://github.com/yangdiansheng/ymusic/blob/master/app/src/main/java/com/yangdiansheng/music/view/BaseModel.java"
    click UserManager "https://github.com/yangdiansheng/ymusic/blob/master/app/src/main/java/com/yangdiansheng/music/view/login/manager/UserManager.java"
    click RequestCenter "https://github.com/yangdiansheng/ymusic/blob/master/app/src/main/java/com/yangdiansheng/music/api/RequestCenter.java"
    click MockData "https://github.com/yangdiansheng/ymusic/blob/master/app/src/main/java/com/yangdiansheng/music/api/MockData.java"
    click lib_network "https://github.com/yangdiansheng/ymusic/tree/master/lib_network/src/main/java/com/yangdiansheng/lib_network/"
    click lib_audio "https://github.com/yangdiansheng/ymusic/tree/master/lib_audio/"
    click lib_common_ui "https://github.com/yangdiansheng/ymusic/tree/master/lib_common_ui/"
    click lib_imageloader "https://github.com/yangdiansheng/ymusic/tree/master/lib_imageloader/"
    click lib_video "https://github.com/yangdiansheng/ymusic/tree/master/lib_video/"
    click lib_webview "https://github.com/yangdiansheng/ymusic/tree/master/lib_webview/"
    click lib_share "https://github.com/yangdiansheng/ymusic/tree/master/lib_share/"
    click lib_update "https://github.com/yangdiansheng/ymusic/tree/master/lib_update/"
    click lib_pullalive "https://github.com/yangdiansheng/ymusic/tree/master/lib_pullalive/"
    click lib_qrcode "https://github.com/yangdiansheng/ymusic/tree/master/lib_qrcode/"

    %% Styles
    classDef coreapp fill:#E3F2FD,stroke:#1E88E5,color:#0D47A1
    classDef support fill:#E8F5E9,stroke:#43A047,color:#1B5E20
    classDef external fill:#FFEBEE,stroke:#E53935,color:#B71C1C
```
