# gangdkrish/smartexpensetracker architecture

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

- Interactive diagram: https://gitdiagram.com/gangdkrish/smartexpensetracker
- Repository: https://github.com/gangdkrish/smartexpensetracker

## Overview

Smart Expense Tracker is a Blazor UI backed by an ASP.NET API. Users sign in or register, then manage expenses; the UI’s expense service sends bearer-authenticated requests to the API, whose controller dispatches expense operations through MediatR handlers to SQLite. The UI tree also includes chart and summary components, but their wiring was not excerpted. The graph keeps those capabilities visible without asserting unsupported connections; relationships are limited to those shown in excerpts or the source index.

Main entry points: [`SmartExpenseTracker/Data/AppDbContext.cs`](https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/Data/AppDbContext.cs) (SQLite context), [`SmartExpenseTracker/Controllers/ExpenseController.cs`](https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/Controllers/ExpenseController.cs) (Expense API), [`ExpenseTrackerUI/Program.cs`](https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Program.cs) (UI endpoints and setup), [`ExpenseTrackerUI/Services/ExpenseService.cs`](https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Services/ExpenseService.cs) (Expense HTTP service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Blazor interface"]
  node_ui_app["App host<br/>[App.razor]"]
  node_home["Home page<br/>[Home.razor]"]
  node_expenses_page["Expenses page<br/>[Expenses.razor]"]
  node_login_page["Login page<br/>[Login.razor]"]
  node_chart["Expense chart<br/>[ExpenseChart.razor]"]
  node_stat_card["Stat card<br/>[StatCard.razor]"]
  node_delete_modal["Delete confirmation"]
end

subgraph group_ui_services["UI services"]
  node_ui_host["UI endpoints and setup<br/>[Program.cs]"]
  node_expense_service["Expense HTTP service<br/>[ExpenseService.cs]"]
  node_service_contract["Expense service contract<br/>[IExpenseService.cs]"]
end

subgraph group_api["API and authentication"]
  node_api_host["API host<br/>[Program.cs]"]
  node_auth_controller["Authentication<br/>[AuthController.cs]"]
  node_expense_controller["Expense API"]
  node_mapping["DTO mapping<br/>[MappingProfile.cs]"]
end

subgraph group_domain_data["Expense domain and data"]
  node_queries["Expense query"]
  node_add_handler["Add expense"]
  node_update_handler["Update expense"]
  node_delete_handler["Delete expense"]
  node_db[("SQLite context<br/>[AppDbContext.cs]")]
  node_expense_model["Expense model<br/>[Expense.cs]"]
  node_user_model["User model<br/>[User.cs]"]
end

node_user(("User"))

node_user -.->|"uses"| node_ui_app
node_ui_host -->|"registers"| node_expense_service
node_ui_host -->|"proxies auth"| node_auth_controller
node_expense_service -->|"sends HTTP"| node_expense_controller
node_expense_controller -->|"dispatches query"| node_queries
node_expense_controller -->|"dispatches command"| node_add_handler
node_expense_controller -->|"dispatches command"| node_update_handler
node_expense_controller -->|"dispatches command"| node_delete_handler
node_queries -->|"reads expenses"| node_db
node_add_handler -->|"writes expense"| node_db
node_update_handler -->|"updates expense"| node_db
node_delete_handler -->|"deletes expense"| node_db
node_auth_controller -->|"reads and writes users"| node_db
node_db -->|"stores"| node_expense_model
node_db -->|"stores"| node_user_model
node_expense_controller -->|"maps DTOs"| node_mapping

click node_ui_app "https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Components/App.razor"
click node_home "https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Components/Pages/Home.razor"
click node_expenses_page "https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Pages/Expenses.razor"
click node_login_page "https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Pages/Login.razor"
click node_chart "https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Components/ExpenseChart.razor"
click node_stat_card "https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Components/StatCard.razor"
click node_delete_modal "https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Components/DeleteConfirmModal.razor"
click node_ui_host "https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Program.cs"
click node_expense_service "https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Services/ExpenseService.cs"
click node_service_contract "https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Services/IExpenseService.cs"
click node_api_host "https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/Program.cs"
click node_auth_controller "https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/Controllers/AuthController.cs"
click node_expense_controller "https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/Controllers/ExpenseController.cs"
click node_mapping "https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/Mappings/MappingProfile.cs"
click node_queries "https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/CQRS/Queries/GetExpensesHandler.cs"
click node_add_handler "https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/CQRS/Commands/AddExpenseHandler.cs"
click node_update_handler "https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/CQRS/Commands/UpdateExpenseHandler.cs"
click node_delete_handler "https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/CQRS/Commands/DeleteExpenseHandler.cs"
click node_db "https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/Data/AppDbContext.cs"
click node_expense_model "https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/Models/Expense.cs"
click node_user_model "https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/Models/User.cs"

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_ui_app,node_home,node_expenses_page,node_login_page,node_chart,node_stat_card,node_delete_modal,node_user toneBlue
class node_ui_host,node_expense_service,node_service_contract toneAmber
class node_api_host,node_auth_controller,node_expense_controller,node_mapping toneMint
class node_queries,node_add_handler,node_update_handler,node_delete_handler,node_db,node_expense_model,node_user_model toneRose
```

## Components

### Blazor interface

- [App host](https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Components/App.razor): `ExpenseTrackerUI/Components/App.razor`
- [Home page](https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Components/Pages/Home.razor): `ExpenseTrackerUI/Components/Pages/Home.razor`
- [Expenses page](https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Pages/Expenses.razor): `ExpenseTrackerUI/Pages/Expenses.razor`
- [Login page](https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Pages/Login.razor): `ExpenseTrackerUI/Pages/Login.razor`
- [Expense chart](https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Components/ExpenseChart.razor): `ExpenseTrackerUI/Components/ExpenseChart.razor`
- [Stat card](https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Components/StatCard.razor): `ExpenseTrackerUI/Components/StatCard.razor`
- [Delete confirmation](https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Components/DeleteConfirmModal.razor): `ExpenseTrackerUI/Components/DeleteConfirmModal.razor`

### UI services

- [UI endpoints and setup](https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Program.cs): `ExpenseTrackerUI/Program.cs`
- [Expense HTTP service](https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Services/ExpenseService.cs): `ExpenseTrackerUI/Services/ExpenseService.cs`
- [Expense service contract](https://github.com/gangdkrish/smartexpensetracker/blob/master/ExpenseTrackerUI/Services/IExpenseService.cs): `ExpenseTrackerUI/Services/IExpenseService.cs`

### API and authentication

- [API host](https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/Program.cs): `SmartExpenseTracker/Program.cs`
- [Authentication](https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/Controllers/AuthController.cs): `SmartExpenseTracker/Controllers/AuthController.cs`
- [Expense API](https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/Controllers/ExpenseController.cs): `SmartExpenseTracker/Controllers/ExpenseController.cs`
- [DTO mapping](https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/Mappings/MappingProfile.cs): `SmartExpenseTracker/Mappings/MappingProfile.cs`

### Expense domain and data

- [Expense query](https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/CQRS/Queries/GetExpensesHandler.cs): `SmartExpenseTracker/CQRS/Queries/GetExpensesHandler.cs`
- [Add expense](https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/CQRS/Commands/AddExpenseHandler.cs): `SmartExpenseTracker/CQRS/Commands/AddExpenseHandler.cs`
- [Update expense](https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/CQRS/Commands/UpdateExpenseHandler.cs): `SmartExpenseTracker/CQRS/Commands/UpdateExpenseHandler.cs`
- [Delete expense](https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/CQRS/Commands/DeleteExpenseHandler.cs): `SmartExpenseTracker/CQRS/Commands/DeleteExpenseHandler.cs`
- [SQLite context](https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/Data/AppDbContext.cs): `SmartExpenseTracker/Data/AppDbContext.cs`
- [Expense model](https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/Models/Expense.cs): `SmartExpenseTracker/Models/Expense.cs`
- [User model](https://github.com/gangdkrish/smartexpensetracker/blob/master/SmartExpenseTracker/Models/User.cs): `SmartExpenseTracker/Models/User.cs`

### Other components

- **User**

## Connections

- User → App host: uses
- UI endpoints and setup → Expense HTTP service: registers (evidence: `ExpenseTrackerUI/Program.cs`)
- UI endpoints and setup → Authentication: proxies auth (evidence: `ExpenseTrackerUI/Program.cs`)
- Expense HTTP service → Expense API: sends HTTP (evidence: `ExpenseTrackerUI/Services/ExpenseService.cs`)
- Expense API → Expense query: dispatches query (evidence: `SmartExpenseTracker/Controllers/ExpenseController.cs`)
- Expense API → Add expense: dispatches command (evidence: `SmartExpenseTracker/Controllers/ExpenseController.cs`)
- Expense API → Update expense: dispatches command (evidence: `SmartExpenseTracker/Controllers/ExpenseController.cs`)
- Expense API → Delete expense: dispatches command (evidence: `SmartExpenseTracker/Controllers/ExpenseController.cs`)
- Expense query → SQLite context: reads expenses (evidence: `SmartExpenseTracker/CQRS/Queries/GetExpensesHandler.cs`)
- Add expense → SQLite context: writes expense (evidence: `SmartExpenseTracker/CQRS/Commands/AddExpenseHandler.cs`)
- Update expense → SQLite context: updates expense (evidence: `SmartExpenseTracker/CQRS/Commands/UpdateExpenseHandler.cs`)
- Delete expense → SQLite context: deletes expense (evidence: `SmartExpenseTracker/CQRS/Commands/DeleteExpenseHandler.cs`)
- Authentication → SQLite context: reads and writes users (evidence: `SmartExpenseTracker/Controllers/AuthController.cs`)
- SQLite context → Expense model: stores (evidence: `SmartExpenseTracker/Data/AppDbContext.cs`)
- SQLite context → User model: stores (evidence: `SmartExpenseTracker/Data/AppDbContext.cs`)
- Expense API → DTO mapping: maps DTOs (evidence: `SmartExpenseTracker/Controllers/ExpenseController.cs`)
