How spinnealte/vibe_bot works
Stubbot is a Telegram bot for presenting courses and sessions, collecting client profiles and consents, and (when enabled) accepting enrollment applications. Clients browse the schedule, register, and can manage their profile and applications; administrators manage course information and operations. The graph includes catalog, registration, enrollment, administration, and analytics/export stages. Source excerpts and the index support the major module relationships; unsampled handler details and integrations are not expanded beyond those references.
Main entry points: repositories Repositories · handlers Bot handlers · admin.py Admin handlers · catalog_flow.py Catalog flow
Components 22
Telegram experience
- Bot handlers
stubbot/tg/handlers - Registration flows
stubbot/tg/flows.py - Catalog flow
stubbot/tg/catalog_flow.py - Admin handlers
stubbot/tg/handlers/admin.py - Screens and rendering
stubbot/tg/render.py - Callback actions
stubbot/tg/callbacks.py
Course and client services
- Registration service
stubbot/services/registration.py - Consent services
stubbot/services/consents.py - Client service
stubbot/services/clients.py - Schedule service
stubbot/services/schedule.py - Enrollment service
stubbot/services/enrollments.py
Administration
- Course administration
stubbot/services/admin_courses.py - Dictionary administration
stubbot/services/admin_dictionaries.py - Session administration
stubbot/services/admin_sessions.py - Client export
stubbot/services/client_export.py
Persistence and reporting
- Repositories
stubbot/repositories - Domain models
stubbot/db/models - Database
stubbot/db/session.py - Analytics repository
stubbot/repositories/analytics.py - Runtime settings
stubbot/config.py
Other components
- Client
- Administrator
Connections 32
- Client → Bot handlers: messages
- Administrator → Admin handlers: administers
- Bot handlers → Registration flows: routes registration
stubbot/tg/flows.py - Bot handlers → Catalog flow: routes catalog
stubbot/tg/handlers/application.py - Registration flows → Registration service: uses
stubbot/tg/flows.py - Registration flows → Consent services: uses
stubbot/tg/flows.py - Registration flows → Client service: uses
stubbot/tg/flows.py - Catalog flow → Schedule service: loads schedule
stubbot/tg/catalog_flow.py - Catalog flow → Enrollment service: submits applications
stubbot/tg/catalog_flow.py - Catalog flow → Screens and rendering: renders cards
stubbot/tg/catalog_flow.py - Bot handlers → Screens and rendering: renders replies
stubbot/tg/handlers/application.py - Bot handlers → Client service: uses
- Admin handlers → Course administration: manages courses
stubbot/tg/handlers/admin.py - Admin handlers → Dictionary administration: manages dictionaries
stubbot/tg/handlers/admin.py - Admin handlers → Session administration: manages sessions
stubbot/tg/handlers/admin.py - Admin handlers → Client export: exports clients
stubbot/tg/handlers/admin.py - Admin handlers → Catalog flow: uses catalog
stubbot/tg/handlers/admin.py - Registration service → Repositories: persists profile
- Consent services → Repositories: persists consent
- Client service → Repositories: reads and writes
stubbot/services/clients.py - Client service → Analytics repository: records attribution
stubbot/services/clients.py - Enrollment service → Schedule service: checks availability
stubbot/services/enrollments.py - Enrollment service → Repositories: stores applications
stubbot/services/enrollments.py - Schedule service → Repositories: loads catalog
stubbot/services/schedule.py - Dictionary administration → Repositories: updates dictionaries
stubbot/services/admin_dictionaries.py - Session administration → Repositories: updates sessions
stubbot/services/admin_sessions.py - Client export → Repositories: reads client data
stubbot/services/client_export.py - Repositories → Domain models: queries models
stubbot/repositories/clients.py - Repositories → Database: executes queries
- Domain models → Database: maps records
- Bot handlers → Callback actions: uses actions
stubbot/tg/handlers/application.py - Bot handlers → Runtime settings: reads settings
stubbot/tg/handlers/application.py