# deniskor2208/task-telegram-bot architecture

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

- Interactive diagram: https://gitdiagram.com/deniskor2208/task-telegram-bot
- Repository: https://github.com/deniskor2208/task-telegram-bot

## Overview

Task Telegram Bot is a Telegram-based task manager. A user sends a command or presses a button; the Telegram client converts the update into a message for the application model, which dispatches command handlers that guide task creation, viewing, status changes, and settings. PostgreSQL stores users, tasks, statuses, and notification data; Redis stores user sessions. Background services check overdue tasks and send deadline reminders. The README documents these capabilities, while several command and service implementations were not sampled, so uncertain runtime links are dashed and uncited.

Main entry points: [`cmd/app/app.go`](https://github.com/deniskor2208/task-telegram-bot/blob/master/cmd/app/app.go) (App bootstrap), [`internal/commands`](https://github.com/deniskor2208/task-telegram-bot/tree/master/internal/commands) (Task commands), [`internal/repositories/task_storage.go`](https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/repositories/task_storage.go) (Task storage), [`internal/clients/tg/tgclient.go`](https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/clients/tg/tgclient.go) (Telegram client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_telegram["Telegram interface"]
  node_tg_client["Telegram client<br/>[tgclient.go]"]
  node_message_model["Message model<br/>[incoming_msg.go]"]
  node_command_registry["Command registry<br/>[registry.go]"]
end

subgraph group_commands["User workflows"]
  node_task_commands["Task commands"]
  node_create_task["Create task flow<br/>[save_task.go]"]
  node_view_tasks["Task viewing<br/>[view_tasks.go]"]
  node_status_commands["Task status actions<br/>[completed_task.go]"]
  node_delete_task["Delete task flow"]
  node_timezone["Timezone settings"]
  node_task_buttons["Inline buttons"]
end

subgraph group_services["Background services"]
  node_overdue_checker["Overdue checker<br/>[overdue_checker.go]"]
  node_deadline_notifier["Deadline notifier"]
  node_session_service["Session service<br/>[session_service.go]"]
end

subgraph group_storage["Persistence"]
  node_user_storage["User storage<br/>[user_storage.go]"]
  node_task_storage["Task storage<br/>[task_storage.go]"]
  node_status_storage["Status storage<br/>[status_storage.go]"]
  node_notification_storage["Notification storage"]
  node_redis_storage["Redis storage<br/>[redis_storage.go]"]
end

subgraph group_foundation["Application foundation"]
  node_app["App bootstrap<br/>[app.go]"]
  node_config["Configuration<br/>[config.go]"]
end

node_user(("Telegram user"))
node_telegram_api["Telegram API"]
node_postgres[("PostgreSQL")]
node_redis[("Redis")]

node_user -->|"sends updates"| node_telegram_api
node_telegram_api -->|"delivers updates"| node_tg_client
node_tg_client -->|"forwards messages"| node_message_model
node_message_model -.->|"dispatches commands"| node_command_registry
node_command_registry -.->|"routes commands"| node_task_commands
node_task_commands -.->|"guides creation"| node_create_task
node_task_commands -.->|"opens task view"| node_view_tasks
node_task_commands -.->|"changes status"| node_status_commands
node_task_commands -.->|"deletes tasks"| node_delete_task
node_task_commands -.->|"sets timezone"| node_timezone
node_create_task -->|"creates tasks"| node_task_storage
node_view_tasks -.->|"reads tasks"| node_task_storage
node_status_commands -.->|"updates tasks"| node_task_storage
node_delete_task -.->|"deletes tasks"| node_task_storage
node_timezone -.->|"updates timezone"| node_user_storage
node_task_commands -.->|"presents actions"| node_task_buttons
node_tg_client -->|"sends replies"| node_telegram_api
node_overdue_checker -.->|"marks overdue"| node_task_storage
node_deadline_notifier -->|"reads deadlines"| node_task_storage
node_deadline_notifier -.->|"tracks notices"| node_notification_storage
node_deadline_notifier -.->|"sends reminders"| node_tg_client
node_session_service -->|"reads and writes"| node_redis_storage
node_user_storage -->|"reads and writes"| node_postgres
node_task_storage -->|"reads and writes"| node_postgres
node_status_storage -.->|"reads and writes"| node_postgres
node_notification_storage -.->|"reads and writes"| node_postgres
node_redis_storage -->|"reads and writes"| node_redis
node_app -->|"loads settings"| node_config
node_app -->|"initializes client"| node_tg_client
node_app -->|"initializes model"| node_message_model
node_app -->|"initializes registry"| node_command_registry
node_app -->|"initializes service"| node_session_service
node_app -->|"initializes checker"| node_overdue_checker
node_app -->|"initializes notifier"| node_deadline_notifier

click node_tg_client "https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/clients/tg/tgclient.go"
click node_message_model "https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/model/messages/incoming_msg.go"
click node_command_registry "https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/interfaces/command/registry.go"
click node_task_commands "https://github.com/deniskor2208/task-telegram-bot/tree/master/internal/commands"
click node_create_task "https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/commands/addtask/save_task.go"
click node_view_tasks "https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/commands/view_tasks.go"
click node_status_commands "https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/commands/completed_task.go"
click node_delete_task "https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/commands/delete_task/delete_task_by_id.go"
click node_timezone "https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/commands/set_timezone/set_timezone_confirm.go"
click node_task_buttons "https://github.com/deniskor2208/task-telegram-bot/tree/master/internal/ui/buttons/commands"
click node_overdue_checker "https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/services/overdue_checker.go"
click node_deadline_notifier "https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/services/deadline_notifier.go"
click node_session_service "https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/services/session_service.go"
click node_user_storage "https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/repositories/user_storage.go"
click node_task_storage "https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/repositories/task_storage.go"
click node_status_storage "https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/repositories/status_storage.go"
click node_notification_storage "https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/repositories/task_notification_storage.go"
click node_redis_storage "https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/repositories/redis_storage.go"
click node_app "https://github.com/deniskor2208/task-telegram-bot/blob/master/cmd/app/app.go"
click node_config "https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/config/config.go"

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_tg_client,node_message_model,node_command_registry,node_user toneBlue
class node_task_commands,node_create_task,node_view_tasks,node_status_commands,node_delete_task,node_timezone,node_task_buttons,node_postgres,node_redis toneAmber
class node_overdue_checker,node_deadline_notifier,node_session_service,node_telegram_api toneMint
class node_user_storage,node_task_storage,node_status_storage,node_notification_storage,node_redis_storage toneRose
class node_app,node_config toneIndigo
```

## Components

### Telegram interface

- [Telegram client](https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/clients/tg/tgclient.go): `internal/clients/tg/tgclient.go`
- [Message model](https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/model/messages/incoming_msg.go): `internal/model/messages/incoming_msg.go`
- [Command registry](https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/interfaces/command/registry.go): `internal/interfaces/command/registry.go`

### User workflows

- [Task commands](https://github.com/deniskor2208/task-telegram-bot/tree/master/internal/commands): `internal/commands`
- [Create task flow](https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/commands/addtask/save_task.go): `internal/commands/addtask/save_task.go`
- [Task viewing](https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/commands/view_tasks.go): `internal/commands/view_tasks.go`
- [Task status actions](https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/commands/completed_task.go): `internal/commands/completed_task.go`
- [Delete task flow](https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/commands/delete_task/delete_task_by_id.go): `internal/commands/delete_task/delete_task_by_id.go`
- [Timezone settings](https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/commands/set_timezone/set_timezone_confirm.go): `internal/commands/set_timezone/set_timezone_confirm.go`
- [Inline buttons](https://github.com/deniskor2208/task-telegram-bot/tree/master/internal/ui/buttons/commands): `internal/ui/buttons/commands`

### Background services

- [Overdue checker](https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/services/overdue_checker.go): `internal/services/overdue_checker.go`
- [Deadline notifier](https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/services/deadline_notifier.go): `internal/services/deadline_notifier.go`
- [Session service](https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/services/session_service.go): `internal/services/session_service.go`

### Persistence

- [User storage](https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/repositories/user_storage.go): `internal/repositories/user_storage.go`
- [Task storage](https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/repositories/task_storage.go): `internal/repositories/task_storage.go`
- [Status storage](https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/repositories/status_storage.go): `internal/repositories/status_storage.go`
- [Notification storage](https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/repositories/task_notification_storage.go): `internal/repositories/task_notification_storage.go`
- [Redis storage](https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/repositories/redis_storage.go): `internal/repositories/redis_storage.go`

### Application foundation

- [App bootstrap](https://github.com/deniskor2208/task-telegram-bot/blob/master/cmd/app/app.go): `cmd/app/app.go`
- [Configuration](https://github.com/deniskor2208/task-telegram-bot/blob/master/internal/config/config.go): `internal/config/config.go`

### Other components

- **Telegram user**
- **Telegram API**
- **PostgreSQL**
- **Redis**

## Connections

- Telegram user → Telegram API: sends updates
- Telegram API → Telegram client: delivers updates (evidence: `internal/clients/tg/tgclient.go`)
- Telegram client → Message model: forwards messages (evidence: `internal/clients/tg/tgclient.go`)
- Message model → Command registry: dispatches commands
- Command registry → Task commands: routes commands
- Task commands → Create task flow: guides creation
- Task commands → Task viewing: opens task view
- Task commands → Task status actions: changes status
- Task commands → Delete task flow: deletes tasks
- Task commands → Timezone settings: sets timezone
- Create task flow → Task storage: creates tasks (evidence: `internal/commands/addtask/save_task.go`)
- Task viewing → Task storage: reads tasks
- Task status actions → Task storage: updates tasks
- Delete task flow → Task storage: deletes tasks
- Timezone settings → User storage: updates timezone
- Task commands → Inline buttons: presents actions (evidence: `internal/commands/tasks_action.go`)
- Telegram client → Telegram API: sends replies (evidence: `internal/clients/tg/tgclient.go`)
- Overdue checker → Task storage: marks overdue
- Deadline notifier → Task storage: reads deadlines (evidence: `internal/services/deadline_notifier.go`)
- Deadline notifier → Notification storage: tracks notices
- Deadline notifier → Telegram client: sends reminders
- Session service → Redis storage: reads and writes (evidence: `internal/services/session_service.go`)
- User storage → PostgreSQL: reads and writes (evidence: `internal/repositories/user_storage.go`)
- Task storage → PostgreSQL: reads and writes (evidence: `internal/repositories/task_storage.go`)
- Status storage → PostgreSQL: reads and writes
- Notification storage → PostgreSQL: reads and writes
- Redis storage → Redis: reads and writes (evidence: `internal/repositories/redis_storage.go`)
- App bootstrap → Configuration: loads settings (evidence: `cmd/app/app.go`)
- App bootstrap → Telegram client: initializes client (evidence: `cmd/app/app.go`)
- App bootstrap → Message model: initializes model (evidence: `cmd/app/app.go`)
- App bootstrap → Command registry: initializes registry (evidence: `cmd/app/app.go`)
- App bootstrap → Session service: initializes service (evidence: `cmd/app/app.go`)
- App bootstrap → Overdue checker: initializes checker (evidence: `cmd/app/app.go`)
- App bootstrap → Deadline notifier: initializes notifier (evidence: `cmd/app/app.go`)
