Grocery Multi-Vendor System

Transform grocery shopping with our Grocery Multi-Vendor System. Built with Flutter and Firebase, it connects vendors, customers, and delivery services, ensuring seamless order management, product tracking, and efficient delivery.

Overall Features

• Vendor Order Management: Grocery vendors can accept, process, and manage orders in real-time.
• Customer-Vendor Chat: Customers can chat with vendors to clarify product details or request specific items.
• Customer-Rider Chat: Customers can communicate directly with the rider handling their delivery.
• Scheduled Orders: Allow customers to schedule recurring grocery orders for convenience.
• Web App & PWA: Accessible via responsive web apps or progressive web apps (PWAs) for both vendors and customers.
• Delivery Management: Streamline the delivery process with optimized routing, order prioritization, and real-time tracking.
• Firebase Integration: Real-time synchronization, secure data handling, and scalable backend support ensure smooth platform operation.
• Nearby Stores: Users can see nearby stores within a 10km radius. Vendors can update their address to enable this feature.
• Bulk Upload: Vendors can upload multiple products via an Excel sheet, with a sample file provided for guidance.
• Blog Post Feature: A blog section for sharing updates, news, and tips, manageable via the admin panel, and accessible to users in the app.
• Multi-language Support: Includes French, Arabic, Hindi, and Russian, with user-selectable language preferences in settings.
• Performance Enhancements: Improved loading times, optimized database queries, and enhanced caching for better performance.
• Delivery E-signature: Upon delivery arrival, users must sign electronically on the order page before the rider can mark the order as completed, ensuring confirmation and accountability.

Vendor-Specific Features

• Product Management: Vendors can add, edit, or remove grocery items with detailed descriptions, images, and categories.
• Product Expiration Tracking: Vendors can input and monitor expiration dates for perishable goods, with alerts for nearing expiry.
• Inventory Management: Real-time stock updates to prevent overselling or shortages.
• Sales Analytics: Track revenue, top-selling products, and customer preferences to optimize business operations.

Customer-Specific Features

• Scheduled Orders: Set up recurring grocery deliveries based on customer needs.
• Real-Time Order Tracking: Customers can track their order status, including delivery updates.
• Search Functionality: Customers can search for groceries by name, category, or brand.
• Secure Payments: Multiple payment options for a seamless and secure checkout experience.
• Expiration Information: View expiration dates of perishable items before purchase (if provided by vendors).

Delivery Service Features

• Category-Based Deliveries: Organize deliveries based on urgency or type (e.g., perishables, dry goods).
• Rider App: A dedicated app for delivery personnel to manage orders and track delivery locations.
• Live Tracking: Customers and vendors can track delivery progress in real-time.
• Optimized Routes: Ensure efficient delivery with optimized routes for riders.
• Rider Document Verification: Support for uploading rider documents with enhanced validation for faster onboarding.

Workflow Overview

This section outlines how the grocery delivery app functions from order placement to final delivery or pickup and payment:

1. Order Placement: The user browses products, adds items to the cart, and checks out.
2. Delivery or Pickup Selection: During checkout, the user selects either delivery or pickup.
   • If Pickup is selected, the user chooses the nearest store or a desired store location for collection.
   • If Delivery is selected, the order proceeds to vendor/admin review.
3. Order Acceptance:
   • For delivery, the admin or vendor can accept the order and assign it manually or allow the system to assign it automatically to a rider.
4. Rider Assignment: The assigned rider receives the order request and can choose to accept or reject it.
5. Rider Acceptance: If accepted, the user is notified that their order is being processed.
6. Order Processing: The vendor or admin updates the order status to processing once the rider arrives at the store to pick it up.
7. On the Way: After collection, the order status is updated to on the way, and the user receives a live update.
8. Communication: The rider can chat with or call the customer during transit for clarification or directions.
9. E-signature on Arrival: Upon delivery arrival, the user must sign the order electronically in the app before the rider can mark the order as completed.
10. Payment Distribution: After completion, payments are automatically processed and distributed to both the vendor (for products) and the rider (for delivery services).

Our Grocery Multi-Vendor System provides the tools and features needed to ensure timely grocery delivery, efficient product management, and seamless communication between vendors, customers, and delivery personnel. Build a reliable and scalable platform that enhances user satisfaction.

App Login Details for Testing

Use the following login details to test the app:

Admin Login

Email: admin123@gmail.com
Password: 123456

Vendor Login

Email: vvendor666@gmail.com
Password: 123456

Email: preciousoliver3@gmail.com
Password: 123456

Rider Login

Email: olivetterider123@gmail.com
Password: 123456

Payment Test Cards

Below are test card details for Stripe, Paystack, and Flutterwave. Use these in test mode only.

Stripe Test Cards

Card Type	Card Number	Expiry Date	CVC
Visa	4242 4242 4242 4242	12/34	123
Mastercard	5555 5555 5555 4444	12/34	123
Declined Card	4000 0000 0000 9995	12/34	123

Paystack Test Cards

Card Type	Card Number	Expiry Date	CVC
Visa	4084 0840 8408 4081	12/34	408
Mastercard	5033 5611 1111 1118	12/34	408
PIN Authentication	5061 4601 2345 6789	12/34	123

Flutterwave Test Cards

Card Type	Card Number	Expiry Date	CVC
Success	5531 8866 5214 2950	09/32	564
Insufficient Funds	4187 4277 8010 0010	09/32	828
Declined	5061 4601 1111 1112	09/32	891

Changelog – July 19, 2025

We are excited to announce the latest updates to our app, including new features, enhancements, and improvements. Here is a detailed list of changes:

• Flutter Update:
  • Upgraded apps to the latest Flutter version for improved performance and compatibility.
  • Enhanced UI rendering and reduced app load times across Android and iOS platforms.
• E-Signature Feature:
  • Added e-signature functionality for delivery confirmation.
  • Customers are now required to provide an e-signature on the order page upon delivery, allowing riders to update the order status to completed.
  • Improved security and verification for delivery completion.