System Requirements Document (SRD)

Project Name: Crystal-Moving

1. Introduction

Welcome to the System Requirements Document (SRD) for Crystal-Moving, a project aimed at creating a clean and professional website for 1st Choice Moving & Packing, a business specializing in moving services. This document outlines the system requirements necessary to design and develop a user-friendly platform that highlights their services, enables online booking, and provides service quotes.

The website will cater to business clients and residential customers in the US, specifically targeting areas served by 1st Choice Moving & Packing. The design will reflect professionalism while ensuring ease of use for customers seeking reliable moving services.

2. System Overview

The Crystal-Moving website will serve as a digital hub for 1st Choice Moving & Packing, allowing customers to explore services, request quotes, and book appointments online. Key features include:

• A clean and professional design that reflects the company's reliability and expertise.
• Interactive booking functionality for scheduling services.
• A service quote system to provide estimates based on customer inputs.
• Detailed service pages showcasing offerings like local and interstate moving, furniture assembly, storage, and junk removal.
• Integration of customer reviews to build trust and credibility.
• Contact information and location map for easy access.

The system will be optimized for desktop and mobile platforms, ensuring accessibility for all users.

3. Functional Requirements

As Story Points:

• As a User, I should be able to book moving services online by selecting a date, time, and service type.
• As a User, I should be able to request a service quote by filling out a simple form with details like location, items to move, and service type.
• As a User, I should be able to view detailed descriptions of all services offered, including pricing estimates.
• As a User, I should be able to read customer reviews to assess the company's reliability.
• As a User, I should be able to access contact information and view the company's location on a map.
• As an Admin, I should be able to manage bookings and service quotes through a backend dashboard.
• As an Admin, I should be able to update service descriptions and pricing information.

4. User Personas

1. Residential Customer

• Description: Individuals looking for local or interstate moving services for their homes.
• Goals: Quick booking, reliable service, and affordable pricing.
• Pain Points: Difficulty finding trustworthy movers and obtaining accurate quotes.

2. Business Client

• Description: Companies requiring corporate moving services, furniture assembly, or storage solutions.
• Goals: Efficient scheduling, professional handling of office equipment, and timely service.
• Pain Points: Ensuring minimal disruption to business operations during the move.

3. Admin

• Description: Staff managing bookings, quotes, and service updates.
• Goals: Seamless backend management and customer satisfaction.
• Pain Points: Handling large volumes of bookings and maintaining accurate service information.

5. Visuals Colors and Theme

Color Palette:

• primary: #2A5D9F (Deep Sapphire Blue)
• primary_light: #5A8CCF (Sky Blue Tint)
• secondary: #F28C28 (Warm Amber)
• accent: #E63946 (Vivid Coral Red)
• highlight: #FFD166 (Golden Yellow)
• bg: #F8F9FA (Soft White)
• surface: rgba(42, 93, 159, 0.1) (Translucent Sapphire Blue)
• text: #212529 (Dark Charcoal)
• text_muted: #6C757D (Muted Gray)
• border: rgba(33, 37, 41, 0.2) (Subtle Charcoal Border)

6. Signature Design Concept

Concept: Interactive Water Cycle Landing Page

The homepage will feature an animated water cycle metaphor to represent the seamless flow of moving services. Users will interact with a dynamic scene where water droplets transform into clouds, rain, and rivers, symbolizing the journey of moving items from one place to another.

Key Features:

• Interactive Animations: Hovering over droplets reveals service categories (e.g., local moving, furniture assembly). Clicking transitions to detailed service pages.
• Scroll-Triggered Transitions: As users scroll, the water cycle evolves—droplets rise, clouds form, rain falls, and rivers flow—creating a visually engaging narrative.
• Micro-Interactions: Subtle animations like ripples when hovering over buttons or droplets bouncing when clicked.
• Color Shifts: The background transitions from dawn to dusk as users navigate the homepage, symbolizing the company's round-the-clock availability.

Libraries:

• @react-three/fiber + @react-three/drei: For 3D water cycle animations.
• gsap: For scroll-triggered transitions and timeline animations.
• framer-motion: For hover effects and spring physics on interactive elements.

7. Interaction Model & Motion Direction

Landing Page Interaction Model: Parallax

The homepage will feature layered depth via scroll, with decorative elements like clouds and droplets moving at different speeds. Real content (e.g., service descriptions) will scroll naturally.

Internal Pages Interaction Model: Static

Service pages, booking forms, and the contact page will prioritize clarity and minimal motion for efficient navigation and readability.

8. Non-Functional Requirements

• Performance: The website must load within 3 seconds on standard broadband connections.
• Accessibility: Ensure WCAG 2.1 compliance for users with disabilities.
• Responsiveness: Fully functional across desktop, tablet, and mobile devices.
• Security: Protect user data with HTTPS encryption and secure backend authentication.
• Scalability: Support up to 10,000 monthly users without performance degradation.

9. Tech Stack

Frontend:

• React for Web

Backend:

• Python
• FastAPI

Database:

• MySQL (preferred for relational data)
• Alembic for migrations

AI Tools:

• GPT 5.4 for user-friendly responses in the booking system.

Local Orchestration:

• Docker
• docker-compose

Server-Side Orchestration:

• Kubernetes

10. Assumptions and Constraints

• The website will primarily serve customers in the US, with a focus on areas near Fort Edward, NY.
• The booking system will not include payment processing in the initial phase.
• Admins will manually approve bookings and quotes until automation is implemented.
• The website will use English as the default language.

11. Glossary

• WCAG: Web Content Accessibility Guidelines.
• HTTPS: Hypertext Transfer Protocol Secure.
• Docker: A platform for containerized applications.
• FastAPI: A modern web framework for building APIs with Python.
• Alembic: A database migration tool for SQLAlchemy.