System Requirements Document (SRD)

Project Name: calm-calling

1. Introduction

The calm-calling project is an AI-powered calling assistant designed to automate client outreach and sales conversations for website services. This system leverages advanced AI technologies to provide natural, human-like interactions, enabling businesses to scale their sales efforts efficiently. The project is tailored for the Indian market, with features like multi-language support (including Hindi and regional tones) and dynamic pricing in INR.

This document outlines the system requirements for the calm-calling project, including functional and non-functional requirements, user personas, design concepts, and technical specifications.

2. System Overview

The calm-calling system is a web application that automates sales calls to potential clients. It integrates AI-driven voice interaction, dynamic pricing strategies, and multi-language support to deliver a professional and engaging sales experience. The system includes a user-friendly dashboard for managing calls, tracking call history, and monitoring performance.

Key features include:

• Automated AI voice calls with natural speech.
• Smart sales conversations tailored to client needs.
• Multi-language support for English, Hindi, and regional tones.
• Dynamic pricing pitches to drive conversions.
• Safety controls to ensure ethical usage.

The system is designed to be intuitive, scalable, and compliant with local regulations.

3. Functional Requirements

• As a User, I should be able to input a phone number for the AI to call.
• As a User, I should be able to start and stop calls using a "Start Calling" button.
• As a User, I should see real-time call status updates (e.g., Calling, Talking, Ended).
• As a User, I should be able to view call logs and history.
• As a User, I should be able to approve calls manually before they are made.
• As a User, I should be able to limit the number of calls made per day.
• As a User, I should hear the AI introduce itself and explain the benefits of having a website.
• As a User, I should hear the AI handle objections and provide convincing responses.
• As a User, I should hear the AI offer dynamic pricing between ₹1999 and ₹4999.
• As a User, I should hear the AI create urgency with limited-time offers.
• As a User, I should hear the AI ask for WhatsApp details or a meeting if I am interested.
• As a User, I should hear the AI politely end the call if I am not interested.
• As a User, I should be able to interact with the AI in English, Hindi, or a regional tone.
• As a User, I should experience smooth text-to-speech and speech-to-text interactions.

4. User Personas

4.1 Business Owner

• Description: Small business owners looking to expand their online presence.
• Goals: Understand the benefits of having a website and make an informed decision.
• Pain Points: Limited technical knowledge, budget constraints.

4.2 Sales Manager

• Description: Sales professionals managing outreach campaigns.
• Goals: Automate client outreach and track performance.
• Pain Points: Time constraints, need for scalable solutions.

4.3 Admin

• Description: System administrators managing the application.
• Goals: Ensure ethical use and monitor system performance.
• Pain Points: Compliance with regulations, system reliability.

5. Visuals Colors and Theme

Color Palette

• Background: #EAF7FF (Light Aqua Blue)
• Surface: #FFFFFF (Pure White)
• Text: #1F2933 (Charcoal Gray)
• Accent: #FF7A59 (Bright Tangerine)
• Muted: #A3B3C3 (Soft Steel Blue)

Theme

The theme is clean, modern, and professional, reflecting the system's focus on efficiency and reliability. The bright tangerine accent adds a touch of energy and enthusiasm, while the light aqua blue background creates a calming and approachable atmosphere.

6. Signature Design Concept

The calm-calling homepage will feature an immersive AI Call Simulation Experience.

Concept Details:

• Interactive Call Flow Visualization: The homepage will display an animated call flow diagram that dynamically updates as users explore features. For example, hovering over "Greeting" will show a snippet of the AI's introduction, while "Objection Handling" will display a sample response.
• 3D Rotating Phone Icon: A central 3D phone icon will rotate slowly, symbolizing the AI's calling capabilities. Clicking on it will trigger a demo call simulation.
• Language Selector Animation: A dropdown menu with animated flags will allow users to select their preferred language. Selecting a language will smoothly transition the interface to that language.
• Micro-interactions: Buttons and icons will have subtle hover effects, such as glowing edges or slight enlargements, to enhance user engagement.
• Dynamic Background: The background will feature a gradient animation that shifts between calming blues and energizing oranges, reflecting the balance between professionalism and approachability.

This design will create a memorable first impression and showcase the system's advanced capabilities.

7. Non-Functional Requirements

• The system should support at least 100 concurrent users.
• The system should have a response time of less than 2 seconds for all interactions.
• The system should comply with local telecommunication regulations in India.
• The system should ensure data security and privacy, adhering to GDPR and Indian IT Act guidelines.
• The system should be accessible on both desktop and mobile devices.

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 coding and academic tasks
• Gemini 3.1 Pro for friendly responses

AI Tools

• Litellm for LLM Routing
• Langchain

Orchestration

• Docker for local orchestration
• Kubernetes for server-side orchestration

9. Assumptions and Constraints

• The system assumes users have basic knowledge of operating a web application.
• The system assumes access to reliable internet for API calls and AI interactions.
• The system is constrained by the capabilities of the selected APIs (e.g., Twilio, OpenAI).
• The system is constrained to operate within the Indian telecommunication framework.

10. Glossary

• AI: Artificial Intelligence.
• TTS: Text-to-Speech.
• STT: Speech-to-Text.
• API: Application Programming Interface.
• LLM: Large Language Model.
• Dashboard: The user interface for managing and monitoring the system.
• Twilio: A cloud communications platform for making calls.