space-idea

1. Introduction

This document outlines the system requirements for "space-idea," a construction marketplace startup based in India. The platform aims to connect customers with construction professionals, laborers, material suppliers, and equipment rental providers. It will support multilingual capabilities and focus on a mobile-first design to cater to non-technical users.

2. System Overview

The "space-idea" construction marketplace is a location-based platform where customers can post construction requirements, search for nearby professionals, and buy or sell leftover construction materials. Providers can create profiles, list services, showcase projects, and communicate with customers. The platform will include separate experiences for various user types, including customers, providers, sellers, material suppliers, laborers, contractors, architects, engineers, and admins.

3. Functional Requirements

Customer Functional Requirements

• As a customer, I want to post construction requirements so that I can find suitable professionals and services.
• As a customer, I want to search for nearby construction professionals to hire them for my projects.
• As a customer, I want to buy construction materials from local suppliers.
• As a customer, I want to sell leftover construction materials to other users in the marketplace.
• As a customer, I want to view provider profiles to assess their suitability for my requirements.
• As a customer, I want to chat with providers to discuss project details and quotes.
• As a customer, I want to receive quotes from providers to compare and make informed decisions.
• As a customer, I want to rate and review providers after project completion to help other users make decisions.
• As a customer, I want to add saved profiles to easily access preferred providers.
• As a customer, I want to use the customer bottom navigation for easy access to home, search, post, chats, and profile sections.
• As a customer, I want to select customer location options to find services within a specific radius or area.
• As a customer, I want to post requirements with a budget range to filter providers that match my financial capacity.
• As a customer, I want to post requirements for commercial projects to find suitable contractors and professionals.

Provider Functional Requirements

• As a provider, I want to create a public profile to showcase my services and past projects.
• As a provider, I want to receive leads from customers to expand my business opportunities.
• As a provider, I want to send quotes to customers to secure projects.
• As a provider, I want to chat with customers to discuss project details and requirements.
• As a provider, I want to manage my portfolio to display completed projects and gain trust.
• As a provider, I want to subscribe to premium plans for enhanced visibility and lead access.
• As a provider, I want to handle turnkey projects to offer comprehensive construction solutions.
• As a provider, I want to manage communication features such as in-app chat, WhatsApp integration, and call options.
• As a provider, I want to follow chat rules to ensure proper communication flow and privacy.

Admin Functional Requirements

• As an admin, I want to manage user profiles to ensure quality and trust in the marketplace.
• As an admin, I want to approve or reject provider profiles based on verification and completeness.
• As an admin, I want to manage categories and services to keep the platform organized and relevant.
• As an admin, I want to monitor and moderate reviews to maintain a trustworthy environment.
• As an admin, I want to generate reports and analytics to track platform performance and user engagement.
• As an admin, I want to enforce admin quality rules to maintain high standards for provider profiles and listings.
• As an admin, I want to add/edit categories to ensure the platform reflects current market needs.

Material and Service Functional Requirements

• As a customer, I want to purchase AAC blocks for construction projects.
• As a customer, I want to hire an AC technician for installation and maintenance services.
• As a customer, I want to purchase aggregates like jelly for construction needs.
• As a customer, I want to hire a barbender for steel cutting and reinforcement tasks.
• As a customer, I want to purchase bricks and blocks like red brick for building projects.
• As a customer, I want to purchase cement types like OPC for construction purposes.
• As a customer, I want to hire a CCTV installer for camera setup and security services.
• As a customer, I want to hire a carpenter for doors and furniture installation.
• As a customer, I want to purchase doors and windows made of wood for my property.

4. User Personas

Customer / Property Owner

• Individuals looking to build, renovate, or repair properties.
• Interested in buying construction materials or selling leftover materials.

Individual Labour

• Workers such as masons, painters, carpenters, etc., seeking job opportunities.

Mestri / Foreman

• Team leaders managing labor teams for construction projects.

Plumber / Electrician

• Professionals offering specialized repair and installation services.

Architect / Civil Engineer

• Professionals providing design, planning, and structural services.

Contractor / Construction Company

• Businesses handling large-scale construction projects.

Material Supplier / Shop Owner

• Businesses selling construction materials and supplies.

Admin

• Platform managers ensuring smooth operation and quality control.

5. Core User Flows

Customer Posts Requirement

1. Login with mobile OTP.
2. Select location and language.
3. Post construction requirement with details.
4. View matching providers and initiate contact.

Provider Onboarding

1. Select provider type.
2. Complete profile with services and location.
3. Submit for admin approval.
4. Start receiving leads and responding to customers.

Admin Approval Process

1. Review pending provider profiles.
2. Verify documents and profile completeness.
3. Approve or reject profiles.
4. Monitor platform activity and user reports.

6. Visuals Colors and Theme

• Primary Color: #FF8C00 (Construction orange)
• Primary Light: #FFA54F (Light saffron-orange)
• Secondary Color: #2F4F4F (Dark slate gray)
• Accent Color: #32CD32 (Lime green for verified/available/success)
• Highlight Color: #FFD700 (Gold for hover states and notifications)
• Background: #F5F5F5 (Light warm grey)
• Surface: rgba(255, 255, 255, 0.9) (White card background)
• Text: #333333 (Dark charcoal)
• Text Muted: #777777 (Medium grey)
• Border: rgba(0, 0, 0, 0.1) (Light grey)

7. Signature Design Concept

The "space-idea" platform will feature an interactive galaxy map as its homepage. Each star in the galaxy represents a different feature or section of the platform. Users can click on a star to open a task card, drag to rotate the cluster, and hover to highlight connections between related features. This concept will be brought to life using @react-three/fiber and @react-three/drei for 3D interactions, creating an engaging and memorable first impression.

8. Interaction Model & Motion Direction

The landing page will utilize a "parallax" interaction model, providing layered depth via scroll. Decorative layers, such as atmospheric blobs and distant shapes, will translate at different speeds, while real content stays in normal flow and scrolls naturally. This approach is ideal for creating a visually rich first impression for the "space-idea" platform.

9. Non-Functional Requirements

• Support for all Indian languages with English as default.
• High availability and scalability to handle peak loads.
• Secure data handling and user privacy protection.

10. Tech Stack

• Frontend: React.js
• Backend: Python + FastAPI
• Database: MySQL with Alembic migrations
• Storage: AWS S3 for images/documents
• Search: PostgreSQL full-text + location filters
• Backend Options: Node.js / NestJS + PostgreSQL + Redis or Python FastAPI + PostgreSQL + Redis
• Cloud Recommendation: AWS S3 for storage, CloudFront for media delivery, RDS PostgreSQL for data, Redis for caching

11. Assumptions and Constraints

• The platform will initially launch in select Indian states and districts.
• Providers must undergo verification before their profiles are public.
• The marketplace will start with a free model and introduce monetization later.
• Disputes will be managed with clear terms and a report flow.

12. Glossary

• MVP: Minimum Viable Product
• OTP: One-Time Password
• GST: Goods and Services Tax
• Aadhaar: Indian biometric ID system
• PWA: Progressive Web App

This document serves as a comprehensive guide for developing the "space-idea" construction marketplace platform, ensuring all user needs and system requirements are addressed.