How karunnagaraj/financetracker works
This is an Android personal finance tracker. The tree suggests a user journey from the app entry point into dashboard, transaction, insight, and settings screens; transactions can be captured from SMS or imported from CSV, then categorized and stored. Dashboard and insights provide different views of tracked spending. The supplied README is empty and no runtime source files were excerpted, so the components and feature areas below are identified from filenames; unverified runtime relationships are shown as dashed edges without evidence paths.
Main entry points: MainScreen.kt Main screen · TransactionRepository.kt Transaction repository · AppDatabase.kt Room database · TransactionsScreen.kt Transaction list
Components 23
App and Navigation
- Activity entry
app/src/main/java/com/example/financetracker/MainActivity.kt - Main screen
app/src/main/java/com/example/financetracker/MainScreen.kt - Screen routes
app/src/main/java/com/example/financetracker/navigation/Screen.kt
Finance Views
- Dashboard
app/src/main/java/com/example/financetracker/ui/screens/dashboard/DashboardScreen.kt - Dashboard state
app/src/main/java/com/example/financetracker/ui/viewmodels/DashboardViewModel.kt - Spending insights
app/src/main/java/com/example/financetracker/ui/screens/insights/InsightsScreen.kt - Transaction list
app/src/main/java/com/example/financetracker/ui/screens/transactions/TransactionsScreen.kt - Transaction state
app/src/main/java/com/example/financetracker/ui/viewmodels/TransactionsViewModel.kt - Categorization sheet
app/src/main/java/com/example/financetracker/ui/screens/transactions/components/CategorizeBottomSheet.kt - Settings and import
app/src/main/java/com/example/financetracker/ui/screens/settings/SettingsScreen.kt
Transaction Storage
- Transaction repository
app/src/main/java/com/example/financetracker/data/repository/TransactionRepository.kt - Room database
app/src/main/java/com/example/financetracker/data/AppDatabase.kt - Transaction DAO
app/src/main/java/com/example/financetracker/data/dao/TransactionDAO.kt - Category DAO
app/src/main/java/com/example/financetracker/data/dao/CustomCategoryDAO.kt - Merchant rule DAO
app/src/main/java/com/example/financetracker/data/dao/MerchantRuleDAO.kt - Finance entities
app/src/main/java/com/example/financetracker/data/entity
Transaction Capture
- SMS receiver
app/src/main/java/com/example/financetracker/utils/SmsReceiver.kt - SMS parser
app/src/main/java/com/example/financetracker/utils/SmsParser.kt - Transaction classifier
app/src/main/java/com/example/financetracker/utils/TransactionClassifier.kt - CSV importer
app/src/main/java/com/example/financetracker/utils/CsvImporter.kt
Other components
- Finance user
- SMS source
- CSV file
Connections 24
- Finance user → Activity entry: opens
- Activity entry → Main screen: launches
- Main screen → Screen routes: routes via
- Main screen → Dashboard: shows
- Main screen → Spending insights: shows
- Main screen → Transaction list: shows
- Main screen → Settings and import: shows
- Dashboard → Dashboard state: uses state
- Dashboard state → Transaction repository: requests data
- Transaction list → Transaction state: uses state
- Transaction list → Categorization sheet: offers categorization
- Transaction state → Transaction repository: requests data
- Settings and import → CSV importer: imports CSV
- SMS source → SMS receiver: delivers messages
- SMS receiver → SMS parser: forwards message
- SMS parser → Transaction classifier: classifies parsed data
- CSV file → CSV importer: provides rows
- Transaction classifier → Transaction repository: submits transaction
- CSV importer → Transaction repository: submits transactions
- Transaction repository → Transaction DAO: accesses transactions
- Transaction DAO → Room database: queries
- Category DAO → Room database: queries
- Merchant rule DAO → Room database: queries
- Room database → Finance entities: stores records