How javohir-g/ttpu-timetable works
TTPU provides EduPage timetables through two Telegram workflows: a self-service bot for students and teachers, and a one-shot sender for a configured group. A separate mini-app data builder publishes current and upcoming timetable data for a web app, with a service worker supporting offline access. The sampled sources show timetable retrieval, formatting, bot interactions, and caching; the mini-app page implementation and profile persistence details were not sampled, so those links are limited.
Main entry points: universal_bot.py Self-service bot · bot.py One-shot sender · data.json Published timetable data · build_data.py Mini-app data builder
Components 16
Telegram workflows
- Self-service bot
universal_bot.py - Profile setup
universal_bot.py - Schedule requests
universal_bot.py - One-shot sender
bot.py
Timetable data
- EduPage timetable retrieval
universal_bot.py - Timetable cache
universal_bot.py - Schedule formatting
universal_bot.py - Fixed-group schedule
bot.py
Mini-app
- Mini-app data builder
miniapp/build_data.py - Published timetable data
miniapp/data.json - Mini-app page
miniapp/index.html - Offline service worker
miniapp/sw.js
Other components
- Student or teacher
- Scheduled operator
- Telegram API
- EduPage service
Connections 18
- Student or teacher → Self-service bot: sends commands
README.md - Self-service bot → Telegram API: polls and replies
universal_bot.py - Self-service bot → Profile setup: handles setup
universal_bot.py - Profile setup → EduPage timetable retrieval: searches entities
universal_bot.py - Self-service bot → Schedule requests: routes schedule commands
universal_bot.py - Schedule requests → Timetable cache: loads timetable
universal_bot.py - Timetable cache → EduPage service: fetches timetable
universal_bot.py - Schedule requests → Schedule formatting: renders schedule
universal_bot.py - Schedule requests → Telegram API: sends schedule
universal_bot.py - Scheduled operator → One-shot sender: runs command
README.md - One-shot sender → EduPage service: fetches timetable
bot.py - One-shot sender → Fixed-group schedule: builds and formats
bot.py - One-shot sender → Telegram API: sends message
bot.py - Mini-app data builder → EduPage service: fetches versions and tables
miniapp/build_data.py - Mini-app data builder → Published timetable data: writes data
miniapp/build_data.py - Offline service worker → Published timetable data: caches data
miniapp/sw.js - Offline service worker → Mini-app page: caches page
miniapp/sw.js - Mini-app page → Published timetable data: reads timetable data