Modules Index
Every module below has a full doc following the same 15-section template (Overview → Cheat Sheet) plus Knowledge Tests (L1–L5) and Practical Assignments. Read Module Architecture first for how controllers map to modules and where the Excel and code diverge.
The data spine (read in this order first)
| Module |
What it owns |
Primary code |
| Order-Ingestion |
Multi-source order intake → crm_queue (monolith and Lambda edge) |
injestionController, per-POS crons, prism-services |
| Customer-CRM |
Customer 360, dedup-by-mobile, profile pipeline |
customerController |
| Customer-Intelligence-RFM |
RFM scoring + 37-filter segmentation |
rfmController, crons/rfmSegments.js |
Outreach
| Module |
What it owns |
Primary code |
| Campaigns |
3 campaign pipelines, ROI, MIS |
campaignController*, processCampaign |
| Automated-Journeys |
8 event-driven journeys |
automatedCampaignController, processAutomatedCampaigns |
| WhatsApp |
Gupshup + Meta TSP, templates, send/receipts |
gupshupOnboardingController, metaTSP |
| SMS-Push |
SMS (DLT) + app/web push (FCM) |
sendSms, sendFcmNotification, queue crons |
Loyalty cluster
| Module |
What it owns |
Primary code |
| Loyalty |
Points earn/burn, tiers, ledger (dual-store ⚠️) |
loyaltyController, handleWalletPointsFlow |
| Wallet |
Customer points wallet vs business messaging wallet |
walletController |
| Membership |
Paid plans — 📄 Excel-rich, backend-partial (validation gap) |
salon reports + ingestion capture |
| Referral |
Refer & Earn (dual incentive) |
rewardHelper, referalMIS |
| Fraud-Prevention |
Velocity limits, blocklists |
fraudRulesController |
Sub-products & analytics
| Module |
What it owns |
Primary code |
| Digital-Bills |
Branded web receipts + widgets |
digitalBillController, invoiceInsightsController |
| Feedback-NPS |
Ratings, NPS, review aggregation, recovery |
feedbackController, npsControllers, lowRatingTrigger |
| Dashboard-Analytics |
Widgets, /stats API, aggregation MIS |
dashboardControllerNew, aggregationProcess |
| Admin-Business |
Admin dashboards + code-only verticals (sales CRM, help desk, QR, gaming, salon, AI) |
adminController, businessController, others |
Key validation flags across modules
- ⚠️ Membership — rich Excel spec, no dedicated backend controller/route/table; see Membership.
- 🐛 Bug E1.7 confirmed in code — 2 of 8 journeys (Low-Rating-Rewards, Referral-Boost) have no queue handler; see Automated-Journeys.
- ⚠️ RFM — code ships 7 segments via an R-first branch, not the Excel's 11-segment R×FM grid; see Customer-Intelligence-RFM.
- ♻️ Dual writers to
crm_queue, dual dashboards, 3 campaign pipelines, non-atomic loyalty points; see Technical Debt.