System Requirements Document (SRD) for proud-gopal

1. Introduction

The proud-gopal project is a digital platform designed to showcase the beloved Gopal Golgappe brand, a local favorite in India. This platform will serve as a hub for customers to explore Gopal's menu, find nearby locations, conveniently place online orders, and even connect via WhatsApp for inquiries or orders. By integrating modern technology with the charm of traditional Indian street food, the project aims to enhance customer engagement and streamline the ordering process.

This document outlines the system requirements for the proud-gopal platform, ensuring a clear roadmap for development and implementation.

2. System Overview

The proud-gopal platform will be a web and mobile application tailored to food lovers who enjoy Gopal's iconic golgappes. The system will provide the following core functionalities:

• A visually appealing interface to browse the menu.
• Location-based services to help users find the nearest Gopal Golgappe outlet.
• An online ordering system for seamless takeaway or delivery.
• Integration with WhatsApp for direct communication and order placement.
• Additional features like reviews, loyalty rewards, and contact options to enhance user experience.

The platform will cater to a diverse audience, including casual visitors, loyal customers, and Gopal's administrative team. It will be optimized for Indian users, considering local preferences, currency (INR), and time zones (IST).

3. Functional Requirements

User Stories:

• As a User, I should be able to browse the menu with detailed descriptions and images.
• As a User, I should be able to locate the nearest Gopal Golgappe outlet using GPS.
• As a User, I should be able to place an online order for takeaway or delivery.
• As a User, I should be able to leave reviews and ratings for menu items and outlets.
• As a User, I should be able to sign up for a loyalty rewards program.
• As a User, I should be able to contact Gopal Golgappe via WhatsApp for inquiries or orders.
• As an Admin, I should be able to manage menu items, including adding, editing, or removing them.
• As an Admin, I should be able to track and manage online orders.
• As an Admin, I should be able to view and respond to customer reviews and feedback.
• As an Admin, I should be able to configure and manage WhatsApp integration for customer communication.

4. User Personas

1. Casual User

• Description: A first-time visitor or occasional customer exploring Gopal Golgappe's offerings.
• Goals: Browse the menu, locate outlets, place orders, and contact via WhatsApp if needed.
• Pain Points: Wants a simple, intuitive interface without unnecessary complexity.

2. Loyal Customer

• Description: A regular customer who frequently orders from Gopal Golgappe.
• Goals: Access loyalty rewards, leave reviews, quickly reorder favorite items, and use WhatsApp for quick communication.
• Pain Points: Prefers personalized experiences and quick access to past orders.

3. Admin

• Description: Gopal Golgappe's management team responsible for maintaining the platform.
• Goals: Manage menu items, track orders, respond to customer feedback, and ensure smooth WhatsApp integration.
• Pain Points: Needs a robust backend system with minimal downtime and easy-to-use tools.

5. Visuals Colors and Theme

Color Palette:

• Background: #FFF8E1 (Warm Beige, reminiscent of golgappe shells)
• Surface: #FFD54F (Golden Yellow, evoking the vibrant street food culture)
• Text: #3E2723 (Deep Brown, for readability and earthy tones)
• Accent: #FF6F00 (Bright Orange, for call-to-action buttons and highlights)
• Muted Tones: #BCAAA4 (Soft Taupe, for secondary elements and subtle contrasts)
• WhatsApp Button: #25D366 (WhatsApp Green, for instant recognition)

6. Signature Design Concept

"The Golgappa Experience: A Virtual Street Food Journey"

The homepage will immerse users in a vibrant, interactive street food market. The design will feature:

• Animated Golgappa Carousel: A 3D carousel of golgappes that users can "spin" to explore menu categories. Each golgappa will represent a category (e.g., spicy, sweet, tangy).
• Interactive Map: A dynamic map of India with glowing pins marking Gopal Golgappe outlets. Hovering over a pin will display outlet details and a "Get Directions" button.
• Live Preparation Animation: A looping animation of golgappes being prepared, with steam and chutney splashes for a sensory experience.
• WhatsApp Integration: A floating WhatsApp icon on every page, allowing users to instantly connect with Gopal Golgappe via chat or call. Clicking the icon will open a pre-filled message with the business number (+91 9712857765).
• Loyalty Rewards Showcase: A floating rewards card that flips to reveal points and offers when clicked.
• Micro-interactions: Buttons that "pop" like golgappes when clicked, and subtle sound effects of crunching and chutney pouring for added immersion.

This design will make the platform unforgettable, blending nostalgia with modern interactivity.

7. Non-Functional Requirements

• Performance: The platform should load within 2 seconds on a 4G network.
• Scalability: Must support up to 10,000 concurrent users during peak hours.
• Security: Implement SSL encryption, secure payment gateways, and user data protection.
• Localization: Support for Hindi and English languages.
• Accessibility: WCAG 2.1 compliance for users with disabilities.
• WhatsApp Integration: Ensure seamless integration with WhatsApp API for reliable communication.

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
• Google Nano Banana for image generation

AI Tools:

• Langchain
• Litellm for LLM Routing

Orchestration:

• Docker (local)
• Kubernetes (server-side)

9. Assumptions and Constraints

• The platform will primarily target users in India, with INR as the default currency and IST as the default timezone.
• Delivery services will initially be limited to cities with existing Gopal Golgappe outlets.
• The loyalty rewards program will require user registration and account creation.
• GPS functionality will depend on user device permissions.
• WhatsApp integration will rely on the availability of the WhatsApp Business API.

10. Glossary

• Golgappe: A popular Indian street food, also known as pani puri or phuchka.
• GPS: Global Positioning System, used for location-based services.
• WCAG: Web Content Accessibility Guidelines, ensuring accessibility for users with disabilities.
• SSL: Secure Sockets Layer, a standard security protocol for encrypted communication.
• WhatsApp API: Application Programming Interface provided by WhatsApp for business communication.