How deniskor2208/task-telegram-bot works
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: app.go App bootstrap · commands Task commands · task_storage.go Task storage · tgclient.go Telegram client
Components 24
Telegram interface
- Telegram client
internal/clients/tg/tgclient.go - Message model
internal/model/messages/incoming_msg.go - Command registry
internal/interfaces/command/registry.go
User workflows
- Task commands
internal/commands - Create task flow
internal/commands/addtask/save_task.go - Task viewing
internal/commands/view_tasks.go - Task status actions
internal/commands/completed_task.go - Delete task flow
internal/commands/delete_task/delete_task_by_id.go - Timezone settings
internal/commands/set_timezone/set_timezone_confirm.go - Inline buttons
internal/ui/buttons/commands
Background services
- Overdue checker
internal/services/overdue_checker.go - Deadline notifier
internal/services/deadline_notifier.go - Session service
internal/services/session_service.go
Persistence
- User storage
internal/repositories/user_storage.go - Task storage
internal/repositories/task_storage.go - Status storage
internal/repositories/status_storage.go - Notification storage
internal/repositories/task_notification_storage.go - Redis storage
internal/repositories/redis_storage.go
Application foundation
- App bootstrap
cmd/app/app.go - Configuration
internal/config/config.go
Other components
- Telegram user
- Telegram API
- PostgreSQL
- Redis
Connections 34
- Telegram user → Telegram API: sends updates
- Telegram API → Telegram client: delivers updates
internal/clients/tg/tgclient.go - Telegram client → Message model: forwards messages
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
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
internal/commands/tasks_action.go - Telegram client → Telegram API: sends replies
internal/clients/tg/tgclient.go - Overdue checker → Task storage: marks overdue
- Deadline notifier → Task storage: reads deadlines
internal/services/deadline_notifier.go - Deadline notifier → Notification storage: tracks notices
- Deadline notifier → Telegram client: sends reminders
- Session service → Redis storage: reads and writes
internal/services/session_service.go - User storage → PostgreSQL: reads and writes
internal/repositories/user_storage.go - Task storage → PostgreSQL: reads and writes
internal/repositories/task_storage.go - Status storage → PostgreSQL: reads and writes
- Notification storage → PostgreSQL: reads and writes
- Redis storage → Redis: reads and writes
internal/repositories/redis_storage.go - App bootstrap → Configuration: loads settings
cmd/app/app.go - App bootstrap → Telegram client: initializes client
cmd/app/app.go - App bootstrap → Message model: initializes model
cmd/app/app.go - App bootstrap → Command registry: initializes registry
cmd/app/app.go - App bootstrap → Session service: initializes service
cmd/app/app.go - App bootstrap → Overdue checker: initializes checker
cmd/app/app.go - App bootstrap → Deadline notifier: initializes notifier
cmd/app/app.go