# sara4quantum/online_store architecture

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

- Interactive diagram: https://gitdiagram.com/sara4quantum/online_store
- Repository: https://github.com/sara4quantum/online_store

## Overview

This Spring Boot online store lets customers log in, browse a catalog, select a product, submit contact and payment details, and place or cancel an order. The controller owns the HTTP workflow and delegates persistence and card validation; the validation layer normalizes and converts card digits before applying a Luhn-style check. The README documents the major page capabilities, while controller excerpts confirm the server-side routes and outcomes. The database technology is documented, but configuration and page-to-route wiring were not sampled.

Main entry points: [`Online-Store/src/main/java/Store/Store_Controller.java`](https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/Store_Controller.java) (Store Controller), [`Online-Store/src/main/java/Store/User_Details_CRUD.java`](https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/User_Details_CRUD.java) (User Repository), [`Online-Store/src/main/java/Store/purchase_orderDetailsCRUD.java`](https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/purchase_orderDetailsCRUD.java) (Order Repository), [`Online-Store/src/main/java/Store/Credit_or_DebitCard_Validation.java`](https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/Credit_or_DebitCard_Validation.java) (Card Validator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Storefront"]
  node_login["Login Page<br/>[login.html]"]
  node_catalog["Product Listing<br/>[productsList.jsp]"]
  node_products["Product Pages"]
end

subgraph group_orders["Order Workflow"]
  node_controller["Store Controller"]
  node_orderform["Order Details<br/>[OrderDetails.jsp]"]
  node_formchecks["Order Form Checks<br/>[OrderDetails.js]"]
  node_placed["Order Confirmation<br/>[PlacedOrder.html]"]
  node_cancelled["Cancellation Page<br/>[Deleted.html]"]
end

subgraph group_data["Persistence"]
  node_userrepo["User Repository"]
  node_userentity["User Record<br/>[User_Details.java]"]
  node_orderrepo["Order Repository"]
  node_orderentity["Order Record"]
  node_database[("Embedded Database")]
end

subgraph group_payments["Card Validation"]
  node_invalid["Invalid Card Page<br/>[creditInvalid.html]"]
  node_validator["Card Validator"]
  node_carddigits["Card Digit Input"]
  node_digitarray["Digit Converter"]
end

node_customer(("Customer"))

node_customer -->|"opens"| node_login
node_customer -->|"submits requests"| node_controller
node_controller -->|"returns view"| node_login
node_controller -->|"renders listing"| node_catalog
node_controller -->|"routes product pages"| node_products
node_controller -->|"renders purchase form"| node_orderform
node_orderform -->|"validates fields"| node_formchecks
node_customer -->|"enters order"| node_orderform
node_controller -->|"checks card"| node_validator
node_validator -->|"normalizes digits"| node_carddigits
node_validator -->|"converts digits"| node_digitarray
node_controller -->|"returns success"| node_placed
node_controller -->|"returns invalid result"| node_invalid
node_controller -->|"returns cancellation"| node_cancelled
node_controller -->|"saves user"| node_userrepo
node_controller -->|"saves or deletes order"| node_orderrepo
node_userrepo -->|"stores records"| node_userentity
node_orderrepo -->|"stores records"| node_orderentity
node_userrepo -.->|"persists via JPA"| node_database
node_orderrepo -.->|"persists via JPA"| node_database

click node_controller "https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/Store_Controller.java"
click node_login "https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/webapp/login.html"
click node_catalog "https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/webapp/productsList.jsp"
click node_products "https://github.com/sara4quantum/online_store/tree/master/Online-Store/src/main/webapp"
click node_orderform "https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/webapp/OrderDetails.jsp"
click node_formchecks "https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/webapp/OrderDetails.js"
click node_placed "https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/webapp/PlacedOrder.html"
click node_cancelled "https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/webapp/Deleted.html"
click node_invalid "https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/webapp/creditInvalid.html"
click node_userrepo "https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/User_Details_CRUD.java"
click node_userentity "https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/User_Details.java"
click node_orderrepo "https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/purchase_orderDetailsCRUD.java"
click node_orderentity "https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/Purchase_OrderDetails.java"
click node_validator "https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/Credit_or_DebitCard_Validation.java"
click node_carddigits "https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/Credit_Card_Digits.java"
click node_digitarray "https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/StringToArray_CreditCard.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_login,node_catalog,node_products toneBlue
class node_controller,node_orderform,node_formchecks,node_placed,node_cancelled toneAmber
class node_userrepo,node_userentity,node_orderrepo,node_orderentity,node_database toneMint
class node_invalid,node_validator,node_carddigits,node_digitarray toneRose
class node_customer toneIndigo
```

## Components

### Storefront

- [Login Page](https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/webapp/login.html): `Online-Store/src/main/webapp/login.html`
- [Product Listing](https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/webapp/productsList.jsp): `Online-Store/src/main/webapp/productsList.jsp`
- [Product Pages](https://github.com/sara4quantum/online_store/tree/master/Online-Store/src/main/webapp): `Online-Store/src/main/webapp`

### Order Workflow

- [Store Controller](https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/Store_Controller.java): `Online-Store/src/main/java/Store/Store_Controller.java`
- [Order Details](https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/webapp/OrderDetails.jsp): `Online-Store/src/main/webapp/OrderDetails.jsp`
- [Order Form Checks](https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/webapp/OrderDetails.js): `Online-Store/src/main/webapp/OrderDetails.js`
- [Order Confirmation](https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/webapp/PlacedOrder.html): `Online-Store/src/main/webapp/PlacedOrder.html`
- [Cancellation Page](https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/webapp/Deleted.html): `Online-Store/src/main/webapp/Deleted.html`

### Persistence

- [User Repository](https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/User_Details_CRUD.java): `Online-Store/src/main/java/Store/User_Details_CRUD.java`
- [User Record](https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/User_Details.java): `Online-Store/src/main/java/Store/User_Details.java`
- [Order Repository](https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/purchase_orderDetailsCRUD.java): `Online-Store/src/main/java/Store/purchase_orderDetailsCRUD.java`
- [Order Record](https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/Purchase_OrderDetails.java): `Online-Store/src/main/java/Store/Purchase_OrderDetails.java`
- **Embedded Database**

### Card Validation

- [Invalid Card Page](https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/webapp/creditInvalid.html): `Online-Store/src/main/webapp/creditInvalid.html`
- [Card Validator](https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/Credit_or_DebitCard_Validation.java): `Online-Store/src/main/java/Store/Credit_or_DebitCard_Validation.java`
- [Card Digit Input](https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/Credit_Card_Digits.java): `Online-Store/src/main/java/Store/Credit_Card_Digits.java`
- [Digit Converter](https://github.com/sara4quantum/online_store/blob/master/Online-Store/src/main/java/Store/StringToArray_CreditCard.java): `Online-Store/src/main/java/Store/StringToArray_CreditCard.java`

### Other components

- **Customer**

## Connections

- Customer → Login Page: opens (evidence: `README.md`)
- Customer → Store Controller: submits requests (evidence: `README.md`)
- Store Controller → Login Page: returns view (evidence: `Online-Store/src/main/java/Store/Store_Controller.java`)
- Store Controller → Product Listing: renders listing (evidence: `Online-Store/src/main/java/Store/Store_Controller.java`)
- Store Controller → Product Pages: routes product pages (evidence: `Online-Store/src/main/java/Store/Store_Controller.java`)
- Store Controller → Order Details: renders purchase form (evidence: `Online-Store/src/main/java/Store/Store_Controller.java`)
- Order Details → Order Form Checks: validates fields (evidence: `README.md`)
- Customer → Order Details: enters order (evidence: `README.md`)
- Store Controller → Card Validator: checks card (evidence: `Online-Store/src/main/java/Store/Store_Controller.java`)
- Card Validator → Card Digit Input: normalizes digits (evidence: `Online-Store/src/main/java/Store/Credit_or_DebitCard_Validation.java`)
- Card Validator → Digit Converter: converts digits (evidence: `Online-Store/src/main/java/Store/Credit_or_DebitCard_Validation.java`)
- Store Controller → Order Confirmation: returns success (evidence: `Online-Store/src/main/java/Store/Store_Controller.java`)
- Store Controller → Invalid Card Page: returns invalid result (evidence: `Online-Store/src/main/java/Store/Store_Controller.java`)
- Store Controller → Cancellation Page: returns cancellation (evidence: `Online-Store/src/main/java/Store/Store_Controller.java`)
- Store Controller → User Repository: saves user (evidence: `Online-Store/src/main/java/Store/Store_Controller.java`)
- Store Controller → Order Repository: saves or deletes order (evidence: `Online-Store/src/main/java/Store/Store_Controller.java`)
- User Repository → User Record: stores records (evidence: `Online-Store/src/main/java/Store/User_Details_CRUD.java`)
- Order Repository → Order Record: stores records (evidence: `Online-Store/src/main/java/Store/purchase_orderDetailsCRUD.java`)
- User Repository → Embedded Database: persists via JPA (evidence: `README.md`)
- Order Repository → Embedded Database: persists via JPA (evidence: `README.md`)
