CASE STUDY 03
StoreFront Retail Suite
An enterprise-grade mobile commerce ecosystem featuring dedicated B2C Customer and B2B Shopkeeper applications powered by a serverless Firebase backend with atomic inventory locking.
Flutter (v3.11+)
Dart & Material 3
Cloud Firestore
ACID Concurrency Locks
Reactive Stream Listeners
Remote Store Kill-Switch
Sequential Order Counter
Semver Version Guards
SharedPreferences Auth
Revenue Analytics Engine
Engineering Summary
"Atomic inventory locking and real-time cloud governance: StoreFront executes multi-document ACID transactions (`runTransaction`) during cart checkout to eliminate stock overselling, while real-time document streams (`snapshots().listen`) power a sub-500ms remote store service kill-switch."
01 / Concept & Product Architecture
StoreFront was engineered to digitize local retail operations without imposing server maintenance burdens. By separating the user experience into two dedicated mobile binaries—`storefront_customer` for shoppers and `storefront_shopkeeper` for store managers—the system delivers tailored role interfaces while operating over a shared, highly-optimized Cloud Firestore NoSQL backend.
02 / Core Engineering Pillars
Atomic Inventory Concurrency Locks
Executes ACID Firestore transactions (`runTransaction`) during checkout. Reads live item quantities, verifies requested amounts against live inventory, locks daily sequential counters (`counters/YYYYMMDD`), creates order documents, and atomically decrements stock (`FieldValue.increment(-qty)`).
Reactive Store Service Kill-Switch
Enables store managers to pause customer ordering platform-wide with a single toggle. Customer devices monitor a real-time document stream (`snapshots().listen`), instantly disabling cart checkout and displaying a friendly service unavailable screen during rush hours.
Sequential Daily NoSQL Order Numbers
Overcomes NoSQL random document ID limitations by maintaining daily resetting counter documents inside database transactions, generating human-readable order IDs (e.g. `order 140820260001`) for clear verbal verification.
Remote App Governance & Version Guard
Fetches version thresholds from Firestore (`app_control`) during splash initialization and compares them against native semver (`package_info_plus`), preventing legacy client builds with deprecated schemas from making invalid cloud requests.
03 / Platform Engineering Checklist
Every component of the StoreFront platform was designed for production stability, reactive data binding, and operational efficiency:
- Dual-App Flutter/Dart Codebase (`storefront_customer` & `storefront_shopkeeper`)
- ACID-Compliant Firestore Transactions (`runTransaction`)
- Reactive Document Streams (`snapshots().listen`)
- Sub-500ms Remote Store Service Kill-Switch
- Sequential Daily Resetting Order ID Counter Algorithm
- Semantic Version Parsing & Mandatory Update Guard
- Real-Time Order Fulfillment Queue with Server Timestamps
- Product Inventory CRUD with Units (`piece`, `kg`, `L`, `ml`, `pack`)
- Admin Customer Account Onboarding Module
- Client-Side Financial Revenue Aggregation Analytics
- Session Persistence (`SharedPreferences`) & Input Validation
- Material 3 Design System & Cohesive Green Palette