How sinavarasina/sas-bot works
SAS-BOT is a WhatsApp public-service bot for village administration. Residents message the bot, pass NIK-based identification, choose a service, complete its stateful workflow, and receive a response or tracking ID. The main service branches cover resident registration/editing, letter requests and PDF generation, and photo-backed complaints; service reviews and status tracking are additional capabilities. PostgreSQL holds operational data, while Google Sheets supports synchronization and reporting. The excerpts show runtime routing and several service integrations; some documented capabilities have unsampled implementation details, so those links are omitted or marked unverified.
Main entry points: router.go Conversation router · surat/service.go Letter processing · pengaduan/service.go Complaint processing · db PostgreSQL
Components 20
Bot runtime
- Bot startup
cmd/sas-bot/main.go - WhatsApp client
internal/whatsapp/client.go - Message events
internal/whatsapp/event-handler.go - Conversation router
internal/bot/router/router.go - AI responses
internal/bot/gemini/service.go
Resident data
- Registration and editing
internal/bot/menu/datadiri/handler.go - Identity validation and save
internal/bot/menu/datadiri/service.go
Letter service
- Letter request flow
internal/bot/menu/surat/handler.go - Letter processing
internal/bot/menu/surat/service.go - Letter workflow state
internal/bot/menu/surat/state.go - PDF generation
internal/bot/menu/surat/generator.go
Complaints
- Complaint flow
internal/bot/menu/pengaduan/handler.go - Complaint processing
internal/bot/menu/pengaduan/service.go - Service reviews
internal/bot/menu
Persistence and integrations
- PostgreSQL
internal/db - Google Sheets
internal/sheets/sheets.go - ImgBB
internal/uploader/imgbb.go - R2 storage
internal/uploader/r2.go
Other components
- Resident
Connections 29
- Resident → WhatsApp: sends messages
README.md - WhatsApp → WhatsApp client: delivers events
internal/whatsapp/client.go - Bot startup → WhatsApp client: starts client
cmd/sas-bot/main.go - Bot startup → Conversation router: configures
cmd/sas-bot/main.go - WhatsApp client → Message events: registers handler
internal/whatsapp/client.go - Message events → Conversation router: routes messages
internal/whatsapp/event-handler.go - Conversation router → Registration and editing: dispatches
internal/bot/router/router.go - Conversation router → Letter request flow: dispatches
internal/bot/router/router.go - Conversation router → Complaint flow: dispatches
internal/bot/router/router.go - Conversation router → PostgreSQL: reads and updates sessions
internal/bot/router/router.go - Bot startup → AI responses: configures
cmd/sas-bot/main.go - Registration and editing → Identity validation and save: delegates validation
internal/bot/menu/datadiri/handler.go - Identity validation and save → PostgreSQL: checks and saves residents
internal/bot/menu/datadiri/service.go - Identity validation and save → Google Sheets: synchronizes resident data
internal/bot/menu/datadiri/service.go - Letter request flow → Letter processing: requests generation
internal/bot/menu/surat/handler.go - Letter request flow → PostgreSQL: reads resident data
internal/bot/menu/surat/handler.go - Letter processing → PostgreSQL: loads session data
internal/bot/menu/surat/service.go - Letter processing → PDF generation: starts generation
internal/bot/menu/surat/service.go - Letter processing → Letter workflow state: uses workflow state
- PDF generation → Google Sheets: logs letter status
internal/bot/menu/surat/generator.go - PDF generation → R2 storage: uploads generated files
internal/bot/menu/surat/generator.go - Complaint flow → Complaint processing: delegates image handling
internal/bot/menu/pengaduan/service.go - Complaint processing → ImgBB: uploads evidence
internal/bot/menu/pengaduan/service.go - Complaint processing → PostgreSQL: saves complaint
internal/bot/menu/pengaduan/service.go - Complaint processing → Google Sheets: records complaint
internal/bot/menu/pengaduan/service.go - Registration and editing → Service reviews: offers rating
README.md - Letter processing → Service reviews: offers rating
internal/bot/menu/surat/service.go - Complaint processing → Service reviews: offers rating
internal/bot/menu/pengaduan/service.go - Service reviews → Google Sheets: records ratings
README.md