System Requirements Document (SRD)
Project Name: clever-whatsapp
1. Introduction
Welcome to the System Requirements Document for clever-whatsapp, a WhatsApp-based AI-governed investment and financial distribution platform. This document outlines the system's architecture, functional and non-functional requirements, user personas, visual design concepts, and technical specifications.
The platform is designed to revolutionize financial services in India, leveraging WhatsApp's widespread adoption and AI-driven orchestration to deliver mutual funds, broking, lending, insurance, and payment solutions seamlessly. Meghna Rajawat, based in India, envisions this platform as a secure, scalable, and compliant solution tailored to the Indian financial landscape.
2. System Overview
clever-whatsapp is a WhatsApp-first financial orchestration platform governed by AI. It enables secure distribution and execution of financial products through conversational interfaces.
Key integrations include:
- Mutual Funds: NSE NMF II, BSE StAR MF
- Broking APIs: Angel One SmartAPI
- Lending Infrastructure: FinBox, Decentro
- Insurance APIs: Digit, Acko
- KYC & Identity APIs: Aadhaar eKYC, CIBIL, Account Aggregator, CKYC
- Payment Infrastructure: UPI, Razorpay, NACH
At its core, the platform features an AI-driven orchestration engine for intent recognition, workflow routing, escalation management, and compliance-safe interaction handling. It is modular, phase-driven, and designed for long-term scalability.
3. Functional Requirements
As story points:
- As a User, I should be able to onboard using Aadhaar eKYC.
- As a User, I should be able to invest in mutual funds via SIP or lump sum.
- As a User, I should be able to redeem mutual fund investments.
- As a User, I should be able to view and manage my broking portfolio.
- As a User, I should be able to apply for loans and check eligibility.
- As a User, I should be able to request insurance quotes and issue policies.
- As a User, I should be able to make payments via UPI and Razorpay.
- As an Admin, I should be able to monitor KYC status and transaction logs.
- As an Admin, I should be able to manage Relationship Manager (RM) assignments.
- As an Admin, I should be able to override workflows manually when needed.
- As a User, I should be able to selectively re-run and regenerate the System Requirements Document (SRD).
4. User Personas
1. User
- Primary customer interacting via WhatsApp.
- Needs seamless access to financial products and services.
- Expects secure, compliant, and user-friendly workflows.
2. Admin
- Responsible for monitoring system operations.
- Manages KYC, transaction logs, and RM assignments.
- Ensures compliance and handles escalations.
3. Relationship Manager (RM)
- Provides personalized assistance to users.
- Handles escalations flagged by the AI engine.
- Manages high-value transactions and distressed users.
5. Visuals Colors and Theme
The visual theme for clever-whatsapp will focus on a clean and professional aesthetic, emphasizing trust and clarity. Based on Meghna's request, the updated color palette is:
Primary Colors:
- White (#FFFFFF) for clarity, simplicity, and a clean interface.
Secondary Colors:
- Light Gray (#F5F5F5) for subtle accents and neutral tones.
- Black (#000000) for text and contrast.
The WhatsApp interface will retain its familiar green accents for user comfort and recognition, while integrating the white and gray palette for a cohesive experience. Blue has been completely removed from the design as per Meghna's preference.
6. Signature Design Concept
Interactive Financial Canvas Homepage
The homepage will resemble a dynamic financial canvas, symbolizing simplicity, clarity, and interconnectedness. The design will feature interactive animations that evolve as users navigate the platform.
- Animations: Sections of the canvas (representing mutual funds, broking, lending, insurance, payments) will "paint themselves" in real-time as users scroll or interact.
- Transitions: Smooth transitions between sections, with canvas strokes morphing into detailed charts, graphs, and product information.
- Micro-Interactions: Hovering over a section highlights it with subtle glowing gray accents, while clicking opens a detailed view with actionable buttons (e.g., "Invest Now," "Apply for Loan").
- Color Shifts: The background remains predominantly white, with light gray accents dynamically highlighting active sections.
This concept creates an unforgettable first impression, blending innovation with functionality while visually reinforcing the platform's theme of simplicity and trust.
7. Non-Functional Requirements
- Scalability: Support millions of users concurrently.
- Security: Implement field-level encryption and immutable audit logs.
- Compliance: Adhere to Indian financial regulations (SEBI, IRDAI, RBI).
- Performance: Ensure low latency for AI responses and transaction processing.
- Reliability: Guarantee failover capabilities and rail redundancy.
8. Tech Stack
Frontend:
- React for Web
- React Native for Mobile App
Backend:
Database:
- MySQL or MariaDB (with Alembic for migrations)
AI Models:
- GPT 5.2 for user-friendly responses
- Claude 4.5 Opas for academic or coding work
- Gemini 3 Pro for friendly responses
- Google Nano Banana for image generation
AI Tools:
- Litellm for LLM Routing
- Langchain
Local Orchestration:
Server-Side Orchestration:
9. Assumptions and Constraints
Assumptions:
- Users are familiar with WhatsApp and basic financial concepts.
- Aadhaar eKYC is widely adopted in India.
- UPI is the preferred payment method for most users.
Constraints:
- Compliance with Indian financial regulations is mandatory.
- WhatsApp Business API limits certain functionalities.
- AI decisions must be auditable and deterministic.
10. Glossary
- AI: Artificial Intelligence
- KYC: Know Your Customer
- RM: Relationship Manager
- UPI: Unified Payments Interface
- NACH: National Automated Clearing House
- SEBI: Securities and Exchange Board of India
- IRDAI: Insurance Regulatory and Development Authority of India
- RBI: Reserve Bank of India
This document provides a comprehensive overview of the clever-whatsapp platform, ensuring clarity and alignment for all stakeholders. Meghna, your vision is inspiring, and this SRD is tailored to bring it to life! 🚀
No comments yet. Be the first!