# fxxeii/savi architecture

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

- Interactive diagram: https://gitdiagram.com/fxxeii/savi
- Repository: https://github.com/fxxeii/savi

## Overview

SAVI is a Codename One personal and group savings app. Users enter through the app’s navigation and account screens, then manage savings and contributions, review home/calendar/reminder/people views, and inspect summaries or initiate transfers. The sampled code shows a shared Java UI and domain layer, with account and profile state plus group and personal savings lists. Several screens and domain modules are represented by the source index rather than excerpts, so their connections are included only where that index or an excerpt supports them; backend service behavior is not established.

Main entry points: [`common/src/main/java/com/savi/app/SAVI.java`](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/SAVI.java) (App Navigation), [`common/src/main/java/com/savi/app/frontend/HomePage.java`](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/frontend/HomePage.java) (Home Dashboard), [`common/src/main/java/com/savi/app/backend/GroupList.java`](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/backend/GroupList.java) (Savings Lists), [`common/src/main/java/com/savi/app/frontend/SummaryPage.java`](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/frontend/SummaryPage.java) (Savings Summary)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App Shell"]
  node_shell["App Navigation<br/>[SAVI.java]"]
end

subgraph group_views["User Workflows"]
  node_login["Login and Signup<br/>[LogInPage.java]"]
  node_homeview["Home Dashboard<br/>[HomePage.java]"]
  node_quickadd["Quick Add<br/>[QuickAddMenu.java]"]
  node_calendar["Calendar View<br/>[CalendarPage.java]"]
  node_reminders["Reminder View<br/>[ReminderPage.java]"]
  node_people["People View<br/>[PeoplePage.java]"]
  node_summary["Savings Summary<br/>[SummaryPage.java]"]
  node_transferview["Transfer Flow<br/>[TransferPage.java]"]
end

subgraph group_domain["Savings Domain"]
  node_home["Home Aggregation<br/>[Home.java]"]
  node_savings["Savings Records<br/>[Savings.java]"]
  node_groupsavings["Group Savings<br/>[GroupSavings.java]"]
  node_contribution["Contribution Record<br/>[Contribution.java]"]
  node_lists["Savings Lists<br/>[GroupList.java]"]
  node_transfer["Transfer Logic<br/>[Transfer.java]"]
  node_groupstats["Group Summary Logic<br/>[GroupSummary.java]"]
end

subgraph group_state["Account State"]
  node_auth[("User Accounts<br/>[User.java]")]
  node_profile[("Profile State<br/>[Profile.java]")]
end

node_user(("App User"))

node_user -->|"opens"| node_shell
node_shell -->|"navigates to"| node_homeview
node_shell -->|"navigates to"| node_calendar
node_shell -->|"navigates to"| node_people
node_shell -->|"opens"| node_quickadd
node_shell -->|"uses"| node_auth
node_shell -->|"uses"| node_profile
node_homeview -->|"reads overview"| node_home
node_homeview -->|"opens"| node_calendar
node_homeview -->|"opens"| node_transferview
node_homeview -->|"opens"| node_summary
node_homeview -->|"opens"| node_reminders
node_quickadd -->|"adds contributions"| node_lists
node_lists -->|"manages"| node_groupsavings
node_lists -->|"records"| node_contribution
node_savings -->|"stores"| node_contribution
node_summary -->|"reads summary"| node_groupstats
node_summary -->|"returns to"| node_homeview
node_transferview -->|"submits transfer"| node_transfer
node_transfer -->|"updates savings"| node_lists
node_people -->|"reads people data"| node_home
node_login -.->|"authenticates"| node_auth
node_reminders -.->|"reads dashboard data"| node_home

