# diegoalvesol/mobileapps2-assignment2 architecture

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

- Interactive diagram: https://gitdiagram.com/diegoalvesol/mobileapps2-assignment2
- Repository: https://github.com/diegoalvesol/mobileapps2-assignment2

## Overview

StateAuthApp is a single-screen-flow Android app demonstrating Compose state, Firebase email/password authentication, and Kotlin exceptions. Users choose a demo from the menu: authentication gates access to the counters, while the exceptions screen runs two independent demos and displays their results. MainActivity owns navigation, authentication state, and demo result state; CounterScreen owns the counter state in the sampled implementation. The graph follows shown calls and README capabilities; Firebase is documented and invoked in MainActivity, while unsampled details are omitted.

Main entry points: [`StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/MainActivity.kt`](https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/MainActivity.kt) (Activity controller), [`StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/exceptions/WordChecker.kt`](https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/exceptions/WordChecker.kt) (Word length demo), [`StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/exceptions/DemoResult.kt`](https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/exceptions/DemoResult.kt) (Demo result), [`StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/LoginScreen.kt`](https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/LoginScreen.kt) (Login form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App flow"]
  node_main_activity["Activity controller<br/>[MainActivity.kt]"]
  node_navigation["Screen choices<br/>[AppScreen.kt]"]
  node_menu["Main menu<br/>[MainMenuScreen.kt]"]
end

subgraph group_auth_state["Auth and state"]
  node_login["Login form<br/>[LoginScreen.kt]"]
  node_firebase["Firebase Auth"]
  node_counter_state["Counter state<br/>[CounterScreen.kt]"]
  node_counter_display["Counter display<br/>[CounterDisplay.kt]"]
end

subgraph group_exceptions["Exception demos"]
  node_exceptions_screen["Exceptions screen"]
  node_preconditions["Precondition demo"]
  node_word_demo["Word length demo<br/>[WordChecker.kt]"]
  node_word_exception["Length exception"]
  node_demo_result["Demo result<br/>[DemoResult.kt]"]
end

subgraph group_presentation["UI presentation"]
  node_colors["Theme colors<br/>[Color.kt]"]
end

node_user(("App user"))

node_user -->|"chooses demo"| node_menu
node_main_activity -->|"tracks screen"| node_navigation
node_main_activity -->|"renders"| node_menu
node_main_activity -->|"renders"| node_login
node_main_activity -->|"renders"| node_exceptions_screen
node_main_activity -->|"renders"| node_counter_state
node_main_activity -->|"authenticates users"| node_firebase
node_login -->|"submits credentials"| node_main_activity
node_main_activity -->|"runs demo"| node_preconditions
node_main_activity -->|"runs demo"| node_word_demo
node_counter_state -->|"passes state"| node_counter_display
node_exceptions_screen -->|"displays results"| node_demo_result
node_preconditions -->|"returns results"| node_demo_result
node_word_demo -->|"returns results"| node_demo_result
node_word_demo -->|"throws"| node_word_exception

click node_main_activity "https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/MainActivity.kt"
click node_navigation "https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/AppScreen.kt"
click node_menu "https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/MainMenuScreen.kt"
click node_login "https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/LoginScreen.kt"
click node_counter_state "https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/CounterScreen.kt"
click node_counter_display "https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/CounterDisplay.kt"
click node_exceptions_screen "https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/ExceptionsScreen.kt"
click node_preconditions "https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/exceptions/PreconditionDemo.kt"
click node_word_demo "https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/exceptions/WordChecker.kt"
click node_word_exception "https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/exceptions/WordTooLongException.kt"
click node_demo_result "https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/exceptions/DemoResult.kt"
click node_colors "https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/theme/Color.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_main_activity,node_navigation,node_menu,node_user toneBlue
class node_login,node_firebase,node_counter_state,node_counter_display toneAmber
class node_exceptions_screen,node_preconditions,node_word_demo,node_word_exception,node_demo_result toneMint
class node_colors toneRose
```

## Components

### App flow

- [Activity controller](https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/MainActivity.kt): `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/MainActivity.kt`
- [Screen choices](https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/AppScreen.kt): `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/AppScreen.kt`
- [Main menu](https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/MainMenuScreen.kt): `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/MainMenuScreen.kt`

### Auth and state

- [Login form](https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/LoginScreen.kt): `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/LoginScreen.kt`
- **Firebase Auth**
- [Counter state](https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/CounterScreen.kt): `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/CounterScreen.kt`
- [Counter display](https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/CounterDisplay.kt): `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/CounterDisplay.kt`

### Exception demos

- [Exceptions screen](https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/ExceptionsScreen.kt): `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/ExceptionsScreen.kt`
- [Precondition demo](https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/exceptions/PreconditionDemo.kt): `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/exceptions/PreconditionDemo.kt`
- [Word length demo](https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/exceptions/WordChecker.kt): `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/exceptions/WordChecker.kt`
- [Length exception](https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/exceptions/WordTooLongException.kt): `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/exceptions/WordTooLongException.kt`
- [Demo result](https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/exceptions/DemoResult.kt): `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/exceptions/DemoResult.kt`

### UI presentation

- [Theme colors](https://github.com/diegoalvesol/mobileapps2-assignment2/blob/main/StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/theme/Color.kt): `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/theme/Color.kt`

### Other components

- **App user**

## Connections

- App user → Main menu: chooses demo
- Activity controller → Screen choices: tracks screen (evidence: `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/MainActivity.kt`)
- Activity controller → Main menu: renders (evidence: `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/MainActivity.kt`)
- Activity controller → Login form: renders (evidence: `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/MainActivity.kt`)
- Activity controller → Exceptions screen: renders (evidence: `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/MainActivity.kt`)
- Activity controller → Counter state: renders (evidence: `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/MainActivity.kt`)
- Activity controller → Firebase Auth: authenticates users (evidence: `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/MainActivity.kt`)
- Login form → Activity controller: submits credentials (evidence: `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/MainActivity.kt`)
- Activity controller → Precondition demo: runs demo (evidence: `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/MainActivity.kt`)
- Activity controller → Word length demo: runs demo (evidence: `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/MainActivity.kt`)
- Counter state → Counter display: passes state (evidence: `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/CounterScreen.kt`)
- Exceptions screen → Demo result: displays results (evidence: `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/ui/ExceptionsScreen.kt`)
- Precondition demo → Demo result: returns results (evidence: `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/exceptions/PreconditionDemo.kt`)
- Word length demo → Demo result: returns results (evidence: `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/exceptions/WordChecker.kt`)
- Word length demo → Length exception: throws (evidence: `StateAuthApp/app/src/main/java/com/diegoalves/stateauthapp/exceptions/WordChecker.kt`)
