# 03. App Store Connect Configuration

meta:
  id: ios-production-03
  feature: ios-production
  priority: P1
  depends_on: []
  tags: [app-store, configuration, production]

objective:
- Complete all App Store Connect configuration for app submission and distribution

deliverables:
- App record created in App Store Connect
- Bundle ID registered and configured
- Signing certificates and provisioning profiles
- App Review information
- Pricing and availability

steps:
1. Create App Store Connect record:
   - App name: Kordant
   - Primary language: English
   - Bundle ID: com.kordant.app (or existing)
   - SKU: kordant-001
   - User Access: Full access for team
2. Configure app capabilities:
   - Push Notifications (entitlements configured)
   - Background Modes (fetch, remote notifications)
   - Camera (for document scanning)
   - Microphone (for VoicePrint enrollment)
   - Face ID / Touch ID (biometric auth)
   - Associated Domains (universal links)
3. Set up signing:
   - Apple Developer account ($99/year)
   - Create Distribution certificate
   - Create App Store provisioning profile
   - Configure Xcode with correct team and signing
4. Configure pricing:
   - Price tier: Free (subscription handled in-app or via web)
   - If in-app purchases: configure in App Store Connect
   - Subscription groups and tiers
   - Introductory offers (free trial)
5. Set availability:
   - All countries or selected markets
   - Pre-order option (optional)
   - Release strategy (manual or automatic)
6. Prepare App Review info:
   - Contact information
   - Demo account credentials (username/password for testing)
   - Notes for reviewer (explain app functionality)
   - Attachment: privacy policy, terms of service
7. Configure TestFlight:
   - Internal testers (team members)
   - External testers (beta group)
   - Test information and feedback email

tests:
- Build: Archive and validate app in Xcode
- Upload: Upload build to App Store Connect
- Verification: Confirm build appears in TestFlight

acceptance_criteria:
- App record created in App Store Connect
- Bundle ID registered and matches Xcode project
- Distribution certificate and provisioning profile active
- All required capabilities enabled
- Pricing set (free with subscriptions)
- Availability configured for target markets
- App Review information complete with demo account
- TestFlight configured with internal testers
- Build successfully uploaded and processing

validation:
- Xcode → Product → Archive → Validate → no errors
- Upload build → appears in App Store Connect within 30 minutes
- TestFlight → build available for internal testing
- App Review info → all fields complete

notes:
- Ensure Apple Developer membership is active and paid
- Bundle ID must match exactly across all configs
- Demo account is critical for reviewer testing
- TestFlight builds must be signed with Distribution cert