Skip to content

Platform Capabilities

Category: Core Infrastructure
Target Users: All users (varies by plan)
Business Value: Foundation for all features

🎯 Overview

The platform infrastructure that powers all MachineAvatars features - authentication, billing, API access, and scalability.

🔐 Authentication & Security

User Authentication

What it does:
Secure user account management with multiple authentication methods.

Features:

  • Email/Password Login: Standard authentication
  • OTP Verification: 6-digit code (60-second expiry)
  • reCAPTCHA v2: Bot protection on signup/login
  • Password Reset: 3-step forgot password flow
  • Session Management: JWT tokens in sessionStorage
  • Auto-logout: Security timeout

Admin Features:

  • Super Admin Portal: Elevated access for platform management
  • User Management: View/edit/disable user accounts
  • Audit Logs: Track user actions

Security:

  • bcrypt password hashing
  • Secure token handling
  • HTTPS encryption
  • CORS protection
  • Rate limiting

Technical:

  • Backend: auth-service (Port 8001)
  • Frontend: login, signup, forgot-password pages
  • Storage: MongoDB users collection

💳 Subscription & Billing

Payment Processing

What it does:
Razorpay-powered subscription management with multi-currency support.

3-Step Payment Flow:

Step 1: Plan Selection

  • View all plans (Free, Pro, Business, Premium)
  • Compare features
  • Select billing cycle (Monthly/Yearly)
  • See pricing in preferred currency

Step 2: Payment

  • Razorpay checkout (secure)
  • Multiple payment methods:
  • Credit/Debit cards
  • UPI
  • Net banking
  • Wallets
  • Real-time verification

Step 3: Confirmation

  • Instant subscription activation
  • Invoice generation
  • Email confirmation

Plans Available:

Plan Monthly (INR) Yearly (INR) Monthly (USD) Yearly (USD)
Free ₹0 ₹0 $0 $0
Pro ₹999 ₹9,990 (17% off) $12 $120 (17% off)
Business ₹4,999 ₹49,990 (17% off) $60 $600 (17% off)
Premium Custom Custom Custom Custom

Features:

  • Auto-renewal
  • Upgrade/downgrade anytime
  • Prorated billing
  • Invoice history
  • Payment mode management
  • Tax/GST support

Technical:

  • Backend: payment-service (Port 8006)
  • Frontend: payment pages, billing pages
  • Integration: Razorpay API
  • Collections: users, subscriptions

Usage Tracking

What it does:
Real-time tracking of plan limits and usage.

Tracked Metrics:

  1. Chatbots Created: vs plan limit
  2. Website Links Crawled: vs plan limit
  3. Chat Sessions: Monthly count vs limit
  4. Storage Used: File uploads
  5. API Calls: For custom integrations

Display:

  • Real-time progress bars
  • Percentage used
  • Days until renewal
  • Upgrade prompts when near limits

Technical:

  • Backend: user-service
  • Frontend: Billing_details_subscriptionplan page
  • Storage: MongoDB aggregation queries

🔌 API & Integrations

REST API Access

What it does:
Programmatic access to chatbot features.

Available Endpoints:

  • Create chatbot: POST /v1/chatbot/create
  • Get response: POST /v2/get-response-{type}-chatbot
  • Manage data: POST /v1/data/upload
  • View history: GET /v1/chat/history

Authentication:

  • API key-based
  • Bearer token support
  • Rate limiting by plan

Plans with API:

  • Business: Limited API access
  • Premium: Full API access + higher limits

SDK Integration

What it does:
JavaScript SDK for easy website embedding.

Features:

  • Widget Embed: Floating chat bubble
  • iFrame Embed: Inline chatbot
  • Custom Integration: React/Vue/Angular components

Example:

<script
  src="https://machineavatars.com/sdk/chat-sdk.js"
  async
  data-h="[encoded-project-id]"
></script>

Configuration:

  • Position (bottom-right, bottom-left, etc.)
  • Colors/branding
  • Auto-open behavior
  • Welcome message

Technical:

  • CDN-hosted SDK
  • Auto-updates
  • Cross-domain support
  • Mobile responsive

Third-Party Integrations

Integrated Services:

1. Razorpay

  • Payment processing
  • Subscription management
  • Invoicing

2. Strapi CMS

  • Homepage content management
  • Dynamic sections
  • SEO metadata

3. Azure Services

  • OpenAI (11 LLM models)
  • Cognitive Services (TTS)
  • Cloud infrastructure

4. Google Analytics

  • Traffic tracking
  • Conversion analytics
  • User behavior

5. MongoDB

  • Primary database
  • Real-time data
  • Scalable storage

6. Milvus

  • Vector database
  • Semantic search
  • RAG pipeline

⚡ Scalability & Performance

Infrastructure

Architecture:

  • Microservices: 23 independent services
  • Load Balancing: Gateway service (Ports 8000/9000)
  • Horizontal Scaling: Auto-scale by demand
  • Database Optimization: Indexes, partitions
  • CDN: Static asset delivery

Performance Specs:

  • Concurrent Users: 10,000+
  • Response Time: <3s average (text chatbot)
  • Uptime: 99.9% SLA (Business/Premium)
  • Data Center: Azure Central India

Monitoring:

  • Real-time metrics
  • Performance logging
  • Error tracking
  • Auto-alerts

Multi-Currency Support

Supported Currencies:

  • INR (Indian Rupee) - Default for India
  • USD (US Dollar) - International

Auto-Detection:

  • IP-based geolocation
  • Manual currency toggle
  • Persistent preference

Pricing Parity:

  • Dynamic exchange rates
  • Local pricing optimization
  • Tax/GST compliance

🌐 Multi-Tenancy

What it does:
Isolated environments for each user/organization.

Features:

  • Data Isolation: Each user's data completely separate
  • Partition Strategy: MongoDB collections partitioned by user_id
  • Milvus Partitions: Vector storage per project_id
  • No Data Leakage: Queries filtered by user/project

Benefits:

  • Security
  • Privacy
  • Performance (smaller search spaces)
  • Customization per tenant

📊 System Status

Public Status Page:

  • Service uptime
  • Incident history
  • Planned maintenance
  • Performance metrics

Technical:

  • Monitoring: Datadog/similar
  • Alerts: Auto-notification for downtime
  • Updates: Real-time status

Technical Details:

Frontend:

Business:

"Reliable infrastructure powering intelligent conversations." ⚡🔐