Profile & Settings PRD for Marketplace Features

Date: March 2026 Author: Product Team Status: Draft Version: 1.0 Related: Marketplace Strategy Analysis v2

Executive Summary

This PRD defines the Profile and Settings features required to support Avala’s data marketplace. Based on comprehensive analysis of the existing codebase, ~60% of the foundation exists but critical marketplace-specific features are missing.

Key Gaps Identified

Category	Current State	Gap
Creator Profiles	Basic user profile	No earnings, analytics, portfolio, verification
Payment Integration	Coworker payouts only	No Stripe Connect, no marketplace transactions
Reputation System	None	No ratings, reviews, or quality scores
Analytics Dashboard	None	No creator metrics, downloads, revenue tracking
Notification Preferences	Placeholder	No granular controls or delivery preferences
API Key Management	Basic CRUD	No scopes, rate limits, usage tracking

Implementation Scope

Backend: 12 new models, 8 new API endpoint groups
Frontend: 6 new pages, 15+ new components
Estimated Effort: 8-12 weeks (2 senior engineers)

Part 1: Current State Analysis

1.1 Existing Profile Infrastructure

Backend Models (Django)

Model	Location	Purpose	Marketplace Ready?
`User`	`account/models.py`	Core user with type, bio, picture	Partial
`CoworkerProfile`	`account/models.py`	Annotator details, payout method, hourly rate	Partial
`CustomerProfile`	`account/models.py`	Buyer company info, industry, urgency	Partial
`CoworkerPayout`	`account/models.py`	Historical payout records	Yes
`Score`	`account/models.py`	Per-task performance scores	No (task-scoped)
`UserCredit`	`account/models.py`	Credit balance system	Partial
`ApiKey`	`apikey/models.py`	API authentication	Partial

Frontend Pages (Flutter)

Page	Route	Status
Profile Overview	`/@{username}`	Implemented
Profile Settings	`/@{username}/settings`	Placeholder only
Coworker Payouts	`/@{username}/payouts`	Implemented (staff-only)
Coworker Wallet	`/@{username}/wallet`	Implemented (staff-only)
Personal Settings	`/settings`	Partial (account, security, storage)

1.2 Existing Organization Infrastructure

Backend Models

Model	Location	Purpose
`Organization`	`organization/models.py`	Org with plan, visibility, verification
`OrganizationMembership`	`organization/models.py`	User-org relationship with roles
`OrganizationInvitation`	`organization/models.py`	Invite flow with token
`Team`	`organization/models.py`	Sub-teams within org
`TeamMembership`	`organization/models.py`	Team member roles
`OrganizationBilling`	`organization/models.py`	Stripe customer/subscription IDs
`OrganizationAllowedDomain`	`organization/models.py`	Email domain auto-enrollment

Frontend Pages

Page	Route	Status
Org Overview	`/{slug}`	Implemented
Org Settings	`/{slug}/settings`	Implemented (account, members, invites)
Org Teams	`/{slug}/teams`	Implemented
Org Members	`/{slug}/members`	Implemented

URL Design: Uses GitHub-style root-level slugs. Both organizations and users share the /{slug}/... namespace. Reserved system routes (/settings, /admin, /api, /search, etc.) are protected.

Part 2: Gap Analysis by Feature Area

2.1 Creator Profile Features

Required for: Marketplace sellers to showcase their work and build trust

What’s Missing

Feature	Backend Gap	Frontend Gap	Priority
Creator verification status	No `is_verified_creator` field	No badge UI	P0
Creator display name	Uses `username` only	No separate display field	P1
Portfolio/showcase	No relation to featured datasets	No showcase section	P1
Social links	No fields	No UI	P2
Response time metrics	No tracking	No display	P2
Creator tier/level	No tier system	No visual indicator	P1

Required Models

