# giglancer/samplebilling architecture

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

- Interactive diagram: https://gitdiagram.com/giglancer/samplebilling
- Repository: https://github.com/giglancer/samplebilling

## Overview

##### Project type and purpose
- Type: Mobile full-stack (client-only) Android application
- Purpose: Demonstrate in-app billing integration with Google Play Billing Library using clean architecture (UI → ViewModel → Use-Cases → Repositories → Data-Sources → Play Billing Service).

##### File structure
- app/src/main/java/com/samplebillingapp/… breaks down into:
- ui/… (BillingViewModel, UI state, Activity)
- domain/… (models, repository interface, use-cases)
- data/… (billing/datasource wrappers and repository implementation)
- di/… (BillingModule for dependency injection)
- Configuration: build.gradle.kts, proguard, signing keys, release artifacts.
- Tests under androidTest and test.

##### README (minimal)

1. Android App Layer
- MainActivity
- BillingViewModel
2. Domain Layer
- Use-Cases (InitializeBilling, GetProductsUseCase, PurchaseProductUseCase, etc.)
- Models (ProductList, PurchaseUpdate, BillingConnectionState)
- Repository Interface (BillingRepository)
3. Data Layer
- Repository Impl (BillingRepositoryImpl)
- Data Sources
– BillingClientWrapper (wraps GoogleBillingClient)
– ProductDataSource
– PurchaseDataSource
4. External Service
- Google Play Billing Service
5. DI Layer
- BillingModule (provides singletons for client, datasources, repo, use-cases)

1. MainActivity → observes → BillingViewModel
2. BillingViewModel → invokes → Domain Use-Cases
3. Use-Cases → call → BillingRepository interface
4. BillingRepositoryImpl → delegates → Data Sources
5. ProductDataSource & PurchaseDataSource → invoke → BillingClientWrapper
6. BillingClientWrapper → communicates → Google Play Billing Service
7. Updates from service → propagate back ↑ through wrapper → data source → repo → use-case → ViewModel → UI

c. Architectural patterns & principles:
- Clean architecture separation: UI, Domain, Data
- Dependency inversion: UI & Domain depend on abstractions (BillingRepository)
- Single Responsibility: each use-case handles one business action
- DI (via BillingModule) for easy swapping/testing

d. Key technologies/frameworks:
- Android Jetpack (ViewModel)
- Kotlin coroutines/Flow (in domain/use-case layers)
- Google Play Billing Library (inside BillingClientWrapper)
- Koin/Hilt-like DI module (BillingModule.kt)
- Gradle Kotlin DSL (build.gradle.kts)

## Diagram (Mermaid)

```mermaid
graph TB
    %% UI Layer
    subgraph "UI Layer"
        direction TB
        BA["BillingApplication"]:::di
        MA["MainActivity"]:::frontend
        VM["BillingViewModel"]:::frontend
        UIState["BillingUiState"]:::frontend
    end

    %% Domain Layer
    subgraph "Domain Layer"
        direction TB
        RepoIface["BillingRepository"]:::domain
        IC["InitializeBillingUseCase"]:::domain
        GP["GetProductsUseCase"]:::domain
        PP["PurchaseProductUseCase"]:::domain
        GPU["GetPurchasesUseCase"]:::domain
        OPU["ObservePurchaseUpdatesUseCase"]:::domain
        AP["AcknowledgePurchaseUseCase"]:::domain
        CP["ConsumePurchaseUseCase"]:::domain
        M1["BillingConnectionState"]:::domain
        M2["ProductList"]:::domain
        M3["PurchaseUpdate"]:::domain
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        RepoImpl["BillingRepositoryImpl"]:::data
        PDS["ProductDataSource"]:::data
        PuDS["PurchaseDataSource"]:::data
        BCW["BillingClientWrapper"]:::data
    end

    %% Dependency Injection
    subgraph "Dependency Injection"
        direction TB
        BM["BillingModule"]:::di
    end

    %% External Service
    subgraph "External Service"
        direction TB
        GPS["Google Play Billing Service"]:::external
    end

    %% Connections
    BA -->|onCreate| IC
    MA -->|observes| VM

    VM -->|invoke use-case| IC
    VM -->|invoke use-case| GP
    VM -->|invoke use-case| PP
    VM -->|invoke use-case| GPU
    VM -->|invoke use-case| OPU
    VM -->|invoke use-case| AP
    VM -->|invoke use-case| CP

    IC -->|calls| RepoIface
    GP -->|calls| RepoIface
    PP -->|calls| RepoIface
    GPU -->|calls| RepoIface
    OPU -->|calls| RepoIface
    AP -->|calls| RepoIface
    CP -->|calls| RepoIface

    RepoIface -->|implemented by| RepoImpl
    RepoImpl -->|delegates| PDS
    RepoImpl -->|delegates| PuDS
    PDS -->|uses| BCW
    PuDS -->|uses| BCW
    BCW -->|communicates| GPS
    GPS -->|updates| BCW
    BCW -->|streams| PuDS
    PuDS -->|streams| RepoImpl
    RepoImpl -->|streams| OPU
    OPU -->|streams| VM

    BM --> BA
    BM --> VM
    BM --> IC
    BM --> GP
    BM --> PP
    BM --> GPU
    BM --> OPU
    BM --> AP
    BM --> CP
    BM --> RepoImpl
    BM --> PDS
    BM --> PuDS
    BM --> BCW

    %% Click Events
    click MA "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/MainActivity.kt"
    click BA "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/BillingApplication.kt"
    click VM "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/ui/billing/BillingViewModel.kt"
    click UIState "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/ui/billing/state/BillingUiState.kt"
    click RepoIface "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/domain/repository/BillingRepository.kt"
    click IC "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/domain/usecase/InitializeBillingUseCase.kt"
    click GP "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/domain/usecase/GetProductsUseCase.kt"
    click PP "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/domain/usecase/PurchaseProductUseCase.kt"
    click GPU "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/domain/usecase/GetPurchasesUseCase.kt"
    click OPU "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/domain/usecase/ObservePurchaseUpdatesUseCase.kt"
    click AP "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/domain/usecase/AcknowledgePurchaseUseCase.kt"
    click CP "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/domain/usecase/ConsumePurchaseUseCase.kt"
    click M1 "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/domain/model/BillingConnectionState.kt"
    click M2 "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/domain/model/ProductList.kt"
    click M3 "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/domain/model/PurchaseUpdate.kt"
    click RepoImpl "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/data/billing/repository/BillingRepositoryImpl.kt"
    click BCW "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/data/billing/datasource/BillingClientWrapper.kt"
    click PDS "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/data/billing/datasource/ProductDataSource.kt"
    click PuDS "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/data/billing/datasource/PurchaseDataSource.kt"
    click BM "https://github.com/giglancer/samplebilling/blob/main/app/src/main/java/com/samplebillingapp/di/BillingModule.kt"

    %% Styles
    classDef frontend fill:#D0E6FF,stroke:#3B83BD,stroke-width:1px
    classDef domain fill:#DFF5D0,stroke:#5A9D3B,stroke-width:1px
    classDef data fill:#FFE7C1,stroke:#D69A3B,stroke-width:1px
    classDef external fill:#E0E0E0,stroke:#7A7A7A,stroke-width:1px
    classDef di fill:#E2D0FF,stroke:#8C3BBD,stroke-width:1px
```
