How matinghanbari/diningreservationbot works
This is a Persian-language Telegram bot for university dining reservations through Samad. Its main workflow takes a student's Telegram request through a screen handler and application use case, obtains or renews a Samad session, and makes the Samad request. Other documented branches cover automatic booking, forget-code sharing, account details, operator support, and an optional AI support chatbot. The README and source index support the layer boundaries and major capabilities; several feature-specific handlers and integrations were not excerpted, so uncertain internal calls are left unconnected.
Main entry points: handlers Screen handlers · session.service.ts Session renewal · reservation.service.ts Menus and bookings · auth.service.ts Authentication
Components 22
Telegram experience
- Screen handlers
src/bot/handlers - Bot service access
src/bot/services.ts
Application services
- Authentication
src/app/auth.service.ts - Menus and bookings
src/app/reservation.service.ts - Session renewal
src/app/session.service.ts - Automatic booking
src/app/auto-reserve.service.ts - Forget-code pool
src/app/forget-code.service.ts - Credit reminders
src/app/credit-watch.service.ts - Account details
src/app/auth.service.ts - Operator support
src/app/support.service.ts - Support chatbot
src/app/chatbot.service.ts - Admin controls
src/app/admin.service.ts
Samad integration
- Samad gateway
src/samad/gateway.ts - Samad HTTP client
src/samad/client.ts
State and persistence
- Redis repositories
src/db/redis - Session cache
src/cache/session.store.ts
Support and operations
- Scheduled jobs
src/scheduler/scheduler.ts
Other components
- Students
- Telegram
- Samad platform
- OpenRouter assistant
- Operator messaging
Connections 26
- Students → Telegram: send requests
- Telegram → Screen handlers: deliver updates
- Screen handlers → Bot service access: access services
src/bot/handlers/start.handler.ts - Screen handlers → Authentication: sign in
- Screen handlers → Menus and bookings: browse and book
- Screen handlers → Automatic booking: configure booking
- Screen handlers → Forget-code pool: claim or donate
- Screen handlers → Account details: view details
- Screen handlers → Operator support: send support
- Screen handlers → Support chatbot: ask questions
- Screen handlers → Admin controls: administer bot
src/bot/handlers/admin.handler.ts - Authentication → Session renewal: establish session
src/app/auth.service.ts - Menus and bookings → Session renewal: use session
src/app/reservation.service.ts - Session renewal → Samad gateway: renew token
- Automatic booking → Menus and bookings: reserve meals
src/app/auto-reserve.service.ts - Forget-code pool → Menus and bookings: issue codes
src/app/forget-code.service.ts - Samad gateway → Samad HTTP client: make requests
- Samad HTTP client → Samad platform: call API
- Authentication → Redis repositories: persist account
- Forget-code pool → Redis repositories: store shared codes
- Operator support → Redis repositories: store tickets
- Session renewal → Session cache: cache tokens
src/app/session.service.ts - Scheduled jobs → Automatic booking: trigger booking
- Scheduled jobs → Credit reminders: trigger checks
- Support chatbot → OpenRouter assistant: request answers
- Operator support → Operator messaging: route messages