System Requirements Document (SRD) for mars-ev

1. Introduction

The mars-ev project is a premium, high-end EV financing platform tailored for the Indian market. It aims to revolutionize the EV financing experience by combining cutting-edge 3D visuals, smooth scrolling animations, and a modern fintech-inspired UI/UX. The platform will provide a seamless, trustworthy, and interactive experience for users seeking financing options for electric vehicles (EVs), including e-rickshaws, EV scooters, and commercial EVs.

This document outlines the system requirements for the mars-ev platform, ensuring alignment with the vision of Sudhanshu Arora and the unique needs of the Indian EV market. The final product will include a live link for easy sharing and showcasing.

2. System Overview

The mars-ev platform will serve as a one-stop solution for EV financing, offering features such as interactive 3D visuals, dynamic EMI calculators, and a fully digital loan application process. The system will cater to individual users, small business owners, and commercial fleet operators, providing tailored financing options for various EV types.

Key highlights of the system:

• Premium User Experience: Inspired by Apple and Tesla, with smooth animations, clean design, and interactive elements.
• Trustworthy Fintech Features: Fast approvals, low EMIs, and minimal documentation to build user confidence.
• Localized for India: INR currency, Indian cities, and EV types popular in the Indian market.
• Interactive 3D Visuals: Users can interact with rotating EV models and experience parallax storytelling.
• Live Link: A shareable live link will be provided upon completion for showcasing the platform.

3. Functional Requirements

• As a User, I should be able to view a fullscreen hero section with a rotating 3D EV model.
• As a User, I should be able to interact with the 3D EV model (rotate/zoom).
• As a User, I should experience smooth scrolling animations and parallax effects.
• As a User, I should be able to calculate my EMI dynamically using sliders for loan amount and tenure.
• As a User, I should be able to view loan products as floating glassmorphism cards.
• As a User, I should be able to apply for a loan through a high-conversion lead form.
• As a User, I should be able to toggle between light and dark modes.
• As a User, I should see animated icons and text that fade in as I scroll.
• As a User, I should be able to view testimonials in an auto-sliding carousel.
• As a User, I should see stats (e.g., ₹100Cr+ disbursed) that count up dynamically on scroll.
• As a User, I should be able to navigate through a step-by-step loan process animation.
• As a User, I should have access to a floating "Apply Now" button and a WhatsApp contact button.
• As a User, I should experience hover micro-interactions on buttons and cards.
• As a User, I should be able to view FAQs in an accordion format with smooth transitions.
• As a User, I should experience fast loading and mobile-first responsiveness.

4. User Personas

4.1 Individual EV Buyers

• Description: Individuals looking to purchase EV scooters or bikes for personal use.
• Needs: Low EMIs, fast approvals, and a simple application process.

4.2 Small Business Owners

• Description: Entrepreneurs seeking financing for e-rickshaws or small commercial EVs.
• Needs: Affordable financing options, minimal documentation, and wide coverage.

4.3 Commercial Fleet Operators

• Description: Businesses managing fleets of EVs for logistics or transportation.
• Needs: Bulk financing options, competitive interest rates, and tailored loan products.

5. Visuals Colors and Theme

Color Palette

• Background: #EAF4FF (soft blue for a clean, futuristic feel)
• Surface: #FFFFFF (pure white for cards and forms)
• Text: #1C1C1C (deep charcoal for readability)
• Accent: #007B5E (rich green for CTAs and highlights)
• Muted: #AAB8C2 (soft gray for secondary elements)

6. Signature Design Concept

Interactive 3D EV Experience

The mars-ev homepage will feature a fullscreen hero section with a rotating 3D EV model (e.g., an e-scooter or e-rickshaw). Users can interact with the model by rotating or zooming in/out, creating a sense of ownership and excitement.

As users scroll, the EV will appear to move forward in a parallax effect, accompanied by evolving text:

1. "Choose Your EV"
2. "Get Instant Approval"
3. "Drive & Earn"

The background will feature a dynamic gradient animation (shifting between green and blue tones) to evoke the eco-friendly and futuristic nature of EVs. Smooth fade-in animations and micro-interactions will enhance the premium feel.

Additional standout features:

• Glassmorphism Loan Cards: Floating cards with subtle 3D tilt and glow animations.
• Interactive EMI Calculator: Sliders with animated numbers and smooth transitions.
• Sticky Floating Elements: "Apply Now" button, WhatsApp contact button, and a scroll progress indicator.

7. Non-Functional Requirements

• Performance: The website must load in under 3 seconds on a 4G connection.
• Responsiveness: Fully optimized for mobile, tablet, and desktop devices.
• SEO: Structured H1, H2 tags, meta descriptions, and fast-loading assets.
• Accessibility: WCAG 2.1 compliance for inclusive design.
• Security: SSL encryption and secure handling of user data.

8. Tech Stack

Frontend

• React for Web
• React Native for mobile app

Backend

• Python
• FastAPI

Database

• MySQL (with Alembic for migrations)

AI Models

• GPT 5.4 for user-friendly responses
• Google Nano Banana for image generation

AI Tools

• Litellm for LLM Routing
• Langchain

Orchestration

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

9. Assumptions and Constraints

• The platform will primarily target Indian users, so all financial calculations will use INR.
• The 3D visuals will be optimized for modern browsers but may have limited functionality on older devices.
• The system will rely on third-party APIs for EMI calculations and loan processing.
• The live link will be hosted on a scalable cloud platform to ensure reliability.

10. Glossary

• EV: Electric Vehicle
• EMI: Equated Monthly Installment
• CTA: Call-to-Action
• WCAG: Web Content Accessibility Guidelines
• NBFC: Non-Banking Financial Company

This document provides a comprehensive foundation for the development of the mars-ev platform. Once the build is complete, you will receive a live link to share and showcase your premium EV financing platform. 🚀