# New fields on User model
class User(AbstractUser):
    # Existing fields...

    # NEW: Creator-specific fields
    creator_display_name = models.CharField(max_length=100, blank=True)
    creator_bio = models.TextField(max_length=2000, blank=True)  # Longer than user bio
    is_verified_creator = models.BooleanField(default=False)
    creator_tier = models.CharField(
        max_length=20,
        choices=[('STARTER', 'Starter'), ('PRO', 'Pro'), ('VERIFIED', 'Verified')],
        default='STARTER'
    )
    social_links = models.JSONField(default=dict)  # {"github": "...", "linkedin": "..."}
    portfolio_datasets = models.ManyToManyField('dataset.Dataset', blank=True)

2.2 Payment Integration (Stripe Connect)

Required for: Creators to receive earnings from dataset sales

What’s Missing

Feature	Backend Gap	Frontend Gap	Priority
Stripe Connect account	No `stripe_connect_account_id`	No onboarding flow	P0
Payout settings	No payout schedule config	No settings UI	P0
Bank account management	No model	No UI	P0
Tax information	No fields	No W-9/tax form UI	P0
Earnings balance	No `available_balance` field	No balance display	P0
Transaction history	No marketplace transaction model	No transaction list	P0

Required Models

# server/apps/account/models.py - Extend or create new

class CreatorPaymentProfile(models.Model):
    """Stripe Connect integration for marketplace creators"""
    user = models.OneToOneField(User, on_delete=models.CASCADE, related_name='payment_profile')

    # Stripe Connect
    stripe_connect_account_id = models.CharField(max_length=255, blank=True)
    stripe_connect_onboarding_complete = models.BooleanField(default=False)
    stripe_connect_payouts_enabled = models.BooleanField(default=False)

    # Payout configuration
    payout_schedule = models.CharField(
        max_length=20,
        choices=[('DAILY', 'Daily'), ('WEEKLY', 'Weekly'), ('MONTHLY', 'Monthly')],
        default='WEEKLY'
    )
    payout_minimum_threshold = MoneyField(
        max_digits=10, decimal_places=2,
        default_currency='USD', default=Money(50, 'USD')
    )

    # Tax information
    tax_form_submitted = models.BooleanField(default=False)
    tax_form_type = models.CharField(max_length=20, blank=True)  # W-9, W-8BEN, etc.

    # Balance (cached, synced from Stripe)
    available_balance = MoneyField(max_digits=12, decimal_places=2, default_currency='USD', default=0)
    pending_balance = MoneyField(max_digits=12, decimal_places=2, default_currency='USD', default=0)

    class Meta:
        db_table = 'account_creator_payment_profile'


class MarketplaceTransaction(models.Model):
    """Individual marketplace sale/purchase record"""
    uid = models.UUIDField(default=uuid.uuid4, unique=True, editable=False)

    # Participants
    seller = models.ForeignKey(User, on_delete=models.PROTECT, related_name='sales')
    buyer = models.ForeignKey(User, on_delete=models.PROTECT, related_name='purchases')

    # What was sold
    dataset = models.ForeignKey('dataset.Dataset', on_delete=models.PROTECT)

    # Pricing
    sale_price = MoneyField(max_digits=10, decimal_places=2, default_currency='USD')
    platform_commission = MoneyField(max_digits=10, decimal_places=2, default_currency='USD')
    seller_earnings = MoneyField(max_digits=10, decimal_places=2, default_currency='USD')

    # Stripe
    stripe_payment_intent_id = models.CharField(max_length=255)
    stripe_transfer_id = models.CharField(max_length=255, blank=True)

    # Status
    status = models.CharField(
        max_length=20,
        choices=[
            ('PENDING', 'Pending'),
            ('COMPLETED', 'Completed'),
            ('REFUNDED', 'Refunded'),
            ('FAILED', 'Failed'),
        ],
        default='PENDING'
    )

    # Timestamps
    created_at = models.DateTimeField(auto_now_add=True)
    completed_at = models.DateTimeField(null=True, blank=True)

    class Meta:
        db_table = 'marketplace_transaction'
        indexes = [
            models.Index(fields=['seller', 'created_at']),
            models.Index(fields=['buyer', 'created_at']),
            models.Index(fields=['status']),
        ]

