How samoskito/nod-rastrackdash-wpp works
RastrackDash is a self-hosted, multi-tenant dashboard for agencies managing WhatsApp leads and Meta Ads. The main workflow receives provider webhooks, parses and records lead activity, applies conversion rules, and can send eligible conversion events to Meta; operators review purchase conversions before approval. The web app also supports workspace setup, provider and Meta integrations, campaign reporting, external data connectors, and diagnostics. The map uses documented capabilities and sampled call relationships; unsampled subsystem links are omitted where wiring is uncertain.
Main entry points: prisma.service.ts Application database · inbound-webhook-ingestion.service.ts Webhook intake · auth.service.ts Authentication · page.tsx Integration controls
Components 26
Dashboard
- Web dashboard
apps/web/src/app/(app)/overview/page.tsx - Integration controls
apps/web/src/app/(app)/integrations/page.tsx - Events & reviews
apps/web/src/app/(app)/events/page.tsx - Reports
apps/web/src/app/(app)/reports/page.tsx
Access & Workspaces
- Authentication
apps/api/src/auth/auth.service.ts - Workspace access
apps/api/src/workspaces/workspaces.service.ts - License client
apps/api/src/licensing-client/license-client.service.ts
Lead Ingestion
- WhatsApp providers
apps/api/src/integrations/whatsapp-providers/whatsapp-provider.registry.ts - Webhook intake
apps/api/src/inbound-webhooks/inbound-webhook-ingestion.service.ts - Provider parsers
apps/api/src/inbound-webhooks/providers/inbound-webhook-parser.registry.ts - Lead attribution
apps/api/src/leads/leads.service.ts - External connectors
apps/api/src/external-data/external-data.service.ts - External event ingestion
apps/api/src/external-data/external-event-ingestion.service.ts
Conversion Operations
- Conversion rules
apps/api/src/conversion-rules/conversion-rules.service.ts - Conversion orchestration
apps/api/src/conversion-rules/provider-conversion-orchestrator.service.ts - Purchase reviews
apps/api/src/inbound-webhook-production/purchase-reviews.service.ts - Review approval
apps/api/src/conversion-rules/provider-conversion-review-approval.service.ts - Conversion delivery
apps/api/src/conversion-events/conversion-events.service.ts
Integrations & Analytics
- Meta Ads & CAPI
apps/api/src/integrations/meta/meta.adapter.ts - Reporting metrics
apps/api/src/reporting/reporting-metrics.engine.ts - Operational diagnostics
apps/api/src/diagnostics/diagnostics.service.ts
Other components
- Agency operator
- Application database
apps/api/src/common/prisma/prisma.service.ts - Meta platform
- WhatsApp provider service
- External MySQL
Connections 38
- Agency operator → Web dashboard: uses
- Agency operator → Integration controls: configures
- Agency operator → Events & reviews: reviews
- Agency operator → Reports: views
- Web dashboard → Authentication: authenticates
- Integration controls → Authentication: authenticates
- Events & reviews → Authentication: authenticates
- Reports → Authentication: authenticates
- Authentication → Workspace access: resolves access
- Authentication → Application database: reads/writes
- Workspace access → Application database: reads/writes
- License client → Application database: records status
- WhatsApp provider service → Webhook intake: delivers events
- Webhook intake → Provider parsers: parses payload
- Webhook intake → Application database: records delivery
- Webhook intake → WhatsApp providers: resolves provider
- Webhook intake → Lead attribution: records lead activity
- Webhook intake → Operational diagnostics: records diagnostics
- WhatsApp providers → WhatsApp provider service: calls provider
- External MySQL → External connectors: supplies rows
- External connectors → External event ingestion: dispatches events
- External event ingestion → Lead attribution: upserts lead
- External event ingestion → Conversion delivery: records conversion
- External event ingestion → Application database: reads/writes
- Conversion rules → Application database: reads/writes
- Conversion orchestration → Application database: persists decisions
- Purchase reviews → Application database: reads/writes
- Events & reviews → Purchase reviews: manages reviews
- Purchase reviews → Review approval: prepares approval
- Review approval → Conversion orchestration: orchestrates decision
- Review approval → Application database: updates review
- Conversion delivery → Application database: records events
- Conversion delivery → Meta Ads & CAPI: dispatches conversions
- Meta Ads & CAPI → Meta platform: calls Meta
- Reports → Reporting metrics: requests metrics
- Reporting metrics → Application database: reads reporting data
- Integration controls → Meta Ads & CAPI: configures Meta
- Integration controls → WhatsApp providers: configures providers