# boriskartofel/caloriesbot architecture

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

- Interactive diagram: https://gitdiagram.com/boriskartofel/caloriesbot
- Repository: https://github.com/boriskartofel/caloriesbot

## Overview

Calorizator is a Telegram calorie-tracking bot: Telegram updates enter through its webhook, are dispatched to message, command, or callback handlers, and then reach managers that implement the product, calorie, statistics, and timer interactions. Managers persist user and domain state and return Telegram responses. The README establishes the bot’s main capabilities; sampled source shows the webhook, dispatch, handler, manager, and persistence paths. Kafka components are present in the tree, but their full runtime wiring is not shown.

Main entry points: [`src/main/java/telegram/Calories_Bot/service/UpdateDispatcher.java`](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/UpdateDispatcher.java) (Update dispatcher), [`src/main/java/telegram/Calories_Bot/service/manager/NotificationManager.java`](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/manager/NotificationManager.java) (Timer notifications), [`src/main/java/telegram/Calories_Bot/service/manager/MainManager.java`](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/manager/MainManager.java) (Main menu), [`src/main/java/telegram/Calories_Bot/service/manager/ProductManager.java`](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/manager/ProductManager.java) (Product tracking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Webhook and dispatch"]
  node_bot["Webhook bot<br/>[Bot.java]"]
  node_controller["Webhook controller"]
  node_dispatcher["Update dispatcher"]
  node_kafka_producer["Update producer"]
  node_kafka_queue["Kafka updates"]
  node_kafka_consumer["Update consumer"]
end

subgraph group_interaction["Bot interactions"]
  node_command_handler["Command handler"]
  node_message_handler["Message handler"]
  node_callback_handler["Callback handler"]
  node_keyboard_factory["Keyboard builder"]
end

subgraph group_domain["Calorie and timer features"]
  node_main_manager["Main menu<br/>[MainManager.java]"]
  node_product_manager["Product tracking"]
  node_notification_manager["Timer notifications"]
  node_timer_task["Timer task"]
  node_product_parser["Product parser<br/>[ProductParser.java]"]
end

subgraph group_persistence["Domain persistence"]
  node_user_repo["User repository<br/>[UserRepo.java]"]
  node_domain_repos["Product and timer repositories"]
  node_user_entity["User state<br/>[User.java]"]
  node_product_entity["Food products<br/>[Product.java]"]
  node_notification_entity["Notification state<br/>[Notification.java]"]
end

node_telegram_user(("Telegram user"))
node_telegram(("Telegram API"))

node_telegram_user -->|"sends updates"| node_telegram
node_telegram -.->|"posts webhook"| node_controller
node_controller -->|"publishes updates"| node_kafka_producer
node_kafka_producer -.->|"publishes updates"| node_kafka_queue
node_kafka_queue -.->|"delivers updates"| node_kafka_consumer
node_kafka_consumer -->|"dispatches updates"| node_dispatcher
node_bot -->|"dispatches updates"| node_dispatcher
node_dispatcher -->|"checks and registers"| node_user_repo
node_dispatcher -->|"routes commands"| node_command_handler
node_dispatcher -->|"routes messages"| node_message_handler
node_dispatcher -->|"routes callbacks"| node_callback_handler
node_command_handler -->|"handles commands"| node_main_manager
node_message_handler -->|"delegates messages"| node_main_manager
node_message_handler -->|"delegates messages"| node_product_manager
node_message_handler -->|"delegates messages"| node_notification_manager
node_callback_handler -->|"routes callbacks"| node_main_manager
node_callback_handler -->|"routes callbacks"| node_product_manager
node_callback_handler -->|"routes callbacks"| node_notification_manager
node_main_manager -->|"reads user state"| node_user_repo
node_main_manager -->|"cleans draft records"| node_domain_repos
node_product_manager -->|"reads and saves"| node_domain_repos
node_notification_manager -->|"reads and saves"| node_domain_repos
node_notification_manager -->|"starts timer"| node_timer_task
node_notification_manager -->|"updates user state"| node_user_repo
node_main_manager -->|"builds menus"| node_keyboard_factory
node_product_manager -->|"builds menus"| node_keyboard_factory
node_notification_manager -->|"builds menus"| node_keyboard_factory
node_user_repo -->|"persists"| node_user_entity
node_domain_repos -.->|"persists products"| node_product_entity
node_domain_repos -.->|"persists timers"| node_notification_entity
node_product_manager -.->|"parses product data"| node_product_parser
node_bot -.->|"sends responses"| node_telegram

click node_bot "https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/bot/Bot.java"
click node_controller "https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/controller/MainController.java"
click node_dispatcher "https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/UpdateDispatcher.java"
click node_kafka_producer "https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/kafka/TelegramBotUpdatesKafkaProducer.java"
click node_kafka_consumer "https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/kafka/TelegramBotUpdatesKafkaConsumer.java"
click node_command_handler "https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/handler/CommandHandler.java"
click node_message_handler "https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/handler/MessageHandler.java"
click node_callback_handler "https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/handler/CallbackQueryHandler.java"
click node_main_manager "https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/manager/MainManager.java"
click node_product_manager "https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/manager/ProductManager.java"
click node_notification_manager "https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/manager/NotificationManager.java"
click node_timer_task "https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/manager/notification/NotificationRunnableTask.java"
click node_keyboard_factory "https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/factory/KeyboardFactory.java"
click node_user_repo "https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/repository/UserRepo.java"
click node_domain_repos "https://github.com/boriskartofel/caloriesbot/tree/stable/src/main/java/telegram/Calories_Bot/repository"
click node_user_entity "https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/entity/User.java"
click node_product_entity "https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/entity/Product.java"
click node_notification_entity "https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/entity/Notification.java"
click node_product_parser "https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/util/ProductParser.java"

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_bot,node_controller,node_dispatcher,node_kafka_producer,node_kafka_queue,node_kafka_consumer,node_telegram_user toneBlue
class node_command_handler,node_message_handler,node_callback_handler,node_keyboard_factory toneAmber
class node_main_manager,node_product_manager,node_notification_manager,node_timer_task,node_product_parser,node_telegram toneMint
class node_user_repo,node_domain_repos,node_user_entity,node_product_entity,node_notification_entity toneRose
```

## Components

### Webhook and dispatch

- [Webhook bot](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/bot/Bot.java): `src/main/java/telegram/Calories_Bot/bot/Bot.java`
- [Webhook controller](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/controller/MainController.java): `src/main/java/telegram/Calories_Bot/controller/MainController.java`
- [Update dispatcher](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/UpdateDispatcher.java): `src/main/java/telegram/Calories_Bot/service/UpdateDispatcher.java`
- [Update producer](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/kafka/TelegramBotUpdatesKafkaProducer.java): `src/main/java/telegram/Calories_Bot/service/kafka/TelegramBotUpdatesKafkaProducer.java`
- **Kafka updates**
- [Update consumer](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/kafka/TelegramBotUpdatesKafkaConsumer.java): `src/main/java/telegram/Calories_Bot/service/kafka/TelegramBotUpdatesKafkaConsumer.java`

### Bot interactions

- [Command handler](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/handler/CommandHandler.java): `src/main/java/telegram/Calories_Bot/service/handler/CommandHandler.java`
- [Message handler](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/handler/MessageHandler.java): `src/main/java/telegram/Calories_Bot/service/handler/MessageHandler.java`
- [Callback handler](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/handler/CallbackQueryHandler.java): `src/main/java/telegram/Calories_Bot/service/handler/CallbackQueryHandler.java`
- [Keyboard builder](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/factory/KeyboardFactory.java): `src/main/java/telegram/Calories_Bot/service/factory/KeyboardFactory.java`

### Calorie and timer features

- [Main menu](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/manager/MainManager.java): `src/main/java/telegram/Calories_Bot/service/manager/MainManager.java`
- [Product tracking](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/manager/ProductManager.java): `src/main/java/telegram/Calories_Bot/service/manager/ProductManager.java`
- [Timer notifications](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/manager/NotificationManager.java): `src/main/java/telegram/Calories_Bot/service/manager/NotificationManager.java`
- [Timer task](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/service/manager/notification/NotificationRunnableTask.java): `src/main/java/telegram/Calories_Bot/service/manager/notification/NotificationRunnableTask.java`
- [Product parser](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/util/ProductParser.java): `src/main/java/telegram/Calories_Bot/util/ProductParser.java`

### Domain persistence

- [User repository](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/repository/UserRepo.java): `src/main/java/telegram/Calories_Bot/repository/UserRepo.java`
- [Product and timer repositories](https://github.com/boriskartofel/caloriesbot/tree/stable/src/main/java/telegram/Calories_Bot/repository): `src/main/java/telegram/Calories_Bot/repository`
- [User state](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/entity/User.java): `src/main/java/telegram/Calories_Bot/entity/User.java`
- [Food products](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/entity/Product.java): `src/main/java/telegram/Calories_Bot/entity/Product.java`
- [Notification state](https://github.com/boriskartofel/caloriesbot/blob/stable/src/main/java/telegram/Calories_Bot/entity/Notification.java): `src/main/java/telegram/Calories_Bot/entity/Notification.java`

### Other components

- **Telegram user**
- **Telegram API**

## Connections

- Telegram user → Telegram API: sends updates (evidence: `README.md`)
- Telegram API → Webhook controller: posts webhook (evidence: `README.md`)
- Webhook controller → Update producer: publishes updates (evidence: `src/main/java/telegram/Calories_Bot/controller/MainController.java`)
- Update producer → Kafka updates: publishes updates
- Kafka updates → Update consumer: delivers updates
- Update consumer → Update dispatcher: dispatches updates (evidence: `src/main/java/telegram/Calories_Bot/service/kafka/TelegramBotUpdatesKafkaConsumer.java`)
- Webhook bot → Update dispatcher: dispatches updates (evidence: `src/main/java/telegram/Calories_Bot/bot/Bot.java`)
- Update dispatcher → User repository: checks and registers (evidence: `src/main/java/telegram/Calories_Bot/service/UpdateDispatcher.java`)
- Update dispatcher → Command handler: routes commands (evidence: `src/main/java/telegram/Calories_Bot/service/UpdateDispatcher.java`)
- Update dispatcher → Message handler: routes messages (evidence: `src/main/java/telegram/Calories_Bot/service/UpdateDispatcher.java`)
- Update dispatcher → Callback handler: routes callbacks (evidence: `src/main/java/telegram/Calories_Bot/service/UpdateDispatcher.java`)
- Command handler → Main menu: handles commands (evidence: `src/main/java/telegram/Calories_Bot/service/handler/CommandHandler.java`)
- Message handler → Main menu: delegates messages (evidence: `src/main/java/telegram/Calories_Bot/service/handler/MessageHandler.java`)
- Message handler → Product tracking: delegates messages (evidence: `src/main/java/telegram/Calories_Bot/service/handler/MessageHandler.java`)
- Message handler → Timer notifications: delegates messages (evidence: `src/main/java/telegram/Calories_Bot/service/handler/MessageHandler.java`)
- Callback handler → Main menu: routes callbacks (evidence: `src/main/java/telegram/Calories_Bot/service/handler/CallbackQueryHandler.java`)
- Callback handler → Product tracking: routes callbacks (evidence: `src/main/java/telegram/Calories_Bot/service/handler/CallbackQueryHandler.java`)
- Callback handler → Timer notifications: routes callbacks (evidence: `src/main/java/telegram/Calories_Bot/service/handler/CallbackQueryHandler.java`)
- Main menu → User repository: reads user state (evidence: `src/main/java/telegram/Calories_Bot/service/manager/MainManager.java`)
- Main menu → Product and timer repositories: cleans draft records (evidence: `src/main/java/telegram/Calories_Bot/service/manager/MainManager.java`)
- Product tracking → Product and timer repositories: reads and saves (evidence: `src/main/java/telegram/Calories_Bot/service/manager/ProductManager.java`)
- Timer notifications → Product and timer repositories: reads and saves (evidence: `src/main/java/telegram/Calories_Bot/service/manager/NotificationManager.java`)
- Timer notifications → Timer task: starts timer (evidence: `src/main/java/telegram/Calories_Bot/service/manager/NotificationManager.java`)
- Timer notifications → User repository: updates user state (evidence: `src/main/java/telegram/Calories_Bot/service/manager/NotificationManager.java`)
- Main menu → Keyboard builder: builds menus (evidence: `src/main/java/telegram/Calories_Bot/service/manager/MainManager.java`)
- Product tracking → Keyboard builder: builds menus (evidence: `src/main/java/telegram/Calories_Bot/service/manager/ProductManager.java`)
- Timer notifications → Keyboard builder: builds menus (evidence: `src/main/java/telegram/Calories_Bot/service/manager/NotificationManager.java`)
- User repository → User state: persists (evidence: `src/main/java/telegram/Calories_Bot/repository/UserRepo.java`)
- Product and timer repositories → Food products: persists products (evidence: `src/main/java/telegram/Calories_Bot/repository/ProductRepo.java`)
- Product and timer repositories → Notification state: persists timers (evidence: `src/main/java/telegram/Calories_Bot/repository/NotificationRepo.java`)
- Product tracking → Product parser: parses product data
- Webhook bot → Telegram API: sends responses