2.3 Reputation & Rating System

Required for: Building trust and quality signals in the marketplace

What’s Missing

Feature	Backend Gap	Frontend Gap	Priority
Dataset ratings	No model	No star rating UI	P0
Dataset reviews	No model	No review display/form	P0
Creator reputation score	No aggregation	No score display	P1
Quality badges	No badge system	No badge components	P1
Review moderation	No model	No moderation UI	P2

Required Models

# server/apps/marketplace/models.py (NEW APP)

class DatasetReview(models.Model):
    """User review of a dataset"""
    uid = models.UUIDField(default=uuid.uuid4, unique=True, editable=False)

    dataset = models.ForeignKey('dataset.Dataset', on_delete=models.CASCADE, related_name='reviews')
    reviewer = models.ForeignKey(User, on_delete=models.CASCADE, related_name='written_reviews')
    transaction = models.ForeignKey(MarketplaceTransaction, on_delete=models.SET_NULL, null=True)

    # Rating
    rating = models.PositiveSmallIntegerField(validators=[MinValueValidator(1), MaxValueValidator(5)])
    title = models.CharField(max_length=200, blank=True)
    body = models.TextField(max_length=5000, blank=True)

    # Quality dimensions (optional detailed ratings)
    quality_score = models.PositiveSmallIntegerField(null=True, validators=[MinValueValidator(1), MaxValueValidator(5)])
    documentation_score = models.PositiveSmallIntegerField(null=True, validators=[MinValueValidator(1), MaxValueValidator(5)])
    value_score = models.PositiveSmallIntegerField(null=True, validators=[MinValueValidator(1), MaxValueValidator(5)])

    # Moderation
    is_verified_purchase = models.BooleanField(default=False)
    is_visible = models.BooleanField(default=True)
    moderation_status = models.CharField(
        max_length=20,
        choices=[('PENDING', 'Pending'), ('APPROVED', 'Approved'), ('REJECTED', 'Rejected')],
        default='APPROVED'
    )

    # Helpfulness
    helpful_count = models.PositiveIntegerField(default=0)

    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)

    class Meta:
        db_table = 'marketplace_dataset_review'
        unique_together = [['dataset', 'reviewer']]
        indexes = [
            models.Index(fields=['dataset', '-created_at']),
            models.Index(fields=['reviewer']),
        ]


class CreatorReputation(models.Model):
    """Aggregated reputation metrics for a creator"""
    user = models.OneToOneField(User, on_delete=models.CASCADE, related_name='reputation')

    # Aggregated scores (updated via Celery task)
    overall_rating = models.DecimalField(max_digits=3, decimal_places=2, default=0)
    total_reviews = models.PositiveIntegerField(default=0)
    total_sales = models.PositiveIntegerField(default=0)
    total_downloads = models.PositiveIntegerField(default=0)

    # Quality metrics
    average_quality_score = models.DecimalField(max_digits=3, decimal_places=2, default=0)
    response_time_hours = models.PositiveIntegerField(null=True)  # Average response time

    # Badges (stored as list of badge IDs)
    badges = ArrayField(models.CharField(max_length=50), default=list)

    # Timestamps
    last_calculated_at = models.DateTimeField(auto_now=True)

    class Meta:
        db_table = 'marketplace_creator_reputation'


class Badge(models.Model):
    """Badge definitions"""
    code = models.CharField(max_length=50, unique=True, primary_key=True)
    name = models.CharField(max_length=100)
    description = models.TextField()
    icon = models.CharField(max_length=100)  # Icon name or URL
    category = models.CharField(
        max_length=20,
        choices=[
            ('ACHIEVEMENT', 'Achievement'),
            ('QUALITY', 'Quality'),
            ('SALES', 'Sales'),
            ('VERIFICATION', 'Verification'),
        ]
    )
    criteria = models.JSONField()  # {"type": "sales_count", "threshold": 100}

    class Meta:
        db_table = 'marketplace_badge'

