How mehreen-14/expense-tracker works
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: app.component.ts App coordinator · InsightsService.java Budgets and insights · ExpenseService.java Expense operations · ExpenseRepository.java Expense records
Components 28
Angular app
- App coordinator
frontend/src/app/app.component.ts - Expense entry
frontend/src/app/components/expense-form/expense-form.component.ts - Dashboard views
frontend/src/app/components/dashboard/dashboard.component.ts - Insights view
frontend/src/app/components/insights-panel/insights-panel.component.ts - Bill manager
frontend/src/app/components/bill-manager/bill-manager.component.ts - Split expenses
frontend/src/app/components/split-expenses/split-expenses.component.ts - Confirmation modal
frontend/src/app/components/confirm-modal/confirm-modal.component.ts - Expense HTTP service
frontend/src/app/services/expense.service.ts - Bill HTTP service
frontend/src/app/services/bill.service.ts - Split HTTP service
frontend/src/app/services/split.service.ts
Spring API
- Expense endpoints
backend/src/main/java/com/elora/expensetracker/controller/ExpenseController.java - Bill endpoints
backend/src/main/java/com/elora/expensetracker/controller/BillController.java - Split endpoints
backend/src/main/java/com/elora/expensetracker/controller/SplitExpenseController.java - Insights endpoints
backend/src/main/java/com/elora/expensetracker/controller/InsightsController.java - Payment endpoints
backend/src/main/java/com/elora/expensetracker/controller/PaymentController.java
Spending domain
- Expense operations
backend/src/main/java/com/elora/expensetracker/service/ExpenseService.java - Recurring bills
backend/src/main/java/com/elora/expensetracker/service/BillService.java - Split settlement
backend/src/main/java/com/elora/expensetracker/service/SplitExpenseService.java - Budgets and insights
backend/src/main/java/com/elora/expensetracker/service/InsightsService.java - Period calculations
backend/src/main/java/com/elora/expensetracker/util/PeriodHelper.java
Persistence
- Expense records
backend/src/main/java/com/elora/expensetracker/repository/ExpenseRepository.java - Bill records
backend/src/main/java/com/elora/expensetracker/repository/BillRepository.java - Split records
backend/src/main/java/com/elora/expensetracker/repository/SplitExpenseRepository.java - Budget records
backend/src/main/java/com/elora/expensetracker/repository/BudgetRepository.java
Payments
- SSLCommerz adapter
backend/src/main/java/com/elora/expensetracker/service/SslCommerzService.java
Other components
- User
- SSLCommerz gateway
- PostgreSQL
Connections 29
- User → App coordinator: uses
README.md - App coordinator → Expense HTTP service: calls
frontend/src/app/app.component.ts - App coordinator → Bill HTTP service: calls
frontend/src/app/app.component.ts - App coordinator → Split HTTP service: calls
frontend/src/app/app.component.ts - Expense entry → App coordinator: submits
frontend/src/app/app.component.ts - Bill manager → Confirmation modal: renders
frontend/src/app/components/bill-manager/bill-manager.component.ts - Expense HTTP service → Expense endpoints: HTTP requests
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
backend/src/main/java/com/elora/expensetracker/controller/ExpenseController.java - Bill endpoints → Recurring bills: delegates
- Split endpoints → Split settlement: delegates
backend/src/main/java/com/elora/expensetracker/controller/SplitExpenseController.java - Insights endpoints → Budgets and insights: delegates
- Payment endpoints → Expense operations: creates expense
backend/src/main/java/com/elora/expensetracker/controller/PaymentController.java - Payment endpoints → SSLCommerz adapter: initiates and verifies
backend/src/main/java/com/elora/expensetracker/controller/PaymentController.java - SSLCommerz adapter → SSLCommerz gateway: gateway requests
- Expense operations → Expense records: reads and writes
backend/src/main/java/com/elora/expensetracker/service/ExpenseService.java - Recurring bills → Bill records: reads and writes
backend/src/main/java/com/elora/expensetracker/service/BillService.java - Split settlement → Split records: reads and writes
backend/src/main/java/com/elora/expensetracker/service/SplitExpenseService.java - Budgets and insights → Expense records: queries spending
backend/src/main/java/com/elora/expensetracker/service/InsightsService.java - Budgets and insights → Budget records: reads budget
- Expense operations → Period calculations: uses date ranges
backend/src/main/java/com/elora/expensetracker/service/ExpenseService.java - Budgets and insights → Period calculations: uses date ranges
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
frontend/src/app/app.component.ts - Insights view → App coordinator: renders data
frontend/src/app/app.component.ts