# vaibhavjain30699/expense architecture

> Architecture diagram of the GitHub repository vaibhavjain30699/expense, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vaibhavjain30699/expense
- Repository: https://github.com/vaibhavjain30699/expense

## Overview

Expense is a Kotlin Android tracker. The user adds an amount and category in a separate activity; the main screen receives that result, creates a timestamped transaction, and sends it through the ViewModel and repository to Room. Room-backed flows also supply the transaction list and total/today summaries; the list supports category-colored entries and confirmed deletion. The graph follows the sampled MVVM and persistence calls. README capabilities are included, but unsampled resource layouts and manifest wiring are not expanded into runtime components.

Main entry points: [`app/src/main/java/com/vaibhav/expense/MainActivity.kt`](https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/MainActivity.kt) (Expense screen), [`app/src/main/java/com/vaibhav/expense/TransactionRepository.kt`](https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/TransactionRepository.kt) (Transaction repository), [`app/src/main/java/com/vaibhav/expense/database/TransactionDAO.kt`](https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/database/TransactionDAO.kt) (Transaction queries), [`app/src/main/java/com/vaibhav/expense/Model/Transaction.kt`](https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/Model/Transaction.kt) (Transaction entity)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Android interface"]
  node_main["Expense screen<br/>[MainActivity.kt]"]
  node_entry["Transaction entry"]
  node_list["Colored transaction list"]
end

subgraph group_state["MVVM state"]
  node_viewmodel["Transaction ViewModel"]
  node_app["Application wiring"]
end

subgraph group_storage["Room persistence"]
  node_repository["Transaction repository"]
  node_database[("Room database")]
  node_dao["Transaction queries<br/>[TransactionDAO.kt]"]
end

subgraph group_domain["Transaction data"]
  node_transaction["Transaction entity<br/>[Transaction.kt]"]
end

node_user(("User"))

node_user -->|"uses"| node_main
node_main -->|"launches"| node_entry
node_entry -->|"returns result"| node_main
node_main -->|"configures"| node_list
node_main -->|"observes and updates"| node_viewmodel
node_app -->|"creates"| node_database
node_app -->|"creates"| node_repository
node_viewmodel -->|"requests data"| node_repository
node_repository -->|"queries and mutates"| node_dao
node_database -->|"provides"| node_dao
node_dao -->|"reads and writes"| node_transaction
node_repository -->|"accepts"| node_transaction
node_list -->|"renders"| node_transaction

click node_main "https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/MainActivity.kt"
click node_entry "https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/NewTransactionActivity.kt"
click node_list "https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/RecyclerViewAdapter.kt"
click node_viewmodel "https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/viewmodel/TransactionViewModel.kt"
click node_app "https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/TransactionApplication.kt"
click node_repository "https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/TransactionRepository.kt"
click node_database "https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/database/TransactionRoomDatabase.kt"
click node_dao "https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/database/TransactionDAO.kt"
click node_transaction "https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/Model/Transaction.kt"

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_main,node_entry,node_list,node_user toneBlue
class node_viewmodel,node_app toneAmber
class node_repository,node_database,node_dao toneMint
class node_transaction toneRose
```

## Components

### Android interface

- [Expense screen](https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/MainActivity.kt): `app/src/main/java/com/vaibhav/expense/MainActivity.kt`
- [Transaction entry](https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/NewTransactionActivity.kt): `app/src/main/java/com/vaibhav/expense/NewTransactionActivity.kt`
- [Colored transaction list](https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/RecyclerViewAdapter.kt): `app/src/main/java/com/vaibhav/expense/RecyclerViewAdapter.kt`

### MVVM state

- [Transaction ViewModel](https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/viewmodel/TransactionViewModel.kt): `app/src/main/java/com/vaibhav/expense/viewmodel/TransactionViewModel.kt`
- [Application wiring](https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/TransactionApplication.kt): `app/src/main/java/com/vaibhav/expense/TransactionApplication.kt`

### Room persistence

- [Transaction repository](https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/TransactionRepository.kt): `app/src/main/java/com/vaibhav/expense/TransactionRepository.kt`
- [Room database](https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/database/TransactionRoomDatabase.kt): `app/src/main/java/com/vaibhav/expense/database/TransactionRoomDatabase.kt`
- [Transaction queries](https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/database/TransactionDAO.kt): `app/src/main/java/com/vaibhav/expense/database/TransactionDAO.kt`

### Transaction data

- [Transaction entity](https://github.com/vaibhavjain30699/expense/blob/master/app/src/main/java/com/vaibhav/expense/Model/Transaction.kt): `app/src/main/java/com/vaibhav/expense/Model/Transaction.kt`

### Other components

- **User**

## Connections

- User → Expense screen: uses (evidence: `README.md`)
- Expense screen → Transaction entry: launches (evidence: `app/src/main/java/com/vaibhav/expense/MainActivity.kt`)
- Transaction entry → Expense screen: returns result (evidence: `app/src/main/java/com/vaibhav/expense/NewTransactionActivity.kt`)
- Expense screen → Colored transaction list: configures (evidence: `app/src/main/java/com/vaibhav/expense/MainActivity.kt`)
- Expense screen → Transaction ViewModel: observes and updates (evidence: `app/src/main/java/com/vaibhav/expense/MainActivity.kt`)
- Application wiring → Room database: creates (evidence: `app/src/main/java/com/vaibhav/expense/TransactionApplication.kt`)
- Application wiring → Transaction repository: creates (evidence: `app/src/main/java/com/vaibhav/expense/TransactionApplication.kt`)
- Transaction ViewModel → Transaction repository: requests data (evidence: `app/src/main/java/com/vaibhav/expense/viewmodel/TransactionViewModel.kt`)
- Transaction repository → Transaction queries: queries and mutates (evidence: `app/src/main/java/com/vaibhav/expense/TransactionRepository.kt`)
- Room database → Transaction queries: provides (evidence: `app/src/main/java/com/vaibhav/expense/database/TransactionRoomDatabase.kt`)
- Transaction queries → Transaction entity: reads and writes (evidence: `app/src/main/java/com/vaibhav/expense/database/TransactionDAO.kt`)
- Transaction repository → Transaction entity: accepts (evidence: `app/src/main/java/com/vaibhav/expense/TransactionRepository.kt`)
- Colored transaction list → Transaction entity: renders (evidence: `app/src/main/java/com/vaibhav/expense/RecyclerViewAdapter.kt`)
