# seshasainekkalapudi/monthlyexpensetracker architecture

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

- Interactive diagram: https://gitdiagram.com/seshasainekkalapudi/monthlyexpensetracker
- Repository: https://github.com/seshasainekkalapudi/monthlyexpensetracker

## Overview

Monthly Expense Tracker is a Flutter app for tracking categorized monthly expenses, with Firebase Authentication and Cloud Firestore. Users authenticate, manage categories and expenses (including shared-expense recovery and settlements), then search/filter records, export PDF reports, and review monthly or yearly trends. Provider manages app state and in-memory calculations. The README documents these capabilities and the broad layers; Dart implementation details were not sampled, so component-level call paths are not asserted.

Main entry points: [`lib/screens`](https://github.com/seshasainekkalapudi/monthlyexpensetracker/tree/master/lib/screens) (Expense screens), [`lib/providers/expense_provider.dart`](https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/providers/expense_provider.dart) (Expense state), [`lib/screens/spend_trends_screen.dart`](https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/screens/spend_trends_screen.dart) (Spending trends), [`lib/providers/category_provider.dart`](https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/providers/category_provider.dart) (Category state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Application UI"]
  node_auth_ui["Authentication screens"]
  node_app_ui["Dashboard and profile"]
  node_category_ui["Category screens"]
  node_expense_ui["Expense screens"]
end

subgraph group_domain["Expense Management"]
  node_category_model["Category data"]
  node_expense_model["Expense and filter data<br/>[expense_model.dart]"]
  node_filter_model["Expense filters"]
end

subgraph group_state["State and Services"]
  node_auth_service["Authentication service<br/>[auth_service.dart]"]
  node_app_state["App state"]
  node_category_state["Category state"]
  node_expense_state["Expense state"]
  node_category_service["Category CRUD"]
  node_expense_service["Expense CRUD"]
end

subgraph group_backend["Firebase Backend"]
  node_firestore[("Cloud Firestore")]
  node_firebase_auth["Firebase Authentication"]
end

subgraph group_reporting["Analysis and Export"]
  node_trends_ui["Spending trends"]
  node_pdf_export["PDF report generation"]
end

node_user(("App user"))

node_user -->|"authenticates"| node_auth_ui
node_user -->|"manages spending"| node_app_ui
node_user -->|"manages categories"| node_category_ui
node_user -->|"manages expenses"| node_expense_ui
node_user -->|"reviews trends"| node_trends_ui
node_auth_ui -.->|"uses authentication"| node_auth_service
node_auth_service -->|"authenticates users"| node_firebase_auth
node_category_ui -.->|"manages categories"| node_category_state
node_expense_ui -.->|"manages expenses"| node_expense_state
node_trends_ui -.->|"reviews spending"| node_expense_state
node_app_state -.->|"manages app state"| node_category_state
node_app_state -.->|"manages app state"| node_expense_state
node_category_state -.->|"uses CRUD service"| node_category_service
node_expense_state -.->|"uses CRUD service"| node_expense_service
node_category_service -->|"stores categories"| node_firestore
node_expense_service -->|"stores expenses"| node_firestore
node_expense_ui -->|"filters and searches"| node_filter_model
node_expense_ui -->|"exports reports"| node_pdf_export
node_trends_ui -->|"shows monthly trends"| node_expense_model

click node_auth_ui "https://github.com/seshasainekkalapudi/monthlyexpensetracker/tree/master/lib/screens"
click node_app_ui "https://github.com/seshasainekkalapudi/monthlyexpensetracker/tree/master/lib/screens"
click node_category_ui "https://github.com/seshasainekkalapudi/monthlyexpensetracker/tree/master/lib/screens"
click node_expense_ui "https://github.com/seshasainekkalapudi/monthlyexpensetracker/tree/master/lib/screens"
click node_trends_ui "https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/screens/spend_trends_screen.dart"
click node_auth_service "https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/services/auth_service.dart"
click node_app_state "https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/providers/app_state_provider.dart"
click node_category_state "https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/providers/category_provider.dart"
click node_expense_state "https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/providers/expense_provider.dart"
click node_category_service "https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/services/category_service.dart"
click node_expense_service "https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/services/expense_service.dart"
click node_category_model "https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/models/category_model.dart"
click node_expense_model "https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/models/expense_model.dart"
click node_filter_model "https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/models/expense_filter.dart"
click node_pdf_export "https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/services/expense_pdf_service.dart"

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_auth_ui,node_app_ui,node_category_ui,node_expense_ui,node_user toneBlue
class node_category_model,node_expense_model,node_filter_model toneAmber
class node_auth_service,node_app_state,node_category_state,node_expense_state,node_category_service,node_expense_service toneMint
class node_firestore,node_firebase_auth toneRose
class node_trends_ui,node_pdf_export toneIndigo
```

## Components

### Application UI

- [Authentication screens](https://github.com/seshasainekkalapudi/monthlyexpensetracker/tree/master/lib/screens): `lib/screens`
- [Dashboard and profile](https://github.com/seshasainekkalapudi/monthlyexpensetracker/tree/master/lib/screens): `lib/screens`
- [Category screens](https://github.com/seshasainekkalapudi/monthlyexpensetracker/tree/master/lib/screens): `lib/screens`
- [Expense screens](https://github.com/seshasainekkalapudi/monthlyexpensetracker/tree/master/lib/screens): `lib/screens`

### Expense Management

- [Category data](https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/models/category_model.dart): `lib/models/category_model.dart`
- [Expense and filter data](https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/models/expense_model.dart): `lib/models/expense_model.dart`
- [Expense filters](https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/models/expense_filter.dart): `lib/models/expense_filter.dart`

### State and Services

- [Authentication service](https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/services/auth_service.dart): `lib/services/auth_service.dart`
- [App state](https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/providers/app_state_provider.dart): `lib/providers/app_state_provider.dart`
- [Category state](https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/providers/category_provider.dart): `lib/providers/category_provider.dart`
- [Expense state](https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/providers/expense_provider.dart): `lib/providers/expense_provider.dart`
- [Category CRUD](https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/services/category_service.dart): `lib/services/category_service.dart`
- [Expense CRUD](https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/services/expense_service.dart): `lib/services/expense_service.dart`

### Firebase Backend

- **Cloud Firestore**
- **Firebase Authentication**

### Analysis and Export

- [Spending trends](https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/screens/spend_trends_screen.dart): `lib/screens/spend_trends_screen.dart`
- [PDF report generation](https://github.com/seshasainekkalapudi/monthlyexpensetracker/blob/master/lib/services/expense_pdf_service.dart): `lib/services/expense_pdf_service.dart`

### Other components

- **App user**

## Connections

- App user → Authentication screens: authenticates (evidence: `README.md`)
- App user → Dashboard and profile: manages spending (evidence: `README.md`)
- App user → Category screens: manages categories (evidence: `README.md`)
- App user → Expense screens: manages expenses (evidence: `README.md`)
- App user → Spending trends: reviews trends (evidence: `README.md`)
- Authentication screens → Authentication service: uses authentication
- Authentication service → Firebase Authentication: authenticates users (evidence: `README.md`)
- Category screens → Category state: manages categories
- Expense screens → Expense state: manages expenses
- Spending trends → Expense state: reviews spending
- App state → Category state: manages app state
- App state → Expense state: manages app state
- Category state → Category CRUD: uses CRUD service
- Expense state → Expense CRUD: uses CRUD service
- Category CRUD → Cloud Firestore: stores categories (evidence: `README.md`)
- Expense CRUD → Cloud Firestore: stores expenses (evidence: `README.md`)
- Expense screens → Expense filters: filters and searches (evidence: `README.md`)
- Expense screens → PDF report generation: exports reports (evidence: `README.md`)
- Spending trends → Expense and filter data: shows monthly trends (evidence: `README.md`)
