How togi-png/telegram-bot works
This repository combines a Telegram task-add command handler with a calendar-based academic planner that sends a daily summary. The planner fetches Canvas assignments and Google Calendar events, interprets deadlines and schedules, then formats and sends a notification. The README describes weekly assignment notifications, while the sampled notifier code shows classes, personal events, upcoming work, and suggested study blocks. The graph separates those product stages; unsampled implementation details are omitted.
Main entry points: notifier.py Planner Orchestrator · command_handler.py Command Handler · tasks.json Task Store
Components 12
Task Commands
- Command Handler
command_handler.py - Task Store
tasks.json
Academic Planner
- Planner Orchestrator
notifier.py - Calendar Event Parsing
notifier.py - Assignment Processing
notifier.py - Study Block Planning
notifier.py - Summary Formatting
notifier.py
Notification Delivery
- Message Sender
notifier.py
Other components
- Student
- Telegram API
- Google Calendar Feed
- Canvas Assignment Feed
Connections 13
- Student → Telegram API: sends commands
- Command Handler → Telegram API: polls updates
command_handler.py - Command Handler → Task Store: loads and saves
command_handler.py - Command Handler → Telegram API: sends confirmation
command_handler.py - Planner Orchestrator → Google Calendar Feed: fetches feed
notifier.py - Planner Orchestrator → Canvas Assignment Feed: fetches feed
notifier.py - Planner Orchestrator → Calendar Event Parsing: gets events
notifier.py - Planner Orchestrator → Assignment Processing: gets assignments
notifier.py - Calendar Event Parsing → Study Block Planning: provides classes
notifier.py - Assignment Processing → Study Block Planning: provides assignments
notifier.py - Planner Orchestrator → Summary Formatting: builds report
notifier.py - Summary Formatting → Message Sender: provides message
notifier.py - Message Sender → Telegram API: sends notification
notifier.py