# mehreen-14/expense-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/mehreen-14/expense-tracker
- Repository: https://github.com/mehreen-14/expense-tracker

## Overview

Expense Tracker lets users record and manage spending, review period summaries and insights, budget monthly spending, manage recurring bills and split expenses, and initiate payments through SSLCommerz. The principal flow runs from the Angular app through HTTP services to Spring controllers, domain services, repositories, and PostgreSQL-backed entities. The README also documents voice-to-form input and payment callbacks; source excerpts confirm payment initiation and verification, while some feature wiring is not shown. Edges are limited to documented or indexed relationships; unsampled subsystem links are omitted where callers cannot be verified.

Main entry points: [`frontend/src/app/app.component.ts`](https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/app.component.ts) (App coordinator), [`backend/src/main/java/com/elora/expensetracker/service/InsightsService.java`](https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/service/InsightsService.java) (Budgets and insights), [`backend/src/main/java/com/elora/expensetracker/service/ExpenseService.java`](https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/service/ExpenseService.java) (Expense operations), [`backend/src/main/java/com/elora/expensetracker/repository/ExpenseRepository.java`](https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/repository/ExpenseRepository.java) (Expense records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Angular app"]
  node_app["App coordinator<br/>[app.component.ts]"]
  node_expense_ui["Expense entry"]
  node_dashboard_ui["Dashboard views"]
  node_insights_ui["Insights view"]
  node_bill_ui["Bill manager"]
  node_split_ui["Split expenses"]
  node_confirm_ui["Confirmation modal"]
  node_expense_http["Expense HTTP service<br/>[expense.service.ts]"]
  node_bill_http["Bill HTTP service<br/>[bill.service.ts]"]
  node_split_http["Split HTTP service<br/>[split.service.ts]"]
end

subgraph group_api["Spring API"]
  node_expense_api["Expense endpoints"]
  node_bill_api["Bill endpoints"]
  node_split_api["Split endpoints"]
  node_insight_api["Insights endpoints"]
  node_payment_api["Payment endpoints"]
end

subgraph group_domain["Spending domain"]
  node_expense_domain["Expense operations"]
  node_bill_domain["Recurring bills<br/>[BillService.java]"]
  node_split_domain["Split settlement"]
  node_insights_domain["Budgets and insights"]
  node_periods["Period calculations<br/>[PeriodHelper.java]"]
end

subgraph group_persistence["Persistence"]
  node_expense_store[("Expense records")]
  node_bill_store[("Bill records")]
  node_split_store[("Split records")]
  node_budget_store[("Budget records")]
end

subgraph group_integrations["Payments"]
  node_ssl_service["SSLCommerz adapter"]
end

node_user(("User"))
node_sslcommerz{{"SSLCommerz gateway"}}
node_postgres[("PostgreSQL")]

node_user -->|"uses"| node_app
node_app -->|"calls"| node_expense_http
node_app -->|"calls"| node_bill_http
node_app -->|"calls"| node_split_http
node_expense_ui -->|"submits"| node_app
node_bill_ui -->|"renders"| node_confirm_ui
node_expense_http -->|"HTTP requests"| node_expense_api
node_bill_http -.->|"HTTP requests"| node_bill_api
node_split_http -.->|"HTTP requests"| node_split_api
node_expense_api -->|"delegates"| node_expense_domain
node_bill_api -.->|"delegates"| node_bill_domain
node_split_api -->|"delegates"| node_split_domain
node_insight_api -.->|"delegates"| node_insights_domain
node_payment_api -->|"creates expense"| node_expense_domain
node_payment_api -->|"initiates and verifies"| node_ssl_service
node_ssl_service -.->|"gateway requests"| node_sslcommerz
node_expense_domain -->|"reads and writes"| node_expense_store
node_bill_domain -->|"reads and writes"| node_bill_store
node_split_domain -->|"reads and writes"| node_split_store
node_insights_domain -->|"queries spending"| node_expense_store
node_insights_domain -.->|"reads budget"| node_budget_store
node_expense_domain -->|"uses date ranges"| node_periods
node_insights_domain -->|"uses date ranges"| node_periods
node_expense_store -.->|"persists"| node_postgres
node_bill_store -.->|"persists"| node_postgres
node_split_store -.->|"persists"| node_postgres
node_budget_store -.->|"persists"| node_postgres
node_dashboard_ui -.->|"renders data"| node_app
node_insights_ui -.->|"renders data"| node_app

click node_app "https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/app.component.ts"
click node_expense_ui "https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/components/expense-form/expense-form.component.ts"
click node_dashboard_ui "https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/components/dashboard/dashboard.component.ts"
click node_insights_ui "https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/components/insights-panel/insights-panel.component.ts"
click node_bill_ui "https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/components/bill-manager/bill-manager.component.ts"
click node_split_ui "https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/components/split-expenses/split-expenses.component.ts"
click node_confirm_ui "https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/components/confirm-modal/confirm-modal.component.ts"
click node_expense_http "https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/services/expense.service.ts"
click node_bill_http "https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/services/bill.service.ts"
click node_split_http "https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/services/split.service.ts"
click node_expense_api "https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/controller/ExpenseController.java"
click node_bill_api "https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/controller/BillController.java"
click node_split_api "https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/controller/SplitExpenseController.java"
click node_insight_api "https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/controller/InsightsController.java"
click node_payment_api "https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/controller/PaymentController.java"
click node_expense_domain "https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/service/ExpenseService.java"
click node_bill_domain "https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/service/BillService.java"
click node_split_domain "https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/service/SplitExpenseService.java"
click node_insights_domain "https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/service/InsightsService.java"
click node_periods "https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/util/PeriodHelper.java"
click node_expense_store "https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/repository/ExpenseRepository.java"
click node_bill_store "https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/repository/BillRepository.java"
click node_split_store "https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/repository/SplitExpenseRepository.java"
click node_budget_store "https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/repository/BudgetRepository.java"
click node_ssl_service "https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/service/SslCommerzService.java"

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_app,node_expense_ui,node_dashboard_ui,node_insights_ui,node_bill_ui,node_split_ui,node_confirm_ui,node_expense_http,node_bill_http,node_split_http,node_user toneBlue
class node_expense_api,node_bill_api,node_split_api,node_insight_api,node_payment_api,node_postgres toneAmber
class node_expense_domain,node_bill_domain,node_split_domain,node_insights_domain,node_periods toneMint
class node_expense_store,node_bill_store,node_split_store,node_budget_store toneRose
class node_ssl_service,node_sslcommerz toneIndigo
```

## Components

### Angular app

- [App coordinator](https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/app.component.ts): `frontend/src/app/app.component.ts`
- [Expense entry](https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/components/expense-form/expense-form.component.ts): `frontend/src/app/components/expense-form/expense-form.component.ts`
- [Dashboard views](https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/components/dashboard/dashboard.component.ts): `frontend/src/app/components/dashboard/dashboard.component.ts`
- [Insights view](https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/components/insights-panel/insights-panel.component.ts): `frontend/src/app/components/insights-panel/insights-panel.component.ts`
- [Bill manager](https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/components/bill-manager/bill-manager.component.ts): `frontend/src/app/components/bill-manager/bill-manager.component.ts`
- [Split expenses](https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/components/split-expenses/split-expenses.component.ts): `frontend/src/app/components/split-expenses/split-expenses.component.ts`
- [Confirmation modal](https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/components/confirm-modal/confirm-modal.component.ts): `frontend/src/app/components/confirm-modal/confirm-modal.component.ts`
- [Expense HTTP service](https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/services/expense.service.ts): `frontend/src/app/services/expense.service.ts`
- [Bill HTTP service](https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/services/bill.service.ts): `frontend/src/app/services/bill.service.ts`
- [Split HTTP service](https://github.com/mehreen-14/expense-tracker/blob/main/frontend/src/app/services/split.service.ts): `frontend/src/app/services/split.service.ts`

### Spring API

- [Expense endpoints](https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/controller/ExpenseController.java): `backend/src/main/java/com/elora/expensetracker/controller/ExpenseController.java`
- [Bill endpoints](https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/controller/BillController.java): `backend/src/main/java/com/elora/expensetracker/controller/BillController.java`
- [Split endpoints](https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/controller/SplitExpenseController.java): `backend/src/main/java/com/elora/expensetracker/controller/SplitExpenseController.java`
- [Insights endpoints](https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/controller/InsightsController.java): `backend/src/main/java/com/elora/expensetracker/controller/InsightsController.java`
- [Payment endpoints](https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/controller/PaymentController.java): `backend/src/main/java/com/elora/expensetracker/controller/PaymentController.java`

### Spending domain

- [Expense operations](https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/service/ExpenseService.java): `backend/src/main/java/com/elora/expensetracker/service/ExpenseService.java`
- [Recurring bills](https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/service/BillService.java): `backend/src/main/java/com/elora/expensetracker/service/BillService.java`
- [Split settlement](https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/service/SplitExpenseService.java): `backend/src/main/java/com/elora/expensetracker/service/SplitExpenseService.java`
- [Budgets and insights](https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/service/InsightsService.java): `backend/src/main/java/com/elora/expensetracker/service/InsightsService.java`
- [Period calculations](https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/util/PeriodHelper.java): `backend/src/main/java/com/elora/expensetracker/util/PeriodHelper.java`

### Persistence

- [Expense records](https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/repository/ExpenseRepository.java): `backend/src/main/java/com/elora/expensetracker/repository/ExpenseRepository.java`
- [Bill records](https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/repository/BillRepository.java): `backend/src/main/java/com/elora/expensetracker/repository/BillRepository.java`
- [Split records](https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/repository/SplitExpenseRepository.java): `backend/src/main/java/com/elora/expensetracker/repository/SplitExpenseRepository.java`
- [Budget records](https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/repository/BudgetRepository.java): `backend/src/main/java/com/elora/expensetracker/repository/BudgetRepository.java`

### Payments

- [SSLCommerz adapter](https://github.com/mehreen-14/expense-tracker/blob/main/backend/src/main/java/com/elora/expensetracker/service/SslCommerzService.java): `backend/src/main/java/com/elora/expensetracker/service/SslCommerzService.java`

### Other components

- **User**
- **SSLCommerz gateway**
- **PostgreSQL**

## Connections

- User → App coordinator: uses (evidence: `README.md`)
- App coordinator → Expense HTTP service: calls (evidence: `frontend/src/app/app.component.ts`)
- App coordinator → Bill HTTP service: calls (evidence: `frontend/src/app/app.component.ts`)
- App coordinator → Split HTTP service: calls (evidence: `frontend/src/app/app.component.ts`)
- Expense entry → App coordinator: submits (evidence: `frontend/src/app/app.component.ts`)
- Bill manager → Confirmation modal: renders (evidence: `frontend/src/app/components/bill-manager/bill-manager.component.ts`)
- Expense HTTP service → Expense endpoints: HTTP requests (evidence: `frontend/src/app/services/expense.service.ts`)
- Bill HTTP service → Bill endpoints: HTTP requests
- Split HTTP service → Split endpoints: HTTP requests
- Expense endpoints → Expense operations: delegates (evidence: `backend/src/main/java/com/elora/expensetracker/controller/ExpenseController.java`)
- Bill endpoints → Recurring bills: delegates
- Split endpoints → Split settlement: delegates (evidence: `backend/src/main/java/com/elora/expensetracker/controller/SplitExpenseController.java`)
- Insights endpoints → Budgets and insights: delegates
- Payment endpoints → Expense operations: creates expense (evidence: `backend/src/main/java/com/elora/expensetracker/controller/PaymentController.java`)
- Payment endpoints → SSLCommerz adapter: initiates and verifies (evidence: `backend/src/main/java/com/elora/expensetracker/controller/PaymentController.java`)
- SSLCommerz adapter → SSLCommerz gateway: gateway requests
- Expense operations → Expense records: reads and writes (evidence: `backend/src/main/java/com/elora/expensetracker/service/ExpenseService.java`)
- Recurring bills → Bill records: reads and writes (evidence: `backend/src/main/java/com/elora/expensetracker/service/BillService.java`)
- Split settlement → Split records: reads and writes (evidence: `backend/src/main/java/com/elora/expensetracker/service/SplitExpenseService.java`)
- Budgets and insights → Expense records: queries spending (evidence: `backend/src/main/java/com/elora/expensetracker/service/InsightsService.java`)
- Budgets and insights → Budget records: reads budget
- Expense operations → Period calculations: uses date ranges (evidence: `backend/src/main/java/com/elora/expensetracker/service/ExpenseService.java`)
- Budgets and insights → Period calculations: uses date ranges (evidence: `backend/src/main/java/com/elora/expensetracker/service/InsightsService.java`)
- Expense records → PostgreSQL: persists
- Bill records → PostgreSQL: persists
- Split records → PostgreSQL: persists
- Budget records → PostgreSQL: persists
- Dashboard views → App coordinator: renders data (evidence: `frontend/src/app/app.component.ts`)
- Insights view → App coordinator: renders data (evidence: `frontend/src/app/app.component.ts`)
