System Requirements Document (SRD) for epic-salon

1. Introduction

The epic-salon project is a comprehensive solution designed to empower Karan Baid's salon business in India. This project combines a robust Customer Relationship Management (CRM) system with a professional, marketing-focused website. The goal is to streamline salon operations, enhance customer engagement, and attract new clientele through a modern online presence.

This document outlines the system requirements for the epic-salon project, detailing its functional and non-functional aspects, user personas, design concepts, and technical specifications.

2. System Overview

The epic-salon project consists of two primary components:

1. CRM System: A tool to manage salon operations efficiently, including appointment scheduling, client history tracking, automated reminders, and loyalty programs.
2. Professional Website: A visually appealing and user-friendly website that highlights salon services, enables online booking, and incorporates marketing features to promote offers and build the salon's brand.

The system is tailored to the Indian market, considering local preferences, currency (INR), and timezone (IST). It aims to provide a seamless experience for both salon staff and customers.

3. Functional Requirements

CRM System

• As a Salon Owner, I should be able to schedule and manage appointments.
• As a Salon Owner, I should be able to track client history, including past appointments and preferences.
• As a Salon Owner, I should be able to send automated reminders to clients for upcoming appointments.
• As a Salon Owner, I should be able to manage a loyalty or reward program to retain customers.

Website

• As a Customer, I should be able to view the salon's services and pricing.
• As a Customer, I should be able to book appointments online.
• As a Customer, I should be able to view promotional offers and discounts.
• As a Customer, I should be able to contact the salon through the website.

4. User Personas

1. Salon Owner

• Role: Manages the salon's operations and oversees customer engagement.
• Goals: Streamline operations, retain customers, and grow the business.
• Pain Points: Manual appointment management, lack of customer insights, and difficulty in marketing.

2. Customer

• Role: Avails salon services and interacts with the website for bookings and inquiries.
• Goals: Convenient booking, access to salon information, and personalized service.
• Pain Points: Difficulty in booking appointments and lack of awareness about offers.

5. Visuals Colors and Theme

The epic-salon project will use a unique, modern color palette that reflects the elegance and professionalism of the salon industry. The colors are designed to evoke trust, sophistication, and warmth.

• Background: #F5F5F5 (Soft Pearl White)
• Surface: #FFFFFF (Pure White)
• Text: #333333 (Charcoal Black)
• Accent: #FF6F61 (Coral Red)
• Muted Tones: #B0BEC5 (Slate Gray)

This palette ensures a clean and professional look while adding a touch of vibrancy with the coral red accent.

6. Signature Design Concept

Interactive Mirror Homepage

The homepage of the epic-salon website will feature an Interactive Mirror design concept. Upon landing on the website, users will see a virtual mirror with a subtle, reflective surface. As users move their cursor across the screen, the mirror will respond with a soft glow, mimicking the effect of light reflecting off a real mirror.

Key features of the Interactive Mirror:

• Dynamic Animations: The mirror will display subtle animations, such as shimmering light effects and soft ripples, creating a luxurious and engaging experience.
• Service Highlights: Key services will appear as floating icons on the mirror, which expand into detailed descriptions when hovered over.
• Personalized Greeting: The mirror will display a personalized message, such as "Welcome to epic-salon, Karan!" for returning users or "Discover Your Style" for new visitors.
• Interactive Booking: Users can "tap" on the mirror to open the booking system, which will appear as a sleek overlay.

This unique design will leave a lasting impression on visitors, setting the salon apart from competitors.

7. Non-Functional Requirements

• The system should support high availability with 99.9% uptime.
• The website should load within 2 seconds on a standard 4G connection.
• The CRM system should handle up to 10,000 customer records efficiently.
• The system should comply with data protection regulations applicable in India.
• The website should be optimized for mobile and desktop devices.

8. Tech Stack

Frontend

• React for Web
• React Native for Mobile App

Backend

• Python
• FastAPI

Database

• MySQL (with Alembic for migrations)

AI Models

• GPT 5.4 for user-friendly responses
• Google Nano Banana for image generation

AI Tools

• Langchain
• Litellm for LLM Routing

Orchestration

• Docker and docker-compose for local development
• Kubernetes for server-side orchestration

9. Assumptions and Constraints

Assumptions

• The salon operates in the Indian timezone (IST).
• The primary currency for transactions is INR.
• Customers are familiar with basic online booking systems.

Constraints

• The system must be scalable to accommodate future growth.
• The design must adhere to the salon's branding guidelines.
• The CRM system must integrate seamlessly with the website.

10. Glossary

• CRM: Customer Relationship Management
• IST: Indian Standard Time
• INR: Indian Rupee
• Frontend: The part of the system that users interact with directly.
• Backend: The server-side logic and database management.
• AI: Artificial Intelligence
• LLM: Large Language Model