System Requirements Document (SRD)

Project Name: divine-ecommerce

1. Introduction

The divine-ecommerce project aims to create a comprehensive e-commerce platform for Rajkot Tools Agency, a business based in Rajkot, India. The platform will cater to a diverse audience, including companies, local businesses, and individual buyers. It will provide a seamless shopping experience with features like product categories, inventory management, payment gateways, and shipping/delivery tracking.

This document outlines the system requirements for the divine-ecommerce platform, ensuring that the solution is robust, scalable, and user-friendly. The platform will be designed to meet the needs of Indian users, incorporating locale-specific features such as GST invoicing, INR currency support, and timezone alignment with IST (Indian Standard Time).

2. System Overview

The divine-ecommerce platform will serve as a digital storefront for Rajkot Tools Agency, enabling customers to browse, purchase, and manage orders online. The system will include:

• A responsive frontend for web and mobile users.
• A robust backend to handle business logic, inventory, and user data.
• Payment gateway integration for secure transactions.
• Features tailored for companies and local businesses, such as bulk ordering and GST-compliant invoices.
• Support for multiple user types, including admins, registered users, and guests.

The platform will be built using modern technologies, ensuring scalability, security, and performance.

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 a search bar.
• I should be able to add products to my cart and proceed to checkout.
• I should be able to create an account or log in to manage my orders.
• I should be able to view and download GST-compliant invoices for my purchases.
• I should be able to track the status of my orders.

As a Company:

• I should be able to register my business and provide GST details.
• I should be able to place bulk orders with special pricing.
• I should be able to manage multiple shipping addresses.
• I should be able to view order history and generate reports for accounting purposes.

As an Admin:

• I should be able to manage product listings, including adding, editing, and deleting products.
• I should be able to manage user accounts and permissions.
• I should be able to view and process orders, including updating their status.
• I should be able to generate sales reports and analytics.

As a Guest:

• I should be able to browse products without logging in.
• I should be able to add products to the cart and checkout as a guest.

4. User Personas

1. Admin

• Role: Manages the platform, including product listings, user accounts, and orders.
• Goals: Ensure smooth operation of the platform, monitor sales, and manage inventory.

2. Registered User (Individual Buyer)

• Role: Purchases products for personal or business use.
• Goals: Find and buy products easily, track orders, and access invoices.

3. Company Representative

• Role: Represents a company or local business purchasing in bulk.
• Goals: Place bulk orders, manage shipping addresses, and access GST-compliant invoices.

4. Guest User

• Role: Browses and purchases products without creating an account.
• Goals: Quickly find and buy products without the need for registration.

5. Visuals Colors and Theme

Color Palette

• Background: #F9F9F6 (Soft Beige)
• Surface: #FFFFFF (Pure White)
• Text: #333333 (Deep Charcoal)
• Accent: #FF6F61 (Vibrant Coral)
• Muted: #B0BEC5 (Cool Gray)

This palette reflects a professional yet approachable aesthetic, aligning with the brand identity of Rajkot Tools Agency.

6. Signature Design Concept

The divine-ecommerce homepage will feature an interactive 3D workshop environment.

• Visuals: The homepage will resemble a virtual workshop, with tools and equipment displayed on shelves and tables. Users can "walk" through the workshop using their mouse or touch gestures.
• Animations: Products will animate subtly when hovered over, such as a wrench spinning or a drill lighting up.
• Transitions: Smooth transitions will guide users from the homepage to product categories, mimicking the experience of moving between aisles in a physical store.
• Micro-interactions: Clicking on a product will "zoom in" on it, providing a detailed view with specifications and pricing.
• Color Shifts: The background will subtly shift from soft beige to vibrant coral as users scroll, creating a dynamic and engaging experience.

This concept will make the website memorable and encourage users to explore the product catalog.

7. Non-Functional Requirements

• Performance: The platform should load within 3 seconds for 90% of users.
• Scalability: The system must support up to 10,000 concurrent users.
• Security: All user data must be encrypted, and the platform must comply with GDPR and Indian data protection laws.
• Availability: The platform should have 99.9% uptime.
• Localization: Support for INR currency and GST invoicing.

8. Tech Stack

Frontend

• React for Web
• React Native for Mobile App

Backend

• Python
• FastAPI

Database

• MySQL (with Alembic for migrations)

AI Tools

• GPT 5.4 for user-friendly responses

Orchestration

• Docker for local development
• Kubernetes for server-side orchestration

9. Assumptions and Constraints

• The platform will primarily serve Indian users, with INR as the default currency.
• GST compliance is mandatory for all invoices.
• The system will not initially support international shipping.
• Payment gateways will include Razorpay and Stripe.

10. Glossary

• GST: Goods and Services Tax, applicable in India.
• INR: Indian Rupee, the currency of India.
• RDBMS: Relational Database Management System.
• FastAPI: A modern, fast web framework for building APIs with Python.
• Alembic: A database migration tool for SQLAlchemy.