How evansvl/vless-shopbot works
VLESS Shop Bot automates VPN-key sales through Telegram, with an admin web panel for configuration and management. The main workflow is customer interaction, plan selection and payment, then key provisioning through 3x-ui; scheduled jobs synchronize keys and notify users about expiry. The graph also includes support tickets and the panel’s management role. Relationships are based on shown imports and calls or README claims; unsampled implementation details are represented only where the README documents the capability.
Main entry points: handlers.py Shop bot handlers · app.py Web panel and webhooks · database.py Application database · bot_controller.py Bot controller
Components 16
Application runtime
- Application entry
src/shop_bot/__main__.py - Bot controller
src/shop_bot/bot_controller.py
Telegram experience
- Shop bot handlers
src/shop_bot/bot/handlers.py - Bot keyboards
src/shop_bot/bot/keyboards.py - Ban middleware
src/shop_bot/bot/middlewares.py - Support bot
src/shop_bot/bot/support_handlers.py - Bot configuration text
src/shop_bot/config.py
Web administration
- Web panel and webhooks
src/shop_bot/webhook_server/app.py
Sales and VPN operations
- Application database
src/shop_bot/data_manager/database.py - Key scheduler
src/shop_bot/data_manager/scheduler.py - 3x-ui integration
src/shop_bot/modules/xui_api.py
Other components
- VPN customer
- Administrator
- Telegram platform
- 3x-ui panels
- Payment providers
Connections 27
- Application entry → Application database: initializes
src/shop_bot/__main__.py - Application entry → Bot controller: creates
src/shop_bot/__main__.py - Application entry → Web panel and webhooks: starts
src/shop_bot/__main__.py - Application entry → Key scheduler: runs
src/shop_bot/__main__.py - Bot controller → Shop bot handlers: registers
src/shop_bot/bot_controller.py - Bot controller → Ban middleware: installs
src/shop_bot/bot_controller.py - Bot controller → Support bot: registers
src/shop_bot/bot_controller.py - Shop bot handlers → Application database: reads and writes
src/shop_bot/bot/handlers.py - Shop bot handlers → Bot keyboards: uses
src/shop_bot/bot/handlers.py - Shop bot handlers → 3x-ui integration: provisions keys
src/shop_bot/bot/handlers.py - Shop bot handlers → Bot configuration text: formats messages
src/shop_bot/bot/handlers.py - Bot keyboards → Application database: reads settings
src/shop_bot/bot/keyboards.py - Ban middleware → Application database: checks bans
src/shop_bot/bot/middlewares.py - Support bot → Application database: stores ticket links
src/shop_bot/bot/support_handlers.py - Key scheduler → Application database: syncs key records
src/shop_bot/data_manager/scheduler.py - Key scheduler → 3x-ui integration: checks panels
src/shop_bot/data_manager/scheduler.py - Web panel and webhooks → Application database: manages records
src/shop_bot/webhook_server/app.py - Web panel and webhooks → Bot controller: starts and stops
- Web panel and webhooks → 3x-ui integration: revokes keys
src/shop_bot/webhook_server/app.py - Web panel and webhooks → Shop bot handlers: dispatches payment
src/shop_bot/webhook_server/app.py - VPN customer → Telegram platform: uses
README.md - Telegram platform → Shop bot handlers: delivers updates
README.md - Shop bot handlers → VPN customer: sends keys
README.md - Administrator → Web panel and webhooks: manages service
README.md - Web panel and webhooks → Payment providers: receives webhooks
README.md - Shop bot handlers → Payment providers: accepts payments
README.md - 3x-ui integration → 3x-ui panels: manages clients
README.md