How shamalsathsara/queen-aura works
Queen Aura is a modular WhatsApp assistant: users send commands or natural-language messages, the bot routes them into academic, media, AI, quiz, greeting, and group-administration features, then replies through WhatsApp. The graph includes documented capabilities even where implementation was not sampled; their internal wiring is omitted when evidence is unavailable. Sampled code supports the routing, session, university, downloader, poll, greeting, and moderation-state links shown.
Main entry points: routes.js Command routes · AuraMain.js Bot event dispatcher · autoPollService.js IT quiz polls · middleware.js Access middleware
Components 30
WhatsApp entry
- Bot event dispatcher
AuraMain.js - Access middleware
src/core/middleware.js
Routing and state
- Intent and state router
src/core/router.js - Command routes
src/routes.js - Conversation sessions
src/state/session.js - Interactive menus
src/ui/components.js
User features
- University resource hub
src/features/university/universityHandler.js - Drive resource access
src/utils/driveHelper.js - AI conversation manager
src/features/ai/AIManager.js - AI chat command
plugins/gemini.js - Media download commands
src/services/downloaderService.js - YouTube commands
plugins/youtube.js - Social downloads
plugins/social.js - Sticker creation
plugins/sticker.js - AI image generation
plugins/image.js - Group moderation
plugins/moderation.js - Anti-link settings
src/state/antiLinkManager.js - Natural-language replies
plugins/autoReply.js
Scheduled services
- IT quiz polls
src/services/autoPollService.js - Bug challenges
src/services/bugChallengeService.js - Command quizzes
src/services/cmdQuizService.js - Quiz leaderboard
src/services/leaderboardService.js - Daily greetings
src/services/dailyGreetingService.js
Runtime support
- Status and system commands
src/features/system.js - Owner commands
src/features/owner.js - Public/private mode
src/state/modeManager.js - Group authorization
src/utils/groupUtils.js - Timezone utilities
src/utils/timeUtils.js
Other components
- WhatsApp users
- WhatsApp / Baileys
Connections 24
- WhatsApp users → WhatsApp / Baileys: send messages
README.md - WhatsApp / Baileys → Bot event dispatcher: delivers events
AuraMain.js - Bot event dispatcher → Access middleware: checks access
AuraMain.js - Bot event dispatcher → Command routes: dispatches commands
AuraMain.js - Command routes → Intent and state router: registers intents
src/routes.js - Intent and state router → Conversation sessions: loads state
src/core/router.js - Intent and state router → Interactive menus: renders menus
src/core/router.js - Command routes → University resource hub: routes university
src/routes.js - University resource hub → Conversation sessions: stores navigation state
src/features/university/universityHandler.js - University resource hub → Drive resource access: accesses files
src/features/university/universityHandler.js - Command routes → AI chat command: routes chat
src/routes.js - AI chat command → AI conversation manager: delegates prompts
plugins/gemini.js - Command routes → Natural-language replies: routes text intents
src/routes.js - YouTube commands → Media download commands: downloads media
plugins/youtube.js - Social downloads → Media download commands: downloads media
plugins/social.js - Command routes → IT quiz polls: routes poll commands
src/routes.js - IT quiz polls → Quiz leaderboard: records poll results
src/services/autoPollService.js - Bug challenges → IT quiz polls: uses poll service
src/services/bugChallengeService.js - Command quizzes → IT quiz polls: uses poll service
src/services/cmdQuizService.js - Daily greetings → Timezone utilities: checks local time
src/services/dailyGreetingService.js - Bot event dispatcher → Anti-link settings: handles link policy
AuraMain.js - Access middleware → Public/private mode: checks mode
src/core/middleware.js - Access middleware → Group authorization: checks permissions
src/core/middleware.js - Command routes → Group moderation: routes group commands