2.4 Creator Analytics Dashboard

Required for: Creators to understand their performance and optimize

What’s Missing

Feature	Backend Gap	Frontend Gap	Priority
Revenue analytics	No aggregation queries	No charts	P0
Download tracking	No download event model	No download stats	P0
View/engagement metrics	No view tracking	No engagement display	P1
Top performers	No ranking queries	No top datasets list	P1
Time-series data	No time-bucketed storage	No trend charts	P1
Export analytics	No export endpoint	No export button	P2

Required Models

# server/apps/analytics/models.py

class DatasetEngagement(models.Model):
    """Track dataset views and engagement"""
    dataset = models.ForeignKey('dataset.Dataset', on_delete=models.CASCADE)
    date = models.DateField()

    # Metrics
    views = models.PositiveIntegerField(default=0)
    unique_viewers = models.PositiveIntegerField(default=0)
    preview_downloads = models.PositiveIntegerField(default=0)
    full_downloads = models.PositiveIntegerField(default=0)
    favorites = models.PositiveIntegerField(default=0)

    class Meta:
        db_table = 'analytics_dataset_engagement'
        unique_together = [['dataset', 'date']]
        indexes = [
            models.Index(fields=['dataset', 'date']),
        ]


class CreatorEarnings(models.Model):
    """Daily earnings aggregation per creator"""
    creator = models.ForeignKey(User, on_delete=models.CASCADE)
    date = models.DateField()

    # Revenue
    gross_revenue = MoneyField(max_digits=12, decimal_places=2, default_currency='USD', default=0)
    net_earnings = MoneyField(max_digits=12, decimal_places=2, default_currency='USD', default=0)
    commission_paid = MoneyField(max_digits=12, decimal_places=2, default_currency='USD', default=0)

    # Volume
    transaction_count = models.PositiveIntegerField(default=0)
    units_sold = models.PositiveIntegerField(default=0)

    class Meta:
        db_table = 'analytics_creator_earnings'
        unique_together = [['creator', 'date']]
        indexes = [
            models.Index(fields=['creator', 'date']),
        ]

Required API Endpoints

# GET /api/v1/users/{uid}/analytics/overview/
# Returns: total_earnings, total_downloads, total_sales, avg_rating

# GET /api/v1/users/{uid}/analytics/earnings/?period=30d
# Returns: time-series earnings data

# GET /api/v1/users/{uid}/analytics/downloads/?period=30d
# Returns: time-series download data

# GET /api/v1/users/{uid}/analytics/top-datasets/?limit=10
# Returns: top performing datasets by revenue/downloads

# GET /api/v1/users/{uid}/analytics/export/?format=csv
# Returns: CSV download of all analytics

2.5 Notification Preferences

Required for: Users to control how they receive updates

What’s Missing

Feature	Backend Gap	Frontend Gap	Priority
Email preferences	No model	No toggles	P1
In-app preferences	No model	No toggles	P1
Notification categories	No categorization	No category UI	P1
Digest settings	No digest config	No digest options	P2
Quiet hours	No quiet hours model	No time picker	P3

Required Models

# server/apps/notifications/models.py (NEW APP)

class NotificationPreference(models.Model):
    """User notification preferences"""
    user = models.OneToOneField(User, on_delete=models.CASCADE, related_name='notification_preferences')

    # Global settings
    email_enabled = models.BooleanField(default=True)
    push_enabled = models.BooleanField(default=True)

    # Category settings (JSON for flexibility)
    # Format: {"sales": {"email": true, "push": true}, "reviews": {"email": false, "push": true}}
    category_settings = models.JSONField(default=dict)

    # Digest settings
    digest_frequency = models.CharField(
        max_length=20,
        choices=[('NONE', 'None'), ('DAILY', 'Daily'), ('WEEKLY', 'Weekly')],
        default='NONE'
    )
    digest_day = models.PositiveSmallIntegerField(default=1)  # 1-7 for weekly
    digest_hour = models.PositiveSmallIntegerField(default=9)  # 0-23

    # Quiet hours
    quiet_hours_enabled = models.BooleanField(default=False)
    quiet_hours_start = models.TimeField(default='22:00')
    quiet_hours_end = models.TimeField(default='08:00')

    class Meta:
        db_table = 'notifications_preference'


