# evgenyalex21/carmngrbot-telegrambot architecture

> Architecture diagram of the GitHub repository evgenyalex21/carmngrbot-telegrambot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/evgenyalex21/carmngrbot-telegrambot
- Repository: https://github.com/evgenyalex21/carmngrbot-telegrambot

## Overview

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: [`handlers/user/user_main_menu.py`](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/user_main_menu.py) (User menu), [`handlers/admin/admin_main_menu.py`](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/admin/admin_main_menu.py) (Admin panel), [`main.py`](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/main.py) (Bot startup), [`core/bot_instance.py`](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/core/bot_instance.py) (Bot instance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Bot Runtime"]
  node_config["Configuration<br/>[config.py]"]
  node_bot["Bot instance<br/>[bot_instance.py]"]
  node_entry["Bot startup<br/>[main.py]"]
end

subgraph group_user["Driver Services"]
  node_user_menu["User menu<br/>[user_main_menu.py]"]
  node_auto_tools["Vehicle tools"]
  node_expenses["Expenses and repairs"]
  node_fuel_city["City fuel search<br/>[gde_benz.py]"]
  node_fuel_prices["Fuel prices<br/>[fuel_prices.py]"]
  node_calculators["Calculators"]
  node_vehicle_location["Vehicle finder<br/>[findtransport.py]"]
  node_places["Place search<br/>[placesearch.py]"]
  node_weather["Weather<br/>[weather.py]"]
  node_regional["Regional and OBD codes"]
  node_reminders["Reminders and alerts"]
  node_other_tools["Other services"]
end

subgraph group_commerce["Subscriptions"]
  node_subscription["Subscription center"]
  node_purchase["Purchase and refunds"]
end

subgraph group_admin["Administration"]
  node_admin_menu["Admin panel<br/>[admin_main_menu.py]"]
  node_admin_access["Admin accounts<br/>[admin.py]"]
  node_admin_ops["Admin operations"]
  node_admin_stats["Statistics and export<br/>[statistics.py]"]
end

subgraph group_crosscut["Access and Operations"]
  node_guards["Handler guards<br/>[utils.py]"]
  node_blocked_state[("Blocked-user state<br/>[blocked_user.py]")]
  node_shared_imports["Shared dependencies<br/>[imports.py]"]
  node_user_admin_chat["User-admin chat"]
  node_admin_chat["Admin communications<br/>[communication.py]"]
end

node_driver(("Telegram user"))
node_telegram(("Telegram API"))
node_external_services(("External APIs"))

node_driver -->|"sends updates"| node_telegram
node_telegram -->|"delivers updates"| node_entry
node_entry -->|"starts polling"| node_bot
node_config -->|"provides token"| node_bot
node_bot -->|"sends responses"| node_telegram
node_entry -->|"registers handlers"| node_user_menu
node_entry -->|"registers handlers"| node_admin_menu
node_user_menu -.->|"routes to"| node_auto_tools
node_user_menu -->|"routes to"| node_subscription
node_user_menu -->|"records usage"| node_admin_stats
node_subscription -->|"starts purchase"| node_purchase
node_admin_menu -->|"delegates to"| node_admin_access
node_admin_menu -->|"routes to"| node_admin_ops
node_admin_menu -->|"routes to"| node_admin_stats
node_user_menu -->|"applies guards"| node_guards
node_guards -->|"checks and updates"| node_blocked_state
node_admin_menu -->|"routes communications"| node_admin_chat
node_user_admin_chat -->|"coordinates chat"| node_admin_chat
node_auto_tools -.->|"uses APIs"| node_external_services
node_shared_imports -->|"imports module"| node_admin_stats

click node_config "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/core/config.py"
click node_bot "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/core/bot_instance.py"
click node_entry "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/main.py"
click node_user_menu "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/user_main_menu.py"
click node_auto_tools "https://github.com/evgenyalex21/carmngrbot-telegrambot/tree/master/handlers/user"
click node_expenses "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/expenses_and_repairs/expenses_and_repairs.py"
click node_fuel_city "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/gde_benz/gde_benz.py"
click node_fuel_prices "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/fuel_prices/fuel_prices.py"
click node_calculators "https://github.com/evgenyalex21/carmngrbot-telegrambot/tree/master/handlers/user/calculators"
click node_vehicle_location "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/findtransport/findtransport.py"
click node_places "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/placesearch/placesearch.py"
click node_weather "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/weather/weather.py"
click node_regional "https://github.com/evgenyalex21/carmngrbot-telegrambot/tree/master/handlers/user"
click node_reminders "https://github.com/evgenyalex21/carmngrbot-telegrambot/tree/master/handlers/user"
click node_other_tools "https://github.com/evgenyalex21/carmngrbot-telegrambot/tree/master/handlers/user/others"
click node_subscription "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/subscription/subscription_main.py"
click node_purchase "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/subscription/buy_subscription.py"
click node_admin_menu "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/admin/admin_main_menu.py"
click node_admin_access "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/admin/admin/admin.py"
click node_admin_ops "https://github.com/evgenyalex21/carmngrbot-telegrambot/tree/master/handlers/admin"
click node_admin_stats "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/admin/statistics/statistics.py"
click node_guards "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/utils.py"
click node_blocked_state "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/decorators/blocked_user.py"
click node_shared_imports "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/core/imports.py"
click node_user_admin_chat "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/others/others_chat_with_admin.py"
click node_admin_chat "https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/admin/communication/communication.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_config,node_bot,node_entry,node_driver toneBlue
class node_user_menu,node_auto_tools,node_expenses,node_fuel_city,node_fuel_prices,node_calculators,node_vehicle_location,node_places,node_weather,node_regional,node_reminders,node_other_tools toneAmber
class node_subscription,node_purchase,node_telegram,node_external_services toneMint
class node_admin_menu,node_admin_access,node_admin_ops,node_admin_stats toneRose
class node_guards,node_blocked_state,node_shared_imports,node_user_admin_chat,node_admin_chat toneIndigo
```

## Components

### Bot Runtime

- [Configuration](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/core/config.py): `core/config.py`
- [Bot instance](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/core/bot_instance.py): `core/bot_instance.py`
- [Bot startup](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/main.py): `main.py`

### Driver Services

- [User menu](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/user_main_menu.py): `handlers/user/user_main_menu.py`
- [Vehicle tools](https://github.com/evgenyalex21/carmngrbot-telegrambot/tree/master/handlers/user): `handlers/user`
- [Expenses and repairs](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/expenses_and_repairs/expenses_and_repairs.py): `handlers/user/expenses_and_repairs/expenses_and_repairs.py`
- [City fuel search](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/gde_benz/gde_benz.py): `handlers/user/gde_benz/gde_benz.py`
- [Fuel prices](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/fuel_prices/fuel_prices.py): `handlers/user/fuel_prices/fuel_prices.py`
- [Calculators](https://github.com/evgenyalex21/carmngrbot-telegrambot/tree/master/handlers/user/calculators): `handlers/user/calculators`
- [Vehicle finder](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/findtransport/findtransport.py): `handlers/user/findtransport/findtransport.py`
- [Place search](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/placesearch/placesearch.py): `handlers/user/placesearch/placesearch.py`
- [Weather](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/weather/weather.py): `handlers/user/weather/weather.py`
- [Regional and OBD codes](https://github.com/evgenyalex21/carmngrbot-telegrambot/tree/master/handlers/user): `handlers/user`
- [Reminders and alerts](https://github.com/evgenyalex21/carmngrbot-telegrambot/tree/master/handlers/user): `handlers/user`
- [Other services](https://github.com/evgenyalex21/carmngrbot-telegrambot/tree/master/handlers/user/others): `handlers/user/others`

### Subscriptions

- [Subscription center](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/subscription/subscription_main.py): `handlers/user/subscription/subscription_main.py`
- [Purchase and refunds](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/subscription/buy_subscription.py): `handlers/user/subscription/buy_subscription.py`

### Administration

- [Admin panel](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/admin/admin_main_menu.py): `handlers/admin/admin_main_menu.py`
- [Admin accounts](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/admin/admin/admin.py): `handlers/admin/admin/admin.py`
- [Admin operations](https://github.com/evgenyalex21/carmngrbot-telegrambot/tree/master/handlers/admin): `handlers/admin`
- [Statistics and export](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/admin/statistics/statistics.py): `handlers/admin/statistics/statistics.py`

### Access and Operations

- [Handler guards](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/utils.py): `handlers/user/utils.py`
- [Blocked-user state](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/decorators/blocked_user.py): `decorators/blocked_user.py`
- [Shared dependencies](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/core/imports.py): `core/imports.py`
- [User-admin chat](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/user/others/others_chat_with_admin.py): `handlers/user/others/others_chat_with_admin.py`
- [Admin communications](https://github.com/evgenyalex21/carmngrbot-telegrambot/blob/master/handlers/admin/communication/communication.py): `handlers/admin/communication/communication.py`

### Other components

- **Telegram user**
- **Telegram API**
- **External APIs**

## Connections

- Telegram user → Telegram API: sends updates (evidence: `README.md`)
- Telegram API → Bot startup: delivers updates (evidence: `main.py`)
- Bot startup → Bot instance: starts polling (evidence: `main.py`)
- Configuration → Bot instance: provides token (evidence: `core/bot_instance.py`)
- Bot instance → Telegram API: sends responses (evidence: `core/bot_instance.py`)
- Bot startup → User menu: registers handlers (evidence: `main.py`)
- Bot startup → Admin panel: registers handlers (evidence: `main.py`)
- User menu → Vehicle tools: routes to (evidence: `handlers/user/user_main_menu.py`)
- User menu → Subscription center: routes to (evidence: `handlers/user/user_main_menu.py`)
- User menu → Statistics and export: records usage (evidence: `handlers/user/user_main_menu.py`)
- Subscription center → Purchase and refunds: starts purchase (evidence: `handlers/user/subscription/buy_subscription.py`)
- Admin panel → Admin accounts: delegates to (evidence: `handlers/admin/admin_main_menu.py`)
- Admin panel → Admin operations: routes to (evidence: `handlers/admin/__init__.py`)
- Admin panel → Statistics and export: routes to (evidence: `handlers/admin/statistics/statistics.py`)
- User menu → Handler guards: applies guards (evidence: `handlers/user/user_main_menu.py`)
- Handler guards → Blocked-user state: checks and updates (evidence: `handlers/user/utils.py`)
- Admin panel → Admin communications: routes communications (evidence: `handlers/admin/communication/communication.py`)
- User-admin chat → Admin communications: coordinates chat (evidence: `handlers/user/others/others_chat_with_admin.py`)
- Vehicle tools → External APIs: uses APIs
- Shared dependencies → Statistics and export: imports module (evidence: `core/imports.py`)
