How evgenyalex21/carmngrbot-telegrambot works
Car Manager Bot is a Telegram service for vehicle owners, with user-facing automotive tools and a separate admin panel. The main workflow starts with a Telegram update, routes it through the bot’s registered handlers, then responds with a tool result or an administrative action. The README also describes subscription/payment and automation capabilities. Paths and calls below follow the tree, excerpts, source index, and README; unsampled feature internals and most storage details are not verified.
Main entry points: user_main_menu.py User menu · admin_main_menu.py Admin panel · main.py Bot startup · bot_instance.py Bot instance
Components 29
Bot Runtime
- Configuration
core/config.py - Bot instance
core/bot_instance.py - Bot startup
main.py
Driver Services
- User menu
handlers/user/user_main_menu.py - Vehicle tools
handlers/user - Expenses and repairs
handlers/user/expenses_and_repairs/expenses_and_repairs.py - City fuel search
handlers/user/gde_benz/gde_benz.py - Fuel prices
handlers/user/fuel_prices/fuel_prices.py - Calculators
handlers/user/calculators - Vehicle finder
handlers/user/findtransport/findtransport.py - Place search
handlers/user/placesearch/placesearch.py - Weather
handlers/user/weather/weather.py - Regional and OBD codes
handlers/user - Reminders and alerts
handlers/user - Other services
handlers/user/others
Subscriptions
- Subscription center
handlers/user/subscription/subscription_main.py - Purchase and refunds
handlers/user/subscription/buy_subscription.py
Administration
- Admin panel
handlers/admin/admin_main_menu.py - Admin accounts
handlers/admin/admin/admin.py - Admin operations
handlers/admin - Statistics and export
handlers/admin/statistics/statistics.py
Access and Operations
- Handler guards
handlers/user/utils.py - Blocked-user state
decorators/blocked_user.py - Shared dependencies
core/imports.py - User-admin chat
handlers/user/others/others_chat_with_admin.py - Admin communications
handlers/admin/communication/communication.py
Other components
- Telegram user
- Telegram API
- External APIs
Connections 20
- Telegram user → Telegram API: sends updates
README.md - Telegram API → Bot startup: delivers updates
main.py - Bot startup → Bot instance: starts polling
main.py - Configuration → Bot instance: provides token
core/bot_instance.py - Bot instance → Telegram API: sends responses
core/bot_instance.py - Bot startup → User menu: registers handlers
main.py - Bot startup → Admin panel: registers handlers
main.py - User menu → Vehicle tools: routes to
handlers/user/user_main_menu.py - User menu → Subscription center: routes to
handlers/user/user_main_menu.py - User menu → Statistics and export: records usage
handlers/user/user_main_menu.py - Subscription center → Purchase and refunds: starts purchase
handlers/user/subscription/buy_subscription.py - Admin panel → Admin accounts: delegates to
handlers/admin/admin_main_menu.py - Admin panel → Admin operations: routes to
handlers/admin/__init__.py - Admin panel → Statistics and export: routes to
handlers/admin/statistics/statistics.py - User menu → Handler guards: applies guards
handlers/user/user_main_menu.py - Handler guards → Blocked-user state: checks and updates
handlers/user/utils.py - Admin panel → Admin communications: routes communications
handlers/admin/communication/communication.py - User-admin chat → Admin communications: coordinates chat
handlers/user/others/others_chat_with_admin.py - Vehicle tools → External APIs: uses APIs
- Shared dependencies → Statistics and export: imports module
core/imports.py