click node_shell "https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/SAVI.java"
click node_login "https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/frontend/LogInPage.java"
click node_homeview "https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/frontend/HomePage.java"
click node_quickadd "https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/frontend/QuickAddMenu.java"
click node_calendar "https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/frontend/CalendarPage.java"
click node_reminders "https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/frontend/ReminderPage.java"
click node_people "https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/frontend/PeoplePage.java"
click node_summary "https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/frontend/SummaryPage.java"
click node_transferview "https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/frontend/TransferPage.java"
click node_home "https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/backend/Home.java"
click node_savings "https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/backend/Savings.java"
click node_groupsavings "https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/backend/GroupSavings.java"
click node_contribution "https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/backend/Contribution.java"
click node_lists "https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/backend/GroupList.java"
click node_transfer "https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/backend/Transfer.java"
click node_groupstats "https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/backend/GroupSummary.java"
click node_auth "https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/backend/User.java"
click node_profile "https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/backend/Profile.java"

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_shell,node_user toneBlue
class node_login,node_homeview,node_quickadd,node_calendar,node_reminders,node_people,node_summary,node_transferview toneAmber
class node_home,node_savings,node_groupsavings,node_contribution,node_lists,node_transfer,node_groupstats toneMint
class node_auth,node_profile toneRose
```

## Components

### App Shell

- [App Navigation](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/SAVI.java): `common/src/main/java/com/savi/app/SAVI.java`

### User Workflows

- [Login and Signup](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/frontend/LogInPage.java): `common/src/main/java/com/savi/app/frontend/LogInPage.java`
- [Home Dashboard](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/frontend/HomePage.java): `common/src/main/java/com/savi/app/frontend/HomePage.java`
- [Quick Add](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/frontend/QuickAddMenu.java): `common/src/main/java/com/savi/app/frontend/QuickAddMenu.java`
- [Calendar View](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/frontend/CalendarPage.java): `common/src/main/java/com/savi/app/frontend/CalendarPage.java`
- [Reminder View](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/frontend/ReminderPage.java): `common/src/main/java/com/savi/app/frontend/ReminderPage.java`
- [People View](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/frontend/PeoplePage.java): `common/src/main/java/com/savi/app/frontend/PeoplePage.java`
- [Savings Summary](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/frontend/SummaryPage.java): `common/src/main/java/com/savi/app/frontend/SummaryPage.java`
- [Transfer Flow](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/frontend/TransferPage.java): `common/src/main/java/com/savi/app/frontend/TransferPage.java`

### Savings Domain

- [Home Aggregation](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/backend/Home.java): `common/src/main/java/com/savi/app/backend/Home.java`
- [Savings Records](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/backend/Savings.java): `common/src/main/java/com/savi/app/backend/Savings.java`
- [Group Savings](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/backend/GroupSavings.java): `common/src/main/java/com/savi/app/backend/GroupSavings.java`
- [Contribution Record](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/backend/Contribution.java): `common/src/main/java/com/savi/app/backend/Contribution.java`
- [Savings Lists](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/backend/GroupList.java): `common/src/main/java/com/savi/app/backend/GroupList.java`
- [Transfer Logic](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/backend/Transfer.java): `common/src/main/java/com/savi/app/backend/Transfer.java`
- [Group Summary Logic](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/backend/GroupSummary.java): `common/src/main/java/com/savi/app/backend/GroupSummary.java`

### Account State

- [User Accounts](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/backend/User.java): `common/src/main/java/com/savi/app/backend/User.java`
- [Profile State](https://github.com/fxxeii/savi/blob/master/common/src/main/java/com/savi/app/backend/Profile.java): `common/src/main/java/com/savi/app/backend/Profile.java`

### Other components

- **App User**

## Connections

- App User → App Navigation: opens (evidence: `common/src/main/java/com/savi/app/SAVI.java`)
- App Navigation → Home Dashboard: navigates to (evidence: `common/src/main/java/com/savi/app/SAVI.java`)
- App Navigation → Calendar View: navigates to (evidence: `common/src/main/java/com/savi/app/SAVI.java`)
- App Navigation → People View: navigates to (evidence: `common/src/main/java/com/savi/app/SAVI.java`)
- App Navigation → Quick Add: opens (evidence: `common/src/main/java/com/savi/app/SAVI.java`)
- App Navigation → User Accounts: uses (evidence: `common/src/main/java/com/savi/app/SAVI.java`)
- App Navigation → Profile State: uses (evidence: `common/src/main/java/com/savi/app/SAVI.java`)
- Home Dashboard → Home Aggregation: reads overview (evidence: `common/src/main/java/com/savi/app/frontend/HomePage.java`)
- Home Dashboard → Calendar View: opens (evidence: `common/src/main/java/com/savi/app/frontend/HomePage.java`)
- Home Dashboard → Transfer Flow: opens (evidence: `common/src/main/java/com/savi/app/frontend/HomePage.java`)
- Home Dashboard → Savings Summary: opens (evidence: `common/src/main/java/com/savi/app/frontend/HomePage.java`)
- Home Dashboard → Reminder View: opens (evidence: `common/src/main/java/com/savi/app/frontend/HomePage.java`)
- Quick Add → Savings Lists: adds contributions (evidence: `common/src/main/java/com/savi/app/frontend/QuickAddMenu.java`)
- Savings Lists → Group Savings: manages (evidence: `common/src/main/java/com/savi/app/backend/GroupList.java`)
- Savings Lists → Contribution Record: records (evidence: `common/src/main/java/com/savi/app/backend/GroupList.java`)
- Savings Records → Contribution Record: stores (evidence: `common/src/main/java/com/savi/app/backend/Savings.java`)
- Savings Summary → Group Summary Logic: reads summary (evidence: `common/src/main/java/com/savi/app/frontend/SummaryPage.java`)
- Savings Summary → Home Dashboard: returns to (evidence: `common/src/main/java/com/savi/app/frontend/SummaryPage.java`)
- Transfer Flow → Transfer Logic: submits transfer (evidence: `common/src/main/java/com/savi/app/frontend/TransferPage.java`)
- Transfer Logic → Savings Lists: updates savings (evidence: `common/src/main/java/com/savi/app/backend/Transfer.java`)
- People View → Home Aggregation: reads people data (evidence: `common/src/main/java/com/savi/app/frontend/PeoplePage.java`)
- Login and Signup → User Accounts: authenticates
- Reminder View → Home Aggregation: reads dashboard data (evidence: `common/src/main/java/com/savi/app/frontend/ReminderPage.java`)
