How uttomkumar143/trafficvaulthub works
TrafficVaultHub is a CPA affiliate-network platform with a React SPA and a Hono API on Cloudflare Workers. Its central workflow is offer discovery and setup, tracked referrals and attribution, conversion validation and risk/compliance review, then ledger accounting, advertiser billing and affiliate payouts. Operations also include identity, tenant-scoped access, support, reporting, notifications, APIs and webhooks. The graph combines sampled wiring with README-described product capabilities; several domain links are documented capability relationships rather than inspected call paths.
Main entry points: app.ts Hono API and wiring · api.ts API client · service.ts Conversion validation · journal.ts Immutable ledger
Components 28
User experience
- React application
frontend/src/app/app.tsx - API client
frontend/src/lib/api.ts - Authentication UI
frontend/src/features/auth/auth-context.tsx - Offer marketplace UI
frontend/src/features/offers/api.ts - Affiliate dashboard UI
frontend/src/features/affiliate-dashboard/api.ts
Identity and access
- Authentication service
backend/src/modules/auth/service.ts - Identity persistence
backend/src/modules/auth/repository.ts - Tenant and RBAC
backend/src/middleware/require-org.ts - Organizations
backend/src/modules/organizations - Worker bindings and tenant helpers
backend/src/lib
Marketplace and tracking
- Offer policy and lifecycle
backend/src/modules/offers/service.ts - Advertiser profiles
backend/src/modules/advertisers - Affiliate profiles
backend/src/modules/affiliates/service.ts - Tracking and SmartLinks
backend/src/modules/tracking - Attribution
backend/src/modules/tracking/attribution-service.ts
Risk and operations
- Conversion validation
backend/src/modules/conversions/service.ts - Fraud risk engine
backend/src/modules/fraud/risk-engine.ts - Compliance review
backend/src/modules/compliance/service.ts - Support and disputes
backend/src/modules/support
Finance and delivery
- Immutable ledger
backend/src/modules/ledger/journal.ts - Advertiser billing
backend/src/modules/billing/service.ts - Affiliate payouts
backend/src/modules/payouts/service.ts - Reconciliation
backend/src/modules/reconciliation/service.ts - Webhooks
backend/src/modules/webhooks/service.ts - Webhook transport
backend/src/modules/webhooks/transport.ts - External integrations
backend/src/integrations
Other components
- Network users
- Hono API and wiring
backend/src/app.ts
Connections 29
- Network users → React application: use
README.md - React application → API client: requests
- API client → Hono API and wiring: calls REST API
- Hono API and wiring → Authentication service: wires services
backend/src/app.ts - Hono API and wiring → Offer policy and lifecycle: wires services
backend/src/app.ts - Hono API and wiring → Tracking and SmartLinks: wires services
backend/src/app.ts - Hono API and wiring → Webhook transport: configures transport
backend/src/app.ts - Hono API and wiring → External integrations: configures adapters
backend/src/app.ts - Authentication UI → API client: uses
- Offer marketplace UI → API client: uses
- Affiliate dashboard UI → API client: uses
- Authentication service → Identity persistence: persists identity
backend/src/modules/auth/service.ts - Tenant and RBAC → Organizations: resolves membership
backend/src/middleware/require-org.ts - Offer policy and lifecycle → Advertiser profiles: checks advertiser
backend/src/modules/offers/service.ts - Offer policy and lifecycle → Tracking and SmartLinks: invalidates eligibility cache
backend/src/modules/offers/service.ts - Network users → Offer policy and lifecycle: manage offers
README.md - Network users → Affiliate profiles: apply as publisher
README.md - Tracking and SmartLinks → Attribution: records attribution
README.md - Tracking and SmartLinks → Conversion validation: tracks conversions
README.md - Conversion validation → Fraud risk engine: checks risk
README.md - Conversion validation → Compliance review: supports review
README.md - Conversion validation → Immutable ledger: accounts approved activity
- Immutable ledger → Advertiser billing: supports billing
- Immutable ledger → Affiliate payouts: funds payouts
backend/src/modules/payouts/service.ts - Immutable ledger → Reconciliation: reconciles balances
- Network users → Support and disputes: request assistance
README.md - Webhooks → Webhook transport: dispatches deliveries
backend/src/modules/webhooks/service.ts - Webhooks → External integrations: delivers event notifications
- Worker bindings and tenant helpers → Tenant and RBAC: provides bindings
backend/src/lib/bindings.ts