How rockkamal253-ns/shop-pos works
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: templates Shop pages · SaleService.java Checkout and void · application.yml Application database · PosController.java POS cart
Components 15
Access and interface
- Sign-in
src/main/java/com/example/shoppos/LoginController.java - Access control
src/main/java/com/example/shoppos/common/config/SecurityConfig.java - Shop pages
src/main/resources/templates
Catalog and inventory
- Products
src/main/java/com/example/shoppos/product/ProductService.java - Categories
src/main/java/com/example/shoppos/product/CategoryService.java - Stock adjustments
src/main/java/com/example/shoppos/inventory/InventoryService.java - Stock movements
src/main/java/com/example/shoppos/inventory/StockMovement.java
Point of sale
- POS cart
src/main/java/com/example/shoppos/sale/PosController.java - Cart
src/main/java/com/example/shoppos/sale/CartService.java - Checkout and void
src/main/java/com/example/shoppos/sale/SaleService.java - Sales and items
src/main/java/com/example/shoppos/sale/Sale.java - History and receipts
src/main/java/com/example/shoppos/sale/SaleController.java
Shop operations
- Admin dashboard
src/main/java/com/example/shoppos/dashboard/DashboardService.java - Application database
src/main/resources/application.yml
Other components
- Cashier / admin
Connections 18
- Cashier / admin → Sign-in: signs in
README.md - Cashier / admin → Shop pages: uses
README.md - Shop pages → POS cart: opens POS
README.md - Shop pages → Products: manages catalog
README.md - Shop pages → Categories: manages catalog
README.md - Shop pages → Stock adjustments: adjusts stock
README.md - POS cart → Cart: maintains cart
README.md - POS cart → Checkout and void: checks out
README.md - Checkout and void → Sales and items: records sale
README.md - Checkout and void → Stock movements: records stock change
README.md - Stock adjustments → Stock movements: records adjustment
README.md - Shop pages → History and receipts: views sales
README.md - Shop pages → Admin dashboard: views summary
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