System Requirements Document (SRD)

Project Name: grand-uniforms

1. Introduction

The grand-uniforms project is an ecommerce platform designed to cater to the uniform needs of employees working in petrol and gas companies across India. This platform will allow individual employees to shop for their uniforms directly, simplifying the procurement process and ensuring convenience. The platform will target employees from companies such as Indian Oil, Hindustan Petroleum, Bharat Petroleum, Indane Gas, HP Gas, and Bharat Gas.

This document outlines the system requirements for the grand-uniforms project, ensuring it meets the needs of its users while adhering to the highest standards of usability and functionality.

2. System Overview

The grand-uniforms ecommerce platform will provide a seamless shopping experience for employees of petrol and gas companies in India. The platform will feature a user-friendly interface, a robust catalog of uniforms, and customization options to meet individual needs. It will also include size filtering, secure payment gateways, and order tracking to enhance the user experience.

The system will operate in the Indian market, adhering to local currency (INR), timezone (IST), and language preferences (English and Hindi).

3. Functional Requirements

• As a User, I should be able to browse a catalog of uniforms categorized by company and role.
• As a User, I should be able to filter uniforms by size, color, and other attributes.
• As a User, I should be able to customize uniforms with options like name tags or logo embroidery.
• As a User, I should be able to add items to a shopping cart and proceed to checkout.
• As a User, I should be able to securely pay for my order using multiple payment options (credit/debit cards, UPI, net banking, etc.).
• As a User, I should be able to track my order status post-purchase.
• As an Admin, I should be able to manage the product catalog, including adding, updating, or removing items.
• As an Admin, I should be able to view and manage orders placed by users.
• As an Admin, I should be able to generate sales reports and analytics.

4. User Personas

1. User (Employee)

   • Employees of petrol and gas companies who need to purchase uniforms for their roles.
   • Primary goals: Browse, customize, and purchase uniforms conveniently.

2. Admin

   • The platform administrator responsible for managing the product catalog, orders, and overall system operations.
   • Primary goals: Ensure smooth platform functioning and manage inventory and sales.

5. Visuals Colors and Theme

The visual design will reflect the professional and industrial nature of the target audience while maintaining a user-friendly and approachable aesthetic.

Color Palette:

• Primary: Deep Blue (#003366) – Represents trust and professionalism.
• Secondary: Bright Orange (#FF6600) – Reflects energy and dynamism, aligning with the petrol/gas industry.
• Accent: White (#FFFFFF) – For clean and readable interfaces.
• Neutral: Light Gray (#F2F2F2) – For backgrounds and subtle elements.

Typography:

• Headings: Bold Sans Serif (e.g., Montserrat or Open Sans).
• Body Text: Clean Sans Serif (e.g., Roboto or Lato).

Theme:

• Clean and modern layout with a focus on usability.
• High contrast for readability and accessibility.

6. Signature Design Concept

Interactive Uniform Showcase with Role-Based Customization

The homepage will feature an interactive 3D carousel of uniforms displayed on virtual mannequins. Users can rotate the mannequins to view uniforms from different angles.

Each uniform will be tagged with the company logo (e.g., Indian Oil, Bharat Petroleum) and role-specific details (e.g., "Station Attendant," "Supervisor"). Users can click on a uniform to open a customization panel where they can:

• Select their size.
• Add customizations like name tags or embroidered logos.
• View a real-time preview of their customized uniform.

The homepage will also include subtle animations, such as the company logos gently glowing when hovered over, and transitions that mimic the flow of fuel (e.g., smooth liquid-like animations).

This design will make the platform visually engaging and provide users with a memorable and intuitive shopping experience.

7. Non-Functional Requirements

• The system should support high availability with 99.9% uptime.
• The platform should load within 2 seconds on average.
• The system should be scalable to handle up to 10,000 concurrent users.
• The platform should comply with Indian data protection laws and ensure secure handling of user data.
• The system should support both English and Hindi languages.

8. Tech Stack

Frontend:

• React for Web

Backend:

• Python
• FastAPI

Database:

• MySQL (with Alembic for migrations)

AI Tools:

• GPT 5.2 for user-friendly responses in the customization panel.

Local Orchestration:

• Docker
• docker-compose

Server-Side Orchestration:

• Kubernetes

9. Assumptions and Constraints

• The platform will primarily target users in India, so all pricing will be in INR.
• The platform will operate in the IST timezone.
• The system will initially focus on uniforms for petrol and gas companies but can be expanded to other industries in the future.
• Internet connectivity is assumed for all users accessing the platform.

10. Glossary

• Ecommerce Platform: A website or application that allows users to purchase goods online.
• Customization Panel: A feature that allows users to personalize their uniforms with options like name tags or logos.
• IST: Indian Standard Time.
• INR: Indian Rupee, the currency of India.
• Admin: The person responsible for managing the platform's backend operations.