System Requirements Document (SRD)

Project Name: wooden-marketplace

1. Introduction

Welcome to the System Requirements Document (SRD) for the wooden-marketplace project. This document outlines the technical and functional requirements for building a full-stack Social Media + Listing Marketplace platform tailored to Khyati Singh's vision. The platform will combine social engagement features with a marketplace for buying and selling wooden products, focusing on a seamless user experience and scalable architecture.

The project is designed for users in India (IN), with locale-specific defaults such as INR currency, IST timezone, and culturally relevant design elements.

2. System Overview

The wooden-marketplace platform will serve as a hybrid social media and marketplace application, enabling users to:

1. Engage socially through posts, likes, comments, and follows.
2. Buy and sell wooden products via a listing system with advanced search and filters.
3. Communicate in real-time through a chat system for buyer-seller interactions.

The platform will feature a modern, mobile-first design optimized for user engagement and conversions. It will support multiple user roles, including buyers, sellers, and administrators, ensuring a secure and efficient environment for transactions and interactions.

3. Functional Requirements

Core Features:

• As a User, I should be able to register and log in using email/password or Google.
• As a User, I should be able to create and edit my profile, including profile image, bio, and location.
• As a User, I should be able to follow/unfollow other users and view their posts and listings.
• As a User, I should be able to upload posts with images/videos, captions, and hashtags.
• As a User, I should be able to like, comment, share, and bookmark posts.
• As a User, I should be able to create listings with title, price, description, category, condition, location, and images.
• As a User, I should be able to search for listings and users with filters like price range, category, location, and condition.
• As a User, I should be able to view listing details, including seller information and similar listings.
• As a User, I should be able to contact sellers via real-time messaging.
• As an Admin, I should be able to manage flagged posts/listings, user reports, and platform analytics.

4. User Personas

1. Buyer

• Interested in purchasing wooden products.
• Browses listings, searches for specific items, and contacts sellers.
• Engages with posts to discover new products and trends.

2. Seller

• Crafts or sells wooden products.
• Creates listings, uploads posts, and interacts with buyers.
• Manages their profile and listings to attract customers.

3. Admin

• Oversees platform operations.
• Manages flagged content, user reports, and analytics.
• Ensures compliance with platform policies.

5. Visuals Colors and Theme

Unique Color Palette:

The wooden-marketplace will feature a warm, earthy theme inspired by natural wood tones.

• Background: #FAF3E0 (Soft Beige)
• Surface: #D9C5A1 (Light Oak)
• Text: #4B3B2F (Dark Walnut)
• Accent: #A67C52 (Golden Brown)
• Muted Tones: #EDE0D4 (Cream White)

This palette evokes a sense of craftsmanship and authenticity, aligning with the wooden product niche.

6. Signature Design Concept

Interactive Wooden Workshop Homepage

The homepage will resemble a virtual wooden workshop, immersing users in the craft of woodworking.

Key Features:

1. Dynamic Background: A living wooden texture that subtly shifts shades based on the time of day (lighter in the morning, darker in the evening).
2. Interactive Elements:
   • Wooden tools (e.g., hammer, saw) that animate when hovered over.
   • Listings displayed as wooden planks that users can "flip" to reveal details.
3. Micro-Interactions:
   • Clicking on a listing triggers a "carving" animation, as if engraving the product details into wood.
   • Posts appear as "wooden frames" that users can slide open to view captions and comments.
4. Navigation:
   • A top navbar styled like a wooden beam with carved icons.
   • Sidebar resembling a wooden shelf for categories and filters.

This design will make the platform instantly memorable and visually captivating, creating a unique identity for the wooden-marketplace.

7. Non-Functional Requirements

• Performance: The platform must load within 2 seconds for optimal user experience.
• Scalability: Support up to 1 million users and listings.
• Security: Implement robust authentication and data encryption.
• Availability: Ensure 99.9% uptime.
• Localization: Default to INR currency and IST timezone.

8. Tech Stack

Frontend:

• React JS
• Tailwind CSS

Backend:

• Python
• FastAPI

Database:

• MySQL (with Alembic for migrations)

AI Tools:

• GPT 5.4 for user-friendly responses
• Google Nano Banana for image generation

Real-Time Communication:

• Socket.io

Deployment:

• Docker + Kubernetes

9. Assumptions and Constraints

Assumptions:

• Users are primarily located in India.
• Listings will focus on wooden products.
• Sellers are responsible for shipping and delivery.

Constraints:

• Limited initial budget for advanced AI features.
• Platform must comply with Indian e-commerce regulations.

10. Glossary

• JWT: JSON Web Token, used for secure authentication.
• IST: Indian Standard Time.
• CTA: Call to Action, a button or link encouraging user interaction.
• ORM: Object-Relational Mapping, a technique for interacting with databases.

This SRD provides a comprehensive foundation for building the wooden-marketplace. Let’s bring this vision to life! 🚀