GENZ-MART System Requirements Document

Introduction

GENZ-MART is a local online marketplace platform designed to cater to the unique needs of the Northeast state communities residing in Bangalore, specifically in areas like Indiranagar, Ejipura, Kalyan Nagar, and Whitefield. The platform aims to provide a seamless shopping experience for products such as axone, smoked pork, bamboo shoots, and other regional specialties.

System Overview

GENZ-MART will function as an online marketplace similar to platforms like Zepto and Blinkit, focusing on delivering niche products from the Northeast states to specific localities in Bangalore. The platform will support product discovery in local vendor, order placement, and delivery tracking, ensuring a user-friendly experience for its target audience.

Functional Requirements as Story Points

• As a User, I should be able to login in different options,browse and search for products like axone, smoked pork, and bamboo shoots.
• As a User, I should be able to place orders for delivery to Indiranagar, Ejipura, Kalyan Nagar, and Whitefield.
• As a User, I should receive notifications about order status and delivery updates.
• As a User, I should be able to track my order in real-time.
• As an Admin, I should be able to manage product listings and inventory specific to Northeast state products.
• As an Admin, I should be able to manage delivery logistics and ensure timely delivery to the specified areas.and Admin panel Dashboard full control and auto payout split between all users like admin platform fee, Delivery Charge and Vendor Product Cost or Charge.

User Personas

• Local Shopper: Residents of Indiranagar, Ejipura, Kalyan Nagar, and Whitefield from the Northeast states looking for familiar regional products.
• Admin: Platform administrators responsible for managing product listings, inventory, and delivery logistics.

Core User Flows

• Local Shopper searches for a product -> adds to cart -> selects delivery location -> places order complete order and payment-> receives order confirmation -> tracks order -> receives delivery.
• Admin updates product inventory -> manages orders -> coordinates with delivery partners -> ensures timely delivery to specified locations,manage all payout.

Visuals Colors and Theme

• primary: #1A73E8 (a deep blue representing trust and reliability)
• primary_light: #D2E3FC (a light blue for hover states and secondary UI elements)
• secondary: #FF6F61 (a coral hue for emphasis and links)
• accent: #FFD700 (a vibrant gold for call-to-action buttons and badges)
• highlight: #FFA500 (an orange hue for active indicators and notifications)
• bg: #FFFFFF (a clean white background)
• surface: rgba(240, 240, 240, 0.8) (a light grey for card/panel backgrounds)
• text: #333333 (a dark grey for primary text)
• text_muted: #777777 (a softer grey for secondary text and labels)
• border: rgba(200, 200, 200, 0.5) (a subtle grey for borders)

Signature Design Concept

The GENZ-MART homepage will feature an interactive map of Bangalore highlighting the target areas (Indiranagar, Ejipura, Kalyan Nagar, Whitefield). Users can hover over each area to see popular products from the Northeast states, with animated 3D icons representing items like axone, smoked pork, and bamboo shoots. Clicking on an icon will open a detailed product page with details and purchasing options in different types of payment.

Landing Hero Motion Brief

The landing hero will showcase a dynamic animation where a basket of Northeast state products travels across a stylized map of Bangalore. As the basket moves, it highlights each target area, showing a transformation of the basket filling with regional products. The animation will loop every 10 seconds, providing a continuous visual story of product delivery. This will be implemented using motion/react for smooth transitions and interactions with 3D.

Interaction Model & Motion Direction

• Interaction Model: Parallax
• The landing page will employ a parallax effect, where the map and product icons move at different speeds as the user scrolls, creating a sense of depth and engagement.
• Internal pages will focus on static layouts for clarity, with minimal motion to enhance usability.

Non-Functional Requirements

• The platform must support high traffic volumes, especially during peak shopping hours.
• Ensure data security and privacy for all user transactions.
• Provide a responsive design that works seamlessly across desktop and mobile devices.

Tech Stack

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

Assumptions and Constraints

• The platform will initially focus on the specified localities in Bangalore.
• Product availability is subject to supplier constraints and regional demand.
• Delivery logistics will be managed in partnership with local delivery services.

Glossary

• Axone: A fermented soybean product popular in Northeast Indian cuisine.
• Smoked Pork: A traditional meat preparation from the Northeast states.
• Bamboo Shoots: Edible shoots from bamboo plants, commonly used in Northeast Indian dishes.