Data Flows
System Data Flows
Step-by-step visualization of how data moves through each major pipeline in Tonal — from indie-artist onboarding to label intelligence and artist-equity payouts.
1. Subscriber Registration & Payment
User Sign-up
Email / OAuth
Auth0
Token issued
Stripe Checkout
$10/mo billing
User Record
DB + Redis cache
2. Artist Onboarding Pipeline
Artist applies
Profile form
ID Verification
Stripe Identity
PRO Verification
ASCAP/BMI/SESAC
Base-44 Identity
Hash generated
Approved
Dashboard access
3. Track Upload & Ingestion
Upload Track
WAV/FLAC/MP3
Audio Fingerprint
Chromaprint hash
AI Detection
CNN classifier
Metadata Enrich
ISRC + tags
CDN Encode
HLS 128/256/320
Published
Searchable
4. Label Intelligence & Data Marketplace
Indie artist verified
No label affiliation
Engagement tracked
Streams, duration, geo
Scout score computed
Transparent formula
Label subscribes
Scout / A&R Pro tier
Data packaged
High-signal analytics
Pending Fund
Artist-equity ledger
5. Streaming & Listen Tracking
User plays track
CDN streams HLS
Edge delivery
Listen event fires
At 30s mark
Fraud check
Anomaly scoring
Valid listen logged
Kafka → DB
6. Monthly Payout Calculation
Pool calculated
80% of sub revenue
Listens aggregated
Per-artist count
Pro-rata computed
Shares assigned
Smart contract log
Immutable record
Stripe Connect payout
Bank transfer
7. Merch Purchase Flow
Browse merch
Artist storefront
Add to cart
Stripe payment
15% commission
Fulfillment
Printful/ShipStation
Tracking sent
Email notification
8. Fraud Detection Pipeline
Listen event
Device fingerprint
Canvas + WebGL
Velocity check
Rate limiting
Behavior analysis
ML model
Score ≥ threshold
Flag / block
Clean event logged
Event Bus Architecture
Kafka Topics
- • stream.listen.raw
- • stream.listen.validated
- • catalog.track.uploaded
- • catalog.track.approved
- • fraud.alert.triggered
- • payout.calculated
- • merch.order.placed
Event Consumers
- • Listen Validator Service
- • AI Detection Worker
- • Fraud Scoring Service
- • Analytics Aggregator
- • Notification Service
- • Payout Calculator
Dead Letter Queue
- • Failed AI scans → manual review
- • Failed payouts → retry with backoff
- • Failed imports → artist notification
- • Unresolved fraud alerts → admin queue