System Requirements Document (SRD)

Project Name: velvet-selamat

1. Introduction

The velvet-selamat project is designed to support the planning and execution of a Jamuan Hari Raya (Hari Raya Celebration Event). This document outlines the system requirements for a digital platform that facilitates event management, including invitations, RSVPs, menu planning, and activity scheduling. Inspired by the joyous and colorful spirit of Hari Raya, the system will incorporate vibrant visuals and user-friendly functionality to enhance the celebration experience.

2. System Overview

The velvet-selamat platform will serve as a centralized hub for organizing and managing Hari Raya events. It will cater to hosts, guests, and administrators, providing tools for:

• Sending digital invitations.
• Managing guest lists and RSVPs.
• Planning menus and activities.
• Sharing event details and updates.

The system will be accessible via web and mobile applications, ensuring convenience for users across devices.

3. Functional Requirements

As a Host:

• I should be able to create and customize digital invitations.
• I should be able to manage guest lists and track RSVPs.
• I should be able to plan and share the event menu.
• I should be able to schedule activities and share the itinerary.

As a Guest:

• I should be able to RSVP to an event.
• I should be able to view event details, including the menu and activities.
• I should be able to communicate dietary preferences or special requests.

As an Admin:

• I should be able to oversee multiple events.
• I should be able to manage user accounts and permissions.
• I should be able to generate reports on event participation and feedback.

4. User Personas

Host

• Description: Individuals or organizations planning a Hari Raya event.
• Goals: Streamline event organization, ensure guest satisfaction, and create memorable experiences.

Guest

• Description: Attendees of the Hari Raya event.
• Goals: Receive event details, RSVP conveniently, and enjoy the celebration.

Admin

• Description: Platform administrators responsible for system maintenance and user support.
• Goals: Ensure smooth operation of the platform and provide assistance to users.

5. Visuals Colors and Theme

Inspired by the reference image provided, the color palette reflects the vibrant and festive mood of Hari Raya:

• Background: #FDF5E6 (Creamy white)
• Surface: #FFD700 (Golden yellow)
• Text: #2F4F4F (Dark slate gray)
• Accent: #FF4500 (Orange-red)
• Muted Tones: #B0C4DE (Light steel blue)

This palette will be applied across the platform to maintain consistency and evoke the celebratory spirit.

6. Signature Design Concept

Interactive Festive Archway Homepage

The homepage will feature a 3D interactive archway inspired by traditional Hari Raya decorations, similar to the reference image. Users will "walk through" the archway to access different sections of the platform.

• Visuals: The archway will be adorned with floral patterns, vibrant colors, and draped fabric animations.
• Animations: Subtle movements of flowers and fabric will create a dynamic and welcoming effect.
• Interaction: Hovering over sections of the archway will reveal tooltips and clickable links to features like invitations, RSVPs, and menus.
• Micro-interactions: Buttons and links will have festive sparkles and sound effects, enhancing the celebratory mood.

This design will make the platform instantly engaging and memorable, aligning with the joyous spirit of Hari Raya.

7. Non-Functional Requirements

• The system must support both web and mobile platforms.
• The platform should be optimized for high performance, ensuring fast load times.
• Data security and privacy must be prioritized, especially for guest information.
• The system should be scalable to accommodate large events.

8. Tech Stack

Frontend

• React for Web
• React Native for Mobile

Backend

• Python
• FastAPI

Database

• MySQL (preferred)
• Alembic for migrations

AI Models

• GPT 5.4 for user-friendly responses

AI Tools

• Langchain
• Litellm for LLM Routing

Orchestration

• Docker
• Kubernetes

9. Assumptions and Constraints

• The platform will primarily target users in Malaysia (MY).
• The system will operate in the MYT timezone.
• The platform will support both Bahasa Malaysia and English languages.
• Internet connectivity is required for accessing the platform.

10. Glossary

• Jamuan Hari Raya: A festive gathering to celebrate Hari Raya Aidilfitri.
• RSVP: Répondez s'il vous plaît, a request for guests to confirm attendance.
• Admin: A user with elevated permissions to manage the platform.
• Host: The organizer of the event.
• Guest: An attendee of the event.