System Requirements Document (SRD) for spicy-temple

1. Introduction

The spicy-temple project is a digital platform dedicated to showcasing the divine experience of Shri Siddheshwar Nath Dham, a sacred Shiva temple. This platform aims to provide devotees with a seamless way to connect with the temple, participate in live darshan, make donations, and explore the temple's rich heritage through an interactive and visually captivating website.

This document outlines the system requirements for the spicy-temple project, ensuring that the platform meets the needs of its users while maintaining a high standard of usability and performance.

2. System Overview

The spicy-temple platform will serve as a central hub for devotees to:

• Access live darshan of the temple.
• Learn about the temple's history, aarti timings, and other details.
• Make online donations securely.
• Explore a gallery of temple images and videos.
• Locate the temple using an embedded Google Map.

The platform will be optimized for both desktop and mobile users, ensuring accessibility for devotees across India and beyond. It will feature a visually rich design inspired by the sacred and auspicious tones of Indian temples, with a focus on gold, saffron, and divine imagery.

3. Functional Requirements

As a User:

• I should be able to view live darshan of the temple.
• I should be able to learn about the temple's history and aarti timings.
• I should be able to make secure online donations.
• I should be able to view a gallery of temple images and videos.
• I should be able to locate the temple using an embedded Google Map.

As an Admin:

• I should be able to upload and manage gallery images and videos.
• I should be able to update aarti timings and temple information.
• I should be able to manage donation records and transactions.

4. User Personas

1. Devotee

• Description: Regular visitors and devotees of Shri Siddheshwar Nath Dham who seek spiritual connection through live darshan, donations, and temple information.
• Goals: Access live darshan, participate in donations, and stay updated on temple activities.
• Technical Proficiency: Basic to moderate.

2. Admin

• Description: Temple staff or authorized personnel responsible for managing the website's content and donation records.
• Goals: Ensure the website is up-to-date and functioning smoothly.
• Technical Proficiency: Moderate to advanced.

5. Visuals Colors and Theme

The spicy-temple project will use a unique color palette inspired by the sacred and divine tones of Indian temples:

• Background: #0D0D0D (Deep Black for mysticism)
• Surface: #1A1A1A (Charcoal Gray for subtle contrast)
• Text: #FFFFFF (Pure White for readability)
• Accent: #FFD700 (Gold for divinity and auspiciousness)
• Muted Tones: #FF9933 (Saffron for spiritual energy)

6. Signature Design Concept

"A Divine Portal to Shri Siddheshwar Nath Dham"

The homepage will feature an immersive parallax scrolling experience that transports users into the temple's divine ambiance. Here's how it will work:

1. Header Section:

   • A full-screen background image of the temple with a golden glow effect emanating from the temple's spire.
   • The title "श्री सिद्धेश्वर नाथ धाम" will appear in golden Devanagari script, with a subtle shimmering animation.
   • Two prominent buttons: "Live Darshan" and "Donate Now," with a glowing saffron hover effect.

2. Interactive Gallery:

   • A carousel of temple images that users can swipe or click through.
   • Each image will have a zoom-in hover effect and a brief caption in both Hindi and English.

3. Aarti Timings Section:

   • A dynamic clock animation that highlights the next aarti time in real-time.

4. Donation Section:

   • A floating QR code with a pulsating golden border, encouraging users to scan and donate.
   • A progress bar showing the current donation goal and amount raised.

5. Location Section:

   • An embedded Google Map with a glowing saffron pin marking the temple's location.
   • A button to get directions directly in Google Maps.

6. Footer:

   • A scrolling ticker with devotional quotes and temple updates.

This design will make the website feel alive, sacred, and deeply engaging for users.

7. Non-Functional Requirements

• The website must load within 3 seconds on a 4G connection.
• The platform must be mobile-responsive and accessible on all major browsers.
• All donation transactions must be secure and comply with Indian financial regulations.
• The website must support both Hindi and English languages.

8. Tech Stack

Frontend:

• React for Web

Backend:

• Python
• FastAPI

Database:

• MySQL (with Alembic for migrations)

AI Tools:

• Litellm for LLM Routing
• Langchain

Local Orchestration:

• Docker
• docker-compose

Server-Side Orchestration:

• Kubernetes

9. Assumptions and Constraints

• The platform will primarily cater to an Indian audience, with Hindi and English as the supported languages.
• The donation system will integrate with Indian payment gateways (e.g., Razorpay, Paytm).
• The website will host high-resolution images and videos, requiring a robust hosting solution.

10. Glossary

• Darshan: The act of seeing and being seen by a deity or sacred object.
• Aarti: A Hindu religious ritual of worship involving light from wicks soaked in ghee or camphor.
• QR Code: A machine-readable code used for quick access to information or payment systems.
• Parallax Scrolling: A web design technique where background images move slower than foreground images, creating a 3D effect.