System Requirements Document (SRD)

Project Name: mars-fruits

1. Introduction

The mars-fruits project is a comprehensive digital platform for Arab Fresh, a UAE-based Fruits & Vegetables Processing company. The platform will combine a company profile with an e-commerce solution to cater to diverse audiences, including normal online customers, HORECA (Hotels, Restaurants, and Cafes), and catering companies. The primary focus will be on promoting processed/pre-cut fruits & vegetables and fresh juices, which align with the convenience and quality expectations of the target market.

This document outlines the system requirements for the mars-fruits project, ensuring that the platform is fresh, easy to navigate, and attention-grabbing, reflecting the vibrant nature of Arab Fresh's offerings.

2. System Overview

The mars-fruits platform will serve as a dual-purpose website:

1. Company Profile: Highlighting Arab Fresh's history, values, and expertise in the fresh produce industry.
2. E-Commerce Platform: Enabling customers to browse, select, and purchase products online, with features tailored for both individual consumers and bulk buyers like HORECA and catering companies.

The platform will emphasize:

• Freshness and Quality: Showcasing the vibrancy of Arab Fresh's products.
• Ease of Use: A seamless user experience for browsing, ordering, and managing accounts.
• Scalability: Supporting bulk orders and subscription models for regular deliveries.

The website will be designed with a modern, fresh aesthetic that resonates with the UAE market and Arab Fresh's brand identity.

3. Functional Requirements

As User:

• I should be able to browse products by category (e.g., Fresh Juices, Pre-Cut Fruits, Pre-Cut Vegetables).
• I should be able to view product details, including images, descriptions, and prices.
• I should be able to add products to a shopping cart and proceed to checkout.
• I should be able to create an account and manage my orders.
• I should be able to make payments online securely.
• I should be able to track my order status after purchase.

As HORECA/Catering Company:

• I should be able to place bulk orders with customized quantities.
• I should be able to request a quote for large-scale orders.
• I should be able to set up recurring orders for regular deliveries.

As Admin:

• I should be able to manage product listings, including adding, editing, and removing items.
• I should be able to view and process orders from all user types.
• I should be able to manage user accounts and permissions.
• I should be able to generate sales and inventory reports.

4. User Personas

1. Normal Online Customer

• Description: Individual consumers looking for fresh produce and juices for personal use.
• Needs: Easy navigation, secure payments, and order tracking.

2. HORECA (Hotels, Restaurants, Cafes)

• Description: Businesses requiring bulk orders of fresh and processed produce.
• Needs: Bulk order options, recurring delivery schedules, and competitive pricing.

3. Catering Companies

• Description: Companies providing catering services that need high-quality, pre-cut fruits and vegetables.
• Needs: Customizable bulk orders and reliable delivery schedules.

4. Admin

• Description: Internal team managing the website and operations.
• Needs: Comprehensive control over product listings, orders, and user management.

5. Visuals Colors and Theme

Color Palette:

• Background: #F5FFF0 (Fresh Mint Green)
• Surface: #FFFFFF (Pure White)
• Text: #333333 (Charcoal Black)
• Accent: #FF6F61 (Juicy Coral)
• Muted Tones: #C4E3CB (Soft Green Mist)

This palette reflects freshness, cleanliness, and vibrancy, aligning with Arab Fresh's brand identity.

6. Signature Design Concept

Interactive Freshness Showcase

The homepage will feature a 3D interactive fruit and vegetable basket that users can explore. As users hover over items in the basket, they will "pop out" with a subtle animation, displaying product details like name, price, and a "Quick Add to Cart" button.

Key Features:

• Dynamic Animations: Fruits and vegetables gently sway as if in a breeze, creating a lively and fresh atmosphere.
• Color Transitions: The background shifts subtly from morning hues (soft yellows and greens) to evening tones (warm oranges and purples) based on the user's local time in the UAE.
• Micro-Interactions: Clicking on a product triggers a smooth zoom-in effect, revealing detailed information and purchase options.
• Juice Splash Effect: When navigating to the Fresh Juices section, a playful juice splash animation transitions the user to the page.

This design will make the website unforgettable and instantly engaging, leaving a lasting impression on visitors.

7. Non-Functional Requirements

• Performance: The website should load within 2 seconds on average UAE internet speeds.
• Scalability: The platform should handle up to 10,000 concurrent users.
• Security: All transactions must be secured with SSL encryption.
• Localization: The platform should support both English and Arabic languages.
• Accessibility: The website must comply with WCAG 2.1 Level AA standards.

8. Tech Stack

Frontend:

• React for Web

Backend:

• Python
• FastAPI

Database:

• MySQL (with Alembic for migrations)

AI Tools:

• GPT 5.4 for user-friendly responses
• Google Nano Banana for image generation

Orchestration:

• Docker
• Kubernetes

9. Assumptions and Constraints

• The platform will primarily target users in the UAE, so all prices will be displayed in AED.
• Delivery services will be limited to UAE regions initially.
• Payment gateways will include local options like PayTabs or Telr, alongside global options like Visa and Mastercard.

10. Glossary

• HORECA: Hotels, Restaurants, and Cafes.
• Processed/Pre-Cut: Fruits and vegetables that are cleaned, peeled, and cut for convenience.
• E-Commerce Platform: A digital storefront for browsing and purchasing products online.
• Bulk Orders: Large quantity orders typically placed by businesses.
• Recurring Orders: Orders scheduled for regular delivery intervals.