System Requirements Document (SRD)

Project Name: winter-price

1. Introduction

The winter-price project aims to develop a price comparison website tailored for users in India, enabling them to compare product prices across popular e-commerce platforms such as Blinkit, Zepto, Instamart, DMart, Jiomart, Amazon, and Flipkart. By focusing on individual product searches, the platform seeks to simplify smart shopping and save users time and money.

This document outlines the updated system requirements for the winter-price project, incorporating recent changes requested by Nishi Jain.

2. System Overview

The winter-price system will serve as a centralized platform for users to search for individual products and compare their prices across multiple e-commerce platforms. The system will temporarily disable the product search functionality as per the API supervisor's directive, while retaining other foundational features for future scalability.

Key features include:

• Aggregation of price data from multiple platforms.
• User-friendly interface for browsing and comparing prices.
• Locale-specific settings optimized for Indian users (e.g., INR currency, IST timezone).

3. Functional Requirements

Core Functionalities:

• As User, I should be able to view a list of supported e-commerce platforms.
• As User, I should be able to see placeholder information for product search functionality (temporarily disabled).
• As Admin, I should be able to manage platform integrations (e.g., Blinkit, Zepto, Instamart).
• As Admin, I should be able to monitor API status and resolve issues.

4. User Personas

1. User

• Description: Regular shoppers looking to compare product prices across platforms.
• Goals: Save time and money by finding the best deals.
• Pain Points: Difficulty in manually comparing prices across multiple platforms.

2. Admin

• Description: System administrators responsible for maintaining platform integrations and ensuring API functionality.
• Goals: Ensure seamless operation of the system and resolve API-related issues.
• Pain Points: Managing multiple platform APIs and troubleshooting integration errors.

5. Visuals Colors and Theme

Color Palette:

The winter-price project will feature a clean, modern, and vibrant color palette inspired by winter tones and e-commerce vibrancy.

• Background: #F5F9FF (Soft Winter Sky Blue)
• Surface: #FFFFFF (Pure White for clarity)
• Text: #2C3E50 (Deep Midnight Blue for readability)
• Accent: #E74C3C (Bright Winter Red for highlights and buttons)
• Muted Tones: #BDC3C7 (Frosty Gray for secondary elements)

6. Signature Design Concept

Interactive Price Carousel Homepage

The homepage will feature an Interactive Price Carousel that dynamically showcases trending products and their prices across platforms.

Details:

• Visuals: A sleek carousel with product images, platform logos, and price tags that scroll horizontally.
• Animations: Smooth transitions between products, with hover effects that expand product details.
• Interactions: Users can click on a product to view placeholder information about its price comparison (temporarily disabled).
• Micro-interactions: Buttons and icons will have subtle bounce effects to enhance user engagement.
• Color Shifts: Accent colors will subtly change based on the platform being highlighted (e.g., Amazon orange, Flipkart blue).

This design concept ensures the homepage is visually captivating and sets the tone for the platform's functionality, even while the product search feature is temporarily disabled.

7. Non-Functional Requirements

• Performance: The system should load pages within 2 seconds under normal conditions.
• Scalability: The architecture should support future expansion to include basket price comparisons.
• Security: Ensure secure API integrations and data handling.
• Localization: Default settings optimized for Indian users (INR currency, IST timezone).

8. Tech Stack

Frontend:

• React for Web

Backend:

• Python
• FastAPI

Database:

• MySQL (preferred for relational data)
• Alembic for migrations

AI Models (Future Scope):

• GPT 5.2 for user-friendly responses

AI Tools:

• Langchain

Local Orchestration:

• Docker
• docker-compose

Server-Side Orchestration:

• Kubernetes

9. Assumptions and Constraints

Assumptions:

• The product search functionality will be re-enabled once the API supervisor resolves the issue.
• Users will primarily access the platform via web browsers.

Constraints:

• Temporary disabling of product search functionality limits user interaction.
• API integrations must comply with platform-specific terms of service.

10. Glossary

• API: Application Programming Interface, used for integrating external platforms.
• Carousel: A rotating display of items, often used in web design for showcasing products.
• IST: Indian Standard Time, the timezone for users in India.
• INR: Indian Rupee, the currency used for price display.

End of Document