How mdarafath07/smartstock works
SmartStock is a cross-platform Flutter inventory and point-of-sale system for electronics retailers. The main workflow is maintaining product and serial-number stock, selecting available units for a sale, recording the transaction, and using dashboard and reports to monitor the business. Its feature-based architecture separates screens, providers, services, and repositories, with Firestore as the documented real-time backend. The README excerpt supports the main product flows and some layer relationships; most Dart sources were not sampled, so other connections are omitted rather than inferred.
Main entry points: index.js Callable functions · routes Navigation · screens Product catalog · new_sale_screen.dart Point of sale
Components 24
App Shell
- Navigation
lib/core/routes
Stock Management
- Product catalog
lib/features/products/screens - Product state
lib/features/products/providers/product_provider.dart - Product operations
lib/features/products/services/product_service.dart - Inventory views
lib/features/inventory/screens - Inventory operations
lib/features/inventory/services/inventory_service.dart - Categories
lib/features/categories/screens
Sales and Service
- Point of sale
lib/features/sales/screens/new_sale_screen.dart - Sale state
lib/features/sales/providers/sale_provider.dart - Sale operations
lib/features/sales/services/sale_service.dart - Customer records
lib/features/customers/screens - Warranty claims
lib/features/warranty/screens - Product issues
lib/features/product_issues/screens - Replacements
lib/features/replacements/screens
Business Insights
- Dashboard
lib/features/dashboard/screens/dashboard_screen.dart - Dashboard state
lib/features/dashboard/providers/dashboard_provider.dart - Dashboard metrics
lib/features/dashboard/services/dashboard_service.dart - Reports and analytics
lib/features/reports/screens
Backend Integrations
- Sheets sync
lib/features/integrations/services - Callable functions
functions/index.js - Cloud Firestore
Other components
- Retail operator
- Google Sheets
- Email service
Connections 22
- Retail operator → Navigation: uses
README.md - Navigation → Dashboard: routes to
README.md - Dashboard → Dashboard state: displays
README.md - Dashboard state → Dashboard metrics: requests metrics
README.md - Dashboard metrics → Cloud Firestore: queries
README.md - Retail operator → Product catalog: manages products
README.md - Product catalog → Product state: uses state
- Retail operator → Inventory views: reviews stock
README.md - Retail operator → Categories: manages categories
- Retail operator → Point of sale: records sale
README.md - Point of sale → Sale state: submits records
README.md - Sale state → Cloud Firestore: bulk creates sales
README.md - Retail operator → Customer records: manages customers
- Retail operator → Warranty claims: checks warranty
README.md - Retail operator → Product issues: tracks issues
- Retail operator → Replacements: handles replacements
- Retail operator → Reports and analytics: views analytics
README.md - Retail operator → Sheets sync: backs up data
README.md - Sheets sync → Callable functions: calls
- Callable functions → Google Sheets: writes sheets
functions/index.js - Callable functions → Cloud Firestore: stores OTPs
functions/index.js - Callable functions → Email service: sends OTP
functions/index.js