Plasma-Nepali

Introduction

The Plasma-Nepali project aims to develop an online Nepali tech store for Roshan Technology Shop. This document outlines the system requirements necessary to create a robust and user-friendly e-commerce platform tailored to the needs of Nepali consumers.

System Overview

The Plasma-Nepali project will deliver an e-commerce platform that enables users to browse, search, and purchase technology products online. The platform will cater specifically to the Nepali market, incorporating local currency, language, and cultural preferences to enhance user experience.

Functional Requirements as Story Points

• As a Customer, I should be able to browse technology products by category.
• As a Customer, I should be able to search for specific products using keywords.
• As a Customer, I should be able to view detailed product descriptions and specifications.
• As a Customer, I should be able to add products to a shopping cart.
• As a Customer, I should be able to proceed to checkout and make a purchase using local payment methods.
• As a Customer, I should be able to create and manage my account.
• As a Customer, I should be able to track my order status.
• As an Admin, I should be able to manage product listings, including adding, updating, and removing products.
• As an Admin, I should be able to view and manage customer orders.
• As an Admin, I should be able to generate sales reports and analytics.

User Personas

• Customer: Individuals looking to purchase technology products online, primarily within Nepal.
• Admin: Personnel responsible for managing the online store, including product listings and customer orders.

Core User Flows

• Customer browses categories -> selects a product -> views product details -> adds to cart -> proceeds to checkout -> completes purchase.
• Admin logs in -> updates product listings -> reviews customer orders -> processes orders -> generates sales reports.

Visuals Colors and Theme

• primary: #1E88E5 (a vibrant blue representing trust and technology)
• primary_light: #BBDEFB (a lighter blue for hover states and secondary UI)
• secondary: #FF7043 (a warm coral for emphasis and links)
• accent: #FFC107 (a bright amber for CTAs and active states)
• highlight: #FFB300 (a rich gold for hover states and notifications)
• bg: #F5F5F5 (a light gray for the page background)
• surface: rgba(255, 255, 255, 0.9) (a soft white for card/panel backgrounds)
• text: #212121 (a dark gray for primary text)
• text_muted: #757575 (a medium gray for secondary text)
• border: rgba(0, 0, 0, 0.1) (a subtle gray for borders)

Signature Design Concept

The Plasma-Nepali homepage will feature an interactive "Tech Galaxy" concept. Users will be greeted by a dynamic galaxy map where each star represents a different product category. Hovering over a star will reveal a preview of products within that category, and clicking will zoom into a detailed view of the products. This interactive experience will be built using @react-three/fiber for a 3D effect, creating an engaging and memorable first impression.

Landing Hero Motion Brief

The landing hero will depict a "Tech Transformation" story: a central tech device (e.g., a smartphone) will gather components (e.g., chips, screens) around it, visibly assembling into a complete product. This transformation will highlight the product's features and benefits, looping every 10 seconds. The animation will be crafted using motion/react for smooth transitions and responsive behavior, ensuring accessibility and engagement across devices.

Interaction Model & Motion Direction

• Intended Interaction Model: Parallax
  • The landing page will feature layered depth via scroll, with decorative elements translating at different speeds to create a visually rich experience.
• Internal Pages: Static
  • Focus on layout clarity and minimal motion for product listings, checkout, and account management pages.

Non-Functional Requirements

• The platform must support high availability and scalability to handle peak shopping periods.
• The system should ensure data security and privacy for all user transactions and information.
• The website must be optimized for both desktop and mobile devices.

Tech Stack

• Frontend: React for Web
• Backend: Python with FastAPI
• Database: MySQL or MariaDB, using Alembic for migrations
• Local Orchestration: Docker, docker-compose

Assumptions and Constraints

• The platform will primarily serve the Nepali market, with all transactions conducted in the local currency (Nepalese Rupee).
• The system will integrate with local payment gateways to facilitate transactions.
• The platform will be developed with scalability in mind to accommodate future growth.

Glossary

• E-commerce: The buying and selling of goods or services using the internet.
• Parallax: A visual effect where background images move slower than foreground images, creating an illusion of depth.
• React: A JavaScript library for building user interfaces.
• FastAPI: A modern, fast (high-performance) web framework for building APIs with Python.
• Docker: A platform for developing, shipping, and running applications in containers.

This document outlines the comprehensive requirements for developing the Plasma-Nepali online tech store, ensuring a tailored and engaging experience for Nepali consumers.