Skip to content

artpromedia/solumobile

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

14 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

eSIM Business Platform

A complete eSIM reselling platform with Next.js frontend and Laravel backend.

πŸš€ Features

Customer Features

  • 🌍 Browse eSIM packages by country/region
  • πŸ’³ Multi-currency support
  • πŸ”’ Secure payment processing (Stripe, Razorpay)
  • πŸ‘€ User registration and KYC verification
  • πŸ“± eSIM activation and QR code download
  • πŸ“Š Order history and tracking
  • 🎫 Support ticket system

Admin Features

  • πŸ“ˆ Comprehensive dashboard with analytics
  • πŸ‘₯ User management with KYC approval
  • πŸ“¦ Order management and tracking
  • 🌐 Package and pricing management (region/country-based)
  • βš™οΈ Payment gateway configuration
  • πŸ“§ Email template management
  • 🎨 Banner and promotion management
  • 🎟️ Support ticket management
  • πŸ“Š Sales reports and analytics

πŸ› οΈ Technology Stack

Frontend (./frontend)

  • Next.js 14 - React framework with App Router
  • TypeScript - Type safety
  • Tailwind CSS - Utility-first styling
  • Shadcn/ui - Beautiful UI components
  • React Query - Data fetching and caching
  • Zustand - Lightweight state management
  • React Hook Form - Form handling
  • Zod - Schema validation

Backend (./backend)

  • Laravel 11 - PHP framework
  • MySQL - Relational database
  • JWT Authentication - API security
  • Laravel Sanctum - API tokens
  • Laravel Queue - Background jobs
  • Laravel Mail - Email notifications
  • Spatie Permissions - Role-based access

Integrations

  • Airalo Partner API - eSIM provider
  • Stripe - International payments
  • Razorpay - India payments

πŸ“ Project Structure

esim-platform/
β”œβ”€β”€ frontend/              # Next.js application
β”‚   β”œβ”€β”€ app/              # App router pages
β”‚   β”œβ”€β”€ components/       # React components
β”‚   β”œβ”€β”€ lib/             # Utilities and configurations
β”‚   β”œβ”€β”€ hooks/           # Custom React hooks
β”‚   └── types/           # TypeScript types
β”œβ”€β”€ backend/              # Laravel API
β”‚   β”œβ”€β”€ app/             # Application logic
β”‚   β”œβ”€β”€ database/        # Migrations and seeders
β”‚   β”œβ”€β”€ routes/          # API routes
β”‚   └── config/          # Configuration files
└── docs/                # Documentation

🚦 Getting Started

Prerequisites

  • Node.js 18+ and npm
  • PHP 8.2+
  • Composer
  • MySQL 8.0+
  • Airalo Partner Account (Sign up here)

Quick Start

1. Frontend Setup

cd frontend
npm install
cp .env.example .env.local
# Edit .env.local with your configuration
npm run dev

Frontend will run on http://localhost:3000

2. Backend Setup

cd backend
composer install
cp .env.example .env
php artisan key:generate
# Configure database in .env
php artisan migrate --seed
php artisan serve

Backend will run on http://localhost:8000

πŸ”§ Configuration

Frontend Environment (.env.local)

NEXT_PUBLIC_API_URL=http://localhost:8000/api
NEXT_PUBLIC_STRIPE_PUBLIC_KEY=pk_test_xxxxx
NEXT_PUBLIC_RAZORPAY_KEY=rzp_test_xxxxx

Backend Environment (.env)

# Airalo API
AIRALO_API_URL=https://sandbox-partners-api.airalo.com/v2
AIRALO_CLIENT_ID=your_client_id
AIRALO_CLIENT_SECRET=your_client_secret

# Payment Gateways
STRIPE_SECRET=sk_test_xxxxx
STRIPE_WEBHOOK_SECRET=whsec_xxxxx
RAZORPAY_KEY=rzp_test_xxxxx
RAZORPAY_SECRET=your_razorpay_secret

# Database
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=esim_platform
DB_USERNAME=root
DB_PASSWORD=

πŸ“– Documentation

🎯 Key Workflows

For Customers

  1. Register/Login β†’ Browse Packages β†’ Select Package β†’ Checkout
  2. Complete Payment β†’ Receive eSIM β†’ Download QR Code
  3. Install eSIM β†’ Activate β†’ Use Data

For Admins

  1. Manage Users & KYC Approvals
  2. Configure Packages & Pricing (add commission over Airalo base price)
  3. Monitor Orders & Handle Refunds
  4. Respond to Support Tickets
  5. View Analytics & Reports

πŸ” Security Features

  • JWT authentication with refresh tokens
  • CSRF protection
  • XSS prevention
  • SQL injection protection
  • Rate limiting on API endpoints
  • Secure password hashing (bcrypt)
  • KYC verification for high-value transactions

πŸ“ˆ Roadmap

  • Mobile app (React Native)
  • Multi-language support
  • WhatsApp notifications
  • Affiliate program
  • Advanced analytics
  • API for third-party integrations

🀝 Support

For issues and questions, check the documentation or create a support ticket.

πŸ“„ License

Private Project - All Rights Reserved


Built with ❀️ for eSIM entrepreneurs

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors