Terra-Service System Requirements Document

Introduction

This document outlines the system requirements for the Terra-Service project, a modern service-booking web application designed to connect customers with skilled taskers. The platform provides a seamless experience for users to browse services, book jobs, manage their bookings, and update their profiles.

System Overview

Terra-Service is designed to facilitate easy and efficient service booking by connecting customers with taskers. The platform supports two primary roles: Customer and Tasker, each with their own dashboard and user experience. The system is built with a focus on usability, aesthetics, and a modern, minimal design using Tailwind CSS.

Functional Requirements

• As a Customer, I should be able to view a grid of available services on the Services Page.
• As a Customer, I should be able to fill out a form on the Booking Page to create a job.
• As a Customer, I should be redirected to the Customer Dashboard after booking a service.
• As a Customer, I should be able to view my bookings dynamically on the Customer Dashboard.
• As a Customer, I should see styled cards with status badges for each booking on the Dashboard.

User Personas

• Customer: A user looking to book services such as plumbing, cleaning, or electrical work. They can browse services, book jobs, and manage their bookings.
• Tasker: A service provider offering skills in various categories. They can manage assigned jobs and update job statuses.

Visuals Colors and Theme

• primary: #FF6F00 (a vibrant orange for brand identity)
• primary_light: #FFA040 (a lighter orange for hover states)
• secondary: #4A4A4A (a neutral gray for text and secondary elements)
• accent: #00BFA5 (a teal color for CTAs and active states)
• highlight: #FFD600 (a bright yellow for notifications and highlights)
• bg: #F5F5F5 (a light gray for the page background)
• surface: rgba(255, 255, 255, 0.9) (a white with slight transparency for cards)
• text: #212121 (a dark gray for primary text)
• text_muted: #757575 (a softer gray for secondary text)
• border: rgba(0, 0, 0, 0.1) (a subtle black for borders)

Signature Design Concept

Interactive Service Galaxy: The homepage will feature an interactive galaxy map where each star represents a service category. Users can click on a star to zoom in and view detailed service options. As users hover over stars, connections between related services will highlight, creating a dynamic and engaging experience. This concept will use @react-three/fiber for 3D rendering and gsap for smooth animations and transitions.

Interaction Model & Motion Direction

• Interaction Model: Parallax
  • The landing page will utilize a parallax effect, creating a layered depth as users scroll. Decorative elements like stars and service icons will move at different speeds, enhancing the storytelling aspect of the platform.
• Motion Direction: Animated
  • Moderate scroll-triggered reveals and hover transitions will be used throughout the platform to maintain a polished and engaging user experience.

Non-Functional Requirements

• The system must be responsive and accessible on various devices, including desktops, tablets, and smartphones.
• The platform should support high availability and handle concurrent user sessions efficiently.
• Data security and user privacy must be ensured through encryption and secure authentication mechanisms.

Tech Stack

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

Assumptions and Constraints

• The application will be deployed in a region where the primary language is English.
• The system will operate in the Jordanian timezone.
• The platform will initially support payment in Jordanian Dinar (JOD).

Glossary

• Customer: A user who books services on the platform.
• Tasker: A service provider offering their skills through the platform.
• Booking: The process of scheduling a service with a tasker.
• Dashboard: A user interface that provides an overview of bookings and profile management.

This document serves as a comprehensive guide for the development and design of the Terra-Service platform, ensuring a cohesive and user-friendly experience for all users.