How hohrandrey/finlytics works
Finlytics is an offline desktop personal-finance tracker. The user enters or edits income and expense operations, organizes them with categories, and reviews filtered history and financial summaries. The runtime flow runs from the desktop entry point through Compose navigation and screens, via a stateful view model and repository, to SQLite persistence. The README also documents filtering, category management, charts, and statistics. Edges reflect shown calls or README-described capabilities; unsampled relationships are omitted rather than inferred.
Main entry points: FinanceViewModel.kt Finance state logic · Main.kt Desktop entry · AppNavigation.kt Screen navigation · OverviewScreen.kt Overview analytics
Components 21
Desktop application
- Desktop entry
src/main/kotlin/Main.kt - App shell
src/main/kotlin/ui/App.kt - Screen navigation
src/main/kotlin/ui/AppNavigation.kt
Finance experience
- Overview analytics
src/main/kotlin/ui/screens/OverviewScreen.kt - Operation history
src/main/kotlin/ui/screens/HistoryScreen.kt - Category settings
src/main/kotlin/ui/screens/SettingsScreen.kt - Operation editor
src/main/kotlin/ui/components/OperationDialog.kt - Category editor
src/main/kotlin/ui/components/AddCategoryDialog.kt - Navigation bar
src/main/kotlin/ui/components/NavigationBar.kt - Pie chart
src/main/kotlin/ui/components/PieChart.kt - Comparison progress
src/main/kotlin/ui/components/GhostRaceProgressBar.kt
State and domain
- Finance state logic
src/main/kotlin/viewmodel/FinanceViewModel.kt - Finance state
src/main/kotlin/viewmodel/FinanceState.kt - Operation model
src/main/kotlin/models/Operation.kt - Finance repository
src/main/kotlin/repository/FinanceRepository.kt
SQLite persistence
- Database initialization
src/main/kotlin/db/database_request/DatabaseInitializer.kt - SQLite configuration
src/main/kotlin/db/database_request/DatabaseConfig.kt - Category requests
src/main/kotlin/db/database_request - Transaction requests
src/main/kotlin/db/database_request - SQLite database
Other components
- Desktop user
Connections 31
- Desktop user → Desktop entry: launches
src/main/kotlin/Main.kt - Desktop entry → App shell: renders
src/main/kotlin/Main.kt - Desktop entry → Finance state logic: creates
src/main/kotlin/Main.kt - Desktop entry → Operation editor: shows
src/main/kotlin/Main.kt - Desktop entry → Category editor: shows
src/main/kotlin/Main.kt - App shell → Screen navigation: renders
src/main/kotlin/ui/App.kt - Screen navigation → Overview analytics: routes
src/main/kotlin/ui/AppNavigation.kt - Screen navigation → Operation history: routes
src/main/kotlin/ui/AppNavigation.kt - Screen navigation → Category settings: routes
src/main/kotlin/ui/AppNavigation.kt - Screen navigation → Finance state logic: uses state
src/main/kotlin/ui/AppNavigation.kt - Overview analytics → Finance state logic: reads state
src/main/kotlin/ui/screens/OverviewScreen.kt - Operation history → Finance state logic: reads state
src/main/kotlin/ui/screens/HistoryScreen.kt - Category settings → Finance state logic: manages categories
src/main/kotlin/ui/screens/SettingsScreen.kt - Operation editor → Finance state logic: submits edits
src/main/kotlin/ui/components/OperationDialog.kt - Category editor → Finance state logic: submits category
src/main/kotlin/ui/components/AddCategoryDialog.kt - Operation history → Navigation bar: renders
src/main/kotlin/ui/screens/HistoryScreen.kt - Overview analytics → Navigation bar: renders
src/main/kotlin/ui/screens/OverviewScreen.kt - Category settings → Navigation bar: renders
src/main/kotlin/ui/screens/SettingsScreen.kt - Overview analytics → Pie chart: renders
src/main/kotlin/ui/screens/OverviewScreen.kt - Overview analytics → Comparison progress: renders
src/main/kotlin/ui/screens/OverviewScreen.kt - Finance state logic → Finance state: updates
src/main/kotlin/viewmodel/FinanceViewModel.kt - Finance state logic → Finance repository: loads and saves
src/main/kotlin/viewmodel/FinanceViewModel.kt - Finance repository → Operation model: uses model
src/main/kotlin/repository/FinanceRepository.kt - Finance repository → Database initialization: initializes
src/main/kotlin/repository/FinanceRepository.kt - Finance repository → Transaction requests: requests operations
src/main/kotlin/repository/FinanceRepository.kt - Finance repository → Category requests: requests categories
src/main/kotlin/repository/FinanceRepository.kt - Database initialization → SQLite configuration: configures
src/main/kotlin/db/database_request/DatabaseInitializer.kt - Database initialization → Category requests: seeds defaults
src/main/kotlin/db/database_request/DatabaseInitializer.kt - Transaction requests → SQLite database: reads and writes
- Category requests → SQLite database: reads and writes
- SQLite configuration → SQLite database: selects file