System Requirements Document (SRD)

Project Name: teal-app

1. Introduction

The teal-app is a cross-platform mobile application designed to facilitate local skill exchange and micro-service marketplaces. It empowers users, primarily students, freelancers, and young professionals, to offer services and hire others nearby. The app focuses on simplicity, trust-building, and scalability, ensuring a seamless experience for users while fostering community-driven economies.

This document outlines the system requirements for the teal-app, including functional and non-functional specifications, technical architecture, and design concepts.

2. System Overview

The teal-app enables users to connect with nearby service providers, book services, and securely process payments within the app. It features user authentication, service listings, real-time chat, booking systems, reviews, and an admin panel for platform management.

Key objectives:

• Ease of Use: Simple onboarding and intuitive navigation.
• Trust: Verified profiles, ratings, and reviews to build credibility.
• Scalability: Multi-city support and future AI-driven features.
• Secure Payments: Integration of UPI, debit/credit cards, and wallets with platform commission handling.

The app will be developed as a cross-platform mobile application for Android and iOS using React Native.

3. Functional Requirements

User Stories:

• Authentication:

  • As a User, I should be able to sign up and log in using email and password.
  • As a User, I should be able to create a profile with a photo, bio, and skills section.

• Home Screen:

  • As a User, I should see a list of nearby service providers.
  • As a User, I should be able to search for services using a search bar.
  • As a User, I should be able to filter services by categories (Design, Tutoring, Tech, Beauty, Repair, etc.).
  • As a User, I should receive location-based service suggestions.

• Service Listing:

  • As a User, I should be able to add a new service with a price per hour, description, and availability schedule.

• Booking System:

  • As a User, I should be able to request bookings for services.
  • As a Service Provider, I should be able to accept or reject bookings.
  • As a User, I should be able to track booking statuses and view upcoming bookings.

• Chat System:

  • As a User, I should be able to send real-time text messages to service providers.
  • As a User, I should receive notification alerts for new messages.

• Review System:

  • As a User, I should be able to leave ratings (1–5 stars) and written feedback for services.
  • As a User, I should be able to view public reviews on service provider profiles.

• Dashboard:

  • As a Service Provider, I should be able to view earnings, active bookings, and completed jobs.

• Admin Panel:

  • As an Admin, I should be able to manage users, remove spam, and view reports.

• Payment Integration:

  • As a User, I should be able to pay for services using UPI, debit/credit cards, and wallets.
  • As a Platform, I should be able to deduct a small commission per transaction.

• Future Scope:

  • As a User, I should receive AI-based recommendations for services.
  • As a Service Provider, I should be able to promote my services through featured listings.
  • As a User, I should receive notifications for updates and reminders.
  • As an Admin, I should have access to a dashboard for managing users and reports.

4. User Personas

1. User:

• Students, freelancers, and young professionals seeking local services.
• Can search, book, and review services.

2. Service Provider:

• Individuals offering services such as tutoring, design, repair, etc.
• Can list services, accept bookings, and manage earnings.

3. Admin:

• Platform managers responsible for user moderation, spam removal, and report handling.

5. Visuals Colors and Theme

Color Palette:

• Background: #F5F9FF (Soft Sky Blue)
• Surface: #FFFFFF (Pure White)
• Text: #2A2A2A (Charcoal Gray)
• Accent: #00A676 (Teal Green)
• Muted Tones: #D1D5DB (Cloud Gray)

Mood Direction:

The teal-app will feature a clean, modern aesthetic with a focus on trust and simplicity. The teal green accent conveys growth and reliability, while the soft sky blue background ensures a calming user experience.

6. Signature Design Concept

Interactive Service Map Homepage

The homepage will feature a dynamic, interactive map that displays nearby service providers as clickable pins. Each pin will animate with a subtle bounce effect when hovered over, and clicking on a pin will open a card with the provider's profile, services, and ratings.

Additional features:

• Category Filters: Users can toggle filters directly on the map to display specific service categories.
• Real-Time Updates: The map will refresh dynamically as users scroll or zoom.
• Micro-Interactions: Smooth transitions and hover effects for pins and cards.
• Teal Glow: Selected pins will emit a soft teal glow to highlight active providers.

This design will make the homepage visually engaging and intuitive, encouraging users to explore services in their area.

7. Non-Functional Requirements

• Performance: The app should load within 2 seconds on standard mobile devices.
• Scalability: Support for multi-city expansion and increasing user base.
• Security: Secure authentication, encrypted payments, and data protection.
• Reliability: 99.9% uptime for backend services.
• Accessibility: Ensure compliance with accessibility standards for visually impaired users.

8. Tech Stack

Frontend:

• React Native for cross-platform mobile app development.

Backend:

• Python with FastAPI for scalable and secure APIs.

Database:

• MySQL for structured data (user profiles, bookings).
• MongoDB for unstructured data (chat messages, reviews).

AI Models:

• GPT 5.4 for user-friendly responses.
• Google Nano Banana for image generation (profile photos, service visuals).

AI Tools:

• Langchain for AI-driven recommendations.

Orchestration:

• Docker and Kubernetes for deployment and scalability.

9. Assumptions and Constraints

Assumptions:

• Users will have access to smartphones with internet connectivity.
• Payment methods (UPI, cards, wallets) are widely used in the target demographic.
• Service providers will actively update their availability and pricing.

Constraints:

• Initial launch will be limited to a single city for testing scalability.
• Real-time chat and notifications depend on stable backend infrastructure.
• AI-based recommendations require sufficient user data for training models.

10. Glossary

• UPI: Unified Payments Interface, a real-time payment system in India.
• JWT: JSON Web Token, a secure authentication method.
• Langchain: A framework for building applications powered by language models.
• Docker: A tool for containerizing applications.
• Kubernetes: A system for automating deployment and scaling of containerized applications.

This document provides a comprehensive overview of the teal-app system requirements, ensuring alignment with Maya's vision for a scalable, user-friendly, and secure skill exchange platform.