# rockkamal253-ns/shop-pos architecture

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

- Interactive diagram: https://gitdiagram.com/rockkamal253-ns/shop-pos
- Repository: https://github.com/rockkamal253-ns/shop-pos

## Overview

ShopPOS is a browser-based point-of-sale and inventory application for small shops. A cashier signs in, manages a cart, and checks out a sale; checkout updates stock and records movements in the same transaction, while sales history and receipts support follow-up. Product and category management, manual stock adjustments, and an admin dashboard are distinct operational capabilities. The README documents these feature relationships; sampled source was limited to the browser JavaScript, so internal Java call paths are not asserted.

Main entry points: [`src/main/resources/templates`](https://github.com/rockkamal253-ns/shop-pos/tree/main/src/main/resources/templates) (Shop pages), [`src/main/java/com/example/shoppos/sale/SaleService.java`](https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/sale/SaleService.java) (Checkout and void), [`src/main/resources/application.yml`](https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/resources/application.yml) (Application database), [`src/main/java/com/example/shoppos/sale/PosController.java`](https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/sale/PosController.java) (POS cart)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and interface"]
  node_login["Sign-in"]
  node_security["Access control"]
  node_pages["Shop pages"]
end

subgraph group_catalog["Catalog and inventory"]
  node_products["Products"]
  node_categories["Categories"]
  node_inventory["Stock adjustments"]
  node_movements["Stock movements<br/>[StockMovement.java]"]
end

subgraph group_sales["Point of sale"]
  node_pos["POS cart<br/>[PosController.java]"]
  node_cart["Cart<br/>[CartService.java]"]
  node_checkout["Checkout and void<br/>[SaleService.java]"]
  node_sale_records["Sales and items<br/>[Sale.java]"]
  node_history["History and receipts"]
end

subgraph group_operations["Shop operations"]
  node_dashboard["Admin dashboard"]
  node_database[("Application database<br/>[application.yml]")]
end

node_cashier(("Cashier / admin"))

node_cashier -->|"signs in"| node_login
node_cashier -->|"uses"| node_pages
node_pages -->|"opens POS"| node_pos
node_pages -->|"manages catalog"| node_products
node_pages -->|"manages catalog"| node_categories
node_pages -->|"adjusts stock"| node_inventory
node_pos -->|"maintains cart"| node_cart
node_pos -->|"checks out"| node_checkout
node_checkout -->|"records sale"| node_sale_records
node_checkout -->|"records stock change"| node_movements
node_inventory -->|"records adjustment"| node_movements
node_pages -->|"views sales"| node_history
node_pages -->|"views summary"| node_dashboard
node_login -.->|"uses access control"| node_security
node_products -.->|"persists catalog"| node_database
node_categories -.->|"persists categories"| node_database
node_checkout -.->|"persists transaction"| node_database
node_dashboard -.->|"reads metrics"| node_database

click node_login "https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/LoginController.java"
click node_security "https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/common/config/SecurityConfig.java"
click node_pages "https://github.com/rockkamal253-ns/shop-pos/tree/main/src/main/resources/templates"
click node_products "https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/product/ProductService.java"
click node_categories "https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/product/CategoryService.java"
click node_inventory "https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/inventory/InventoryService.java"
click node_movements "https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/inventory/StockMovement.java"
click node_pos "https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/sale/PosController.java"
click node_cart "https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/sale/CartService.java"
click node_checkout "https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/sale/SaleService.java"
click node_sale_records "https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/sale/Sale.java"
click node_history "https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/sale/SaleController.java"
click node_dashboard "https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/dashboard/DashboardService.java"
click node_database "https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/resources/application.yml"

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_security,node_pages toneBlue
class node_products,node_categories,node_inventory,node_movements toneAmber
class node_pos,node_cart,node_checkout,node_sale_records,node_history toneMint
class node_dashboard,node_database toneRose
class node_cashier toneIndigo
```

## Components

### Access and interface

- [Sign-in](https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/LoginController.java): `src/main/java/com/example/shoppos/LoginController.java`
- [Access control](https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/common/config/SecurityConfig.java): `src/main/java/com/example/shoppos/common/config/SecurityConfig.java`
- [Shop pages](https://github.com/rockkamal253-ns/shop-pos/tree/main/src/main/resources/templates): `src/main/resources/templates`

### Catalog and inventory

- [Products](https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/product/ProductService.java): `src/main/java/com/example/shoppos/product/ProductService.java`
- [Categories](https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/product/CategoryService.java): `src/main/java/com/example/shoppos/product/CategoryService.java`
- [Stock adjustments](https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/inventory/InventoryService.java): `src/main/java/com/example/shoppos/inventory/InventoryService.java`
- [Stock movements](https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/inventory/StockMovement.java): `src/main/java/com/example/shoppos/inventory/StockMovement.java`

### Point of sale

- [POS cart](https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/sale/PosController.java): `src/main/java/com/example/shoppos/sale/PosController.java`
- [Cart](https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/sale/CartService.java): `src/main/java/com/example/shoppos/sale/CartService.java`
- [Checkout and void](https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/sale/SaleService.java): `src/main/java/com/example/shoppos/sale/SaleService.java`
- [Sales and items](https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/sale/Sale.java): `src/main/java/com/example/shoppos/sale/Sale.java`
- [History and receipts](https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/sale/SaleController.java): `src/main/java/com/example/shoppos/sale/SaleController.java`

### Shop operations

- [Admin dashboard](https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/java/com/example/shoppos/dashboard/DashboardService.java): `src/main/java/com/example/shoppos/dashboard/DashboardService.java`
- [Application database](https://github.com/rockkamal253-ns/shop-pos/blob/main/src/main/resources/application.yml): `src/main/resources/application.yml`

### Other components

- **Cashier / admin**

## Connections

- Cashier / admin → Sign-in: signs in (evidence: `README.md`)
- Cashier / admin → Shop pages: uses (evidence: `README.md`)
- Shop pages → POS cart: opens POS (evidence: `README.md`)
- Shop pages → Products: manages catalog (evidence: `README.md`)
- Shop pages → Categories: manages catalog (evidence: `README.md`)
- Shop pages → Stock adjustments: adjusts stock (evidence: `README.md`)
- POS cart → Cart: maintains cart (evidence: `README.md`)
- POS cart → Checkout and void: checks out (evidence: `README.md`)
- Checkout and void → Sales and items: records sale (evidence: `README.md`)
- Checkout and void → Stock movements: records stock change (evidence: `README.md`)
- Stock adjustments → Stock movements: records adjustment (evidence: `README.md`)
- Shop pages → History and receipts: views sales (evidence: `README.md`)
- Shop pages → Admin dashboard: views summary (evidence: `README.md`)
- Sign-in → Access control: uses access control
- Products → Application database: persists catalog
- Categories → Application database: persists categories
- Checkout and void → Application database: persists transaction
- Admin dashboard → Application database: reads metrics
