How nvm2478/flowt works
Flowt is an Android personal-expense ledger. Users record and edit transactions, browse a categorized ledger and reports, configure metrics and appearance, and import or export bill files. The main route is Activity → app state/navigation → entry UI → transaction repository → Room; the same state layer supplies ledger/report views. Import includes parsing, mapping, duplicate review, and persistence; export builds and encodes tables. The index identifies other subsystems, but their internal calls are not asserted where excerpts do not show them.
Main entry points: AppViewModel.kt App state · FlowtApp.kt App navigation · ImportService.kt Import planning · ExportService.kt Export service
Components 24
App and screens
- Android activity
app/src/main/java/com/flowt/app/MainActivity.kt - App navigation
app/src/main/java/com/flowt/app/ui/FlowtApp.kt - Entry and edit
app/src/main/java/com/flowt/app/ui/entry/EntryScreen.kt - Ledger view
app/src/main/java/com/flowt/app/ui/ledger/LedgerScreen.kt - Reports
app/src/main/java/com/flowt/app/ui/report/ReportScreen.kt - Settings
app/src/main/java/com/flowt/app/ui/settings - App state
app/src/main/java/com/flowt/app/ui/AppViewModel.kt
Ledger data
- Transaction repository
app/src/main/java/com/flowt/app/data/TxRepository.kt - Category repository
app/src/main/java/com/flowt/app/data/CategoryRepository.kt - Transactions
app/src/main/java/com/flowt/app/data/db/TransactionEntity.kt - Category tree
app/src/main/java/com/flowt/app/data/db/Category.kt - Room database
app/src/main/java/com/flowt/app/data/db/FlowtDatabase.kt
Bill interchange
- Import review
app/src/main/java/com/flowt/app/ui/settings/ImportScreen.kt - Import planning
app/src/main/java/com/flowt/app/data/bill/ImportService.kt - Bill table parsing
app/src/main/java/com/flowt/app/data/bill/BillTable.kt - Export service
app/src/main/java/com/flowt/app/data/bill/ExportService.kt - CSV codecs
app/src/main/java/com/flowt/app/data/bill/CsvWriter.kt - XLSX codecs
app/src/main/java/com/flowt/app/data/bill/XlsxWriter.kt
Metrics
- Metric calculations
app/src/main/java/com/flowt/app/metrics/MetricValue.kt - Metric definitions
app/src/main/java/com/flowt/app/metrics/LedgerMetric.kt
Appearance
- Preferences
app/src/main/java/com/flowt/app/data/PrefsRepository.kt - Theme roles
app/src/main/java/com/flowt/app/ui/theme/FlowtTheme.kt - Color palette
app/src/main/java/com/flowt/app/ui/theme/FlowtColors.kt
Other components
- User
Connections 36
- User → Android activity: opens app
app/src/main/java/com/flowt/app/MainActivity.kt - Android activity → App navigation: sets content
app/src/main/java/com/flowt/app/MainActivity.kt - Android activity → App state: creates
app/src/main/java/com/flowt/app/MainActivity.kt - Android activity → Theme roles: applies
app/src/main/java/com/flowt/app/MainActivity.kt - User → Entry and edit: records spending
- App navigation → Entry and edit: shows
app/src/main/java/com/flowt/app/ui/FlowtApp.kt - App navigation → Ledger view: shows
app/src/main/java/com/flowt/app/ui/FlowtApp.kt - App navigation → Reports: shows
app/src/main/java/com/flowt/app/ui/FlowtApp.kt - App navigation → Settings: shows
app/src/main/java/com/flowt/app/ui/FlowtApp.kt - Entry and edit → App state: uses
app/src/main/java/com/flowt/app/ui/entry/EntryScreen.kt - App state → Transaction repository: observes and updates
app/src/main/java/com/flowt/app/ui/AppViewModel.kt - App state → Category repository: uses
app/src/main/java/com/flowt/app/ui/AppViewModel.kt - App state → Import planning: invokes
app/src/main/java/com/flowt/app/ui/AppViewModel.kt - App state → Export service: invokes
app/src/main/java/com/flowt/app/ui/AppViewModel.kt - Ledger view → App state: reads state
- Reports → App state: reads state
- Transaction repository → Room database: accesses
app/src/main/java/com/flowt/app/data/TxRepository.kt - Category repository → Room database: accesses
app/src/main/java/com/flowt/app/data/CategoryRepository.kt - Room database → Transactions: stores
app/src/main/java/com/flowt/app/data/db/FlowtDatabase.kt - Room database → Category tree: stores
app/src/main/java/com/flowt/app/data/db/FlowtDatabase.kt - Import review → App state: requests import
app/src/main/java/com/flowt/app/ui/settings/ImportScreen.kt - Import planning → Bill table parsing: parses rows
app/src/main/java/com/flowt/app/data/bill/ImportService.kt - Import planning → Category repository: loads and creates categories
app/src/main/java/com/flowt/app/data/bill/ImportService.kt - Import planning → Transaction repository: checks and inserts
app/src/main/java/com/flowt/app/data/bill/ImportService.kt - Import planning → Preferences: records imported file
app/src/main/java/com/flowt/app/data/bill/ImportService.kt - Export service → Transaction repository: reads transactions
app/src/main/java/com/flowt/app/data/bill/ExportService.kt - Export service → Category repository: reads categories
app/src/main/java/com/flowt/app/data/bill/ExportService.kt - Export service → CSV codecs: encodes CSV
app/src/main/java/com/flowt/app/data/bill/ExportService.kt - Export service → XLSX codecs: encodes XLSX
app/src/main/java/com/flowt/app/data/bill/ExportService.kt - App state → Preferences: observes preferences
app/src/main/java/com/flowt/app/ui/AppViewModel.kt - Settings → App state: updates settings
app/src/main/java/com/flowt/app/ui/settings/ImportScreen.kt - Theme roles → Color palette: provides palette
app/src/main/java/com/flowt/app/ui/theme/FlowtColors.kt - App state → Metric calculations: computes metrics
app/src/main/java/com/flowt/app/ui/AppViewModel.kt - Metric calculations → Metric definitions: uses definitions
app/src/main/java/com/flowt/app/metrics/MetricValue.kt - Metric calculations → Transactions: calculates from
app/src/main/java/com/flowt/app/metrics/MetricValue.kt - Ledger view → Metric calculations: renders values
app/src/main/java/com/flowt/app/ui/ledger/LedgerScreen.kt