How raj262007/gcet-hyderabad-hackathon-2026 works
StockSense is an inventory-management application for warehouse staff and managers. Users enter through authentication, then use the dashboard and operational views to manage products, receive and dispatch goods, transfer stock, reconcile counts, and review movement history. The React inventory context coordinates shared state and API synchronization with a local Node/Express service backed by JSON data. The README documents additional capabilities such as reordering rules, barcode lookup, printable slips, and offline fallback; unsampled implementations are shown at their documented paths without inferring internal call wiring.
Main entry points: App.jsx App Shell · InventoryContext.jsx Inventory State · ReceiptsView.jsx Goods Receipts · DeliveriesView.jsx Delivery Orders
Components 20
Application Shell
- App Shell
src/App.jsx - Authentication
src/views/AuthView.jsx - Navigation Bar
src/components/Navbar.jsx - Barcode Scanner
src/components/BarcodeScannerModal.jsx - User Profile
src/views/ProfileView.jsx - Settings
src/views/SettingsView.jsx
Stock Operations
- Goods Receipts
src/views/ReceiptsView.jsx - Delivery Orders
src/views/DeliveriesView.jsx - Internal Transfers
src/views/InternalTransfersView.jsx - Stock Adjustments
src/views/StockAdjustmentsView.jsx - Print Slips
src/components/PrintSlipModal.jsx
Inventory Oversight
- Dashboard
src/views/DashboardView.jsx - Product Catalog
src/views/ProductsView.jsx - Movement Ledger
src/views/MoveHistoryView.jsx - Reordering Rules
src/views/ReorderingRulesView.jsx - Low Stock Alerts
src/components/NotificationDrawer.jsx
State and Persistence
- Inventory State
src/context/InventoryContext.jsx - Local REST API
server/server.js - JSON Inventory Data
server/data/db.json
Other components
- Warehouse User
Connections 31
- Warehouse User → App Shell: uses
- App Shell → Authentication: renders
- App Shell → Dashboard: routes
- App Shell → Product Catalog: routes
- App Shell → Goods Receipts: routes
- App Shell → Delivery Orders: routes
- App Shell → Internal Transfers: routes
- App Shell → Stock Adjustments: routes
- App Shell → Movement Ledger: routes
- App Shell → Reordering Rules: routes
- App Shell → User Profile: routes
- App Shell → Settings: routes
- App Shell → Navigation Bar: renders
- App Shell → Barcode Scanner: opens
- App Shell → Low Stock Alerts: renders
- Goods Receipts → Print Slips: opens
- Delivery Orders → Print Slips: opens
- Authentication → Inventory State: updates user
- Dashboard → Inventory State: reads state
- Product Catalog → Inventory State: reads and updates
- Goods Receipts → Inventory State: manages receipts
- Delivery Orders → Inventory State: manages deliveries
- Internal Transfers → Inventory State: manages transfers
- Stock Adjustments → Inventory State: reconciles stock
- Movement Ledger → Inventory State: reads ledger
- Reordering Rules → Inventory State: reads stock rules
- Barcode Scanner → Inventory State: looks up stock
- Low Stock Alerts → Inventory State: reads alerts
- Print Slips → Inventory State: reads product data
- Inventory State → Local REST API: fetches and syncs
- Local REST API → JSON Inventory Data: reads and writes