System Requirements Document (SRD) for pearl-food

1. Introduction

The pearl-food project is a grocery store application designed to provide users in Pakistan (PK) with a seamless and convenient way to browse, order, and pay for groceries. This app aims to cater to the growing demand for online grocery shopping by offering an intuitive, user-friendly platform that simplifies the shopping experience. Whether users are looking for fresh produce, pantry staples, or household essentials, pearl-food will deliver convenience at their fingertips.

This document outlines the system requirements for pearl-food, including functional and non-functional requirements, user personas, design concepts, and the technical stack.

2. System Overview

The pearl-food application will serve as a centralized platform for grocery shopping. It will allow users to browse a wide range of grocery items, add them to their cart, and place orders for delivery or pickup. The system will also include features for managing inventory, processing payments, and tracking orders.

Key features include:

• A user-friendly interface for browsing and searching products.
• Secure payment processing.
• Real-time inventory updates.
• Delivery and pickup options.
• User accounts for personalized experiences.

The system will be designed to accommodate the needs of individual users, store administrators, and delivery personnel, ensuring a smooth and efficient operation.

3. Functional Requirements

User Stories:

• As a User, I should be able to browse grocery items by category.
• As a User, I should be able to search for specific grocery items.
• As a User, I should be able to add items to my cart.
• As a User, I should be able to view my cart and modify quantities.
• As a User, I should be able to place an order for delivery or pickup.
• As a User, I should be able to track the status of my order.
• As a User, I should be able to create and manage my account.
• As an Admin, I should be able to manage inventory (add, update, delete items).
• As an Admin, I should be able to view and manage user orders.
• As an Admin, I should be able to generate sales reports.
• As a Delivery Personnel, I should be able to view assigned orders and update delivery status.

4. User Personas

1. User (Customer)

• Description: End-users who browse and purchase groceries.
• Goals: Convenience, variety, and timely delivery.
• Pain Points: Limited time, difficulty finding specific items, and unreliable delivery services.

2. Admin

• Description: Store managers responsible for inventory and order management.
• Goals: Efficient inventory management, accurate sales tracking, and smooth order processing.
• Pain Points: Manual inventory updates, order mismanagement, and lack of real-time data.

3. Delivery Personnel

• Description: Individuals responsible for delivering orders to customers.
• Goals: Timely and accurate deliveries.
• Pain Points: Unclear delivery instructions and inefficient route planning.

5. Visuals Colors and Theme

Color Palette:

• Background: #F9F5F0 (soft beige for a warm, inviting feel)
• Surface: #FFFFFF (clean white for clarity and simplicity)
• Text: #2C2C2C (dark charcoal for readability)
• Accent: #FF6F3C (vibrant orange for call-to-action elements)
• Muted Tones: #B8B8B8 (light gray for secondary information)

This color palette is designed to evoke a sense of freshness, cleanliness, and trustworthiness, aligning with the grocery shopping experience.

6. Signature Design Concept

The pearl-food homepage will feature an interactive "marketplace street" design. Upon landing, users will see a vibrant, animated street scene with storefronts representing different grocery categories (e.g., Produce, Dairy, Bakery). Each storefront will "light up" as the user hovers over it, with subtle animations like swinging signs or opening doors.

Key elements:

• Dynamic Animations: Hover effects that bring the street to life (e.g., a fruit cart vendor waving or a bakery emitting steam).
• Category Navigation: Clicking on a storefront zooms into that category, transitioning smoothly to a product listing page.
• Time-Based Visuals: The street scene changes based on the time of day (e.g., morning sunlight, evening lanterns).
• Micro-Interactions: Cart icons that jiggle when items are added, and a checkout button that pulses gently to draw attention.

This design will create a memorable first impression and make the shopping experience feel immersive and enjoyable.

7. Non-Functional Requirements

• Performance: The app should load within 2 seconds on a standard 4G connection.
• Scalability: The system should handle up to 10,000 concurrent users.
• Security: All user data must be encrypted, and payment processing must comply with PCI DSS standards.
• Availability: The app should maintain 99.9% uptime.
• Localization: The app should support Urdu and English languages.
• Accessibility: The app should comply with WCAG 2.1 standards for accessibility.

8. Tech Stack

Frontend:

• React for Web
• React Native for Mobile App

Backend:

• Python
• FastAPI

Database:

• MySQL (with Alembic for migrations)

AI Models:

• GPT 5.4 for user-friendly responses.

AI Tools:

• Langchain
• Litellm for LLM Routing

Orchestration:

• Docker for local orchestration.
• Kubernetes for server-side orchestration.

9. Assumptions and Constraints

Assumptions:

• Users will primarily access the app via mobile devices.
• The app will initially cater to users in Pakistan, with PKR as the default currency.
• Delivery services will be limited to specific regions during the initial launch.

Constraints:

• Limited budget for initial development and marketing.
• Dependence on third-party payment gateways for secure transactions.
• Internet connectivity may vary across regions, requiring offline support for certain features.

10. Glossary

• User: An individual who uses the app to browse and purchase groceries.
• Admin: A store manager responsible for managing inventory and orders.
• Delivery Personnel: Individuals tasked with delivering orders to customers.
• PCI DSS: Payment Card Industry Data Security Standard, a set of security standards for handling card payments.
• WCAG: Web Content Accessibility Guidelines, standards for making web content accessible to everyone.