NOTIFICATION_CATEGORIES = [
    ('SALES', 'Sales & Purchases'),
    ('REVIEWS', 'Reviews & Ratings'),
    ('FOLLOWERS', 'Followers & Social'),
    ('UPDATES', 'Product Updates'),
    ('MARKETING', 'Marketing & Promotions'),
    ('SECURITY', 'Security Alerts'),
    ('PAYOUTS', 'Payouts & Earnings'),
]

2.6 Enhanced API Key Management

Required for: SDK users to manage access with granular permissions

What’s Missing

Feature	Backend Gap	Frontend Gap	Priority
Key scopes	Field exists but unused	No scope selector	P1
Rate limit display	No tracking	No rate limit UI	P2
Usage statistics	No tracking	No usage charts	P2
Key expiration	Field exists	No expiration picker	P2
IP whitelisting	No field	No IP input	P3

Required Model Updates

# server/apps/apikey/models.py - Extend existing

class ApiKey(models.Model):
    # Existing fields...

    # NEW: Enhanced management
    rate_limit_per_minute = models.PositiveIntegerField(default=60)
    rate_limit_per_day = models.PositiveIntegerField(default=10000)

    # Usage tracking
    total_requests = models.PositiveIntegerField(default=0)
    last_used_at = models.DateTimeField(null=True, blank=True)
    last_used_ip = models.GenericIPAddressField(null=True, blank=True)

    # IP restrictions
    allowed_ips = ArrayField(models.GenericIPAddressField(), default=list, blank=True)


class ApiKeyUsageLog(models.Model):
    """Hourly usage aggregation per API key"""
    api_key = models.ForeignKey(ApiKey, on_delete=models.CASCADE)
    hour = models.DateTimeField()  # Truncated to hour

    request_count = models.PositiveIntegerField(default=0)
    error_count = models.PositiveIntegerField(default=0)

    class Meta:
        db_table = 'apikey_usage_log'
        unique_together = [['api_key', 'hour']]

2.7 Privacy & Visibility Settings

Required for: Users to control their public presence

What’s Missing

Feature	Backend Gap	Frontend Gap	Priority
Profile visibility toggle	Field exists	No toggle	P1
Default dataset visibility	No field	No selector	P1
Hide statistics	No field	No toggle	P2
Hide reviews	No field	No toggle	P2
Block users	No model	No block UI	P3

Required Model Updates

# server/apps/account/models.py - Extend User

class User(AbstractUser):
    # Existing fields...

    # NEW: Privacy settings
    profile_visibility = models.CharField(...)  # EXISTS
    default_dataset_visibility = models.CharField(
        max_length=20,
        choices=[('PUBLIC', 'Public'), ('PRIVATE', 'Private'), ('ORG_ONLY', 'Organization Only')],
        default='PRIVATE'
    )
    show_statistics_publicly = models.BooleanField(default=True)
    show_reviews_publicly = models.BooleanField(default=True)
    allow_messages = models.BooleanField(default=True)


class UserBlock(models.Model):
    """User blocking for safety"""
    blocker = models.ForeignKey(User, on_delete=models.CASCADE, related_name='blocking')
    blocked = models.ForeignKey(User, on_delete=models.CASCADE, related_name='blocked_by')
    reason = models.TextField(blank=True)
    created_at = models.DateTimeField(auto_now_add=True)

    class Meta:
        db_table = 'account_user_block'
        unique_together = [['blocker', 'blocked']]

Part 3: Frontend Requirements

3.1 New Pages Required

