# flp-zarato/controle-gastos-app architecture

> Architecture diagram of the GitHub repository flp-zarato/controle-gastos-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/flp-zarato/controle-gastos-app
- Repository: https://github.com/flp-zarato/controle-gastos-app

## Overview

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: [`app/src/main/java/com/flpzarato/controlegastos/data/repository/ExpenseRepository.kt`](https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/data/repository/ExpenseRepository.kt) (Expense repository), [`app/src/main/java/com/flpzarato/controlegastos/data/repository/SheetsSyncRepository.kt`](https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/data/repository/SheetsSyncRepository.kt) (Sync reconciliation), [`app/src/main/java/com/flpzarato/controlegastos/data/repository`](https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/data/repository) (Other repositories), [`app/src/main/java/com/flpzarato/controlegastos/sync/SheetsSyncWorker.kt`](https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/sync/SheetsSyncWorker.kt) (Background worker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["App experience"]
  node_entry["Android entry<br/>[MainActivity.kt]"]
  node_navigation["Navigation"]
  node_login["Google login"]
  node_expenseui["Expense entry"]
  node_home["Expense overview"]
  node_listing["Expense listing"]
  node_invoice["Invoice views"]
  node_cardsui["Card management"]
  node_categoriesui["Category management"]
  node_recurringui["Recurring expenses"]
end

subgraph group_domain["Expense workflows"]
  node_expenseflow["Expense repository"]
  node_installments["Installment rules"]
  node_otherrepos["Other repositories"]
end

subgraph group_storage["Local data"]
  node_room[("Room database<br/>[AppDatabase.kt]")]
  node_daos["Data access"]
  node_entities["Expense model<br/>[ExpenseEntity.kt]"]
end

subgraph group_sync["Sheets synchronization"]
  node_scheduler["Sync scheduler<br/>[SyncScheduler.kt]"]
  node_worker["Background worker"]
  node_syncrepo["Sync reconciliation"]
  node_status["Sync status"]
  node_sheets["Google Sheets API<br/>[SheetsApi.kt]"]
end

subgraph group_identity["Google access"]
  node_authmanager["Google authorization"]
  node_preferences["User preferences<br/>[UserPreferences.kt]"]
end

node_person(("App user"))
node_spreadsheet[("Shared spreadsheet")]

node_person -->|"opens"| node_entry
node_entry -->|"starts"| node_navigation
node_person -.->|"signs in"| node_login
node_login -.->|"requests identity"| node_authmanager
node_person -.->|"enters purchase"| node_expenseui
node_expenseui -->|"creates expense"| node_expenseflow
node_expenseflow -->|"calculates installments"| node_installments
node_expenseflow -->|"writes expense rows"| node_daos
node_expenseflow -->|"requests sync"| node_scheduler
node_home -.->|"reads overview data"| node_otherrepos
node_listing -.->|"observes expenses"| node_expenseflow
node_invoice -.->|"reads card charges"| node_expenseflow
node_cardsui -.->|"manages cards"| node_otherrepos
node_categoriesui -.->|"manages categories"| node_otherrepos
node_recurringui -.->|"manages templates"| node_otherrepos
node_scheduler -->|"enqueues work"| node_worker
node_worker -->|"runs sync"| node_syncrepo
node_worker -->|"updates status"| node_status
node_syncrepo -->|"pulls and pushes"| node_daos
node_syncrepo -->|"reads and writes"| node_sheets
node_syncrepo -->|"reads account settings"| node_preferences
node_sheets -->|"exchanges rows"| node_spreadsheet
node_person -.->|"shares records"| node_spreadsheet
node_authmanager -.->|"provides access token"| node_sheets
node_room -->|"provides accessors"| node_daos

click node_entry "https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/MainActivity.kt"
click node_navigation "https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/ui/navigation"
click node_login "https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/ui/login"
click node_expenseui "https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/ui/expense"
click node_home "https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/ui/home"
click node_listing "https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/ui/listing"
click node_invoice "https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/ui/invoice"
click node_cardsui "https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/ui/cards"
click node_categoriesui "https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/ui/categories"
click node_recurringui "https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/ui/recurring"
click node_expenseflow "https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/data/repository/ExpenseRepository.kt"
click node_installments "https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/domain/InstallmentCalculator.kt"
click node_otherrepos "https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/data/repository"
click node_room "https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/data/local/AppDatabase.kt"
click node_daos "https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/data/local/dao"
click node_entities "https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/data/local/entity/ExpenseEntity.kt"
click node_scheduler "https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/sync/SyncScheduler.kt"
click node_worker "https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/sync/SheetsSyncWorker.kt"
click node_syncrepo "https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/data/repository/SheetsSyncRepository.kt"
click node_status "https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/sync/SyncStatusRepository.kt"
click node_sheets "https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/data/remote/SheetsApi.kt"
click node_authmanager "https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/data/remote/auth/GoogleAuthManager.kt"
click node_preferences "https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/data/prefs/UserPreferences.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_navigation,node_login,node_expenseui,node_home,node_listing,node_invoice,node_cardsui,node_categoriesui,node_recurringui,node_person toneBlue
class node_expenseflow,node_installments,node_otherrepos,node_spreadsheet toneAmber
class node_room,node_daos,node_entities toneMint
class node_scheduler,node_worker,node_syncrepo,node_status,node_sheets toneRose
class node_authmanager,node_preferences toneIndigo
```

## Components

### App experience

- [Android entry](https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/MainActivity.kt): `app/src/main/java/com/flpzarato/controlegastos/MainActivity.kt`
- [Navigation](https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/ui/navigation): `app/src/main/java/com/flpzarato/controlegastos/ui/navigation`
- [Google login](https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/ui/login): `app/src/main/java/com/flpzarato/controlegastos/ui/login`
- [Expense entry](https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/ui/expense): `app/src/main/java/com/flpzarato/controlegastos/ui/expense`
- [Expense overview](https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/ui/home): `app/src/main/java/com/flpzarato/controlegastos/ui/home`
- [Expense listing](https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/ui/listing): `app/src/main/java/com/flpzarato/controlegastos/ui/listing`
- [Invoice views](https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/ui/invoice): `app/src/main/java/com/flpzarato/controlegastos/ui/invoice`
- [Card management](https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/ui/cards): `app/src/main/java/com/flpzarato/controlegastos/ui/cards`
- [Category management](https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/ui/categories): `app/src/main/java/com/flpzarato/controlegastos/ui/categories`
- [Recurring expenses](https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/ui/recurring): `app/src/main/java/com/flpzarato/controlegastos/ui/recurring`

### Expense workflows

- [Expense repository](https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/data/repository/ExpenseRepository.kt): `app/src/main/java/com/flpzarato/controlegastos/data/repository/ExpenseRepository.kt`
- [Installment rules](https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/domain/InstallmentCalculator.kt): `app/src/main/java/com/flpzarato/controlegastos/domain/InstallmentCalculator.kt`
- [Other repositories](https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/data/repository): `app/src/main/java/com/flpzarato/controlegastos/data/repository`

### Local data

- [Room database](https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/data/local/AppDatabase.kt): `app/src/main/java/com/flpzarato/controlegastos/data/local/AppDatabase.kt`
- [Data access](https://github.com/flp-zarato/controle-gastos-app/tree/main/app/src/main/java/com/flpzarato/controlegastos/data/local/dao): `app/src/main/java/com/flpzarato/controlegastos/data/local/dao`
- [Expense model](https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/data/local/entity/ExpenseEntity.kt): `app/src/main/java/com/flpzarato/controlegastos/data/local/entity/ExpenseEntity.kt`

### Sheets synchronization

- [Sync scheduler](https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/sync/SyncScheduler.kt): `app/src/main/java/com/flpzarato/controlegastos/sync/SyncScheduler.kt`
- [Background worker](https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/sync/SheetsSyncWorker.kt): `app/src/main/java/com/flpzarato/controlegastos/sync/SheetsSyncWorker.kt`
- [Sync reconciliation](https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/data/repository/SheetsSyncRepository.kt): `app/src/main/java/com/flpzarato/controlegastos/data/repository/SheetsSyncRepository.kt`
- [Sync status](https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/sync/SyncStatusRepository.kt): `app/src/main/java/com/flpzarato/controlegastos/sync/SyncStatusRepository.kt`
- [Google Sheets API](https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/data/remote/SheetsApi.kt): `app/src/main/java/com/flpzarato/controlegastos/data/remote/SheetsApi.kt`

### Google access

- [Google authorization](https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/data/remote/auth/GoogleAuthManager.kt): `app/src/main/java/com/flpzarato/controlegastos/data/remote/auth/GoogleAuthManager.kt`
- [User preferences](https://github.com/flp-zarato/controle-gastos-app/blob/main/app/src/main/java/com/flpzarato/controlegastos/data/prefs/UserPreferences.kt): `app/src/main/java/com/flpzarato/controlegastos/data/prefs/UserPreferences.kt`

### Other components

- **App user**
- **Shared spreadsheet**

## Connections

- App user → Android entry: opens
- Android entry → Navigation: starts (evidence: `app/src/main/java/com/flpzarato/controlegastos/MainActivity.kt`)
- App user → Google login: signs in
- Google login → Google authorization: requests identity (evidence: `app/src/main/java/com/flpzarato/controlegastos/data/remote/auth/GoogleAuthManager.kt`)
- App user → Expense entry: enters purchase
- Expense entry → Expense repository: creates expense (evidence: `app/src/main/java/com/flpzarato/controlegastos/ui/expense/AddExpenseScreen.kt`)
- Expense repository → Installment rules: calculates installments (evidence: `app/src/main/java/com/flpzarato/controlegastos/data/repository/ExpenseRepository.kt`)
- Expense repository → Data access: writes expense rows (evidence: `app/src/main/java/com/flpzarato/controlegastos/data/repository/ExpenseRepository.kt`)
- Expense repository → Sync scheduler: requests sync (evidence: `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 (evidence: `app/src/main/java/com/flpzarato/controlegastos/sync/SyncScheduler.kt`)
- Background worker → Sync reconciliation: runs sync (evidence: `app/src/main/java/com/flpzarato/controlegastos/sync/SheetsSyncWorker.kt`)
- Background worker → Sync status: updates status (evidence: `app/src/main/java/com/flpzarato/controlegastos/sync/SheetsSyncWorker.kt`)
- Sync reconciliation → Data access: pulls and pushes (evidence: `app/src/main/java/com/flpzarato/controlegastos/data/repository/SheetsSyncRepository.kt`)
- Sync reconciliation → Google Sheets API: reads and writes (evidence: `app/src/main/java/com/flpzarato/controlegastos/data/repository/SheetsSyncRepository.kt`)
- Sync reconciliation → User preferences: reads account settings (evidence: `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 (evidence: `app/src/main/java/com/flpzarato/controlegastos/data/remote/auth/GoogleAuthManager.kt`)
- Room database → Data access: provides accessors (evidence: `app/src/main/java/com/flpzarato/controlegastos/data/local/AppDatabase.kt`)
