How ngocquang95/stallwise works
Stallwise is a self-hosted shop operations app for consolidating marketplace and in-person sales, managing products and stock, and tracking revenue and gross profit. The main workflow is to map and import marketplace exports or enter orders, manage their lifecycle, and reflect sales and returns in the stock ledger; dashboard and export features help review results. The graph highlights sampled service calls and documented capabilities. Several UI pages and backend controllers are present in the tree but were not sampled, so their internal wiring is not inferred.
Main entry points: route.ts Backend API proxy · OrderService.java Order lifecycle · ImportService.java File import · import-wizard.tsx Import wizard
Components 22
Shop interface
- Shop workspace
frontend/src/app/(app) - Login screen
frontend/src/app/login/page.tsx - Backend API proxy
frontend/src/app/api/backend/[...path]/route.ts - Login route
frontend/src/app/api/auth/login/route.ts - Import wizard
frontend/src/components/imports/import-wizard.tsx - Dashboard view
frontend/src/components/dashboard/dashboard-view.tsx
Identity and setup
- JWT authentication
backend/src/main/java/dev/ngocquang/stallwise/auth/AuthService.java - Role security
backend/src/main/java/dev/ngocquang/stallwise/config/SecurityConfig.java
Orders and catalog
- Product catalog
backend/src/main/java/dev/ngocquang/stallwise/product/ProductService.java - Product records
backend/src/main/java/dev/ngocquang/stallwise/product/Product.java - Sales channels
backend/src/main/java/dev/ngocquang/stallwise/channel/ChannelService.java - Order lifecycle
backend/src/main/java/dev/ngocquang/stallwise/order/OrderService.java - Order records
backend/src/main/java/dev/ngocquang/stallwise/order/SalesOrder.java
Imports and stock
- File import
backend/src/main/java/dev/ngocquang/stallwise/importer/ImportService.java - Tabular file reader
backend/src/main/java/dev/ngocquang/stallwise/importer/TabularFileReader.java - Stock ledger
backend/src/main/java/dev/ngocquang/stallwise/inventory/InventoryService.java - Stock movements
backend/src/main/java/dev/ngocquang/stallwise/inventory/StockMovement.java
Reporting and settings
- Dashboard metrics
backend/src/main/java/dev/ngocquang/stallwise/report/DashboardService.java - Order export
backend/src/main/java/dev/ngocquang/stallwise/report/ExportService.java - Shop settings
backend/src/main/java/dev/ngocquang/stallwise/settings/SettingsService.java
Other components
- Shop staff
- Marketplaces
Connections 22
- Shop staff → Login screen: signs in
README.md - Login screen → Login route: submits credentials
frontend/src/app/api/auth/login/route.ts - Login route → JWT authentication: requests token
- JWT authentication → Role security: issues JWT
backend/src/main/java/dev/ngocquang/stallwise/auth/AuthService.java - Shop staff → Shop workspace: manages shop
README.md - Shop workspace → Backend API proxy: requests backend
- Backend API proxy → Order lifecycle: routes requests
- Backend API proxy → Product catalog: routes requests
- Backend API proxy → Dashboard metrics: routes requests
- Marketplaces → Import wizard: provides exports
README.md - Shop staff → Import wizard: uploads export
README.md - Import wizard → File import: submits mapping
- File import → Tabular file reader: reads file
backend/src/main/java/dev/ngocquang/stallwise/importer/ImportService.java - File import → Order lifecycle: places orders
backend/src/main/java/dev/ngocquang/stallwise/importer/ImportService.java - Order lifecycle → Stock ledger: records stock changes
backend/src/main/java/dev/ngocquang/stallwise/order/OrderService.java - Product catalog → Stock ledger: records opening stock
backend/src/main/java/dev/ngocquang/stallwise/product/ProductService.java - Stock ledger → Stock movements: saves movements
backend/src/main/java/dev/ngocquang/stallwise/inventory/InventoryService.java - Order lifecycle → Order records: saves orders
backend/src/main/java/dev/ngocquang/stallwise/order/OrderService.java - Dashboard metrics → Dashboard view: supplies metrics
- Shop staff → Dashboard view: reviews results
README.md - Shop staff → Order export: exports orders
README.md - Shop staff → Shop settings: configures shop
README.md