System Requirements Document (SRD)

Project Name: green-voiceflow

1. Introduction

The green-voiceflow project, envisioned by Chittuluri Sathvika, is a full-stack AI-powered voice automation SaaS website designed to help businesses handle missed calls automatically using AI. This premium web application will provide a seamless user experience with modern design principles, including a dark theme, gradients, glassmorphism cards, and smooth animations. The platform aims to impress users and judges alike, making it ideal for hackathon demonstrations and real-world business applications.

The system will cater to businesses across India (IN) and globally, ensuring responsiveness, scalability, and ease of use. Locale-specific considerations such as timezone (IST) and currency (INR) will be integrated where applicable.

2. System Overview

The green-voiceflow system is a SaaS platform that automates missed call handling for businesses using AI. The flow begins with a customer call, which is either handled or missed. AI processes the missed calls and generates actionable leads, updating the dashboard in real time.

Key features include:

• A visually rich landing page to attract users.
• A demo page for showcasing the product's capabilities.
• A premium dashboard for analytics and insights.
• Real-time updates and notifications for seamless user interaction.
• Voice simulation for demonstrating AI capabilities.

The system will be built as a responsive website optimized for both desktop and mobile users, ensuring accessibility across devices.

3. Functional Requirements

As User:

• I should be able to log in using email and password.
• I should be able to view a landing page with a hero section, features, and pricing preview.
• I should be able to try a live demo of the product.
• I should be able to simulate incoming calls, missed calls, callbacks, and bookings on the demo page.
• I should be able to view real-time updates on the dashboard.
• I should be able to access call history on the calls page.
• I should be able to view leads generated on the leads page.
• I should be able to analyze summary stats on the analytics page.
• I should be able to configure settings on the settings page.

As Admin:

• I should be able to access backend APIs for managing calls, leads, and dashboard stats.
• I should be able to monitor real-time polling for updates.

4. User Personas

1. Small Business Owners

• Primary users of the platform.
• Need a simple and effective way to manage missed calls and convert them into leads.
• Require real-time insights into call performance and lead generation.

2. Customer Service Teams

• Secondary users who handle customer interactions.
• Require tools to monitor call sentiment and satisfaction levels.

3. Hackathon Judges

• Temporary users for demo purposes.
• Require a visually impressive UI and seamless functionality to evaluate the product.

5. Visuals Colors and Theme

Color Palette:

• Background: #121212 (Dark Charcoal)
• Surface: #1E1E2F (Deep Indigo)
• Text: #E0E0E0 (Soft Silver)
• Accent: #4CAF50 (Emerald Green)
• Muted Tones: #757575 (Muted Gray)

Theme:

The website will feature a dark theme with gradients and glassmorphism cards. Rounded corners, shadows, and smooth hover effects will enhance the visual appeal. Icons will be used extensively for navigation and interaction, ensuring a modern and intuitive user experience.

6. Signature Design Concept

Interactive Galaxy Dashboard

The homepage will feature an interactive galaxy map where each star represents a feature or section of the website. As users hover over a star, it will expand and display a brief description of the feature. Clicking on a star will zoom into that section, revealing its content in a visually stunning way.

Key Features:

• Animations: Stars will twinkle and pulse gently, creating a dynamic and engaging experience.
• Transitions: Smooth zoom-in and zoom-out effects when navigating between sections.
• Color Shifts: The galaxy background will subtly change colors based on the time of day (e.g., deep blue at night, soft purple at dawn).
• Micro-Interactions: Hovering over stars will trigger tooltips with feature descriptions.

This design will make the homepage unforgettable, leaving a lasting impression on users and hackathon judges.

7. Non-Functional Requirements

• Performance: The website must load within 3 seconds on standard broadband connections.
• Scalability: The system should handle up to 10,000 concurrent users.
• Security: Implement HTTPS and secure authentication mechanisms.
• Accessibility: Ensure WCAG 2.1 compliance for users with disabilities.
• Localization: Default timezone set to IST and currency to INR.

8. Tech Stack

Frontend:

• React for Web

Backend:

• Python
• FastAPI

Database:

• MySQL (with Alembic for migrations)

AI Models:

• GPT 5.4 for user-friendly responses
• Claude 4.6 Opas for academic or coding work

AI Tools:

• Litellm for LLM Routing
• Langchain

Local Orchestration:

• Docker
• docker-compose

Server-Side Orchestration:

• Kubernetes

9. Assumptions and Constraints

• The system will primarily target desktop users but will be responsive for mobile devices.
• Real-time polling will be used for updates, with a polling interval of 2 seconds.
• Data storage will use JSON or SQLite for simplicity during the demo phase.

10. Glossary

• AI: Artificial Intelligence, used for automating tasks such as call handling and lead generation.
• SaaS: Software as a Service, a cloud-based software delivery model.
• Glassmorphism: A design style featuring translucent surfaces with a frosted-glass effect.
• WCAG: Web Content Accessibility Guidelines, standards for making web content accessible.
• IST: Indian Standard Time, the timezone used in India.

This document outlines the comprehensive requirements for the green-voiceflow project, ensuring clarity and alignment with the user's vision.