epic-investment

Introduction

The "epic-investment" project aims to design and build a mobile-first, lovable, friendly, and trustworthy investment app/website. The platform will allow users to invest, earn daily returns, track their team, and invite friends. The design will reflect the warmth and approachability associated with Patanjali products, using a colorful and inviting user interface.

System Overview

The epic-investment platform will cater to a diverse audience, including teenagers and high-net-worth individuals (ICH). It will provide a seamless experience for users to manage their investments, track earnings, and engage with a referral system. The system will include user-friendly features such as simple registration, investment plans, daily returns tracking, and an admin panel for management.

Functional Requirements

• As a User, I should be able to register/login using email or phone number with OTP.
• As a User, I should be able to manage my profile, including name, display picture, and wallet balance.
• As a User, I should be able to view and invest in long-term and VIP plans with details like plan name, price, daily return, duration, and total return.
• As a User, I should be able to see my daily earnings and current balance automatically calculated.
• As a User, I should be able to use a multi-level referral system to earn commissions and track team size and earnings.
• As a User, I should be able to invite friends using copy and share buttons with micro-interactions. All prices should be displayed in Indian Rupees (INR).
• As a User, I should be able to request withdrawals with a minimum amount and view withdrawal history.
• As an Admin, I should be able to manage users, plans, payments, daily return percentages, and commission percentages.
• As an Admin, I should be able to view a dashboard with total users, investments, withdrawals, top referrers, and active teams.
• As an Admin, I should be able to approve or reject withdrawals easily.
• As a User, I should be able to use a payment gateway for top-up and withdrawal with real-time balance updates.

User Personas

• Teenager: A tech-savvy individual looking for an easy and engaging way to start investing.
• ICH (High-Net-Worth Individual): An experienced investor seeking advanced tools and reliable returns.
• Admin: A platform manager responsible for overseeing user activities, managing plans, and ensuring smooth operations.

Visuals Colors and Theme

• primary: #FF6F61 (a warm coral)
• primary_light: #FFB3A7 (a lighter coral tint)
• secondary: #FFD700 (a bright gold)
• accent: #32CD32 (a vibrant lime green)
• highlight: #FFA500 (a warm orange)
• bg: #F5F5DC (a soft beige)
• surface: rgba(255, 248, 220, 0.8) (a light cream)
• text: #333333 (a dark charcoal)
• text_muted: #777777 (a medium gray)
• border: rgba(204, 204, 204, 0.5) (a subtle gray)

Signature Design Concept

The homepage of the epic-investment platform will feature an interactive "Investment Garden" concept. Users will navigate through a virtual garden where each plant represents a different investment plan. Using @react-three/fiber and @react-three/drei, users can click on plants to reveal plan details, drag to explore different sections of the garden, and hover to see growth animations representing potential returns. The garden will change colors based on time of day, providing a dynamic and engaging experience.

Interaction Model & Motion Direction

The landing page will utilize a "parallax" interaction model, creating a layered depth effect as users scroll through the garden. Decorative elements like floating leaves and butterflies will move at different speeds, enhancing the storytelling aspect. Internal pages will adopt a "static" model to prioritize clarity and ease of use for data-heavy tasks.

Non-Functional Requirements

• The system should ensure data security and privacy for all users.
• The platform should be highly responsive and perform well on mobile devices.
• The design should be intuitive and accessible to users of all ages and backgrounds.

Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB, using Alembic for migrations
• AI Models: GPT 5.4 for user-friendly responses
• Local Orchestration: Docker, docker-compose
• Server-side Orchestration: Kubernetes

Assumptions and Constraints

• The platform will primarily target users in India, with all prices displayed in Indian Rupees (INR).
• The minimum investment and withdrawal amounts are set to ₹100 and ₹200, respectively.
• The system will support UPI, cards, and wallets for payment processing.

Glossary

• OTP: One-Time Password
• ICH: High-Net-Worth Individual
• UPI: Unified Payments Interface
• RDBMS: Relational Database Management System
• AI: Artificial Intelligence

This document outlines the comprehensive requirements and design vision for the epic-investment platform, ensuring a delightful and efficient user experience.