How ananth-madura/madhura_crm works
This repository is a CRM and business-operations application with a substantial WhatsApp communications suite. Users authenticate into role-based dashboards, manage leads and operational records, and access notifications; CRM events and WhatsApp tools also drive messaging, campaigns, and conversational flows. The frontend calls a Node/Express backend, which routes requests to domain handlers and shared MySQL persistence. The README only describes Create React App setup, so product capabilities are inferred from the file tree and sampled code; unsampled routes and integrations are grouped conservatively.
Main entry points: database.js MySQL database · server.js HTTP server · waAutomationService.js Event automation · client.js API client
Components 26
Web application
- App routing
frontend/src/App.js - Login and session
frontend/src/auth/AuthContext.jsx - Notification UI
frontend/src/context/NotificationContext.jsx - CRM screens
frontend/src/pages - WhatsApp screens
frontend/src/pages - API client
frontend/src/api/client.js
CRM operations
- CRM routes
backend/routes - Tasks and targets
backend/routes/taskRoutes.js - Call reporting
backend/routes/callReportRoutes.js - Quotations
backend/routes/quotationRoutes.js - Reports
backend/routes/reportRoutes.js
WhatsApp suite
- WhatsApp sessions
backend/services/whatsappService.js - WhatsApp Cloud API
backend/services/whatsappCloudApi.js - Conversation flows
backend/services/waFlowEngine.js - Event automation
backend/services/waAutomationService.js - Campaign engine
backend/services/waCampaignEngine.js - Account balancing
backend/services/waLoadBalancer.js - WhatsApp routes
backend/routes - WhatsApp lead capture
backend/services/waLeadCapture.js
Backend platform
- HTTP server
backend/server.js - Auth routes
backend/routes/authRoutes.js - Access control
backend/middleware/authMiddleware.js - MySQL database
backend/config/database.js - Live notifications
backend/sockets/notifications.js
Other components
- CRM user
- WhatsApp platform
Connections 46
- CRM user → App routing: uses
frontend/src/App.js - App routing → Login and session: provides session
frontend/src/App.js - App routing → CRM screens: routes to
frontend/src/App.js - App routing → WhatsApp screens: routes to
frontend/src/App.js - Login and session → API client: requests
- CRM screens → API client: requests
- WhatsApp screens → API client: requests
- Notification UI → API client: requests
- API client → HTTP server: HTTP requests
- HTTP server → Auth routes: mounts routes
backend/server.js - HTTP server → Tasks and targets: mounts routes
backend/server.js - HTTP server → CRM routes: mounts routes
backend/server.js - HTTP server → WhatsApp routes: mounts routes
backend/server.js - Auth routes → MySQL database: queries
backend/routes/authRoutes.js - Tasks and targets → MySQL database: queries
backend/routes/taskRoutes.js - Tasks and targets → Access control: checks access
backend/routes/taskRoutes.js - CRM routes → MySQL database: queries
backend/routes/taskRoutes.js - Call reporting → MySQL database: queries
backend/routes/callReportRoutes.js - Call reporting → Access control: checks access
backend/routes/callReportRoutes.js - Quotations → MySQL database: queries
backend/routes/quotationRoutes.js - Quotations → Access control: checks access
backend/routes/quotationRoutes.js - Reports → MySQL database: queries
backend/routes/reportRoutes.js - HTTP server → Live notifications: initializes socket
backend/server.js - Live notifications → MySQL database: reads and writes
backend/sockets/notifications.js - HTTP server → MySQL database: initializes
backend/server.js - WhatsApp routes → Conversation flows: invokes flows
backend/routes/waFlowRoutes.js - WhatsApp routes → Campaign engine: starts campaigns
backend/routes/waCampaignRoutes.js - Conversation flows → MySQL database: reads and writes
backend/services/waFlowEngine.js - Conversation flows → HTTP server: emits handoff
backend/services/waFlowEngine.js - Campaign engine → MySQL database: tracks campaigns
backend/services/waCampaignEngine.js - Campaign engine → HTTP server: emits message updates
backend/services/waCampaignEngine.js - Event automation → MySQL database: checks opt-outs
backend/services/waAutomationService.js - Event automation → HTTP server: emits message updates
backend/services/waAutomationService.js - Account balancing → MySQL database: reads configuration
backend/services/waLoadBalancer.js - Account balancing → WhatsApp sessions: uses sessions
backend/services/waLoadBalancer.js - Account balancing → WhatsApp Cloud API: uses API
backend/services/waLoadBalancer.js - WhatsApp sessions → HTTP server: emits socket events
backend/services/whatsappService.js - WhatsApp Cloud API → WhatsApp platform: sends messages
- WhatsApp lead capture → MySQL database: stores leads
backend/services/waLeadCapture.js - WhatsApp lead capture → Live notifications: notifies users
backend/services/waLeadCapture.js - WhatsApp routes → Access control: checks access
backend/routes/taskRoutes.js - Event automation → WhatsApp sessions: sends messages
backend/services/waAutomationService.js - Campaign engine → Account balancing: balances sending
backend/services/waCampaignEngine.js - Conversation flows → WhatsApp lead capture: captures leads
backend/services/waFlowEngine.js - Call reporting → Event automation: triggers automation
backend/routes/callReportRoutes.js - Quotations → Event automation: triggers automation
backend/routes/quotationRoutes.js