How maxxsalov/golova_na_meste_bot works
This is a Telegram reminder bot for shared chats. Members register, send natural-language reminder requests, and receive scheduled chat notifications with controls to mark done or snooze. Separate handlers support reminder lists and management, timezone and quiet-mode settings, statistics, help/FAQ, and inline commands. The main bot process registers the handlers; a separate scheduler polls overdue reminders. Relationships below follow shown imports, calls, and router registration; unsampled behavior is represented only where documented in the README.
Main entry points: main.py Bot entry · repository.py Reminder repository · misc.py Chat settings · jobs.py Reminder dispatch
Components 17
Telegram bot
- Bot entry
bot/main.py - Settings
bot/config.py - Registration
bot/handlers/registration.py - Chat settings
bot/handlers/misc.py - Inline commands
bot/handlers/inline.py - Help and FAQ
bot/content.py
Reminder workflow
- Reminder commands
bot/handlers/reminders.py - Message parser
bot/parser.py - Reminder actions
bot/handlers/callbacks.py
Persistence
- DB sessions
db/database.py - Reminder repository
db/repository.py - Domain models
db/models.py - SQL database
Scheduled delivery
- Scheduler entry
scheduler/main.py - Reminder dispatch
scheduler/jobs.py
Other components
- Chat members
- Telegram API
Connections 30
- Chat members → Telegram API: send commands
README.md - Telegram API → Bot entry: deliver updates
bot/main.py - Bot entry → Settings: loads settings
bot/main.py - Bot entry → DB sessions: creates sessions
bot/main.py - Bot entry → Registration: registers router
bot/main.py - Bot entry → Reminder commands: registers router
bot/main.py - Bot entry → Reminder actions: registers router
bot/main.py - Bot entry → Chat settings: registers router
bot/main.py - Bot entry → Inline commands: registers router
bot/main.py - Registration → Reminder repository: uses
bot/handlers/registration.py - Reminder commands → Message parser: parses messages
bot/handlers/reminders.py - Reminder commands → Reminder repository: resolves and saves
bot/handlers/reminders.py - Reminder commands → Telegram API: replies
bot/handlers/reminders.py - Reminder actions → Reminder repository: updates status
bot/handlers/callbacks.py - Reminder actions → Help and FAQ: uses FAQ
bot/handlers/callbacks.py - Reminder actions → Telegram API: edits messages
bot/handlers/callbacks.py - Chat settings → Reminder repository: manages settings
bot/handlers/misc.py - Chat settings → Domain models: queries statistics
bot/handlers/misc.py - Chat settings → Help and FAQ: serves FAQ
bot/handlers/misc.py - Chat settings → Telegram API: replies
bot/handlers/misc.py - Inline commands → Help and FAQ: filters commands
bot/handlers/inline.py - Reminder repository → Domain models: queries entities
db/repository.py - Bot entry → SQL database: connects
- Scheduler entry → Settings: loads settings
scheduler/main.py - Scheduler entry → DB sessions: creates sessions
scheduler/main.py - Scheduler entry → Reminder dispatch: schedules every 30s
scheduler/main.py - Reminder dispatch → Reminder repository: finds overdue
scheduler/jobs.py - Reminder dispatch → Domain models: loads reminder details
scheduler/jobs.py - Reminder dispatch → Reminder actions: gets action keyboard
scheduler/jobs.py - Reminder dispatch → Telegram API: sends notifications
scheduler/jobs.py