# stagnantwater69/laundrylink architecture

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

- Interactive diagram: https://gitdiagram.com/stagnantwater69/laundrylink
- Repository: https://github.com/stagnantwater69/laundrylink

## Overview

LaundryLink is a JavaFX desktop app for managing a laundry shop. Its documented first-run path is welcome → owner setup → login → dashboard; staff accounts and profile management support ongoing access administration. The dashboard summarizes daily activity and recent orders, while the app also exposes customer, order, payment, and service/price screens. The graph connects only relationships shown in the README or supplied source/index; several screen implementations and order workflows were not sampled, so their internal links are omitted.

Main entry points: [`src/com/laundrylink/service/AccountService.java`](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/service/AccountService.java) (Account management), [`src/com/laundrylink/config/ConnectionFactory.java`](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/config/ConnectionFactory.java) (Connection factory), [`src/com/laundrylink/service/AuthService.java`](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/service/AuthService.java) (Authentication), [`src/com/laundrylink/util/SessionContext.java`](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/util/SessionContext.java) (Session context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_welcome["Welcome"]
  node_owner_setup["Owner setup"]
  node_login["Login"]
  node_shell["Main shell"]
  node_dashboard_ui["Dashboard screen"]
  node_account_screens["Account screens"]
  node_shop_screens["Shop screens"]
end

subgraph group_domain["Shop workflows"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_accounts["Account management"]
  node_dashboard["Dashboard data"]
  node_orders["Order actions<br/>[OrderService.java]"]
  node_models["Domain models"]
end

subgraph group_data["Persistence"]
  node_user_dao["User records<br/>[UserDAO.java]"]
  node_dashboard_dao["Dashboard queries<br/>[DashboardDAO.java]"]
  node_mysql[("MySQL database")]
end

subgraph group_runtime["Shared runtime"]
  node_connection["Connection factory"]
  node_db_config["Database settings"]
  node_session["Session context"]
  node_navigation["View navigation"]
  node_app["Application entry"]
  node_transactions["Transactions"]
end

node_owner(("Owner / staff"))

node_owner -->|"opens"| node_welcome
node_welcome -->|"starts setup"| node_owner_setup
node_owner_setup -->|"then logs in"| node_login
node_login -->|"authenticates"| node_auth
node_auth -->|"looks up user"| node_user_dao
node_auth -->|"opens connection"| node_connection
node_auth -->|"signs out"| node_session
node_owner_setup -->|"creates owner"| node_accounts
node_welcome -->|"checks setup"| node_accounts
node_accounts -->|"manages accounts"| node_user_dao
node_accounts -->|"opens connection"| node_connection
node_accounts -->|"checks permissions"| node_session
node_shell -->|"logs out"| node_auth
node_shell -->|"observes session"| node_session
node_dashboard_ui -->|"loads dashboard"| node_dashboard
node_dashboard_ui -->|"releases orders"| node_orders
node_dashboard -->|"queries"| node_dashboard_dao
node_dashboard -->|"opens connection"| node_connection
node_dashboard -->|"checks login"| node_session
node_orders -->|"checks session"| node_session
node_user_dao -->|"maps users"| node_models
node_dashboard_dao -->|"maps results"| node_models
node_connection -->|"loads settings"| node_db_config
node_connection -->|"connects"| node_mysql
node_app -->|"initializes screens"| node_navigation
node_navigation -->|"loads view"| node_shell
node_navigation -->|"loads views"| node_shop_screens
node_accounts -->|"runs transactions"| node_transactions
node_transactions -->|"opens connection"| node_connection

click node_welcome "https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/controller/WelcomeController.java"
click node_owner_setup "https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/controller/OwnerSetupController.java"
click node_login "https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/controller/LoginController.java"
click node_shell "https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/controller/MainShellController.java"
click node_dashboard_ui "https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/controller/DashboardController.java"
click node_account_screens "https://github.com/stagnantwater69/laundrylink/tree/main/src/com/laundrylink/controller"
click node_shop_screens "https://github.com/stagnantwater69/laundrylink/tree/main/src/com/laundrylink/view"
click node_auth "https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/service/AuthService.java"
click node_accounts "https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/service/AccountService.java"
click node_dashboard "https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/service/DashboardService.java"
click node_orders "https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/service/OrderService.java"
click node_models "https://github.com/stagnantwater69/laundrylink/tree/main/src/com/laundrylink/model"
click node_user_dao "https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/dao/UserDAO.java"
click node_dashboard_dao "https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/dao/DashboardDAO.java"
click node_connection "https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/config/ConnectionFactory.java"
click node_db_config "https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/config/DatabaseConfig.java"
click node_session "https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/util/SessionContext.java"
click node_navigation "https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/util/SceneNavigator.java"
click node_app "https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/LaundryLinkApp.java"
click node_transactions "https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/service/TransactionHelper.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_welcome,node_owner_setup,node_login,node_shell,node_dashboard_ui,node_account_screens,node_shop_screens toneBlue
class node_auth,node_accounts,node_dashboard,node_orders,node_models toneAmber
class node_user_dao,node_dashboard_dao,node_mysql toneMint
class node_connection,node_db_config,node_session,node_navigation,node_app,node_transactions toneRose
class node_owner toneIndigo
```

## Components

### Desktop interface

- [Welcome](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/controller/WelcomeController.java): `src/com/laundrylink/controller/WelcomeController.java`
- [Owner setup](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/controller/OwnerSetupController.java): `src/com/laundrylink/controller/OwnerSetupController.java`
- [Login](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/controller/LoginController.java): `src/com/laundrylink/controller/LoginController.java`
- [Main shell](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/controller/MainShellController.java): `src/com/laundrylink/controller/MainShellController.java`
- [Dashboard screen](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/controller/DashboardController.java): `src/com/laundrylink/controller/DashboardController.java`
- [Account screens](https://github.com/stagnantwater69/laundrylink/tree/main/src/com/laundrylink/controller): `src/com/laundrylink/controller`
- [Shop screens](https://github.com/stagnantwater69/laundrylink/tree/main/src/com/laundrylink/view): `src/com/laundrylink/view`

### Shop workflows

- [Authentication](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/service/AuthService.java): `src/com/laundrylink/service/AuthService.java`
- [Account management](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/service/AccountService.java): `src/com/laundrylink/service/AccountService.java`
- [Dashboard data](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/service/DashboardService.java): `src/com/laundrylink/service/DashboardService.java`
- [Order actions](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/service/OrderService.java): `src/com/laundrylink/service/OrderService.java`
- [Domain models](https://github.com/stagnantwater69/laundrylink/tree/main/src/com/laundrylink/model): `src/com/laundrylink/model`

### Persistence

- [User records](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/dao/UserDAO.java): `src/com/laundrylink/dao/UserDAO.java`
- [Dashboard queries](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/dao/DashboardDAO.java): `src/com/laundrylink/dao/DashboardDAO.java`
- **MySQL database**

### Shared runtime

- [Connection factory](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/config/ConnectionFactory.java): `src/com/laundrylink/config/ConnectionFactory.java`
- [Database settings](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/config/DatabaseConfig.java): `src/com/laundrylink/config/DatabaseConfig.java`
- [Session context](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/util/SessionContext.java): `src/com/laundrylink/util/SessionContext.java`
- [View navigation](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/util/SceneNavigator.java): `src/com/laundrylink/util/SceneNavigator.java`
- [Application entry](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/LaundryLinkApp.java): `src/com/laundrylink/LaundryLinkApp.java`
- [Transactions](https://github.com/stagnantwater69/laundrylink/blob/main/src/com/laundrylink/service/TransactionHelper.java): `src/com/laundrylink/service/TransactionHelper.java`

### Other components

- **Owner / staff**

## Connections

- Owner / staff → Welcome: opens (evidence: `README.md`)
- Welcome → Owner setup: starts setup (evidence: `README.md`)
- Owner setup → Login: then logs in (evidence: `README.md`)
- Login → Authentication: authenticates (evidence: `src/com/laundrylink/controller/LoginController.java`)
- Authentication → User records: looks up user (evidence: `src/com/laundrylink/service/AuthService.java`)
- Authentication → Connection factory: opens connection (evidence: `src/com/laundrylink/service/AuthService.java`)
- Authentication → Session context: signs out (evidence: `src/com/laundrylink/service/AuthService.java`)
- Owner setup → Account management: creates owner (evidence: `src/com/laundrylink/controller/OwnerSetupController.java`)
- Welcome → Account management: checks setup (evidence: `src/com/laundrylink/controller/WelcomeController.java`)
- Account management → User records: manages accounts (evidence: `src/com/laundrylink/service/AccountService.java`)
- Account management → Connection factory: opens connection (evidence: `src/com/laundrylink/service/AccountService.java`)
- Account management → Session context: checks permissions (evidence: `src/com/laundrylink/service/AccountService.java`)
- Main shell → Authentication: logs out (evidence: `src/com/laundrylink/controller/MainShellController.java`)
- Main shell → Session context: observes session (evidence: `src/com/laundrylink/controller/MainShellController.java`)
- Dashboard screen → Dashboard data: loads dashboard (evidence: `src/com/laundrylink/controller/DashboardController.java`)
- Dashboard screen → Order actions: releases orders (evidence: `src/com/laundrylink/controller/DashboardController.java`)
- Dashboard data → Dashboard queries: queries (evidence: `src/com/laundrylink/service/DashboardService.java`)
- Dashboard data → Connection factory: opens connection (evidence: `src/com/laundrylink/service/DashboardService.java`)
- Dashboard data → Session context: checks login (evidence: `src/com/laundrylink/service/DashboardService.java`)
- Order actions → Session context: checks session (evidence: `src/com/laundrylink/service/OrderService.java`)
- User records → Domain models: maps users (evidence: `src/com/laundrylink/dao/UserDAO.java`)
- Dashboard queries → Domain models: maps results (evidence: `src/com/laundrylink/dao/DashboardDAO.java`)
- Connection factory → Database settings: loads settings (evidence: `src/com/laundrylink/config/ConnectionFactory.java`)
- Connection factory → MySQL database: connects (evidence: `README.md`)
- Application entry → View navigation: initializes screens (evidence: `src/com/laundrylink/LaundryLinkApp.java`)
- View navigation → Main shell: loads view (evidence: `src/com/laundrylink/util/SceneNavigator.java`)
- View navigation → Shop screens: loads views
- Account management → Transactions: runs transactions (evidence: `src/com/laundrylink/service/AccountService.java`)
- Transactions → Connection factory: opens connection (evidence: `src/com/laundrylink/service/TransactionHelper.java`)
