🚀 Guide de Configuration Premium - Kazalendar

📋 Vue d'ensemble

Ce guide vous accompagne dans la configuration du système de paiement in-app pour Kazalendar, permettant de débloquer des fonctionnalités premium.

🛠️ Configuration Technique

1. Dépendances Installées

Les packages suivants ont été ajoutés à pubspec.yaml :

dependencies:
  in_app_purchase: ^3.1.13
  shared_preferences: ^2.2.2

2. Structure du Code

lib/features/premium/
├── core/
│   └── premium_config.dart          # Configuration des produits
├── data/
│   ├── models/
│   │   └── premium_product_model.dart
│   ├── repositories/
│   │   └── premium_repository_impl.dart
│   └── services/
│       └── premium_service_impl.dart
├── domain/
│   ├── entities/
│   │   └── premium_product.dart
│   ├── repositories/
│   │   └── premium_repository.dart
│   └── services/
│       └── premium_service.dart
└── presentation/
    ├── pages/
    │   └── premium_page.dart
    └── widgets/
        ├── premium_feature_list.dart
        ├── premium_product_card.dart
        └── premium_gate.dart

3. Base de Données

Exécutez le script SQL supabase/migrations/create_premium_tables.sql pour créer les tables nécessaires :

• premium_products : Produits disponibles
• premium_users : Statut des utilisateurs
• purchases : Historique des achats
• premium_features : Fonctionnalités premium

🏪 Configuration des Stores

Google Play Console

1. Connectez-vous à Google Play Console

2. Sélectionnez votre app Kazalendar

3. Allez dans le menu latéral : "Monétiser" > "Abonnements"

4. Créez un nouvel abonnement en cliquant sur "Créer un abonnement"

---

Abonnement : Kazalendar Premium

Étape 1 : Informations de base

• ID de l'abonnement : kazalendar_premium (cet ID sera utilisé dans le code)
• Nom : Kazalendar Premium
• Description : Débloquez toutes les fonctionnalités premium de Kazalendar

Étape 2 : Offres de base (Base plans)

Vous devez créer 2 offres de base :

📅 Offre 1 : Abonnement Mensuel

• ID de l'offre de base : monthly
• Période de facturation : 1 mois (récurrent)
• Type de renouvellement : Auto-renouvelable
• Prix : 9,99 €
  • Cliquez sur "Ajouter un prix"
  • Sélectionnez tous les pays où vous voulez distribuer
  • Définissez le prix pour chaque région (ou laissez Google convertir automatiquement)

📆 Offre 2 : Abonnement Annuel

• ID de l'offre de base : yearly
• Période de facturation : 1 an (récurrent)
• Type de renouvellement : Auto-renouvelable
• Prix : 99,00 €
  • Cliquez sur "Ajouter un prix"
  • Sélectionnez tous les pays où vous voulez distribuer
  • Définissez le prix pour chaque région

Note : Les deux offres sont des abonnements récurrents. Si vous souhaitez une option "achat unique annuel" sans renouvellement, vous devrez créer un produit "Achat unique" séparé dans la section "Produits in-app".

Étape 3 : Offres spéciales (optionnel)

Vous pouvez ajouter des offres promotionnelles :

• Essai gratuit de 7 jours
• Prix promotionnel pour les nouveaux utilisateurs
• Offre de lancement à prix réduit

Étape 4 : Options avancées

• Période de grâce : 3 jours (recommandé) - permet aux utilisateurs de résoudre les problèmes de paiement
• Réactivation : Activée (permet aux utilisateurs de réactiver un abonnement annulé)

5. Activez l'abonnement et attendez l'approbation (peut prendre quelques heures)

App Store Connect

1. Connectez-vous à App Store Connect

2. Sélectionnez votre app Kazalendar

3. Allez dans "Fonctionnalités" > "Achats intégrés"

4. Créez les mêmes produits avec les mêmes IDs

5. Soumettez pour révision

🔧 Configuration Android

1. Permissions

Ajoutez dans android/app/src/main/AndroidManifest.xml :

<uses-permission android:name="com.android.vending.BILLING" />

2. Configuration de test

Pour les tests, ajoutez dans android/app/build.gradle :

android {
    buildTypes {
        debug {
            // Configuration pour les tests
            buildConfigField "boolean", "ENABLE_BILLING_DEBUG", "true"
        }
    }
}

🍎 Configuration iOS

1. Capabilities

Dans Xcode, activez "In-App Purchase" dans les capabilities de votre app.

2. Configuration de test

Créez des comptes de test dans App Store Connect pour tester les achats.

🧪 Tests

1. Comptes de test

• Google Play : Créez des comptes de test dans Google Play Console
• App Store : Créez des comptes de test dans App Store Connect

2. Test des achats

1. Installez l'app sur un appareil de test
2. Connectez-vous avec un compte de test
3. Testez l'achat de chaque produit
4. Vérifiez que les fonctionnalités se débloquent

3. Test de restauration

1. Achetez un produit
2. Désinstallez l'app
3. Réinstallez l'app
4. Testez la restauration des achats

📊 Fonctionnalités Premium

Limites Version Gratuite

• Clients : 5 maximum
• Commandes : 20 maximum
• Templates : 1 maximum

Fonctionnalités Débloquées avec Premium

• ✅ Clients illimités
• ✅ Analyses avancées
• ✅ Templates personnalisés
• ✅ Export de données
• ✅ Support prioritaire
• ✅ Synchronisation cloud
• ✅ Sauvegarde automatique
• ✅ Mises à jour prioritaires

🔍 Intégration dans l'App

1. Vérification du statut premium

final premiumService = PremiumService();
final isPremium = await premiumService.isPremiumUser();

2. Vérification d'une fonctionnalité

final isUnlocked = await premiumService.isFeatureUnlocked('unlimited_clients');

3. Utilisation du PremiumGate

PremiumGate(
  featureId: 'unlimited_clients',
  child: YourPremiumWidget(),
  fallback: YourFreeVersionWidget(),
)

🚨 Points d'Attention

1. Sécurité

• Ne stockez jamais les informations de paiement côté client
• Validez toujours les achats côté serveur
• Utilisez les webhooks pour les notifications de paiement

2. UX

• Indiquez clairement les limites de la version gratuite
• Proposez des essais gratuits
• Facilitez l'upgrade vers Premium

3. Conformité

• Respectez les guidelines des stores
• Implémentez la restauration des achats
• Gérez les annulations d'abonnement

📈 Métriques à Suivre

• Taux de conversion gratuit → premium
• Churn rate des abonnements
• Revenus par utilisateur
• Utilisation des fonctionnalités premium

🆘 Support

En cas de problème :

1. Vérifiez les logs de l'app
2. Testez avec des comptes de test
3. Consultez la documentation des stores
4. Contactez le support technique

---

🎉 Félicitations !

Votre système de paiement in-app est maintenant configuré ! Les utilisateurs peuvent désormais débloquer des fonctionnalités premium et vous pouvez monétiser votre application.

Prochaines étapes :

1. Testez tous les flux d'achat
2. Configurez les analytics
3. Lancez votre app avec confiance ! 🚀