How flp-zarato/controle-gastos-app works
Controle de Gastos is an offline-first Android app for shared household expense tracking. Users sign in with Google and configure a shared spreadsheet; expense entry saves to the local Room-backed model, calculates card installments and invoice months, and schedules sync. Background sync reconciles local records with Google Sheets so both users see shared expenses. Other major branches cover categories, cards, recurring expenses and invoice views. Unsampled UI and remote-client details are represented at their exact tree directories; their internal call links are omitted where source evidence was not provided.
Main entry points: ExpenseRepository.kt Expense repository · SheetsSyncRepository.kt Sync reconciliation · repository Other repositories · SheetsSyncWorker.kt Background worker
Components 25
App experience
- Android entry
app/src/main/java/com/flpzarato/controlegastos/MainActivity.kt - Navigation
app/src/main/java/com/flpzarato/controlegastos/ui/navigation - Google login
app/src/main/java/com/flpzarato/controlegastos/ui/login - Expense entry
app/src/main/java/com/flpzarato/controlegastos/ui/expense - Expense overview
app/src/main/java/com/flpzarato/controlegastos/ui/home - Expense listing
app/src/main/java/com/flpzarato/controlegastos/ui/listing - Invoice views
app/src/main/java/com/flpzarato/controlegastos/ui/invoice - Card management
app/src/main/java/com/flpzarato/controlegastos/ui/cards - Category management
app/src/main/java/com/flpzarato/controlegastos/ui/categories - Recurring expenses
app/src/main/java/com/flpzarato/controlegastos/ui/recurring
Expense workflows
- Expense repository
app/src/main/java/com/flpzarato/controlegastos/data/repository/ExpenseRepository.kt - Installment rules
app/src/main/java/com/flpzarato/controlegastos/domain/InstallmentCalculator.kt - Other repositories
app/src/main/java/com/flpzarato/controlegastos/data/repository
Local data
- Room database
app/src/main/java/com/flpzarato/controlegastos/data/local/AppDatabase.kt - Data access
app/src/main/java/com/flpzarato/controlegastos/data/local/dao - Expense model
app/src/main/java/com/flpzarato/controlegastos/data/local/entity/ExpenseEntity.kt
Sheets synchronization
- Sync scheduler
app/src/main/java/com/flpzarato/controlegastos/sync/SyncScheduler.kt - Background worker
app/src/main/java/com/flpzarato/controlegastos/sync/SheetsSyncWorker.kt - Sync reconciliation
app/src/main/java/com/flpzarato/controlegastos/data/repository/SheetsSyncRepository.kt - Sync status
app/src/main/java/com/flpzarato/controlegastos/sync/SyncStatusRepository.kt - Google Sheets API
app/src/main/java/com/flpzarato/controlegastos/data/remote/SheetsApi.kt
Google access
- Google authorization
app/src/main/java/com/flpzarato/controlegastos/data/remote/auth/GoogleAuthManager.kt - User preferences
app/src/main/java/com/flpzarato/controlegastos/data/prefs/UserPreferences.kt
Other components
- App user
- Shared spreadsheet
Connections 25
- App user → Android entry: opens
- Android entry → Navigation: starts
app/src/main/java/com/flpzarato/controlegastos/MainActivity.kt - App user → Google login: signs in
- Google login → Google authorization: requests identity
app/src/main/java/com/flpzarato/controlegastos/data/remote/auth/GoogleAuthManager.kt - App user → Expense entry: enters purchase
- Expense entry → Expense repository: creates expense
app/src/main/java/com/flpzarato/controlegastos/ui/expense/AddExpenseScreen.kt - Expense repository → Installment rules: calculates installments
app/src/main/java/com/flpzarato/controlegastos/data/repository/ExpenseRepository.kt - Expense repository → Data access: writes expense rows
app/src/main/java/com/flpzarato/controlegastos/data/repository/ExpenseRepository.kt - Expense repository → Sync scheduler: requests sync
app/src/main/java/com/flpzarato/controlegastos/data/repository/ExpenseRepository.kt - Expense overview → Other repositories: reads overview data
- Expense listing → Expense repository: observes expenses
- Invoice views → Expense repository: reads card charges
- Card management → Other repositories: manages cards
- Category management → Other repositories: manages categories
- Recurring expenses → Other repositories: manages templates
- Sync scheduler → Background worker: enqueues work
app/src/main/java/com/flpzarato/controlegastos/sync/SyncScheduler.kt - Background worker → Sync reconciliation: runs sync
app/src/main/java/com/flpzarato/controlegastos/sync/SheetsSyncWorker.kt - Background worker → Sync status: updates status
app/src/main/java/com/flpzarato/controlegastos/sync/SheetsSyncWorker.kt - Sync reconciliation → Data access: pulls and pushes
app/src/main/java/com/flpzarato/controlegastos/data/repository/SheetsSyncRepository.kt - Sync reconciliation → Google Sheets API: reads and writes
app/src/main/java/com/flpzarato/controlegastos/data/repository/SheetsSyncRepository.kt - Sync reconciliation → User preferences: reads account settings
app/src/main/java/com/flpzarato/controlegastos/data/repository/SheetsSyncRepository.kt - Google Sheets API → Shared spreadsheet: exchanges rows
- App user → Shared spreadsheet: shares records
- Google authorization → Google Sheets API: provides access token
app/src/main/java/com/flpzarato/controlegastos/data/remote/auth/GoogleAuthManager.kt - Room database → Data access: provides accessors
app/src/main/java/com/flpzarato/controlegastos/data/local/AppDatabase.kt