# franwik/savingmoneyunina architecture

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

- Interactive diagram: https://gitdiagram.com/franwik/savingmoneyunina
- Repository: https://github.com/franwik/savingmoneyunina

## Overview

Saving Money Unina is a JavaFX personal-finance application for managing a user's accounts, cards, transactions, wallets, and familiar-linked financial records. The workflow starts at login or registration, enters the authenticated application, and lets users manage those records through page controllers and controls, with DAO implementations providing the persistence layer. The README identifies PostgreSQL as the database. Several feature areas are documented by the source tree but their implementation was not sampled, so their internal call paths are not asserted here.

Main entry points: [`Java Application/sources/saving-money-unina/src/main/java/smu/DAOImplementation`](https://github.com/franwik/savingmoneyunina/tree/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/DAOImplementation) (DAO implementations), [`Java Application/sources/saving-money-unina/src/main/java/smu/App.java`](https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/App.java) (JavaFX app), [`Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/LoginPageController.java`](https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Boundary/LoginPageController.java) (Login page), [`Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/ApplicationPageController.java`](https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Boundary/ApplicationPageController.java) (Finance navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_app["JavaFX app<br/>[App.java]"]
  node_application["Finance navigation"]
end

subgraph group_identity["Access and session"]
  node_login["Login page"]
  node_register["Registration page"]
  node_session["Logged user<br/>[LoggedUser.java]"]
end

subgraph group_features["Finance features"]
  node_home["Home and familiars"]
  node_bankui["Bank accounts"]
  node_cardui["Cards"]
  node_transactionui["Transactions"]
  node_walletui["Wallets"]
end

subgraph group_logic["Business controls"]
  node_homecontrol["Home control<br/>[HomeControl.java]"]
  node_bankcontrol["Bank control"]
  node_cardcontrol["Card control<br/>[CardControl.java]"]
  node_transactioncontrol["Transaction control"]
  node_walletcontrol["Wallet control<br/>[WalletControl.java]"]
end

subgraph group_persistence["Persistence and data"]
  node_daos["DAO implementations"]
  node_database[("PostgreSQL database<br/>[Database.java]")]
  node_models["Finance data models"]
end

node_user(("User"))

node_user -->|"starts"| node_app
node_app -->|"loads first"| node_login
node_login -->|"navigates"| node_app
node_login -.->|"sets session"| node_session
node_register -->|"navigates"| node_app
node_register -.->|"sets session"| node_session
node_application -->|"switches pages"| node_app
node_application -->|"clears on logout"| node_session
node_login -.->|"opens after login"| node_application
node_register -.->|"opens after signup"| node_application
node_home -->|"uses"| node_homecontrol
node_bankui -->|"uses"| node_bankcontrol
node_cardui -->|"uses"| node_cardcontrol
node_transactionui -->|"uses"| node_transactioncontrol
node_walletui -->|"uses"| node_walletcontrol
node_bankcontrol -->|"reads and writes"| node_daos
node_cardcontrol -->|"reads and writes"| node_daos
node_transactioncontrol -->|"reads and writes"| node_daos
node_homecontrol -.->|"uses"| node_daos
node_walletcontrol -.->|"uses"| node_daos
node_daos -.->|"persists data"| node_database
node_home -->|"reads session"| node_session
node_bankcontrol -->|"uses account models"| node_models
node_cardcontrol -->|"uses card models"| node_models
node_transactioncontrol -->|"uses transaction models"| node_models

click node_app "https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/App.java"
click node_login "https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Boundary/LoginPageController.java"
click node_register "https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Boundary/RegisterPageController.java"
click node_session "https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/LoggedUser.java"
click node_application "https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Boundary/ApplicationPageController.java"
click node_home "https://github.com/franwik/savingmoneyunina/tree/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Boundary/Home"
click node_bankui "https://github.com/franwik/savingmoneyunina/tree/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Boundary/BankAccount"
click node_cardui "https://github.com/franwik/savingmoneyunina/tree/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Boundary/Card"
click node_transactionui "https://github.com/franwik/savingmoneyunina/tree/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Boundary/Transaction"
click node_walletui "https://github.com/franwik/savingmoneyunina/tree/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Boundary/Wallet"
click node_homecontrol "https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Control/HomeControl.java"
click node_bankcontrol "https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Control/BankAccountControl.java"
click node_cardcontrol "https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Control/CardControl.java"
click node_transactioncontrol "https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Control/TransactionControl.java"
click node_walletcontrol "https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Control/WalletControl.java"
click node_daos "https://github.com/franwik/savingmoneyunina/tree/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/DAOImplementation"
click node_database "https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Database.java"
click node_models "https://github.com/franwik/savingmoneyunina/tree/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/DTO"

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_app,node_application,node_user toneBlue
class node_login,node_register,node_session toneAmber
class node_home,node_bankui,node_cardui,node_transactionui,node_walletui toneMint
class node_homecontrol,node_bankcontrol,node_cardcontrol,node_transactioncontrol,node_walletcontrol toneRose
class node_daos,node_database,node_models toneIndigo
```

## Components

### Application entry

- [JavaFX app](https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/App.java): `Java Application/sources/saving-money-unina/src/main/java/smu/App.java`
- [Finance navigation](https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Boundary/ApplicationPageController.java): `Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/ApplicationPageController.java`

### Access and session

- [Login page](https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Boundary/LoginPageController.java): `Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/LoginPageController.java`
- [Registration page](https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Boundary/RegisterPageController.java): `Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/RegisterPageController.java`
- [Logged user](https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/LoggedUser.java): `Java Application/sources/saving-money-unina/src/main/java/smu/LoggedUser.java`

### Finance features

- [Home and familiars](https://github.com/franwik/savingmoneyunina/tree/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Boundary/Home): `Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/Home`
- [Bank accounts](https://github.com/franwik/savingmoneyunina/tree/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Boundary/BankAccount): `Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/BankAccount`
- [Cards](https://github.com/franwik/savingmoneyunina/tree/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Boundary/Card): `Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/Card`
- [Transactions](https://github.com/franwik/savingmoneyunina/tree/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Boundary/Transaction): `Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/Transaction`
- [Wallets](https://github.com/franwik/savingmoneyunina/tree/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Boundary/Wallet): `Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/Wallet`

### Business controls

- [Home control](https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Control/HomeControl.java): `Java Application/sources/saving-money-unina/src/main/java/smu/Control/HomeControl.java`
- [Bank control](https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Control/BankAccountControl.java): `Java Application/sources/saving-money-unina/src/main/java/smu/Control/BankAccountControl.java`
- [Card control](https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Control/CardControl.java): `Java Application/sources/saving-money-unina/src/main/java/smu/Control/CardControl.java`
- [Transaction control](https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Control/TransactionControl.java): `Java Application/sources/saving-money-unina/src/main/java/smu/Control/TransactionControl.java`
- [Wallet control](https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Control/WalletControl.java): `Java Application/sources/saving-money-unina/src/main/java/smu/Control/WalletControl.java`

### Persistence and data

- [DAO implementations](https://github.com/franwik/savingmoneyunina/tree/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/DAOImplementation): `Java Application/sources/saving-money-unina/src/main/java/smu/DAOImplementation`
- [PostgreSQL database](https://github.com/franwik/savingmoneyunina/blob/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/Database.java): `Java Application/sources/saving-money-unina/src/main/java/smu/Database.java`
- [Finance data models](https://github.com/franwik/savingmoneyunina/tree/main/Java%20Application/sources/saving-money-unina/src/main/java/smu/DTO): `Java Application/sources/saving-money-unina/src/main/java/smu/DTO`

### Other components

- **User**

## Connections

- User → JavaFX app: starts (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/App.java`)
- JavaFX app → Login page: loads first (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/App.java`)
- Login page → JavaFX app: navigates (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/LoginPageController.java`)
- Login page → Logged user: sets session
- Registration page → JavaFX app: navigates (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/RegisterPageController.java`)
- Registration page → Logged user: sets session
- Finance navigation → JavaFX app: switches pages (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/ApplicationPageController.java`)
- Finance navigation → Logged user: clears on logout (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/ApplicationPageController.java`)
- Login page → Finance navigation: opens after login
- Registration page → Finance navigation: opens after signup
- Home and familiars → Home control: uses (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/Home/HomePageController.java`)
- Bank accounts → Bank control: uses (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/BankAccount/BankAccountPageController.java`)
- Cards → Card control: uses (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/Card/CardPageController.java`)
- Transactions → Transaction control: uses (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/Transaction/TransactionPageController.java`)
- Wallets → Wallet control: uses (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/Wallet/WalletPageController.java`)
- Bank control → DAO implementations: reads and writes (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/Control/BankAccountControl.java`)
- Card control → DAO implementations: reads and writes (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/Control/CardControl.java`)
- Transaction control → DAO implementations: reads and writes (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/Control/TransactionControl.java`)
- Home control → DAO implementations: uses (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/Control/HomeControl.java`)
- Wallet control → DAO implementations: uses (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/Control/WalletControl.java`)
- DAO implementations → PostgreSQL database: persists data
- Home and familiars → Logged user: reads session (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/Boundary/Home/HomePageController.java`)
- Bank control → Finance data models: uses account models (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/Control/BankAccountControl.java`)
- Card control → Finance data models: uses card models (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/Control/CardControl.java`)
- Transaction control → Finance data models: uses transaction models (evidence: `Java Application/sources/saving-money-unina/src/main/java/smu/Control/TransactionControl.java`)
