# mrihsann/sales-tracking architecture

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

- Interactive diagram: https://gitdiagram.com/mrihsann/sales-tracking
- Repository: https://github.com/mrihsann/sales-tracking

## Overview

##### Project type and purpose
- This is a native Android mobile application named “Sales Tracking.”
- It follows a “Clean Architecture” (or layered) approach with MVVM and Jetpack Compose for UI.
- Its purpose is to let sales teams track orders, products, and performance metrics offline via Room database.

##### File structure
- Top-level files: gradle scripts, settings, wrapper, README.
- app/src/main/java/com/ihsanarslan/salestracking contains these key packages:
- data – Entities, Room DAOs, STDatabase (local persistence)
- domain – DTOs, repository interfaces & implementations, and use-case classes grouped by feature (order / product)
- presentation – MVVM ViewModels + Composable Screens (Home, OrderList, ProductList, Analysis) and their UI components
- navigation – NavigationGraph & Router for Compose navigation
- di – AppModule.kt for dependency injection
- ui/theme & util – theming, Resource wrapper, app entry (StApplication.kt), MainActivity.kt

##### README for additional insights
- Confirms a small/medium business focus and that it’s designed for offline-first, local data tracking.

##### Elements
- Clear labels: “Composable Screens,” “ViewModels,” “UseCases,” “Repositories,” “Room DAOs,” “STDatabase”
- Green for domain/use-case
- Orange for data/DAO/DB
- Gray for Android framework

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Android Framework
    subgraph "Android Framework"
        AF1["MainActivity"]:::androidfw
        AF2["StApplication"]:::androidfw
    end

    %% UI Layer
    subgraph "UI Layer"
        direction TB
        UI1["NavigationGraph"]:::ui
        UI2["Router"]:::ui

        subgraph "Screens & ViewModels"
            direction TB
            HS["HomeScreen"]:::ui
            HV["HomeViewModel"]:::ui
            OLS["OrderListScreen"]:::ui
            OLV["OrderListViewModel"]:::ui
            PLS["ProductListScreen"]:::ui
            PLV["ProductListViewModel"]:::ui
            AS["AnalysisScreen"]:::ui
            AV["AnalysisViewModel"]:::ui
        end
    end

    %% Domain Layer
    subgraph "Domain Layer"
        direction TB
        UC["UseCases"]:::domain
        RI["Repository Interfaces"]:::domain
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        subgraph "Repository Implementations"
            RIO["OrderDaoImpl"]:::data
            RIP["ProductDaoImpl"]:::data
        end
        subgraph "DAOs"
            OD["OrderDao"]:::data
            PD["ProductDao"]:::data
        end
        subgraph "Entities"
            E1["OrderEntity"]:::data
            E2["ProductEntity"]:::data
            E3["OrderProductCrossRefEntity"]:::data
        end
        DB["STDatabase"]:::data
    end

    %% External Persistence
    SQLite["SQLite File"]:::external

    %% Connections
    AF1 --> UI1
    AF1 --> AF2

    UI1 --> UI2
    UI2 --> HS
    UI2 --> OLS
    UI2 --> PLS
    UI2 --> AS

    HS <--> HV
    OLS <--> OLV
    PLS <--> PLV
    AS <--> AV

    HV --> UC
    OLV --> UC
    PLV --> UC
    AV --> UC

    UC --> RI
    RI --> RIO
    RI --> RIP

    RIO --> OD
    RIP --> PD

    OD --> DB
    PD --> DB

    DB --> SQLite

    %% Click Events
    click AF1 "https://github.com/mrihsann/sales-tracking/blob/master/app/src/main/java/com/ihsanarslan/salestracking/MainActivity.kt"
    click AF2 "https://github.com/mrihsann/sales-tracking/blob/master/app/src/main/java/com/ihsanarslan/salestracking/StApplication.kt"

    click UI1 "https://github.com/mrihsann/sales-tracking/blob/master/app/src/main/java/com/ihsanarslan/salestracking/navigation/NavigationGraph.kt"
    click UI2 "https://github.com/mrihsann/sales-tracking/blob/master/app/src/main/java/com/ihsanarslan/salestracking/navigation/Router.kt"

    click HS "https://github.com/mrihsann/sales-tracking/blob/master/app/src/main/java/com/ihsanarslan/salestracking/presentation/home/HomeScreen.kt"
    click HV "https://github.com/mrihsann/sales-tracking/blob/master/app/src/main/java/com/ihsanarslan/salestracking/presentation/home/HomeViewModel.kt"

    click OLS "https://github.com/mrihsann/sales-tracking/blob/master/app/src/main/java/com/ihsanarslan/salestracking/presentation/order_list/OrderListScreen.kt"
    click OLV "https://github.com/mrihsann/sales-tracking/blob/master/app/src/main/java/com/ihsanarslan/salestracking/presentation/order_list/OrderListViewModel.kt"

    click PLS "https://github.com/mrihsann/sales-tracking/blob/master/app/src/main/java/com/ihsanarslan/salestracking/presentation/product_list/ProductListScreen.kt"
    click PLV "https://github.com/mrihsann/sales-tracking/blob/master/app/src/main/java/com/ihsanarslan/salestracking/presentation/product_list/ProductListViewModel.kt"

    click AS "https://github.com/mrihsann/sales-tracking/blob/master/app/src/main/java/com/ihsanarslan/salestracking/presentation/analysis/AnalysisScreen.kt"
    click AV "https://github.com/mrihsann/sales-tracking/blob/master/app/src/main/java/com/ihsanarslan/salestracking/presentation/analysis/AnalysisViewModel.kt"

    click RIO "https://github.com/mrihsann/sales-tracking/blob/master/app/src/main/java/com/ihsanarslan/salestracking/domain/repository/OrderDaoImpl.kt"
    click RIP "https://github.com/mrihsann/sales-tracking/blob/master/app/src/main/java/com/ihsanarslan/salestracking/domain/repository/ProductDaoImpl.kt"

    click DB "https://github.com/mrihsann/sales-tracking/blob/master/app/src/main/java/com/ihsanarslan/salestracking/data/local/database/STDatabase.kt"

    click OD "https://github.com/mrihsann/sales-tracking/blob/master/app/src/main/java/com/ihsanarslan/salestracking/data/local/database/dao/OrderDao.kt"
    click PD "https://github.com/mrihsann/sales-tracking/blob/master/app/src/main/java/com/ihsanarslan/salestracking/data/local/database/dao/ProductDao.kt"

    %% Styles
    classDef androidfw fill:#cccccc,stroke:#333,stroke-width:1px
    classDef ui fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef domain fill:#90EE90,stroke:#333,stroke-width:1px
    classDef data fill:#FFA500,stroke:#333,stroke-width:1px
    classDef external fill:#F5F5F5,stroke:#333,stroke-width:1px
```