Page	Route	Components	Priority
Creator Analytics	`/{username}/analytics`	Charts, stats cards, date picker	P0
Payment Settings	`/settings/payment`	Stripe Connect button, bank form, tax form	P0
Privacy Settings	`/settings/privacy`	Toggle groups, visibility selectors	P1
Notification Settings	`/settings/notifications`	Category toggles, digest options	P1
Purchase History	`/{username}/purchases`	Transaction list, filters	P1
Reviews Written	`/{username}/reviews`	Review cards, edit/delete	P2

3.2 New Components Required

Component	Location	Purpose
`CreatorBadge`	`lib/common/widgets/`	Display verification/achievement badges
`ReputationScore`	`lib/common/widgets/`	Star rating display with count
`StatsCard`	`lib/common/widgets/`	Analytics metric card (value, trend, label)
`AnalyticsChart`	`lib/common/widgets/`	Time-series line/bar chart
`StripeConnectButton`	`lib/settings/`	Stripe Connect onboarding button
`PayoutScheduleSelector`	`lib/settings/`	Payout frequency dropdown
`NotificationToggleGroup`	`lib/settings/`	Category toggle group
`DatasetRatingInput`	`lib/datasets/`	5-star rating selector
`ReviewCard`	`lib/datasets/`	Review display with rating, text, author
`ReviewForm`	`lib/datasets/`	Review submission form
`TransactionCard`	`lib/profile/`	Purchase/sale transaction display
`EarningsChart`	`lib/profile/`	Revenue over time chart
`DownloadsChart`	`lib/profile/`	Downloads over time chart
`VisibilityToggle`	`lib/settings/`	Public/Private/Org toggle
`DateRangePicker`	`lib/common/widgets/`	Analytics date range selection

3.3 State Management (Cubits/BLoCs)

Cubit/BLoC	Purpose
`CreatorAnalyticsCubit`	Load and cache analytics data
`PaymentSettingsCubit`	Manage Stripe Connect state
`NotificationPreferencesCubit`	Load/save notification settings
`PrivacySettingsCubit`	Load/save privacy settings
`DatasetReviewsCubit`	Load reviews for a dataset
`WriteReviewCubit`	Submit/edit review
`PurchaseHistoryCubit`	Load purchase transactions
`TransactionsCubit`	Load all transactions (sales + purchases)

Part 4: API Endpoints Required

4.1 Creator Profile & Analytics

GET    /api/v1/users/{uid}/creator-profile/
PATCH  /api/v1/users/{uid}/creator-profile/
GET    /api/v1/users/{uid}/analytics/overview/
GET    /api/v1/users/{uid}/analytics/earnings/
GET    /api/v1/users/{uid}/analytics/downloads/
GET    /api/v1/users/{uid}/analytics/top-datasets/
GET    /api/v1/users/{uid}/analytics/export/

4.2 Payment Integration

GET    /api/v1/users/{uid}/payment-profile/
POST   /api/v1/users/{uid}/payment-profile/stripe-connect/onboard/
GET    /api/v1/users/{uid}/payment-profile/stripe-connect/status/
PATCH  /api/v1/users/{uid}/payment-profile/payout-settings/
GET    /api/v1/users/{uid}/transactions/
GET    /api/v1/users/{uid}/transactions/{uid}/
GET    /api/v1/users/{uid}/payouts/
POST   /api/v1/users/{uid}/payouts/request/

4.3 Reviews & Ratings

GET    /api/v1/datasets/{slug}/reviews/
POST   /api/v1/datasets/{slug}/reviews/
GET    /api/v1/datasets/{slug}/reviews/{uid}/
PATCH  /api/v1/datasets/{slug}/reviews/{uid}/
DELETE /api/v1/datasets/{slug}/reviews/{uid}/
POST   /api/v1/datasets/{slug}/reviews/{uid}/helpful/
GET    /api/v1/users/{uid}/reviews/
GET    /api/v1/users/{uid}/reputation/

4.4 Notifications

GET    /api/v1/users/{uid}/notification-preferences/
PATCH  /api/v1/users/{uid}/notification-preferences/
GET    /api/v1/users/{uid}/notifications/
POST   /api/v1/users/{uid}/notifications/mark-read/

