# Keys for All: Multi-Platform Sales Distribution

## Overview

Simple key-based monetization system for VoiceUwu where users can purchase license keys across multiple platforms and stores. Focus is on maximizing sales channels, not complex community features.

## Core Concept

**Problem**: Need to sell VoiceUwu license keys across different platforms and stores  
**Solution**: Unified key format that works everywhere, with platform-specific purchase flows

## Sales Channels

### Mobile Platforms
- **Apple App Store** (iOS/macOS) - StoreKit 2
- **Google Play Store** (Android) - Play Billing API

### Web/Direct Sales  
- **Web Portal** - Stripe checkout
- **Web Portal** - PayPal checkout

### Gaming/PC
- **Steam Store** - Steam Web API

## Key Format & Validation

**Universal Key**: `VUUW-XXXX-XXXX-XXXX`
- Works across all platforms once activated
- Offline validation (no network required)
- Cryptographic integrity checking
- Feature-based pricing (1 key = $3 = 1 feature)

## Architecture

### Core Components
```
VoiceUwu Apps (iOS/Android/PC)
├── VUKeyValidator          # Offline key validation
├── VUFeatureGate          # Level-based feature access
├── VUKeyStorage           # Secure local storage
└── VUKeySync              # Optional cloud sync

Purchase Platforms
├── Apple StoreKit         # iOS/macOS in-app purchase
├── Google Play Billing    # Android in-app purchase  
├── Web Portal (Stripe)    # Direct web sales
├── Web Portal (PayPal)    # Direct web sales
└── Steam Store            # PC gaming distribution

Central Key Server
├── Platform validation    # Verify legitimate purchases
├── Key generation         # Create unique valid keys
└── User sync             # Optional account linking
```

## Purchase Flows

### In-App Purchase (iOS/Android)
1. User taps "Upgrade" in app
2. Platform handles payment (Apple/Google)
3. App receives purchase receipt
4. App sends receipt to key server for validation
5. Key server generates and returns license key
6. Key auto-activates in app

### Web Purchase (Stripe/PayPal)
1. User visits web store
2. Selects license level and quantity
3. Completes payment via Stripe/PayPal
4. Key server validates payment and generates keys
5. User receives keys via email
6. User enters key in any VoiceUwu app to activate

### Steam Purchase (PC)
1. User purchases through Steam store
2. Steam processes payment
3. Steam client calls key server with transaction
4. Key server validates and generates keys
5. Keys delivered through Steam or in-game

## User Experience

### Key Activation
- Enter 19-character key: `VUUW-XXXX-XXXX-XXXX-L1`
- Instant validation and feature unlock
- Keys work offline once activated
- Optional account sync across devices

### Feature Access
- **Free**: Basic voice analysis
- **Level 1 ($19)**: Advanced monitors, enhanced features
- **Level 2 ($39)**: Premium visualizations, full feature set

### Key Management
- View activated keys in app
- Optional web portal for purchased keys
- Transfer keys between devices
- Gift keys to others

## Implementation Priorities

### Phase 1: Foundation
1. **Key validation system** - Offline cryptographic validation
2. **Feature gating** - Level-based access control
3. **Apple integration** - StoreKit 2 in-app purchases
4. **Key server** - Generate and validate keys

### Phase 2: Expansion
1. **Google Play integration** - Android in-app purchases
2. **Web portal** - Stripe/PayPal direct sales
3. **Account system** - Optional user accounts for key sync
4. **Key management** - Web dashboard for purchases

### Phase 3: Gaming
1. **Steam integration** - PC gaming distribution
2. **Bulk sales** - Volume discounts and gift keys
3. **Analytics** - Sales tracking across platforms

## Technical Requirements

### Key Server Endpoints
```
POST /purchase/apple          # Process Apple IAP
POST /purchase/google         # Process Google Play
POST /purchase/stripe         # Process Stripe payment
POST /purchase/paypal         # Process PayPal payment  
POST /purchase/steam          # Process Steam purchase

GET  /keys/:email            # Sync user's keys
POST /keys/activate          # Activate key on device
```

### Security Features
- Cryptographic key validation
- Purchase receipt verification for each platform
- Rate limiting on key generation
- Secure key storage (keychain/keystore)

## Revenue Strategy

**Single Product, Multiple Channels**:
- Same license levels across all platforms
- Platform-specific pricing (account for store fees)
- No feature differences between purchase methods
- Keys work universally once purchased

**Target Markets**:
- **Mobile**: Casual voice training users
- **Web**: Users who prefer browser-based purchasing  
- **Steam**: PC gaming community, voice mod enthusiasts
- **Enterprise**: Bulk purchases for organizations

This simplified approach focuses on maximizing sales reach while maintaining a unified user experience across all platforms.