🤖 Alamor VPN Bot - Complete VPN Management System with 3X-UI Panel Integration

[AlamorNetwork]

Project Overview

Alamor VPN Bot is a comprehensive and professional system for managing and selling VPN subscriptions through Telegram. The bot utilizes the 3X-UI panel API for creating, deleting, renewing, and retrieving configuration information, with a modular and secure design architecture.

🔥 Phase 1 Features

🎯 User Panel

• Purchase configurations with customizable options:
  • Server selection
  • Plan volume and duration
  • Free test account (once per day)
  • Real-time subscription link generation via API
  • View purchase history and active services

🛡️ Admin Panel

• Server management (add, edit, delete, connection testing)
• Plan management (volume, duration, pricing)
• Payment gateway management (card-to-card, enable/disable)
• Channel lock management (user membership verification)
• Payment list viewing and manual confirmation
• Two-factor authentication (2FA) for each server
• Admin notifications for purchases and payments

🧩 Database (SQLite)

• Store user data, purchases, plans, gateways, and servers
• No sensitive data storage (Telegram ID only)
• Real-time config retrieval from panel API

🧠 Technical Structure

• Python + telebot library
• No Canvas usage
• Modular design (separate files for db, bot, api_client, and menus)
• Inline Keyboard and dynamic responses

🛠️ Technologies

• Python 3.10+
• SQLite (lightweight local database)
• PyTelegramBotAPI (official library)
• Official 3X-UI API
• Minimal design with high scalability

🧭 Future Phases

1. Automatic config renewal with remaining volume transfer
2. Wallet system and token-based payments
3. Diverse payment gateways (Perfect Money, cryptocurrency, star payment)
4. "Soros" AI integration for chat, sales, and user guidance
5. Smart bank SMS detection and automatic payment verification
6. Digital product sales (licenses, files, special accounts)
7. Detailed financial reporting for admins

🔌 3X-UI Panel API Integration

• Direct request handling for client creation, deletion, and renewal
• Panel login testing before each operation
• Custom sub_path subscription link generation
• Real-time config delivery without local storage

🔒 Security and Access Control

• Encrypted server information storage
• Admin authentication via Telegram numeric ID
• Channel membership verification before operations
• Free test limitations

📍 Complete User Flow

1. User enters bot and confirms channel membership
2. Selects server and plan through menu
3. Card-to-card payment information displayed
4. Sends receipt to admin
5. Upon confirmation, config is created and subscription link is provided

---

Development Status

• Basic bot structure
• User panel implementation
• Admin panel implementation
• Database integration
• API integration
• Future phase features

Technical Requirements

• Python 3.10 or higher
• SQLite database
• Telegram Bot API access
• 3X-UI panel with API access