How btaquee/cardsense works
CardSense is a personal-finance web app for tracking spending against monthly budgets and maximizing credit-card rewards. Users authenticate, add or import transactions, manage their card wallet and budgets, then review alerts, reward breakdowns, and recommendations. The React app calls a Django REST API; transaction and card data support reward calculations, while budget services aggregate monthly spend and create threshold events. The README also describes analytics and profile/settings capabilities. Some backend views and frontend pages were not sampled, so those subsystem links are included only where routing or explicit documentation supports them.
Main entry points: App.tsx Web routes · views.py Transaction endpoints · services.py Spend and thresholds · api.ts API client
Components 27
Web experience
- Web routes
web/src/App.tsx - Sign-in UI
web/src/components/auth - Profile settings
web/src/components/Profile - Transaction tools
web/src/components/Transactions - Budget views
web/src/components/Budgets - Card management
web/src/components/Cards/CardManagement.tsx - Rewards breakdown
web/src/components/Rewards/RewardsBreakdown.tsx - Dashboard
web/src/components/Dashboard/Dashboard.tsx - API client
web/src/services/api.ts - Auth service
web/src/services/auth.service.ts - Transaction service
web/src/services/transaction.service.ts - Budget service
web/src/services/budget.service.ts - Card service
web/src/services/card.service.ts
Accounts and spending
- Django API routes
api/urls.py - Authentication
accounts/views.py - Transaction endpoints
transactions/views.py - Transaction records
transactions/models.py
Budget tracking
- Budget endpoints
budgets/views.py - Spend and thresholds
budgets/services.py - Budgets and alerts
budgets/models.py - Budget signals
budgets/signals.py
Cards and rewards
- Card endpoints
cards/views.py - Card catalog and wallet
cards/models.py - Card optimizer
optimizer/services.py - Reward calculations
transactions/rewards.py
Insights
- Spending analytics
analytics_views.py
Other components
- User
Connections 41
- User → Web routes: uses
web/src/App.tsx - Web routes → Sign-in UI: routes
web/src/App.tsx - Web routes → Transaction tools: routes
web/src/App.tsx - Web routes → Budget views: routes
web/src/App.tsx - Web routes → Card management: routes
web/src/App.tsx - Web routes → Rewards breakdown: routes
web/src/App.tsx - Web routes → Dashboard: routes
web/src/App.tsx - Web routes → Profile settings: routes
web/src/App.tsx - Sign-in UI → Auth service: uses
- Transaction tools → Transaction service: uses
web/src/services/transaction.service.ts - Budget views → Budget service: uses
web/src/components/Budgets/BudgetList.tsx - Card management → Card service: uses
web/src/components/Cards/CardManagement.tsx - Rewards breakdown → Card service: requests cards
web/src/components/Rewards/RewardsBreakdown.tsx - Rewards breakdown → Transaction service: requests transactions
web/src/components/Rewards/RewardsBreakdown.tsx - Auth service → API client: sends requests
web/src/services/auth.service.ts - Transaction service → API client: sends requests
web/src/services/transaction.service.ts - Budget service → API client: sends requests
web/src/services/budget.service.ts - Card service → API client: sends requests
web/src/services/card.service.ts - API client → Django API routes: HTTP requests
web/src/services/api.ts - Django API routes → Authentication: routes auth
api/urls.py - Django API routes → Spending analytics: routes analytics
api/urls.py - Transaction service → Transaction endpoints: HTTP requests
web/src/services/transaction.service.ts - Budget service → Budget endpoints: HTTP requests
web/src/services/budget.service.ts - Card service → Card endpoints: HTTP requests
web/src/services/card.service.ts - Transaction endpoints → Transaction records: reads and writes
transactions/views.py - Transaction endpoints → Card optimizer: requests recommendation
transactions/views.py - Transaction endpoints → Spend and thresholds: uses budget logic
transactions/views.py - Transaction endpoints → Reward calculations: uses reward logic
transactions/views.py - Budget endpoints → Spend and thresholds: computes spend
budgets/services.py - Spend and thresholds → Transaction records: aggregates spend
budgets/services.py - Spend and thresholds → Budgets and alerts: creates alerts
budgets/services.py - Budget signals → Spend and thresholds: evaluates thresholds
budgets/signals.py - Budget signals → Transaction records: observes transactions
budgets/signals.py - Budget endpoints → Budgets and alerts: manages
- Card endpoints → Card catalog and wallet: reads and writes
cards/views.py - Card endpoints → Reward calculations: requests rewards
cards/views.py - Card optimizer → Card catalog and wallet: ranks wallet rules
optimizer/services.py - Reward calculations → Card catalog and wallet: reads reward rules
transactions/rewards.py - Spending analytics → Transaction records: reads transactions
analytics_views.py - Spending analytics → Budgets and alerts: reads budgets
analytics_views.py - Spending analytics → Reward calculations: uses reward logic
analytics_views.py