How gopi0974/ai-smart-cart works
AuraCart is a smart-cart shopping system: a shopper pairs to a cart, scans products, and has basket placement checked by camera-based rules before checkout. Cart sessions coordinate verification, billing, and security alerts; camera feeds and cart events reach shopper and admin interfaces in real time. The README documents the major capabilities, while the edges below are limited to relationships visible in excerpts or explicitly described there; some frontend-to-backend wiring is therefore shown as unverified.
Main entry points: cart_manager.py Cart Manager · main.py REST and WebSocket API · ai_verifier.py AI Verifier · app.js Shopper App
Components 21
Shopping Interfaces
- Shopper App
frontend/shopper/app.js - Barcode Scanner
frontend/shopper/scanner.js - Camera Streamer
frontend/cart_cam/cam.js - Admin Dashboard
frontend/admin/admin.js
Cart Backend
- REST and WebSocket API
backend/main.py - Cart Manager
backend/services/cart_manager.py
Vision Verification
- AI Verifier
backend/vision/ai_verifier.py - Hand Detector
backend/vision/hand_detector.py - Vision Model Adapter
backend/vision/models/yolo_adapter.py - Vision Model Interface
backend/vision/models/base_model.py - Rule Interface
backend/vision/rules/base_rule.py - Timing Rule
backend/vision/rules/timing_rule.py - Hand Entry Rule
backend/vision/rules/hand_rule.py - Visual Match Rule
backend/vision/rules/visual_rule.py - Rule Configuration
backend/vision/rules_config.json
Cart Domain
- Product Catalog
backend/data/products.json - Cart Session State
backend/models/cart_state.py - Product Models
backend/models/product.py - Billing and Receipts
backend/services/billing_service.py
Camera Devices
- Cart Camera
esp32_cam/AuraCart_ESP32_CAM.ino
Other components
- Shopper
Connections 28
- Shopper → Shopper App: uses
README.md - Shopper App → Barcode Scanner: uses scanner
README.md - Shopper App → REST and WebSocket API: pairs and shops
- Barcode Scanner → REST and WebSocket API: submits scans
- Camera Streamer → REST and WebSocket API: streams frames
README.md - Cart Camera → REST and WebSocket API: uploads frames
backend/main.py - REST and WebSocket API → Cart Manager: routes cart actions
backend/main.py - REST and WebSocket API → Admin Dashboard: broadcasts events
README.md - REST and WebSocket API → Shopper App: broadcasts events
README.md - Admin Dashboard → REST and WebSocket API: monitors carts
README.md - Cart Manager → Product Catalog: loads catalog
backend/services/cart_manager.py - Cart Manager → Cart Session State: updates sessions
backend/services/cart_manager.py - Cart Manager → Product Models: creates cart items
backend/services/cart_manager.py - Cart Manager → AI Verifier: requests verification
backend/services/cart_manager.py - Cart Manager → Billing and Receipts: calculates totals
backend/services/cart_manager.py - AI Verifier → Hand Detector: processes frames
backend/vision/ai_verifier.py - AI Verifier → Vision Model Adapter: detects objects
backend/vision/ai_verifier.py - AI Verifier → Timing Rule: evaluates timing
backend/vision/ai_verifier.py - AI Verifier → Hand Entry Rule: evaluates hand events
backend/vision/ai_verifier.py - AI Verifier → Visual Match Rule: evaluates visual match
backend/vision/ai_verifier.py - AI Verifier → Rule Configuration: loads settings
README.md - Vision Model Adapter → Vision Model Interface: implements interface
backend/vision/models/yolo_adapter.py - Timing Rule → Rule Interface: implements rule
backend/vision/rules/timing_rule.py - Hand Entry Rule → Rule Interface: implements rule
backend/vision/rules/hand_rule.py - Visual Match Rule → Rule Interface: implements rule
backend/vision/rules/visual_rule.py - Visual Match Rule → Product Models: compares product traits
backend/vision/rules/visual_rule.py - Cart Manager → Shopper App: sends security countdown
README.md - Cart Manager → Admin Dashboard: escalates security alerts
README.md