Docs
Home
  • Overview
  • Web installer
  • Production deployment
  • aaPanel
  • aaPanel quick reference
  • Storefront & customers
  • Admin
  • eSIM providers
  • AI assistant
Home
  • Overview
  • Web installer
  • Production deployment
  • aaPanel
  • aaPanel quick reference
  • Storefront & customers
  • Admin
  • eSIM providers
  • AI assistant

esimScan

eSIM store & travel-data reseller — storefront, customer accounts & admin

Setup & deploymentStorefront & customersAdmineSIM providersAI assistant

Sell eSIMs end-to-end

Public storefront with country/region browsing, guest checkout, payment, and automatic eSIM delivery (QR + activation) by email.

Multi-provider supply

Connect Airalo, eSIM Access, Maya Mobile, and eSIM Go — sync their catalogs, set margins, and fulfill manually, in stub demo mode, or live via the provider API.

Optional AI assistant

Bring your own OpenAI, Claude (Anthropic), or DeepSeek key to power a storefront eSIM Advisor and AI support reply drafting. Off by default; billed by your provider.

Laravel + Inertia (React)

Laravel 12, MySQL, Inertia.js + React, TailwindCSS, Redis (optional; database fallback for cache/queue). RBAC, audit logs, multi-currency, multi-language with RTL.

Documentation index

GuideWhat it covers
Setup & deploymentLocal install, environment, database, migrations, seeding, i18n, troubleshooting — plus the entry point for production deployment, aaPanel, and the aaPanel quick reference
Web installerBrowser-based setup wizard at /install — requirements & permission checks, database test, admin account, migrations, and optional one-click demo-data import
Storefront & customersThe public buying experience — browse destinations, checkout, vouchers/gift cards, eSIM delivery, and the optional customer account (eSIMs, orders, KYC, support)
AdminThe store back-office at /admin — dashboard, orders, providers, catalog, customers/KYC, marketing, email/SMTP, currencies, languages, payment gateways, roles & permissions
eSIM provider configurationAiralo, eSIM Access, Maya Mobile, eSIM Go — where to get credentials, what to paste, testing, and syncing the catalog
AI assistantOptional AI — choose OpenAI/Claude/DeepSeek, enable the storefront eSIM Advisor and support reply drafting (bring your own key)

Start with Setup & deployment to install and host. Use Storefront & customers to understand the buyer journey, and Admin to run the store and configure the system.

The two areas

esimScan has one public storefront and one back-office. Knowing each one makes everything else fall into place.

AreaURLWhoWhat
Storefront/End customersBrowse destinations & packages, guest checkout, pay, receive the eSIM by email. An optional customer account (/login → /account) tracks past eSIMs and orders.
Admin back-office/adminYou (the store owner)Run the store: orders, providers, catalog, marketing, customers, KYC, payments, reporting — plus email, currencies, languages, gateways, roles, and branding.

Quick reference

  • App (dev): http://localhost:8000
  • Storefront: / · Customer login: /login · Customer account: /account
  • Admin login: /admin/login → Admin: /admin
  • Configuration: a single .env at the repository root

For repository layout and scripts, see the project README at the repository root (parent of this docs folder).

esimScan