How nishit-luhadia30/budget-planner works
Budget Tracker is a personal-finance web app. Users sign in, select a month, create a budget, and manage expenses; the dashboard presents summaries and supports exports and an assistant. The API authenticates requests and stores monthly budgets with embedded transactions. Separate capabilities include transaction ingestion and mock imports, recurring-expense processing, and analytics helpers. The graph follows documented and indexed relationships; some frontend API calls and unsampled route internals are represented only where README documentation supports them.
Main entry points: Dashboard.js Monthly dashboard · server.js Express server · Budget.js Monthly budget model · auth.js JWT middleware
Components 28
Web application
- React routes
frontend/src/App.js - Session state
frontend/src/context/AuthContext.js - Monthly dashboard
frontend/src/components/Dashboard.js - Budget form
frontend/src/components/BudgetForm.js - Expense form
frontend/src/components/ExpenseForm.js - Budget summary
frontend/src/components/BudgetSummary.js - Expense list
frontend/src/components/ExpenseList.js - Export options
frontend/src/components/ExportOptions.js - File generation
frontend/src/utils/exportUtils.js - Assistant UI
frontend/src/components/AIAssistant.js - Notifications
frontend/src/components/NotificationSystem.js
API and domain
- Express server
backend/server.js - Authentication routes
backend/routes/auth.js - JWT middleware
backend/middleware/auth.js - Budget routes
backend/routes/budget.js - Expense routes
backend/routes/expense.js - Transaction routes
backend/routes/transactions.js - Export route
backend/routes/export.js - Assistant route
backend/routes/ai.js
Persistence
- User model
backend/models/User.js - Monthly budget model
backend/models/Budget.js
Services
- Merchant categorization
backend/services/categorization.js - Mock transactions
backend/services/mockPaymentProvider.js - Assistant data queries
backend/services/aiTools.js - Recurring processor
backend/services/recurringExpenses.js - Finance analytics
backend/services/financeAnalytics.js
Other components
- User
- MongoDB
Connections 44
- User → React routes: uses
README.md - React routes → Session state: provides session
frontend/src/App.js - React routes → Monthly dashboard: routes to
frontend/src/App.js - Monthly dashboard → Budget form: renders
frontend/src/components/Dashboard.js - Monthly dashboard → Expense form: renders
frontend/src/components/Dashboard.js - Monthly dashboard → Expense list: renders
frontend/src/components/Dashboard.js - Monthly dashboard → Budget summary: renders
frontend/src/components/Dashboard.js - Monthly dashboard → Export options: renders
frontend/src/components/Dashboard.js - Monthly dashboard → Assistant UI: renders
frontend/src/components/Dashboard.js - Monthly dashboard → Notifications: renders
frontend/src/components/Dashboard.js - Session state → Authentication routes: authenticates via
README.md - Monthly dashboard → Budget routes: requests monthly data
frontend/src/components/Dashboard.js - Budget form → Budget routes: updates budget
README.md - Expense form → Expense routes: submits expenses
README.md - Export options → Export route: requests report data
README.md - Export options → File generation: generates files
README.md - Assistant UI → Assistant route: sends questions
README.md - Express server → Authentication routes: mounts
backend/server.js - Express server → Budget routes: mounts
backend/server.js - Express server → Expense routes: mounts
backend/server.js - Express server → Transaction routes: mounts
backend/server.js - Express server → Export route: mounts
backend/server.js - Express server → Assistant route: mounts
backend/server.js - Express server → Recurring processor: starts service
backend/server.js - Authentication routes → User model: reads and writes
backend/routes/auth.js - JWT middleware → User model: loads user
backend/middleware/auth.js - Budget routes → JWT middleware: protects routes
README.md - Expense routes → JWT middleware: protects routes
README.md - Transaction routes → JWT middleware: protects routes
backend/routes/transactions.js - Export route → JWT middleware: protects routes
README.md - Assistant route → JWT middleware: protects routes
backend/routes/ai.js - Budget routes → Monthly budget model: reads and writes
backend/routes/budget.js - Expense routes → Monthly budget model: mutates expenses
backend/routes/expense.js - Transaction routes → Monthly budget model: stores transactions
backend/routes/transactions.js - Export route → Monthly budget model: reads reports
backend/routes/export.js - Transaction routes → Merchant categorization: categorizes
backend/routes/transactions.js - Transaction routes → Mock transactions: collects samples
backend/routes/transactions.js - Assistant route → Assistant data queries: selects data queries
backend/routes/ai.js - Assistant data queries → Monthly budget model: queries transactions
backend/services/aiTools.js - Recurring processor → Monthly budget model: processes due entries
backend/services/recurringExpenses.js - Finance analytics → Monthly budget model: analyzes budgets
backend/services/financeAnalytics.js - Finance analytics → Merchant categorization: uses categories
backend/services/financeAnalytics.js - User model → MongoDB: persists
README.md - Monthly budget model → MongoDB: persists
README.md