# leony99/pack architecture

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

- Interactive diagram: https://gitdiagram.com/leony99/pack
- Repository: https://github.com/leony99/pack

## Overview

Pack is a clothing e-commerce monorepo: a React storefront and customer/admin interfaces use a Spring REST API. The main purchase journey is catalog discovery, cart management, checkout, then payment and shipment handling; the API also supports inventory, customer accounts, and staff administration. The map preserves these major capabilities, but several subsystem links are dashed because their implementation was not sampled. Source excerpts confirm the cart, checkout, catalog, authentication, and inventory interactions shown with evidence.

Main entry points: [`backend/src/main/java/com/leonycosta/packapi/PackApiApplication.java`](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/PackApiApplication.java) (Pack REST API), [`backend/src/main/java/com/leonycosta/packapi/order/order/OrderService.java`](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/order/order/OrderService.java) (Order checkout), [`backend/src/main/java/com/leonycosta/packapi/cart/cart/CartService.java`](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/cart/cart/CartService.java) (Shopping cart), [`backend/src/main/java/com/leonycosta/packapi/customer/customer/CustomerService.java`](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/customer/customer/CustomerService.java) (Customer accounts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_storefront_ui["Storefront<br/>[index.tsx]"]
  node_catalog_ui["Catalog UI<br/>[CatalogView.tsx]"]
  node_cart_ui["Cart and checkout UI<br/>[CartDrawer.tsx]"]
  node_account_ui["Customer account UI<br/>[AccountPanel.tsx]"]
  node_admin_ui["Admin panel<br/>[AdminPanel.tsx]"]
  node_newsletter["Newsletter and contact"]
end

subgraph group_identity["Accounts and access"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_customers["Customer accounts"]
  node_staff["Staff and permissions<br/>[StaffService.java]"]
  node_customer_store[("Customer data")]
end

subgraph group_commerce["Commerce and fulfillment"]
  node_api["Pack REST API"]
  node_cart["Shopping cart<br/>[CartService.java]"]
  node_orders["Order checkout<br/>[OrderService.java]"]
  node_payments["Payments"]
  node_shipping["Shipping"]
  node_cart_store[("Cart data")]
  node_order_store[("Order data")]
end

subgraph group_catalog["Catalog and inventory"]
  node_products["Product catalog"]
  node_variants["Product variants"]
  node_inventory["Stock movements"]
  node_product_store[("Product data")]
end

node_shopper(("Shopper"))

node_shopper -.->|"browses"| node_storefront_ui
node_storefront_ui -.->|"opens catalog"| node_catalog_ui
node_catalog_ui -.->|"requests catalog"| node_api
node_shopper -.->|"shops"| node_cart_ui
node_cart_ui -.->|"submits purchase"| node_api
node_shopper -.->|"manages account"| node_account_ui
node_admin_ui -.->|"administers store"| node_api
node_api -.->|"handles authentication"| node_auth
node_auth -->|"creates customers"| node_customers
node_auth -->|"authenticates staff"| node_staff
node_customers -->|"persists customers"| node_customer_store
node_customers -->|"creates cart"| node_cart_store
node_api -.->|"serves catalog"| node_products
node_products -->|"queries products"| node_product_store
node_products -->|"uses variants"| node_variants
node_cart -->|"validates stock"| node_variants
node_cart -->|"validates customer"| node_customers
node_cart -.->|"loads cart"| node_cart_store
node_api -.->|"manages cart"| node_cart
node_cart_ui -.->|"updates cart"| node_cart
node_orders -->|"locks cart"| node_cart
node_orders -->|"loads customer"| node_customers
node_orders -->|"registers stock out"| node_inventory
node_orders -.->|"saves order"| node_order_store
node_api -.->|"checks out"| node_orders
node_orders -.->|"coordinates payment"| node_payments
node_orders -->|"calculates shipping"| node_shipping
node_api -.->|"records movements"| node_inventory
node_variants -.->|"tracks stock"| node_inventory
node_api -.->|"accepts subscriptions"| node_newsletter
node_api -.->|"manages staff"| node_staff

click node_storefront_ui "https://github.com/leony99/pack/blob/main/frontend/src/routes/index.tsx"
click node_catalog_ui "https://github.com/leony99/pack/blob/main/frontend/src/components/catalog/CatalogView.tsx"
click node_cart_ui "https://github.com/leony99/pack/blob/main/frontend/src/components/cart/CartDrawer.tsx"
click node_account_ui "https://github.com/leony99/pack/blob/main/frontend/src/components/account/AccountPanel.tsx"
click node_admin_ui "https://github.com/leony99/pack/blob/main/frontend/src/components/admin/AdminPanel.tsx"
click node_api "https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/PackApiApplication.java"
click node_auth "https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/auth/AuthService.java"
click node_customers "https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/customer/customer/CustomerService.java"
click node_products "https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/product/product/ProductService.java"
click node_variants "https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/product/product_variant/ProductVariantService.java"
click node_inventory "https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/product/inventory/InventoryMovementService.java"
click node_cart "https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/cart/cart/CartService.java"
click node_orders "https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/order/order/OrderService.java"
click node_payments "https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/order/payment/PaymentService.java"
click node_shipping "https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/order/shipment/ShipmentService.java"
click node_staff "https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/staff/staff/StaffService.java"
click node_newsletter "https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/customer/newsletter/NewsletterService.java"
click node_product_store "https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/product/product/ProductRepository.java"
click node_customer_store "https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/customer/customer/CustomerRepository.java"
click node_cart_store "https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/cart/cart/CartRepository.java"
click node_order_store "https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/order/order/OrderRepository.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_storefront_ui,node_catalog_ui,node_cart_ui,node_account_ui,node_admin_ui,node_newsletter toneBlue
class node_auth,node_customers,node_staff,node_customer_store toneAmber
class node_api,node_cart,node_orders,node_payments,node_shipping,node_cart_store,node_order_store toneMint
class node_products,node_variants,node_inventory,node_product_store toneRose
class node_shopper toneIndigo
```

## Components

### Storefront

- [Storefront](https://github.com/leony99/pack/blob/main/frontend/src/routes/index.tsx): `frontend/src/routes/index.tsx`
- [Catalog UI](https://github.com/leony99/pack/blob/main/frontend/src/components/catalog/CatalogView.tsx): `frontend/src/components/catalog/CatalogView.tsx`
- [Cart and checkout UI](https://github.com/leony99/pack/blob/main/frontend/src/components/cart/CartDrawer.tsx): `frontend/src/components/cart/CartDrawer.tsx`
- [Customer account UI](https://github.com/leony99/pack/blob/main/frontend/src/components/account/AccountPanel.tsx): `frontend/src/components/account/AccountPanel.tsx`
- [Admin panel](https://github.com/leony99/pack/blob/main/frontend/src/components/admin/AdminPanel.tsx): `frontend/src/components/admin/AdminPanel.tsx`
- [Newsletter and contact](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/customer/newsletter/NewsletterService.java): `backend/src/main/java/com/leonycosta/packapi/customer/newsletter/NewsletterService.java`

### Accounts and access

- [Authentication](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/auth/AuthService.java): `backend/src/main/java/com/leonycosta/packapi/auth/AuthService.java`
- [Customer accounts](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/customer/customer/CustomerService.java): `backend/src/main/java/com/leonycosta/packapi/customer/customer/CustomerService.java`
- [Staff and permissions](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/staff/staff/StaffService.java): `backend/src/main/java/com/leonycosta/packapi/staff/staff/StaffService.java`
- [Customer data](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/customer/customer/CustomerRepository.java): `backend/src/main/java/com/leonycosta/packapi/customer/customer/CustomerRepository.java`

### Commerce and fulfillment

- [Pack REST API](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/PackApiApplication.java): `backend/src/main/java/com/leonycosta/packapi/PackApiApplication.java`
- [Shopping cart](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/cart/cart/CartService.java): `backend/src/main/java/com/leonycosta/packapi/cart/cart/CartService.java`
- [Order checkout](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/order/order/OrderService.java): `backend/src/main/java/com/leonycosta/packapi/order/order/OrderService.java`
- [Payments](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/order/payment/PaymentService.java): `backend/src/main/java/com/leonycosta/packapi/order/payment/PaymentService.java`
- [Shipping](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/order/shipment/ShipmentService.java): `backend/src/main/java/com/leonycosta/packapi/order/shipment/ShipmentService.java`
- [Cart data](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/cart/cart/CartRepository.java): `backend/src/main/java/com/leonycosta/packapi/cart/cart/CartRepository.java`
- [Order data](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/order/order/OrderRepository.java): `backend/src/main/java/com/leonycosta/packapi/order/order/OrderRepository.java`

### Catalog and inventory

- [Product catalog](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/product/product/ProductService.java): `backend/src/main/java/com/leonycosta/packapi/product/product/ProductService.java`
- [Product variants](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/product/product_variant/ProductVariantService.java): `backend/src/main/java/com/leonycosta/packapi/product/product_variant/ProductVariantService.java`
- [Stock movements](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/product/inventory/InventoryMovementService.java): `backend/src/main/java/com/leonycosta/packapi/product/inventory/InventoryMovementService.java`
- [Product data](https://github.com/leony99/pack/blob/main/backend/src/main/java/com/leonycosta/packapi/product/product/ProductRepository.java): `backend/src/main/java/com/leonycosta/packapi/product/product/ProductRepository.java`

### Other components

- **Shopper**

## Connections

- Shopper → Storefront: browses
- Storefront → Catalog UI: opens catalog
- Catalog UI → Pack REST API: requests catalog (evidence: `README.md`)
- Shopper → Cart and checkout UI: shops
- Cart and checkout UI → Pack REST API: submits purchase (evidence: `README.md`)
- Shopper → Customer account UI: manages account
- Admin panel → Pack REST API: administers store (evidence: `README.md`)
- Pack REST API → Authentication: handles authentication
- Authentication → Customer accounts: creates customers (evidence: `backend/src/main/java/com/leonycosta/packapi/auth/AuthService.java`)
- Authentication → Staff and permissions: authenticates staff (evidence: `backend/src/main/java/com/leonycosta/packapi/auth/AuthService.java`)
- Customer accounts → Customer data: persists customers (evidence: `backend/src/main/java/com/leonycosta/packapi/customer/customer/CustomerService.java`)
- Customer accounts → Cart data: creates cart (evidence: `backend/src/main/java/com/leonycosta/packapi/customer/customer/CustomerService.java`)
- Pack REST API → Product catalog: serves catalog (evidence: `README.md`)
- Product catalog → Product data: queries products (evidence: `backend/src/main/java/com/leonycosta/packapi/product/product/ProductService.java`)
- Product catalog → Product variants: uses variants (evidence: `backend/src/main/java/com/leonycosta/packapi/product/product/ProductService.java`)
- Shopping cart → Product variants: validates stock (evidence: `backend/src/main/java/com/leonycosta/packapi/cart/cart/CartService.java`)
- Shopping cart → Customer accounts: validates customer (evidence: `backend/src/main/java/com/leonycosta/packapi/cart/cart/CartService.java`)
- Shopping cart → Cart data: loads cart (evidence: `backend/src/main/java/com/leonycosta/packapi/cart/cart/CartService.java`)
- Pack REST API → Shopping cart: manages cart (evidence: `README.md`)
- Cart and checkout UI → Shopping cart: updates cart
- Order checkout → Shopping cart: locks cart (evidence: `backend/src/main/java/com/leonycosta/packapi/order/order/OrderService.java`)
- Order checkout → Customer accounts: loads customer (evidence: `backend/src/main/java/com/leonycosta/packapi/order/order/OrderService.java`)
- Order checkout → Stock movements: registers stock out (evidence: `backend/src/main/java/com/leonycosta/packapi/order/order/OrderService.java`)
- Order checkout → Order data: saves order (evidence: `backend/src/main/java/com/leonycosta/packapi/order/order/OrderService.java`)
- Pack REST API → Order checkout: checks out (evidence: `README.md`)
- Order checkout → Payments: coordinates payment (evidence: `README.md`)
- Order checkout → Shipping: calculates shipping (evidence: `backend/src/main/java/com/leonycosta/packapi/order/order/OrderService.java`)
- Pack REST API → Stock movements: records movements (evidence: `README.md`)
- Product variants → Stock movements: tracks stock (evidence: `README.md`)
- Pack REST API → Newsletter and contact: accepts subscriptions
- Pack REST API → Staff and permissions: manages staff
