System Requirements Document (SRD)

Project Name: sky-groom

1. Introduction

The sky-groom project is a digital wedding invitation website designed to celebrate the union of Rishabh Sonpure and Diksha Binjwe. The couple is getting married on 5th December, with pre-wedding festivities including a Haldi function on 3rd December and a Mehendi function on 4th December. This website aims to provide an engaging, visually appealing, and user-friendly experience for guests to access all relevant wedding details, including event timelines, locations, and celebratory visuals.

This document outlines the system requirements for the sky-groom project, ensuring the final product meets the expectations of the user, Daksh Chouhan, and provides a delightful experience for all visitors.

2. System Overview

The sky-groom website will serve as a digital wedding invitation platform, offering:

• A visually stunning and interactive design to reflect the joyous occasion.
• Smooth slides showcasing the couple's names, event details, and photos.
• Embedded Google Maps for easy navigation to event venues.
• Placeholder images for now, which can later be replaced with real photos.
• A selective re-run capability for regenerating the System Requirements Document (SRD) based on user-triggered updates.

The website will be purely informational, without RSVP functionality, and will focus on delivering a celebratory and immersive experience for guests.

3. Functional Requirements

The following functional requirements are defined as story points:

• As a Guest, I should be able to view the couple's names and wedding date prominently on the homepage.
• As a Guest, I should be able to navigate through interactive slides showcasing the event details.
• As a Guest, I should be able to view the timeline of events (Haldi on 3rd Dec, Mehendi on 4th Dec, Wedding on 5th Dec).
• As a Guest, I should be able to see placeholder photos for each event.
• As a Guest, I should be able to access Google Maps for the event locations directly from the website.
• As a Guest, I should experience smooth animations and transitions while browsing the website.
• As a User, I should be able to trigger a selective re-run capability to regenerate the System Requirements Document (SRD) when updates are needed.

4. User Personas

4.1 Guest

• Description: Individuals invited to the wedding who will use the website to access event details and locations.
• Goals:
  • View the wedding timeline and event details.
  • Access Google Maps for navigation.
  • Enjoy an engaging and visually appealing experience.

4.2 User (Daksh Chouhan)

• Description: The project owner who will manage the website and ensure it meets the requirements.
• Goals:
  • Ensure the website reflects the celebratory and elegant theme.
  • Trigger updates to the SRD when necessary using the selective re-run capability.
  • Replace placeholder images with real photos closer to the wedding date.

5. Visuals Colors and Theme

The sky-groom website will feature a vibrant and celebratory color palette to reflect the joyous occasion of a wedding. The colors are designed to evoke warmth, happiness, and elegance.

Color Palette

• Background: #FFF8E7 (Soft Cream)
• Surface: #FFDAB9 (Peach Puff)
• Text: #4A2C2A (Rich Cocoa)
• Accent: #FF6F61 (Coral Red)
• Muted Tones: #BFA89E (Muted Taupe)

This palette combines soft, warm tones with vibrant accents to create a festive yet elegant aesthetic.

6. Signature Design Concept

The sky-groom website will feature a "Storybook Wedding Journey" homepage design.

Concept Details:

• Interactive Storybook Slides: The homepage will resemble a storybook, with each "page" representing a key moment or event. Users can "flip" through the pages using smooth swipe or click animations.
• Dynamic Visuals:
  • The first page will feature an animated introduction with the couple's names, wedding date, and a subtle confetti animation.
  • Subsequent pages will showcase the Haldi, Mehendi, and Wedding events with placeholder photos, event details, and soft background music.
• Google Maps Integration: Each event page will include a "Find Location" button that opens an embedded Google Map for the venue.
• Subtle Animations: Elements like text and photos will fade in and out as users navigate through the slides, creating a seamless and immersive experience.
• Festive Flourishes: Decorative motifs like floral patterns, mehendi designs, and golden accents will frame the content, adding a celebratory touch.

This design will make the website feel like a personal and magical journey through the couple's wedding story.

7. Non-Functional Requirements

• The website must load within 3 seconds on standard broadband connections.
• The design must be responsive and optimized for both desktop and mobile devices.
• Animations and transitions must be smooth and not exceed 1 second in duration.
• Google Maps integration must be functional and accurate.
• Placeholder images must be easily replaceable with real photos.
• The selective re-run capability for the SRD must be user-friendly and allow updates without disrupting existing content.

8. Tech Stack

Frontend

• React for web development.

Backend

• Python with FastAPI for server-side logic.

Database

• MySQL for storing event details and other static content.

AI Tools

• Google Nano Banana for placeholder image generation (if required).

Local Orchestration

• Docker and docker-compose for containerization.

Server-Side Orchestration

• Kubernetes for deployment and scalability.

9. Assumptions and Constraints

Assumptions

• The website will not include RSVP functionality.
• Placeholder images will be used initially and replaced later with real photos.
• The user, Daksh Chouhan, will provide final images and event details closer to the wedding date.
• The selective re-run capability will be used to update the SRD as needed.

Constraints

• The website must be completed and deployed before the wedding date (5th December).
• The design must align with the celebratory and elegant theme specified by the user.

10. Glossary

• Interactive Slides: A series of web pages or sections that users can navigate through with animations or transitions.
• Placeholder Images: Temporary images used in the design until real photos are provided.
• Google Maps Integration: Embedding Google Maps into the website to provide location details.
• Responsive Design: A design approach that ensures the website looks and functions well on devices of all sizes.
• Selective Re-Run Capability: A feature that allows the user to regenerate the SRD based on updates or changes without impacting existing content.
• Docker: A platform for developing, shipping, and running applications in containers.
• Kubernetes: An open-source system for automating deployment, scaling, and management of containerized applications.