4.5 Privacy & Blocking

GET    /api/v1/users/{uid}/privacy-settings/
PATCH  /api/v1/users/{uid}/privacy-settings/
GET    /api/v1/users/{uid}/blocked-users/
POST   /api/v1/users/{uid}/blocked-users/
DELETE /api/v1/users/{uid}/blocked-users/{blocked_uid}/

Part 5: Implementation Roadmap

Phase 1: Creator Foundation (Weeks 1-3)

Goal: Enable creators to set up profiles and connect payments

Task	Backend	Frontend	Owner
Creator profile fields	Add fields to User model	Profile settings form	BE/FE
Stripe Connect integration	CreatorPaymentProfile model + API	Onboarding flow	BE/FE
Payment settings page	Payout settings API	Settings UI	BE/FE
Basic analytics overview	Overview endpoint	Stats cards	BE/FE

Deliverables:

Creator can add display name, bio, social links
Creator can connect Stripe account
Creator can see basic earnings overview

Phase 2: Reputation & Reviews (Weeks 4-6)

Goal: Build trust signals through ratings and reviews

Task	Backend	Frontend	Owner
Review model + API	DatasetReview model	Review form/display	BE/FE
Reputation aggregation	CreatorReputation + Celery task	Reputation display	BE
Badge system	Badge model + assignment logic	Badge components	BE/FE
Review moderation	Moderation status + admin UI	Admin panel	BE

Deliverables:

Users can rate/review purchased datasets
Creators have aggregated reputation scores
Verification and achievement badges display

Phase 3: Analytics Dashboard (Weeks 7-9)

Goal: Give creators insights into their performance

Task	Backend	Frontend	Owner
Engagement tracking	DatasetEngagement model	-	BE
Earnings aggregation	CreatorEarnings + Celery	-	BE
Analytics page	Time-series APIs	Charts, filters	FE
Export functionality	CSV export endpoint	Export button	BE/FE

Deliverables:

Creators see revenue, downloads, views over time
Top performing datasets highlighted
Analytics exportable as CSV

Phase 4: Settings & Privacy (Weeks 10-12)

Goal: Complete user control over their experience

Task	Backend	Frontend	Owner
Notification preferences	NotificationPreference model	Settings toggles	BE/FE
Privacy settings	Privacy fields + API	Privacy toggles	BE/FE
Enhanced API keys	Usage tracking + rate limits	Key management UI	BE/FE
User blocking	UserBlock model + enforcement	Block UI	BE/FE

Deliverables:

Users control notification delivery
Users control profile/data visibility
API keys show usage and have granular scopes

Part 6: Success Metrics

Metric	Target (Month 3)	Target (Month 6)
Creators with Stripe Connected	50	200
Datasets with ratings	100	500
Average creator rating	4.0+	4.2+
Analytics page DAU	20% of creators	40% of creators
Notification opt-in rate	70%	75%
API keys with scopes configured	30%	50%

Part 7: Open Questions

Commission structure: Is 12% platform commission final? Need to confirm for transaction model.
Tax handling: Do we collect W-9 ourselves or use Stripe’s tax form collection?
Review moderation: Auto-approve all reviews or require moderation queue?
Badge criteria: What are the specific thresholds for each badge type?
Analytics retention: How long do we keep daily analytics data? (Suggest: 2 years)
Notification channels: Do we support SMS notifications or just email + in-app?

Appendix A: Database Migration Plan

New Tables

account_creator_payment_profile
marketplace_transaction
marketplace_dataset_review
marketplace_creator_reputation
marketplace_badge
analytics_dataset_engagement
analytics_creator_earnings
notifications_preference
apikey_usage_log
account_user_block

Modified Tables

account_user - Add creator fields, privacy settings
apikey_apikey - Add rate limits, usage tracking

Migration Order

Core user fields (no dependencies)
Payment profile (depends on user)
Transaction/review models (depends on user + dataset)
Analytics tables (depends on user + dataset)
Notification preferences (depends on user)

