How sameer07-bit/shopsahayak works
ShopSahayak is a retail-store business assistant spanning store operations, AI/voice interaction, and a browser interface. The documented owner workflow runs from reviewing inventory and sales, through an AI restock recommendation and purchase-order approval, to updated stock and business insights. The repository also contains customer Khata, authentication, OCR, notifications, and messaging capabilities. Arrows are limited to relationships visible in excerpts, the SOURCE INDEX, or README; several controllers and frontend modules were not sampled, so their internal connections are not inferred.
Main entry points: server.js Express API · productController.js Product inventory · db.js Database connection · app.js Retail dashboard
Components 22
Store experience
- Retail dashboard
js/app.js - Guided demo
js/demo-flow.js - Language support
js/translations.js
Retail operations
- Sales and reports
controllers/salesController.js - Product inventory
controllers/productController.js - Customer Khata
controllers/customerController.js - Suppliers and orders
controllers/supplierController.js - Store profile
controllers/storeController.js - Notifications
controllers/notificationController.js
AI and channels
- AI assistant
controllers/aiController.js - Voice assistant
controllers/voiceController.js - Retail AI engine
utils/geminiClient.js - Handwriting OCR
controllers/ocrController.js - Gemini OCR service
services/geminiOcrService.js - WhatsApp messaging
controllers/whatsappController.js - Registration messaging
utils/smsService.js
API and persistence
- Authentication
controllers/authController.js - Express API
server.js - Database connection
config/db.js - MongoDB
- User data tables
utils/dynamicTableManager.js
Other components
- Store owner
Connections 25
- Store owner → Retail dashboard: uses
- Retail dashboard → Guided demo: runs walkthrough
- Retail dashboard → Language support: offers languages
- Express API → Database connection: connects
server.js - Express API → Product inventory: mounts routes
server.js - Express API → Sales and reports: mounts routes
server.js - Express API → Customer Khata: mounts routes
server.js - Express API → Suppliers and orders: mounts routes
server.js - Express API → Store profile: mounts routes
server.js - Express API → Authentication: mounts routes
server.js - Express API → AI assistant: mounts routes
server.js - Express API → Voice assistant: mounts routes
server.js - Express API → Handwriting OCR: mounts routes
server.js - Express API → WhatsApp messaging: mounts routes
server.js - Express API → Notifications: mounts routes
server.js - Database connection → MongoDB: connects
config/db.js - Database connection → Product inventory: seeds products
config/db.js - Database connection → Customer Khata: seeds customers
config/db.js - Voice assistant → Retail AI engine: generates response
controllers/voiceController.js - Voice assistant → Product inventory: reads context
controllers/voiceController.js - Product inventory → User data tables: records user data
controllers/productController.js - Product inventory → Suppliers and orders: creates restock order
controllers/productController.js - Authentication → Registration messaging: dispatches registration SMS
controllers/authController.js - Registration messaging → Notifications: creates notification
utils/smsService.js - Handwriting OCR → Gemini OCR service: OCR processing