System Requirements Document (SRD)

Project Name: garnet-homepage

1. Introduction

The garnet-homepage project is a web application designed to serve as a modern, user-friendly platform for dropshipping. Dropshipping is a retail fulfillment method where the store does not keep products in stock but instead transfers customer orders and shipment details to a third-party supplier. This project will focus on creating a seamless experience for both customers and administrators, with a clean design, efficient functionality, and scalable architecture.

This document outlines the system requirements for the garnet-homepage project, ensuring clarity and alignment with the goals of Pratik Deshmukh, based in India (IN). The platform will cater to a global audience while incorporating locale-specific defaults like INR currency and IST timezone.

2. System Overview

The garnet-homepage will be a web-based application that enables users to browse and purchase products through a dropshipping model. The system will integrate with third-party suppliers to manage inventory and order fulfillment. Key features include:

• A visually appealing homepage optimized for product discovery.
• User-friendly navigation and search functionality.
• Integration with suppliers for real-time inventory updates.
• Secure payment gateway supporting multiple currencies, with INR as the default.
• Admin dashboard for managing products, orders, and analytics.

The platform will be developed using modern web technologies, ensuring scalability, responsiveness, and ease of maintenance.

3. Functional Requirements

As a User:

• I should be able to browse products by category.
• I should be able to search for specific products using keywords.
• I should be able to view product details, including images, descriptions, and prices.
• I should be able to add products to my cart and proceed to checkout.
• I should be able to track my order status after purchase.

As an Admin:

• I should be able to add, edit, or remove products from the catalog.
• I should be able to view and manage customer orders.
• I should be able to track sales and generate reports.
• I should be able to integrate with supplier APIs for inventory updates.

As a Guest:

• I should be able to browse products without logging in.
• I should be prompted to create an account or log in during checkout.

4. User Personas

1. Customer

• Description: End-users who browse and purchase products.
• Goals: Find and buy products easily, track orders, and receive timely updates.

2. Admin

• Description: Platform managers responsible for maintaining the product catalog, managing orders, and analyzing sales data.
• Goals: Efficiently manage the platform, ensure smooth operations, and optimize sales.

3. Guest

• Description: Visitors who browse the website without creating an account.
• Goals: Explore products and decide whether to register or purchase.

5. Visuals Colors and Theme

Color Palette

The garnet-homepage will feature a unique, vibrant color palette to create a modern and inviting aesthetic:

• Background: #F9F9F9 (Soft Cream)
• Surface: #FFFFFF (Pure White)
• Text: #333333 (Dark Charcoal)
• Accent: #FF6F3C (Bright Coral Orange)
• Muted Tones: #B2B2B2 (Soft Gray)

Typography

• Primary Font: Poppins (Sans-serif)
• Secondary Font: Montserrat (Sans-serif)

The design will emphasize readability and a clean layout, ensuring a professional and user-friendly experience.

6. Signature Design Concept

Interactive Product Showcase with Dynamic Animations

The homepage will feature an immersive product showcase where products appear as floating cards in a 3D carousel. Users can interact with the carousel by dragging or swiping to rotate the cards. Each product card will have subtle hover animations, such as a slight zoom-in effect and shadow enhancement, to draw attention.

Key Features:

• Dynamic Background: A gradient background that shifts colors based on the time of day (e.g., warm tones in the morning, cool tones at night).
• Micro-Interactions: Buttons like "Add to Cart" and "View Details" will have ripple effects upon clicking.
• Smooth Transitions: Section changes will include fade-in and slide animations for a polished feel.

This bold, interactive design will make the homepage visually stunning and memorable, ensuring a strong first impression.

7. Non-Functional Requirements

• Performance: The website must load within 3 seconds on a standard broadband connection.
• Scalability: The system should handle up to 10,000 concurrent users.
• Security: All user data must be encrypted, and the platform must comply with GDPR and other relevant data protection regulations.
• Responsiveness: The website must be fully responsive and optimized for desktop, tablet, and mobile devices.

8. Tech Stack

Frontend

• React for Web

Backend

• Python
• FastAPI

Database

• MySQL (with Alembic for migrations)

AI Tools

• Litellm for LLM Routing
• Langchain

Orchestration

• Docker
• Kubernetes

9. Assumptions and Constraints

Assumptions

• The platform will primarily target users in India but will support global customers.
• INR will be the default currency, with support for other currencies as needed.
• The system will integrate with third-party suppliers for inventory and order fulfillment.

Constraints

• The platform must comply with Indian e-commerce regulations.
• Payment gateway integration must support UPI, credit/debit cards, and net banking.

10. Glossary

• Dropshipping: A retail model where the store does not stock inventory but transfers orders to a supplier for fulfillment.
• API: Application Programming Interface, used for integrating with third-party systems.
• Responsive Design: A design approach that ensures the website works well on all device sizes.
• GDPR: General Data Protection Regulation, a data protection law in the European Union.