project-fd5f0931 System Requirements Document

Introduction

The purpose of this document is to outline the system requirements for "project-fd5f0931," a WhatsApp-native Food Ordering & Kitchen Micro SaaS. This project aims to provide small food businesses in Sri Lanka, such as small restaurants, cloud kitchens, home bakers, and burger stalls, with an efficient and cost-effective solution for managing orders through WhatsApp.

System Overview

The system will enable small food businesses to manage orders received via WhatsApp by parsing customer messages, checking inventory, processing payments, and sending status updates. The solution will be affordable and tailored to the needs of Sri Lankan businesses, leveraging the widespread use of WhatsApp in the region.

Source Content Inventory

• Core Flow: Customer sends order via WhatsApp, system parses order, checks inventory, sends confirmation, processes payment, and updates order status.
• Micro SaaS Features: Menu builder, order inbox, daily summary, low inventory alerts.
• Target Audience: Small food businesses in Sri Lanka.
• Pricing: LKR 1,000–3,000/month.

Functional Requirements as Story Points

• As a Customer, I want to send my order via WhatsApp using natural language or keywords.
• As a System, I should parse the order to identify items, quantities, and notes.
• As a System, I should check the availability of items in the inventory.
• As a System, I should send a confirmation message with order details and total cost.
• As a System, I should provide a payment link or cash-on-delivery option.
• As a System, I should send status updates for order confirmation, preparation, and delivery.
• As a Business Owner, I want to build a simple menu with items, prices, and images.
• As a Business Owner, I want to view an order inbox with filters for new, confirmed, ready, and delivered orders.
• As a Business Owner, I want to receive a daily summary of orders, revenue, and popular items.
• As a Business Owner, I want to receive low inventory alerts.

User Personas

• Customer: Individuals placing orders via WhatsApp.
• Business Owner: Small food business operators managing orders and inventory.

Core User Flows

• Customer sends order via WhatsApp -> System parses order -> System checks inventory -> System sends confirmation -> Customer receives payment link -> System sends status updates.
• Business Owner builds menu -> Receives orders in inbox -> Views daily summary -> Receives low inventory alerts.

Visuals Colors and Theme

• primary: #1A73E8 (deep blue)
• primary_light: #E8F0FE (light blue)
• secondary: #FF6F61 (coral)
• accent: #FFD700 (gold)
• highlight: #FFA500 (orange)
• bg: #FFFFFF (white)
• surface: rgba(250, 250, 250, 0.8)
• text: #333333 (dark gray)
• text_muted: #777777 (light gray)
• border: rgba(200, 200, 200, 0.5)

Signature Design Concept

The landing page will feature an interactive "Order Journey" animation. As users scroll, they will see a visual representation of an order moving through different stages: from being placed, to preparation, to delivery. Each stage will be animated with smooth transitions using motion/react. Users can hover over each stage to see detailed information and micro-interactions, such as a burger being assembled or a delivery scooter moving. This dynamic storytelling will make the process engaging and intuitive.

Landing Hero Motion Brief

The hero section will depict a customer's order transforming into a prepared meal ready for delivery. The animation will start with a WhatsApp message bubble appearing, followed by the order items assembling into a meal. The meal will then transition into a delivery scooter animation, symbolizing the journey to the customer. This loop will last 10 seconds, using motion/react for seamless transitions. The animation will pause on hover, allowing users to interact with each stage.

Interaction Model & Motion Direction

• Intended Interaction Model: Animated
• The landing page will feature scroll-triggered reveals and hover transitions to enhance user engagement. Each section will have a unique interactive element, such as kinetic typography or morphing SVGs, to maintain visual interest.

Non-Functional Requirements

• The system must be reliable and handle multiple orders simultaneously.
• It should be scalable to accommodate growing business needs.
• The interface must be user-friendly and intuitive for both customers and business owners.

Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB
• AI Models: GPT 5.4 for user-friendly responses
• Local Orchestration: Docker, docker-compose

Assumptions and Constraints

• The system assumes customers are familiar with WhatsApp and can send orders using text messages.
• The pricing model is based on the affordability for small businesses in Sri Lanka.
• The system must comply with local regulations regarding online transactions and data privacy.

Glossary

• Micro SaaS: A small-scale software as a service solution targeting niche markets.
• WhatsApp-native: Designed to work seamlessly within the WhatsApp platform.
• Inventory: The stock of items available for order.
• Order Inbox: A digital space where business owners can view and manage incoming orders.