How atcasanova/churrasbot works
CHURRASBOT is a Bash-based Telegram bot for scheduling group barbecues and recording attendance through time-limited live-location check-ins. Its user workflow runs from Telegram updates through the bot’s message/location handling to event administration or check-in validation, then to group responses and attendance ranking. The README also documents venue management, calendar invitations, email notifications, reminders, and admin fraud cancellation. The source excerpts were unavailable, so edges reflect documented behavior and filenames; internal call wiring beyond that is not asserted.
Main entry points: handleMessage.sh Message handler · main.sh Main loop · newchurras.sh Event scheduling · achaChurras.sh Check-in validation
Components 21
Bot runtime
- Bot launcher
bot.sh - Main loop
src/main.sh - Message handler
src/handleMessage.sh - Location handler
src/handleLocation.sh - Live-location handler
src/handleLiveLocation.sh
Event management
- Venue setup
src/newplace.sh - Event scheduling
src/newchurras.sh - Schedule conflict check
src/checkOverlap.sh - Event deletion
src/delchurras.sh - Next event query
src/qualchurras.sh - Calendar invitation
src/geraIcs.sh
Attendance
- Check-in validation
src/achaChurras.sh - Distance check
src/distance.sh - Attendance ranking
src/ranking.sh - Fraud cancellation
src/fake.sh
Communications
- Check-in reminder
src/lembrete.sh - Email registration
src/cadastraEmail.sh - Email notifications
src/notificaUsers.sh
Other components
- Telegram users
- Telegram API
- SMTP mail service
Connections 26
- Telegram users → Telegram API: send commands
- Telegram users → Telegram API: send live location
- Telegram API → Bot launcher: deliver updates
- Bot launcher → Main loop: start
- Main loop → Telegram API: poll updates
- Main loop → Message handler: handle messages
- Main loop → Location handler: handle locations
- Main loop → Live-location handler: handle live location
- Message handler → Venue setup: set venue
- Message handler → Event scheduling: schedule event
- Message handler → Event deletion: delete event
- Message handler → Next event query: query event
- Message handler → Email registration: register email
- Message handler → Attendance ranking: request ranking
- Message handler → Fraud cancellation: cancel check-in
- Event scheduling → Schedule conflict check: check conflicts
- Event scheduling → Calendar invitation: generate invitation
- Event scheduling → Email notifications: notify subscribers
- Live-location handler → Check-in validation: validate attendance
- Check-in validation → Distance check: check distance
- Check-in validation → Telegram API: remove location message
- Fraud cancellation → Attendance ranking: adjust score
- Check-in reminder → Telegram API: send reminder
- Email notifications → SMTP mail service: send email
- Message handler → Telegram API: send responses
- Event scheduling → Telegram API: announce and pin