KaamSetu

Introduction

The "KaamSetu" project is a comprehensive Flutter application designed to connect customers with local service providers in India. It facilitates seamless interactions between customers and workers for various services such as electricians, plumbers, painters, carpenters, cleaners, mechanics, and delivery workers. The application aims to provide a user-friendly platform with robust features and a modern design aesthetic.

System Overview

KaamSetu is built using Flutter, leveraging Firebase for authentication, database management, and storage. The application supports three primary user roles: Customer, Worker, and Admin, each with distinct functionalities. The app is designed with a responsive and clean UI, adhering to Material Design 3 principles, and is optimized for mobile devices.

Functional Requirements

• As a Customer, I should be able to log in using OTP or Google.
• As a Customer, I should be able to search for workers by category.
• As a Customer, I should be able to view worker profiles and book workers.
• As a Customer, I should be able to view my booking history and manage my profile.
• As a Worker, I should be able to register and log in to the application.
• As a Worker, I should be able to add skills/services and update my availability status.
• As a Worker, I should be able to accept or reject bookings and view my earnings.
• As an Admin, I should be able to log in and manage customers and workers.
• As an Admin, I should be able to approve or reject workers and manage service categories and bookings.

User Personas

1. Customer: Individuals seeking local services.
2. Worker: Service providers offering skills in various categories.
3. Admin: Personnel managing the platform's operations and user activities.

Visuals Colors and Theme

• primary: #FF6F00 (a vibrant orange)
• primary_light: #FFA040 (a lighter tint of orange)
• secondary: #004D40 (a deep teal for contrast)
• accent: #D32F2F (a bold red for CTAs)
• highlight: #FFC107 (a warm amber for notifications)
• bg: #FFFFFF (white for a clean background)
• surface: rgba(255, 255, 255, 0.9) (light surface for cards)
• text: #212121 (dark grey for primary text)
• text_muted: #757575 (soft grey for secondary text)
• border: rgba(0, 0, 0, 0.1) (subtle border color)

Signature Design Concept

The home page of KaamSetu will feature an interactive "Service Map" concept. Users will see a dynamic map of their locality with animated icons representing different service categories. As users hover over or click on these icons, they will expand to show available workers in that category, with smooth transitions and animations powered by framer-motion. This interactive map will provide a visually engaging and intuitive way for users to explore services in their area.

Interaction Model & Motion Direction

The landing page will utilize a "parallax" interaction model, creating a layered depth effect as users scroll through the page. This will include decorative layers that move at different speeds, enhancing the storytelling aspect of the app. Internal pages, such as dashboards and settings, will adopt a "static" model for clarity and ease of use.

Non-Functional Requirements

• The application must be responsive and function seamlessly on various mobile devices.
• Ensure high availability and reliability with Firebase backend services.
• Maintain data security and user privacy, adhering to relevant regulations.

Tech Stack

• Frontend: Flutter (latest stable version)
• Backend: Firebase (Authentication, Firestore, Storage)
• Authentication: Firebase OTP and Google Sign-In
• UI Framework: Material Design 3

Assumptions and Constraints

• The application will initially support English, with potential for future localization.
• The admin functionalities will be mobile-first, with considerations for future web expansion.
• The app will adhere to modern design principles, ensuring a professional and engaging user experience.

Glossary

• OTP: One-Time Password
• UI: User Interface
• UX: User Experience
• Firestore: A NoSQL cloud database to store and sync data for client- and server-side development.
• Firebase: A platform developed by Google for creating mobile and web applications.