# giovanischiar/rule-of-three-wearos architecture

> Architecture diagram of the GitHub repository giovanischiar/rule-of-three-wearos, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/giovanischiar/rule-of-three-wearos
- Repository: https://github.com/giovanischiar/rule-of-three-wearos

## Overview

Rule Of 3 is a WearOS app for entering three values, calculating the fourth by cross-multiplication, viewing a result with adjustable precision, and browsing or editing calculation history. The main flow starts at the Android activity, navigates to the calculator, and passes input actions through its ViewModel and repository to the calculation model and persistence abstractions. History has a separate repository and ViewModel. The README documents Room persistence and the result/history capabilities; unsampled storage wiring is represented conservatively because its call paths were not shown.

Main entry points: [`app/src/main/java/io/schiar/ruleofthree/model/repository/CrossMultipliersCreatorRepository.kt`](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/model/repository/CrossMultipliersCreatorRepository.kt) (Calculator repository), [`app/src/main/java/io/schiar/ruleofthree/view/navigation/Navigation.kt`](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/view/navigation/Navigation.kt) (Navigation), [`app/src/main/java/io/schiar/ruleofthree/view/crossmultiplierscreator/CrossMultipliersCreatorScreen.kt`](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/view/crossmultiplierscreator/CrossMultipliersCreatorScreen.kt) (Calculator screen), [`app/src/main/java/io/schiar/ruleofthree/viewmodel/CrossMultipliersCreatorViewModel.kt`](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/viewmodel/CrossMultipliersCreatorViewModel.kt) (Calculator ViewModel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and navigation"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_navigation["Navigation<br/>[Navigation.kt]"]
end

subgraph group_calculator["Calculation workflow"]
  node_creator_screen["Calculator screen"]
  node_calculator_view["Calculator components"]
  node_creator_vm["Calculator ViewModel"]
  node_creator_repo["Calculator repository"]
  node_multiplier["Cross-multiplication model<br/>[CrossMultiplier.kt]"]
  node_input["Input model<br/>[Input.kt]"]
  node_viewdata["View data mapping<br/>[ModelToViewData.kt]"]
end

subgraph group_history["History workflow"]
  node_history_screen["History screen<br/>[HistoryScreen.kt]"]
  node_history_vm["History ViewModel"]
  node_history_repo["History repository"]
end

subgraph group_storage["Persistence"]
  node_history_data["History data source"]
  node_current_data["Current data source"]
  node_local_data["Local data sources"]
  node_room_database[("Room database")]
  node_past_dao["History DAO"]
end

node_user(("App user"))

node_user -->|"opens"| node_activity
node_activity -->|"starts"| node_navigation
node_navigation -->|"routes to"| node_creator_screen
node_navigation -->|"routes to"| node_history_screen
node_creator_screen -->|"uses"| node_creator_vm
node_creator_screen -->|"renders"| node_calculator_view
node_creator_vm -->|"delegates to"| node_creator_repo
node_creator_repo -->|"calculates with"| node_multiplier
node_multiplier -->|"uses"| node_input
node_creator_vm -->|"maps to"| node_viewdata
node_history_screen -->|"uses"| node_history_vm
node_history_vm -->|"delegates to"| node_history_repo
node_history_repo -->|"reads and writes"| node_history_data
node_creator_repo -->|"reads and updates"| node_current_data
node_creator_repo -->|"adds calculations"| node_history_data
node_local_data -->|"implements"| node_history_data
node_room_database -->|"provides"| node_past_dao
node_local_data -.->|"persists through"| node_room_database

click node_activity "https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/MainActivity.kt"
click node_navigation "https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/view/navigation/Navigation.kt"
click node_creator_screen "https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/view/crossmultiplierscreator/CrossMultipliersCreatorScreen.kt"
click node_calculator_view "https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/view/shared/component/CrossMultiplierView.kt"
click node_creator_vm "https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/viewmodel/CrossMultipliersCreatorViewModel.kt"
click node_creator_repo "https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/model/repository/CrossMultipliersCreatorRepository.kt"
click node_multiplier "https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/model/CrossMultiplier.kt"
click node_input "https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/model/Input.kt"
click node_viewdata "https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/viewmodel/util/ModelToViewData.kt"
click node_history_screen "https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/view/history/HistoryScreen.kt"
click node_history_vm "https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/viewmodel/HistoryViewModel.kt"
click node_history_repo "https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/model/repository/HistoryRepository.kt"
click node_history_data "https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/model/datasource/PastCrossMultipliersDataSource.kt"
click node_current_data "https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/model/datasource/CurrentCrossMultiplierDataSource.kt"
click node_local_data "https://github.com/giovanischiar/rule-of-three-wearos/tree/main/app/src/main/java/io/schiar/ruleofthree/model/datasource/local"
click node_room_database "https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/library/room/RuleOfThreeRoomDatabase.kt"
click node_past_dao "https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/library/room/PastCrossMultipliersRoomDAO.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_activity,node_navigation,node_user toneBlue
class node_creator_screen,node_calculator_view,node_creator_vm,node_creator_repo,node_multiplier,node_input,node_viewdata toneAmber
class node_history_screen,node_history_vm,node_history_repo toneMint
class node_history_data,node_current_data,node_local_data,node_room_database,node_past_dao toneRose
```

## Components

### App and navigation

- [Main activity](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/MainActivity.kt): `app/src/main/java/io/schiar/ruleofthree/MainActivity.kt`
- [Navigation](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/view/navigation/Navigation.kt): `app/src/main/java/io/schiar/ruleofthree/view/navigation/Navigation.kt`

### Calculation workflow

- [Calculator screen](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/view/crossmultiplierscreator/CrossMultipliersCreatorScreen.kt): `app/src/main/java/io/schiar/ruleofthree/view/crossmultiplierscreator/CrossMultipliersCreatorScreen.kt`
- [Calculator components](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/view/shared/component/CrossMultiplierView.kt): `app/src/main/java/io/schiar/ruleofthree/view/shared/component/CrossMultiplierView.kt`
- [Calculator ViewModel](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/viewmodel/CrossMultipliersCreatorViewModel.kt): `app/src/main/java/io/schiar/ruleofthree/viewmodel/CrossMultipliersCreatorViewModel.kt`
- [Calculator repository](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/model/repository/CrossMultipliersCreatorRepository.kt): `app/src/main/java/io/schiar/ruleofthree/model/repository/CrossMultipliersCreatorRepository.kt`
- [Cross-multiplication model](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/model/CrossMultiplier.kt): `app/src/main/java/io/schiar/ruleofthree/model/CrossMultiplier.kt`
- [Input model](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/model/Input.kt): `app/src/main/java/io/schiar/ruleofthree/model/Input.kt`
- [View data mapping](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/viewmodel/util/ModelToViewData.kt): `app/src/main/java/io/schiar/ruleofthree/viewmodel/util/ModelToViewData.kt`

### History workflow

- [History screen](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/view/history/HistoryScreen.kt): `app/src/main/java/io/schiar/ruleofthree/view/history/HistoryScreen.kt`
- [History ViewModel](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/viewmodel/HistoryViewModel.kt): `app/src/main/java/io/schiar/ruleofthree/viewmodel/HistoryViewModel.kt`
- [History repository](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/model/repository/HistoryRepository.kt): `app/src/main/java/io/schiar/ruleofthree/model/repository/HistoryRepository.kt`

### Persistence

- [History data source](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/model/datasource/PastCrossMultipliersDataSource.kt): `app/src/main/java/io/schiar/ruleofthree/model/datasource/PastCrossMultipliersDataSource.kt`
- [Current data source](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/model/datasource/CurrentCrossMultiplierDataSource.kt): `app/src/main/java/io/schiar/ruleofthree/model/datasource/CurrentCrossMultiplierDataSource.kt`
- [Local data sources](https://github.com/giovanischiar/rule-of-three-wearos/tree/main/app/src/main/java/io/schiar/ruleofthree/model/datasource/local): `app/src/main/java/io/schiar/ruleofthree/model/datasource/local`
- [Room database](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/library/room/RuleOfThreeRoomDatabase.kt): `app/src/main/java/io/schiar/ruleofthree/library/room/RuleOfThreeRoomDatabase.kt`
- [History DAO](https://github.com/giovanischiar/rule-of-three-wearos/blob/main/app/src/main/java/io/schiar/ruleofthree/library/room/PastCrossMultipliersRoomDAO.kt): `app/src/main/java/io/schiar/ruleofthree/library/room/PastCrossMultipliersRoomDAO.kt`

### Other components

- **App user**

## Connections

- App user → Main activity: opens (evidence: `app/src/main/java/io/schiar/ruleofthree/MainActivity.kt`)
- Main activity → Navigation: starts (evidence: `app/src/main/java/io/schiar/ruleofthree/MainActivity.kt`)
- Navigation → Calculator screen: routes to (evidence: `app/src/main/java/io/schiar/ruleofthree/view/navigation/Navigation.kt`)
- Navigation → History screen: routes to (evidence: `app/src/main/java/io/schiar/ruleofthree/view/navigation/Navigation.kt`)
- Calculator screen → Calculator ViewModel: uses (evidence: `app/src/main/java/io/schiar/ruleofthree/view/crossmultiplierscreator/CrossMultipliersCreatorScreen.kt`)
- Calculator screen → Calculator components: renders (evidence: `app/src/main/java/io/schiar/ruleofthree/view/crossmultiplierscreator/CrossMultipliersCreatorScreen.kt`)
- Calculator ViewModel → Calculator repository: delegates to (evidence: `app/src/main/java/io/schiar/ruleofthree/viewmodel/CrossMultipliersCreatorViewModel.kt`)
- Calculator repository → Cross-multiplication model: calculates with (evidence: `app/src/main/java/io/schiar/ruleofthree/model/repository/CrossMultipliersCreatorRepository.kt`)
- Cross-multiplication model → Input model: uses (evidence: `app/src/main/java/io/schiar/ruleofthree/model/CrossMultiplier.kt`)
- Calculator ViewModel → View data mapping: maps to (evidence: `app/src/main/java/io/schiar/ruleofthree/viewmodel/CrossMultipliersCreatorViewModel.kt`)
- History screen → History ViewModel: uses (evidence: `app/src/main/java/io/schiar/ruleofthree/view/history/HistoryScreen.kt`)
- History ViewModel → History repository: delegates to (evidence: `app/src/main/java/io/schiar/ruleofthree/viewmodel/HistoryViewModel.kt`)
- History repository → History data source: reads and writes (evidence: `app/src/main/java/io/schiar/ruleofthree/model/repository/HistoryRepository.kt`)
- Calculator repository → Current data source: reads and updates (evidence: `app/src/main/java/io/schiar/ruleofthree/model/repository/CrossMultipliersCreatorRepository.kt`)
- Calculator repository → History data source: adds calculations (evidence: `app/src/main/java/io/schiar/ruleofthree/model/repository/CrossMultipliersCreatorRepository.kt`)
- Local data sources → History data source: implements (evidence: `app/src/main/java/io/schiar/ruleofthree/model/datasource/local/PastCrossMultipliersLocalDataSource.kt`)
- Room database → History DAO: provides (evidence: `app/src/main/java/io/schiar/ruleofthree/library/room/RuleOfThreeRoomDatabase.kt`)
- Local data sources → Room database: persists through
