System Requirements Document (SRD)

Project Name: lunar-app

1. Introduction

The lunar-app is a modern, mobile-friendly food ordering application designed to provide a seamless experience for users and administrators. The app, tentatively named QuickBite, allows users to browse products, place orders, and make payments via UPI QR codes. Additionally, the app includes an admin panel for managing products, orders, and payments.

This document outlines the system requirements for the lunar-app, incorporating a newly requested feature: a to-do application for task management. The app will cater to users in India (IN), with locale-specific considerations such as INR currency, UPI-based payments, and WhatsApp integration.

2. System Overview

The lunar-app is a single-vendor food ordering platform with a clean, minimal, and modern user interface. It supports both guest and registered user checkouts, QR-based payments, and real-time order updates. The admin panel provides tools for managing products, orders, and analytics.

The newly added to-do application feature will allow users to manage personal tasks efficiently. This feature will include task creation, categorization, prioritization, and reminders.

The system is designed to be mobile-responsive, with smooth animations, dark/light mode toggles, and a subscription-based QR system for premium features.

3. Functional Requirements

User Side Features

• As a User, I should be able to view all products from a single shop.
• As a User, I should see products organized into categories (e.g., Snacks, Drinks, Meals).
• As a User, I should see product cards with an image, name, price, rating, and availability.
• As a User, I should be able to search for items using a search bar.
• As a User, I should be able to add items to my cart.
• As a User, I should be able to view and manage my cart, including increasing or decreasing item quantities.
• As a User, I should see an order summary with total price calculation.
• As a User, I should be able to place an order without logging in (guest checkout).
• As a User, I should be able to enter my name, phone number, and address during checkout.
• As a User, I should see an order confirmation screen after placing an order.
• As a User, I should see a QR code for payment and have the option to upload a payment screenshot.
• As a User, I should see clear payment instructions.
• As a User, I should be able to manage personal tasks using a to-do application.
  • Add tasks with a title and description.
  • Categorize tasks (e.g., Personal, Work, Shopping).
  • Set task priorities (e.g., High, Medium, Low).
  • Mark tasks as completed.
  • Receive reminders for pending tasks.

Admin Panel Features

• As an Admin, I should be able to log in securely.
• As an Admin, I should see a dashboard with total orders, revenue, and product count.
• As an Admin, I should be able to add new food items with details (name, price, image, category, description).
• As an Admin, I should be able to edit or delete products.
• As an Admin, I should be able to toggle product availability (in stock/out of stock).
• As an Admin, I should be able to view all orders with customer details (name, items, total, status).
• As an Admin, I should be able to update order statuses (Pending, Confirmed, Completed).
• As an Admin, I should be able to upload or change the QR code for payment.
• As an Admin, I should be able to add UPI IDs and payment instructions.
• As an Admin, I should be able to view basic analytics (e.g., daily orders, best-selling items).

4. User Personas

1. User

• Primary user of the app.
• Can browse products, add items to the cart, place orders, and manage tasks.

2. Admin

• Responsible for managing products, orders, and payments.
• Uses the admin panel for operational tasks and analytics.

5. Visuals Colors and Theme

Color Palette

• Background: #F5F5F5 (soft white)
• Surface: #FFFFFF (pure white)
• Text: #333333 (dark gray)
• Accent: #FF6F61 (vibrant coral)
• Muted: #B0BEC5 (light gray-blue)

6. Signature Design Concept

The lunar-app will feature an interactive galaxy-themed homepage. The landing page will resemble a starry night sky, with constellations representing different app features (e.g., "Order Food," "Manage Tasks," "Admin Panel").

• Animations: Stars will twinkle subtly, and constellations will glow when hovered over.
• Transitions: Clicking on a constellation will zoom into a specific feature, creating a seamless transition.
• Micro-interactions: Icons and buttons will have soft, pulsating effects to mimic celestial movements.
• Dark/Light Mode: The galaxy theme will adapt to the selected mode, with a bright daytime sky for light mode and a deep, starry night for dark mode.

This design will create an unforgettable first impression, aligning with the app's modern and innovative identity.

7. Non-Functional Requirements

• The app must be mobile-responsive and load within 3 seconds on standard 4G networks.
• The system should support at least 10,000 concurrent users.
• Data storage must comply with local regulations (e.g., GDPR, if applicable).
• Notifications should be delivered within 2 seconds of an event.

8. Tech Stack

Frontend

• React for Web
• React Native for Mobile

Backend

• Python
• FastAPI

Database

• MySQL (with Alembic for migrations)

AI Models

• GPT 5.4 for user-friendly responses

AI Tools

• LangChain

Orchestration

• Docker
• Kubernetes

9. Assumptions and Constraints

• The app will initially target users in India, with INR as the default currency.
• UPI-based payments will be the primary payment method.
• The to-do application will not include advanced features like collaboration or file attachments in the initial release.

10. Glossary

• UPI: Unified Payments Interface, a real-time payment system in India.
• QR Code: A machine-readable code used for payments.
• To-Do Application: A feature for managing personal tasks.
• Admin Panel: A backend interface for managing the app's operations.