VedicVibe System Requirements Document

1. Introduction

VedicVibe is a spiritual wellness progressive web application (PWA) designed to provide users with free birth charts and horoscopes. Users can also purchase personalized written guidance from Vedic Astrologers based in Nepal for a fee. The platform aims to cater to a global audience, offering features such as anonymous queries and a chat function for detailed astrological consultations.

2. System Overview

VedicVibe is a feature-rich application that combines spiritual wellness with modern technology. It provides users with personalized astrological insights and guidance. The application supports both free and paid services, with the first query being free and subsequent queries requiring a payment of $4.99. The platform includes an anonymous feature for users who wish to ask questions without revealing their identity. Additionally, a chat feature is integrated within the app, allowing users to interact with astrologers and receive detailed responses within 20-24 hours.

3. Functional Requirements

• As a User, I should be able to receive a free birth chart and horoscope.
• As a User, I should be able to purchase personalized written guidance from Vedic Astrologers for $4.99.
• As a User, I should be able to ask one free query and pay for additional queries.
• As a User, I should be able to ask questions anonymously.
• As a User, I should be able to use a chat feature within the app to ask questions.
• As an Astrologer, I should be able to respond to user queries within 20-24 hours.

4. User Personas

• User: Individuals seeking spiritual guidance and astrological insights.
• Astrologer: Vedic Astrologers providing personalized guidance and responding to user queries.

5. Core User Flows

• User accesses the app -> receives free birth chart and horoscope -> asks a free query -> pays for additional queries -> uses chat feature to ask questions -> receives detailed response from astrologer.
• Astrologer logs into the app -> reviews user queries -> provides detailed responses within 20-24 hours.

6. Visuals Colors and Theme

• primary: #4B0082 (Indigo)
• primary_light: #9370DB (Medium Purple)
• secondary: #FF4500 (Orange Red)
• accent: #32CD32 (Lime Green)
• highlight: #FFD700 (Gold)
• bg: #F5F5F5 (White Smoke)
• surface: rgba(255, 255, 255, 0.8)
• text: #000000 (Black)
• text_muted: #696969 (Dim Gray)
• border: rgba(0, 0, 0, 0.1)

7. Signature Design Concept

The VedicVibe homepage will feature an interactive celestial map where users can explore different constellations. Each constellation represents a section of the app, such as birth charts, horoscopes, and personal guidance. Users can click on a constellation to navigate to the respective section. The map will be animated using @react-three/fiber and @react-three/drei to create a 3D experience. Hovering over a constellation will display a brief description, and clicking will initiate a smooth transition to the selected feature. This interactive map will provide an engaging and immersive experience, reflecting the spiritual and cosmic theme of VedicVibe.

8. Interaction Model & Motion Direction

The landing page will utilize a "parallax" interaction model, creating a sense of depth as users scroll through the content. Decorative layers, such as stars and constellations, will move at different speeds to enhance the visual storytelling. Internal pages, such as the chat and guidance sections, will adopt a "static" interaction model to ensure clarity and ease of use.

9. Non-Functional Requirements

• The application must support high availability to cater to a global audience.
• Response time for user queries should not exceed 24 hours.
• The platform should ensure data privacy and security, especially for anonymous queries.

10. Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB
• AI Models: GPT 5.4 for user-friendly responses
• AI Tools: Litellm for LLM Routing
• Local Orchestration: Docker, docker-compose
• Server-side Orchestration: Kubernetes

11. Assumptions and Constraints

• The application will primarily target users interested in Vedic astrology and spiritual wellness.
• The platform must comply with international data protection regulations.
• Payment processing will be handled through a secure third-party service.

12. Glossary

• PWA: Progressive Web Application
• Vedic Astrology: A system of astrology with roots in the Vedic traditions of India.
• Astrologer: A practitioner of astrology who provides insights based on celestial observations.