# spider-man2099-restor/oop_inventorysystem architecture

> Architecture diagram of the GitHub repository spider-man2099-restor/oop_inventorysystem, 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/spider-man2099-restor/oop_inventorysystem
- Repository: https://github.com/spider-man2099-restor/oop_inventorysystem

## Overview

This is a Java Swing inventory-management desktop application. The user starts at account creation or login, then reaches a product dashboard where products can be added, edited, and deleted. Product records and user credentials are stored in pipe-delimited local files; product validation and a shared product model support inventory operations. The excerpts establish several calls directly, while some form-to-dashboard and file-persistence details are only partially shown, so those links are marked unverified rather than treated as confirmed flow.

Main entry points: [`src/com/inventory/view/Dashboard.java`](https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/view/Dashboard.java) (Product dashboard), [`src/com/inventory/util/FileUtil.java`](https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/util/FileUtil.java) (File utilities), [`src/com/inventory/view/SignUpForm.java`](https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/view/SignUpForm.java) (Sign-up form), [`src/com/inventory/view/LoginForm.java`](https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/view/LoginForm.java) (Login form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Application startup"]
  node_main["Application entry<br/>[Main.java]"]
end

subgraph group_accounts["Account access"]
  node_signup["Sign-up form<br/>[SignUpForm.java]"]
  node_login["Login form<br/>[LoginForm.java]"]
  node_account_validation["Account validation"]
  node_duplicate_email["Duplicate email check<br/>[Helpers.java]"]
end

subgraph group_inventory["Inventory workflow"]
  node_dashboard["Product dashboard<br/>[Dashboard.java]"]
  node_add_form["Add product form<br/>[addForm.java]"]
  node_edit_form["Edit product form<br/>[editForm.java]"]
  node_product_validation["Product validation"]
end

subgraph group_shared["Shared services"]
  node_product["Product model<br/>[Product.java]"]
  node_file_util["File utilities<br/>[FileUtil.java]"]
  node_users_file[("User records<br/>[Users.txt]")]
  node_products_file[("Product records<br/>[Products.txt]")]
end

node_user(("User"))

node_user -->|"starts"| node_main
node_main -->|"opens"| node_signup
node_main -->|"initializes files"| node_file_util
node_user -->|"enters account details"| node_signup
node_user -->|"enters credentials"| node_login
node_signup -->|"validates signup"| node_account_validation
node_login -->|"validates login"| node_account_validation
node_account_validation -->|"checks duplicates"| node_duplicate_email
node_duplicate_email -->|"reads users"| node_file_util
node_account_validation -->|"reads users"| node_file_util
node_file_util -.->|"reads and writes"| node_users_file
node_signup -->|"opens login"| node_login
node_login -->|"opens signup"| node_signup
node_login -.->|"opens dashboard"| node_dashboard
node_signup -.->|"opens dashboard"| node_dashboard
node_user -->|"manages inventory"| node_dashboard
node_dashboard -->|"opens selected product"| node_edit_form
node_dashboard -.->|"opens add form"| node_add_form
node_add_form -->|"validates product"| node_product_validation
node_edit_form -->|"validates changes"| node_product_validation
node_add_form -->|"creates product"| node_product
node_edit_form -->|"creates updated product"| node_product
node_edit_form -->|"updates product"| node_dashboard
node_dashboard -->|"loads and formats"| node_product
node_product_validation -->|"checks product IDs"| node_file_util
node_dashboard -.->|"persists inventory"| node_file_util
node_file_util -.->|"reads and writes"| node_products_file

click node_main "https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/main/Main.java"
click node_signup "https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/view/SignUpForm.java"
click node_login "https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/view/LoginForm.java"
click node_account_validation "https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/validations/LoginSignUpValidation.java"
click node_duplicate_email "https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/validations/Helpers.java"
click node_dashboard "https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/view/Dashboard.java"
click node_add_form "https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/view/addForm.java"
click node_edit_form "https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/view/editForm.java"
click node_product_validation "https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/validations/ProductValidation.java"
click node_product "https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/model/Product.java"
click node_file_util "https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/util/FileUtil.java"
click node_users_file "https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/Users.txt"
click node_products_file "https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/Products.txt"

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,node_user toneBlue
class node_signup,node_login,node_account_validation,node_duplicate_email toneAmber
class node_dashboard,node_add_form,node_edit_form,node_product_validation toneMint
class node_product,node_file_util,node_users_file,node_products_file toneRose
```

## Components

### Application startup

- [Application entry](https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/main/Main.java): `src/com/inventory/main/Main.java`

### Account access

- [Sign-up form](https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/view/SignUpForm.java): `src/com/inventory/view/SignUpForm.java`
- [Login form](https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/view/LoginForm.java): `src/com/inventory/view/LoginForm.java`
- [Account validation](https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/validations/LoginSignUpValidation.java): `src/com/inventory/validations/LoginSignUpValidation.java`
- [Duplicate email check](https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/validations/Helpers.java): `src/com/inventory/validations/Helpers.java`

### Inventory workflow

- [Product dashboard](https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/view/Dashboard.java): `src/com/inventory/view/Dashboard.java`
- [Add product form](https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/view/addForm.java): `src/com/inventory/view/addForm.java`
- [Edit product form](https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/view/editForm.java): `src/com/inventory/view/editForm.java`
- [Product validation](https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/validations/ProductValidation.java): `src/com/inventory/validations/ProductValidation.java`

### Shared services

- [Product model](https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/model/Product.java): `src/com/inventory/model/Product.java`
- [File utilities](https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/src/com/inventory/util/FileUtil.java): `src/com/inventory/util/FileUtil.java`
- [User records](https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/Users.txt): `Users.txt`
- [Product records](https://github.com/spider-man2099-restor/oop_inventorysystem/blob/master/Products.txt): `Products.txt`

### Other components

- **User**

## Connections

- User → Application entry: starts
- Application entry → Sign-up form: opens (evidence: `src/com/inventory/main/Main.java`)
- Application entry → File utilities: initializes files (evidence: `src/com/inventory/main/Main.java`)
- User → Sign-up form: enters account details
- User → Login form: enters credentials
- Sign-up form → Account validation: validates signup (evidence: `src/com/inventory/validations/LoginSignUpValidation.java`)
- Login form → Account validation: validates login (evidence: `src/com/inventory/validations/LoginSignUpValidation.java`)
- Account validation → Duplicate email check: checks duplicates (evidence: `src/com/inventory/validations/LoginSignUpValidation.java`)
- Duplicate email check → File utilities: reads users (evidence: `src/com/inventory/validations/Helpers.java`)
- Account validation → File utilities: reads users (evidence: `src/com/inventory/validations/LoginSignUpValidation.java`)
- File utilities → User records: reads and writes
- Sign-up form → Login form: opens login (evidence: `src/com/inventory/view/SignUpForm.java`)
- Login form → Sign-up form: opens signup (evidence: `src/com/inventory/view/LoginForm.java`)
- Login form → Product dashboard: opens dashboard (evidence: `src/com/inventory/view/LoginForm.java`)
- Sign-up form → Product dashboard: opens dashboard (evidence: `src/com/inventory/view/SignUpForm.java`)
- User → Product dashboard: manages inventory
- Product dashboard → Edit product form: opens selected product (evidence: `src/com/inventory/view/Dashboard.java`)
- Product dashboard → Add product form: opens add form (evidence: `src/com/inventory/view/addForm.java`)
- Add product form → Product validation: validates product (evidence: `src/com/inventory/view/addForm.java`)
- Edit product form → Product validation: validates changes (evidence: `src/com/inventory/view/editForm.java`)
- Add product form → Product model: creates product (evidence: `src/com/inventory/view/addForm.java`)
- Edit product form → Product model: creates updated product (evidence: `src/com/inventory/view/editForm.java`)
- Edit product form → Product dashboard: updates product (evidence: `src/com/inventory/view/editForm.java`)
- Product dashboard → Product model: loads and formats (evidence: `src/com/inventory/view/Dashboard.java`)
- Product validation → File utilities: checks product IDs (evidence: `src/com/inventory/validations/ProductValidation.java`)
- Product dashboard → File utilities: persists inventory (evidence: `src/com/inventory/view/Dashboard.java`)
- File utilities → Product records: reads and writes
