System Requirements Document (SRD)

Project Name: magma-salon

1. Introduction

The magma-salon project aims to create a sleek, professional, and user-friendly online presence for Faiyaz Shiaka's unisex salon located in Mumbai, India. The salon specializes in a wide range of grooming and haircare services, and this document outlines the system requirements for developing a digital solution that enhances customer engagement, streamlines communication, and showcases the salon's offerings effectively.

This SRD is tailored to meet the specific needs of the salon, including the integration of WhatsApp for instant communication and a focus on mobile-friendly design.

2. System Overview

The magma-salon system will provide a digital platform that highlights the salon's services, customer reviews, and contact options. The primary focus is on creating a smooth and professional design that integrates WhatsApp functionality for instant communication. The platform will emphasize ease of use, responsiveness, and aesthetic appeal to attract and retain customers.

Key features include:

• A mobile-friendly landing page showcasing services, reviews, and contact details.
• Prominent WhatsApp chat button for instant customer interaction.
• Visual representation of the salon's offerings and location.
• Integration of customer testimonials to build trust and credibility.

3. Functional Requirements

As User:

• I should be able to view all available services with descriptions.
• I should be able to see customer reviews and ratings.
• I should be able to contact the salon via WhatsApp directly from the platform.
• I should be able to find the salon's location and navigate to it using integrated maps.

As Admin:

• I should be able to update service offerings and descriptions.
• I should be able to manage customer reviews and ratings.
• I should be able to monitor WhatsApp interactions initiated through the platform.

4. User Personas

1. Admin

• Role: Salon owner or manager.
• Responsibilities: Managing services, reviews, and customer interactions.

2. User

• Role: Customer seeking grooming or haircare services.
• Responsibilities: Browsing services, reading reviews, contacting the salon, and booking appointments.

5. Visuals Colors and Theme

Color Palette:

The color scheme for magma-salon will reflect sophistication, warmth, and professionalism, aligning with the salon's identity.

• Background: #F5F5F5 (Soft Gray)
• Surface: #FFFFFF (Pure White)
• Text: #333333 (Dark Charcoal)
• Accent: #FF5733 (Vibrant Coral)
• Muted Tones: #B2B2B2 (Neutral Gray)

This palette ensures a clean and modern aesthetic while maintaining a welcoming vibe for customers.

6. Signature Design Concept

Interactive Mirror Landing Page

The homepage will feature an interactive mirror design that mimics the experience of standing in front of a salon mirror. The mirror will display dynamic reflections of the salon's services, customer testimonials, and promotional offers.

Key Features:

• Animations: Subtle shimmer effects on the mirror surface to create a realistic feel.
• Transitions: Smooth fade-ins and slide transitions for content updates.
• Interaction: Users can "swipe" or "tap" on the mirror to explore different sections, such as services, reviews, and contact options.
• Color Shifts: The mirror's frame will change colors based on the time of day (e.g., coral during the day, muted gray at night).

This bold and eccentric design will make the magma-salon platform instantly memorable and engaging for users.

7. Non-Functional Requirements

• Performance: The platform must load within 2 seconds on mobile devices.
• Scalability: The system should support up to 10,000 monthly visitors without performance degradation.
• Security: All customer interactions via WhatsApp must be encrypted.
• Accessibility: The platform must adhere to WCAG 2.1 standards for accessibility.

8. Tech Stack

Frontend:

• React for Web

Backend:

• Python
• FastAPI

Database:

• MySQL (with Alembic for migrations)

AI Tools:

• GPT 5.4 for user-friendly responses

Local Orchestration:

• Docker
• docker-compose

9. Assumptions and Constraints

• The platform will primarily target customers in Mumbai, India, and will operate in IST (Indian Standard Time).
• WhatsApp integration will require the salon to have a verified business account.
• The system will not include online payment functionality at this stage.

10. Glossary

• Landing Page: The main page of the platform that users interact with first.
• WCAG: Web Content Accessibility Guidelines, a standard for ensuring web accessibility.
• IST: Indian Standard Time, the timezone used in Mumbai, India.
• Alembic: A database migration tool for Python.

This document provides a comprehensive overview of the requirements for the magma-salon project. Let me know if there are any additional features or changes you'd like to incorporate, Faiyaz!