GADE CLOUD Showcase

Commercial VPN service and SaaS platform for automated VPN subscription management.

The project covers the full lifecycle of a VPN product: Telegram onboarding, plan selection, trial access, YooKassa payments, automatic VPN access provisioning through Marzban API, user profile, support, reminders, admin tools and a Telegram Mini App.

This repository is a public showcase version. The original project contains commercial/private code and configuration, so production secrets, bot tokens, payment credentials, client data, server IPs and internal business details are not published here.

What The Product Does

GADE CLOUD automates the full VPN subscription lifecycle:

• user starts in Telegram;
• bot handles onboarding, trial access, subscription purchase and profile flow;
• payment flow is processed through YooKassa;
• VPN access is provisioned through Marzban API;
• user data and subscription state are stored in PostgreSQL;
• Telegram Mini App provides a web-based account and purchase experience;
• admin/support flows help manage users, tickets, manuals and operational tasks;
• scheduled jobs send reminders and handle lifecycle events.

What This Demonstrates

This showcase is not only about a VPN product. It demonstrates that I can build and operate a real commercial service around infrastructure-heavy backend logic.

• Design a product flow from first Telegram message to paid active subscription.
• Integrate Telegram Bot API, Telegram Mini App, payment provider and VPN control panel.
• Automate user provisioning instead of manually creating accounts.
• Build billing logic: trial, plans, device limits, payment status, subscription extension.
• Work with Linux/VPS infrastructure, Xray/VLESS/REALITY and Marzban-based access management.
• Store and update operational state in PostgreSQL.
• Add admin/support tools, anti-spam protection, reminders and lifecycle jobs.
• Think as both developer and product owner: user journey, support, billing, operations and reliability.

Key Features

• Telegram bot built with aiogram.
• Telegram Mini App and web frontend.
• YooKassa billing and payment scenarios.
• Marzban API integration for VPN user provisioning.
• VPN subscription lifecycle: trial, purchase, extension, profile, reminders.
• Infrastructure stack around Xray, VLESS/REALITY and Linux/VPS hosting.
• PostgreSQL-backed storage.
• Trial flow, paid plans, device limits and subscription periods.
• User profile, support, manuals and referral flows.
• Admin panel and operational commands.
• Anti-spam/rate-limit middleware.
• Scheduler for subscription reminders and lifecycle tasks.
• Email notifications and web API integration.

Tech Stack

• Bot: Python, aiogram, Asyncio
• Web/API: Node.js, Express
• Database: PostgreSQL
• Billing: YooKassa
• VPN Control Plane: Marzban API, Xray, VLESS/REALITY
• Frontend: HTML, CSS, JavaScript, Telegram Mini App
• Automation: APScheduler
• Security/Hardening: rate limiting, anti-spam middleware, Helmet, CORS
• Integrations: Telegram Bot API, Telegram Web App, SMTP/email

Architecture

flowchart LR
    User["Telegram User"] --> Bot["Telegram Bot / aiogram"]
    User --> MiniApp["Telegram Mini App"]
    MiniApp --> WebAPI["Node.js / Express API"]
    Bot --> BotDB["PostgreSQL"]
    WebAPI --> BotDB
    Bot --> YooKassa["YooKassa Payments"]
    WebAPI --> YooKassa
    Bot --> Marzban["Marzban API"]
    WebAPI --> Marzban
    Marzban --> VPN["Xray / VLESS / REALITY"]
    Bot --> Scheduler["APScheduler Jobs"]
    Scheduler --> BotDB
    WebAPI --> Email["SMTP / Email Notifications"]
    Admin["Admin / Support"] --> Bot

Loading

More details: docs/architecture.md

Screenshots

Public demo screenshots are available in the screenshots/ folder.
All screenshots use demo data or sanitized production-like views.

Product Preview

Telegram Bot	Telegram Mini App

Web Landing	Billing Flow

Admin Panel	Marzban Dashboard

Technical Snippets

View code snippets

Aiogram Bot Flow

Marzban API Client

Payment Flow

Demo Flow

A short demo scenario is described in docs/demo-flow.md:

1. User opens Telegram bot.
2. Bot shows onboarding and plan options.
3. User chooses a plan or trial.
4. Payment flow is created through YooKassa.
5. After payment, VPN access is provisioned through Marzban API.
6. User opens profile/Mini App and sees subscription state.
7. Admin/support tools show operational control.

Public GitHub Note

Most of this project was developed as a commercial VPN product. This public repository is intended as a clean product/engineering showcase: architecture, product description, screenshots, sanitized code snippets and demo materials.

RU: Это публичная showcase-версия проекта. Приватные данные, токены, платежные ключи, server-side secrets, IP-адреса и чувствительная бизнес-логика не публикуются.