DHWANI

Introduction

DHWANI is an e-commerce platform designed to facilitate the sale of earrings. The platform will provide a seamless experience for both customers and administrators, focusing on efficient product management, user authentication, order processing, and secure payment integration. This document outlines the system requirements necessary to implement the DHWANI project.

System Overview

The DHWANI platform will serve as an end-to-end e-commerce solution for selling earrings. It will include features for product management, user authentication, order management, payment processing, and administrative controls. The system will be designed to cater to both customers and administrators, ensuring a smooth and efficient operation.

Functional Requirements

• As a User, I should be able to register and log in to the platform.
• As a User, I should be able to browse and search for earrings.
• As a User, I should be able to add earrings to my cart and place an order.
• As a User, I should be able to make secure payments for my orders.
• As an Admin, I should be able to manage product listings, including adding and updating earrings.
• As an Admin, I should be able to view and manage customer orders.
• As an Admin, I should be able to manage user accounts and permissions.

User Personas

• Customer: Individuals looking to purchase earrings. They can browse products, add items to their cart, and complete purchases.
• Admin: Responsible for managing the product catalog, processing orders, and overseeing user accounts.

Visuals Colors and Theme

• primary: #6A1B9A (Deep Purple)
• primary_light: #AB47BC (Light Purple)
• secondary: #FF7043 (Coral)
• accent: #FFEB3B (Vibrant Yellow)
• highlight: #FFC107 (Amber)
• bg: #F5F5F5 (Light Gray)
• surface: rgba(255, 255, 255, 0.8) (White)
• text: #212121 (Dark Gray)
• text_muted: #757575 (Muted Gray)
• border: rgba(0, 0, 0, 0.1) (Light Black)

Signature Design Concept

The DHWANI homepage will feature an interactive 3D jewelry box using @react-three/fiber. Users can rotate and open the box to reveal different collections of earrings. Each collection will be represented by a unique compartment within the box. Hovering over a compartment will animate it slightly, inviting users to click and explore further. This concept will create an engaging and memorable first impression, encouraging users to interact with the site.

Interaction Model & Motion Direction

The landing page will utilize a "parallax" interaction model. Layers of decorative elements, such as floating jewelry pieces and subtle background patterns, will move at different speeds as users scroll. This will create a sense of depth and immersion. Internal pages, such as the product catalog and checkout, will adopt a "static" model to prioritize clarity and ease of use.

Non-Functional Requirements

• The system should support high availability and handle up to 10,000 concurrent users.
• Payment processing must comply with PCI DSS standards.
• The platform should load within 3 seconds on a standard broadband connection.

Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB, using Alembic for migrations
• AI Models: None specified
• AI Tools: None specified
• Local Orchestration: Docker, docker-compose
• Server-side Orchestration: Kubernetes

Assumptions and Constraints

• The platform will initially target the Indian market, with INR as the default currency.
• The system will operate within the IST timezone.
• The platform will be optimized for desktop and mobile web browsers.

Glossary

• E-commerce: Electronic commerce, the buying and selling of goods or services using the internet.
• PCI DSS: Payment Card Industry Data Security Standard, a set of security standards designed to ensure that all companies that accept, process, store or transmit credit card information maintain a secure environment.
• IST: Indian Standard Time, the time zone observed throughout India and Sri Lanka.