How andreaunali/whatsorder-ai works
WhatsOrder AI converts customer WhatsApp messages into reviewed, structured daily orders and a kitchen prep PDF. The main flow is WhatsApp intake, Python message processing (including deterministic checks, recurring-order handling and AI parsing), catalog validation, SQLite persistence, and dashboard review or PDF output. Customer profiles and standing orders support both daily automatic orders and “usual” references. The README documents file-based handoffs; sampled source confirms several internal calls, but not every processing branch, so undocumented relationships are omitted.
Main entry points: processor.py Message processor · app.py Order dashboard · whatsapp-listener.js WhatsApp listener · db.py Orders database
Components 19
WhatsApp intake
- WhatsApp listener
whatsapp-listener.js - Message inbox
- Listener commands
Order processing
- Message processor
processor.py - Local transcription
processor.py - Alias normalization
normalize.py - Order plausibility
sanity.py - Order parsing
processor.py - Recurring orders
processor.py - Catalog validation
processor.py
Order operations
- Orders database
db.py - Customer profiles
db.py - Standing orders
db.py
Review and output
- Order dashboard
app.py - Review queue
app.py - Kitchen prep PDF
pdf_generator.py
Other components
- Customer
- Groq LLM
- WhatsApp service
Connections 22
- Customer → WhatsApp service: sends message
README.md - WhatsApp service → WhatsApp listener: delivers text, voice, photo
README.md - WhatsApp listener → Message inbox: writes message files
README.md - Message inbox → Message processor: reads messages
README.md - Message processor → Local transcription: transcribes audio
README.md - Message processor → Alias normalization: normalizes text
processor.py - Message processor → Order plausibility: checks plausibility
processor.py - Message processor → Recurring orders: handles references
README.md - Message processor → Order parsing: parses messages
README.md - Order parsing → Groq LLM: requests parse
processor.py - Message processor → Catalog validation: validates parsed items
processor.py - Recurring orders → Orders database: loads base orders
README.md - Catalog validation → Orders database: saves validated orders
README.md - Message processor → Orders database: looks up customer
processor.py - Order dashboard → Orders database: reads and updates orders
app.py - Order dashboard → Review queue: presents ambiguous orders
README.md - Order dashboard → Standing orders: creates today's orders
app.py - Order dashboard → Customer profiles: manages profiles
app.py - Order dashboard → Kitchen prep PDF: generates prep sheet
app.py - Order dashboard → Listener commands: writes broadcast or disconnect
README.md - Listener commands → WhatsApp listener: polls commands
README.md - WhatsApp listener → WhatsApp service: sends broadcast
whatsapp-listener.js