System Requirements Document (SRD) for steel-web

1. Introduction

The purpose of this document is to outline the system requirements for steel-web, an online store envisioned by Sayed Saeed Shah from Pakistan. The platform will serve as a specialized e-commerce solution for selling electric machine bodies and materials, such as air coolers, washing machine parts, and dryer machine components. This document details the functional and non-functional requirements, user personas, design concepts, and technical specifications for the project.

2. System Overview

steel-web is an e-commerce platform tailored to meet the needs of customers seeking electric machine bodies and materials. The system will provide a seamless shopping experience with features like secure online payments, product categorization, inventory management, and order tracking. The platform will cater to both desktop and mobile users, ensuring accessibility and responsiveness.

The primary goals of steel-web are:

• To provide a user-friendly interface for browsing and purchasing products.
• To enable secure and modern payment methods, excluding cash-on-delivery (COD).
• To streamline inventory and order management for the store owner.
• To offer promotional tools for discounts and bundle deals.

The platform will primarily target customers in Pakistan, with the potential for international expansion in the future.

3. Functional Requirements

The functional requirements for steel-web are outlined below as user stories:

• As a User, I should be able to browse products by categories such as air coolers, washing machine parts, and dryer machine components.
• As a User, I should be able to filter products by price range, material type, and availability.
• As a User, I should be able to securely pay using credit/debit cards, Easypaisa, JazzCash, and PayPal.
• As a User, I should be able to create an account to view my purchase history and manage my wishlist.
• As a User, I should be able to track the status of my orders in real-time.
• As an Admin, I should be able to manage inventory and update stock levels.
• As an Admin, I should be able to create promotional offers such as discounts and bundle deals.
• As an Admin, I should be able to view and manage customer orders.

4. User Personas

4.1 Admin

• Role: Store owner or manager.
• Responsibilities: Manage inventory, update stock, create promotional offers, and oversee customer orders.
• Goals: Ensure smooth operations of the store and maximize sales.

4.2 User

• Role: Customer.
• Responsibilities: Browse products, make purchases, track orders, and manage their account.
• Goals: Find and purchase electric machine bodies and materials easily and securely.

5. Visuals Colors and Theme

The visual identity of steel-web will reflect a modern and professional aesthetic, emphasizing trust and reliability. Below is the unique color palette for the project:

• Background: #F5F7FA (Light Grayish Blue)
• Surface: #FFFFFF (Pure White)
• Text: #2C3E50 (Dark Slate Gray)
• Accent: #E74C3C (Vivid Red)
• Muted: #95A5A6 (Muted Gray)

This palette ensures a clean and professional look, with the vivid red accent drawing attention to key elements like buttons and promotional banners.

6. Signature Design Concept

The homepage of steel-web will feature a dynamic 3D product showcase. Upon landing, users will see a rotating 3D model of an air cooler, washing machine, or dryer machine component. The model will be interactive, allowing users to zoom in, rotate, and explore the product in detail.

Key Features:

• Interactive Animations: Hovering over product categories will trigger smooth animations, such as parts assembling or disassembling.
• Dynamic Background: The background will subtly shift between shades of blue and gray, creating a calming and modern atmosphere.
• Micro-Interactions: Buttons and icons will have responsive animations, such as a slight "bounce" effect when clicked.
• Call-to-Action (CTA): A prominent "Shop Now" button will pulse gently to draw attention.

This design concept ensures that the homepage leaves a lasting impression while providing an engaging and intuitive user experience.

7. Non-Functional Requirements

• Performance: The platform must load within 2 seconds on both desktop and mobile devices.
• Scalability: The system should handle up to 10,000 concurrent users without performance degradation.
• Security: All payment transactions must be encrypted using SSL/TLS protocols.
• Accessibility: The platform must comply with WCAG 2.1 Level AA standards.
• Localization: The platform will support Urdu and English languages for the Pakistani audience.

8. Tech Stack

The following technologies will be used to develop steel-web:

Frontend

• React for Web

Backend

• Python
• FastAPI

Database

• MySQL (with Alembic for migrations)

AI Tools

• GPT 5.4 for user-friendly responses
• Litellm for LLM routing

Orchestration

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

9. Assumptions and Constraints

• The platform will initially target the Pakistani market, with international expansion considered later.
• Only online payment methods will be supported; cash-on-delivery (COD) is excluded.
• The system will require a reliable hosting solution to ensure uptime and performance.

10. Glossary

• COD: Cash on Delivery.
• SSL/TLS: Secure Sockets Layer/Transport Layer Security, protocols for encrypting internet communications.
• WCAG: Web Content Accessibility Guidelines, standards for making web content accessible to people with disabilities.
• LLM: Large Language Model, used for AI-driven features.