BHATKE VIMUKT SS

Introduction

Bhatke Vimukt Samajik Sanstha (BVSS) is focused on creating a digital platform to streamline donations and manage outreach efforts. This document outlines the system requirements for the development of a comprehensive tool that supports both fundraising and operational needs.

System Overview

The platform will facilitate QR code donations, manage donor relationships, and provide event updates. It will serve both donors and the internal team, enhancing engagement and transparency.

Functional Requirements

• As a Donor, I should be able to make donations via QR code.
• As a Donor, I should receive updates on upcoming events.
• As an Admin, I should be able to manage donor information.
• As an Admin, I should be able to update event details.
• As a Team Member, I should be able to access donor management tools.

User Personas

• Donor: Individuals interested in contributing to the cause.
• Admin: Internal team members managing the platform.
• Team Member: Staff involved in operations and outreach.

Visuals Colors and Theme

• primary: #1A73E8 (Deep Blue)
• primary_light: #E8F0FE (Light Blue)
• secondary: #FF6F61 (Coral)
• accent: #FFD700 (Gold)
• highlight: #FFA500 (Orange)
• bg: #FFFFFF (White)
• surface: rgba(240, 240, 240, 0.8)
• text: #333333 (Dark Gray)
• text_muted: #777777 (Gray)
• border: rgba(200, 200, 200, 0.5)

Signature Design Concept

Interactive Donation Portal

The homepage will feature an interactive donation portal where users can drag and drop their donation amount into a virtual donation box. As the amount increases, a visual representation of the impact (e.g., a growing tree or expanding community) will animate on the screen. This concept will use framer-motion for smooth animations and gsap for scroll-triggered effects. The portal will also include a real-time donation counter that updates dynamically.

Interaction Model & Motion Direction

• Landing Page: Parallax

  • Layered depth with scroll-triggered animations.
  • Decorative elements like floating icons and dynamic counters.
  • Real content scrolls naturally with interactive elements.

• Internal Pages: Static

  • Focus on clarity and ease of navigation.
  • Minimal motion to enhance reading speed and data access.

Non-Functional Requirements

• The platform should be responsive and accessible on all devices.
• Ensure data security and privacy for all user information.
• Maintain high performance and quick load times.

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

Assumptions and Constraints

• The platform will primarily serve users in India.
• Internet connectivity is assumed for all users.
• The platform will comply with local data protection regulations.

Glossary

• QR Code: A machine-readable code used for making payments.
• Donor Management: Tools and processes for managing donor information and interactions.
• Parallax: A scrolling technique that creates an illusion of depth.