Appendix B: Third-Party Integrations

Service	Purpose	API Docs
Stripe Connect	Creator payouts	https://stripe.com/docs/connect
Stripe Tax	Tax form collection	https://stripe.com/docs/tax
SendGrid	Email notifications	https://docs.sendgrid.com/
Firebase	Push notifications	https://firebase.google.com/docs/cloud-messaging

Last Updated: March 2026

​Profile & Settings PRD for Marketplace Features

​Executive Summary

​Key Gaps Identified

​Implementation Scope

​Part 1: Current State Analysis

​1.1 Existing Profile Infrastructure

​Backend Models (Django)

​Frontend Pages (Flutter)

​1.2 Existing Organization Infrastructure

​Backend Models

​Frontend Pages

​Part 2: Gap Analysis by Feature Area

​2.1 Creator Profile Features

​What’s Missing

​Required Models

​2.2 Payment Integration (Stripe Connect)

​What’s Missing

​Required Models

​2.3 Reputation & Rating System

​What’s Missing

​Required Models

​2.4 Creator Analytics Dashboard

​What’s Missing

​Required Models

​Required API Endpoints

​2.5 Notification Preferences

​What’s Missing

​Required Models

​2.6 Enhanced API Key Management

​What’s Missing

​Required Model Updates

​2.7 Privacy & Visibility Settings

​What’s Missing

​Required Model Updates

​Part 3: Frontend Requirements

​3.1 New Pages Required

​3.2 New Components Required

​3.3 State Management (Cubits/BLoCs)

​Part 4: API Endpoints Required

​4.1 Creator Profile & Analytics

​4.2 Payment Integration

​4.3 Reviews & Ratings

​4.4 Notifications

​4.5 Privacy & Blocking

​Part 5: Implementation Roadmap

​Phase 1: Creator Foundation (Weeks 1-3)

​Phase 2: Reputation & Reviews (Weeks 4-6)

​Phase 3: Analytics Dashboard (Weeks 7-9)

​Phase 4: Settings & Privacy (Weeks 10-12)

​Part 6: Success Metrics

​Part 7: Open Questions

​Appendix A: Database Migration Plan

​New Tables

​Modified Tables

​Migration Order

​Appendix B: Third-Party Integrations

Profile & Settings PRD for Marketplace Features

Executive Summary

Key Gaps Identified

Implementation Scope

Part 1: Current State Analysis

1.1 Existing Profile Infrastructure

Backend Models (Django)

Frontend Pages (Flutter)

1.2 Existing Organization Infrastructure

Backend Models

Frontend Pages

Part 2: Gap Analysis by Feature Area

2.1 Creator Profile Features

What’s Missing

Required Models

2.2 Payment Integration (Stripe Connect)

What’s Missing

Required Models

2.3 Reputation & Rating System

What’s Missing

Required Models

2.4 Creator Analytics Dashboard

What’s Missing

Required Models

Required API Endpoints

2.5 Notification Preferences

What’s Missing

Required Models

2.6 Enhanced API Key Management

What’s Missing

Required Model Updates

2.7 Privacy & Visibility Settings

What’s Missing

Required Model Updates

Part 3: Frontend Requirements

3.1 New Pages Required

3.2 New Components Required

3.3 State Management (Cubits/BLoCs)

Part 4: API Endpoints Required

4.1 Creator Profile & Analytics

4.2 Payment Integration

4.3 Reviews & Ratings

4.4 Notifications

4.5 Privacy & Blocking

Part 5: Implementation Roadmap

Phase 1: Creator Foundation (Weeks 1-3)

Phase 2: Reputation & Reviews (Weeks 4-6)

Phase 3: Analytics Dashboard (Weeks 7-9)

Phase 4: Settings & Privacy (Weeks 10-12)

Part 6: Success Metrics

Part 7: Open Questions

Appendix A: Database Migration Plan

New Tables

Modified Tables

Migration Order

Appendix B: Third-Party Integrations